废弃发票

简介

本接口用于对开放平台的已开具的发票做作废处理，作废完以后用户可重新开具相关发票。

服务提供方

享道

接口URL

/openapi/invoice/cancel

请求方式

POST

请求频次

单次

请求参数

参数名称	类型	必选	说明
invoice_id	string	是	发票业务号
cancel_by	string	是	取消人
reason	string	是	取消原因
timestamp	long	是	请求时间，Unix Timestamp单位毫秒

响应参数

参数名称	类型	必有	说明
errCode	int	是	服务响应状态，参见附录5
errMsg	string	是	服务响应状态说明，参见附录5

请求事例

请求

curl --request POST \
  --url https://open-sit.saicmobility.com/merchant/v1/openapi/invoice/cancel \
  --header 'content-type: application/json' \
  --header 'x-merchantid: open_merchant_YBRlTU4dqZ2j4n5Z' \
  --header 'x-sign: 11f4845e302a561fb036955365ae560f9d78490d' \
  --header 'x-signalgorithm: 1' \
  --header 'x-timestamp: 1603348931717' \
  --data '{"appId":"open_app_BwH96b6vfFgBtsaa","cancel_by":"saic","invoice_id":"I8c8276a165a046319ef1b1f6d3ac6613","merchantId":"open_merchant_YBRlTU4dqZ2j4n5Z","reason":"废弃发票","timestamp":1603348931717}'

响应

{
    "errCode": 10000,
    "errMsg": "successful"
}