订单取消开票
需授权 预计阅读时间: 8 分钟说明
对于没有开票记录,或者开票失败的订单,将会执行删除订单的操作。
对于已经存在开票记录的,则执行冲红操作,如果是蓝字发票,会全额冲红,如果是已经冲红的发票,则系统会提示冲红操作失败。
公共参数
名称 | 说明 |
---|---|
appCode | 由电子发票平台分配的 appCode |
cmdName | chinaeinv.api.order.v11.cancel |
sign | 数字签名字符串,调用方需要使用电子发票服务平台供的数字证书对 请求报文进行签名并作 Base64 编码,生成数字签名字符串。 |
请求参数说明
名称 | 类型 | 必填 | 长度 | 描述 |
---|---|---|---|---|
orderNo | String | 是 | 50 | 订单编号。 |
subOrderNo | String | 如果开票时传入了子订单编号,则必须填写 | 50 | 子订单编号。 |
taxpayerCode | String | 是 | 20 | 销货方纳税人识别号。 |
返回参数说明
名称 | 类型 | 描述 |
---|---|---|
code | String | 处理结果代码。 |
message | String | 处理结果消息。 |
请求报文示例
{
"orderNo": "订单编号",
"subOrderNo": "子订单编号",
"scanCodeKey": "购货方扫码开票时使用的唯一标识",
"taxpayerCode": "销货方纳税人识别号",
}
响应报文示例
{
"code": "处理结果代码",
"message": "处理结果消息"
}
返回错误说明
代码 | 说明 |
---|---|
0 | 处理成功。 |
1 | 系统内部错误,如出现该错误请及时联系电子发票服务平台。 |
2 | 参数校验未通过,详情请参考处理结果消息。 |
3 | appCode不存在或数字证书不可用。 |
4 | 数字签名错误,请检查数字证书、字符编码格式等是否正确。 |
6 | 正在处理中。 |
400 | 纳税人不存在或不可用,可能是传入的纳税人识别号错误或正在对该纳税人进行维护。 |
401 | 要查询的发票不存在。 |
501 | 重复的订单。 |
502 | “订单的状态不是“待开票”或“开票失败”,不能开票。” |
503 | “订单的状态不是“开票成功”或“开票失败”,不能冲红。” |
504 | 订单不存在 |
505 | “订单没有找到对应的蓝票,不能冲红。” |
506 | 冲红金额超过对应蓝票金额。 |
507 | 订单已开票,不能重复开票。 |
508 | 订单正在开票中,取消订单时,如果改订单已经在开票中时返回。 |