5.1.03回调接口-按单回调(单据对应的所有发票开票完毕后一起回调(包含开票成功和开票失败),不支持合并又拆分的场景)
POST
/:忽略该接口前缀,此为对接发票云方提供的回调地址(对接方必须按照成功响应示例报文返回 json )一个开票申请单如果拆分开具了N张发票,在发票开具完毕后,只全部回调一次,开票成功失败的都会返回
(业务编号 businessSystemCode 以 3std1 开头,就会开启这种方式的回调)
请求参数
业务编码,开票回调是INVOICE.OPEN,作废回调是INVOICE.CANCEL,红冲回调是INVOICE.RED
0成功,9999失败,按单回调无法根据此状态码判断,会存在部分开具成功,部分失败的情况,根据是否存在发票代码号码判断
开票失败原因,成功返回success
需要把data里面的base64字符串解密
购买方地址和电话,GBK编码100字节,开专票时若未传入则用名称匹配系统维护的地址电话【长度:100】
购买方银行和账号,GBK编码100字节,开专票时若未传入则用名称匹配系统维护的银行和账号【长度:100】
购买方性质,0-企业,1-个人
差额征税差额【长度:(14,2)】
开票人【长度:10】
收款人【长度:10】
复核人【长度:10】
含税标识,0-不含税,1-含税【长度:1】
清单标志,0-非清单发票,1-清单发票【长度:1】
发票状态 0-正常 2-待开 3-红冲 6-作废
板式文件下载地址,航信百旺税盘开普通电票为PDF文件,开电子专票为ofd文件,ukey开电票都是ofd文件,数电票为ofd文件
PDF转图片预览地址
数电票pdf地址,星瀚版本5.0.022支持
数电票xml地址,星瀚版本5.0.022支持
开票类型,0蓝票,1红票 【长度:1】
发票种类, 028-增值税电子专用发票, 004-增值税纸质专用发票, 026-增值税电子普通发票, 007-增值税纸质普通发票 【长度:4】
原蓝票发票代码,开红票必传【长度:12】
原蓝票发票号码,开红票必传【长度:8】
原蓝票状态,红冲、回调时存在,红冲回调为3、作废回调为6
原蓝票开票时间,红冲、回调时存在,格式为"yyyyMMdd"
纸票打印标识,0-未打印 1-已打印
红字信息表编号,专用发票红冲必传【长度:16】
备注,GBK编码230字节【长度:230】
序列号 【拆分合并后重新生成的编号】
征税方式,0-普通 2-差额
是否已超过月预警阈值
示例代码
返回响应
{
"message": "string",
"errorCode": "string",
"success": true
}