开票结果回调(蓝票)
接口请求参数
回调说明 | |
---|---|
回调说明 | 针对商户对开票结果的实时性要求,标普智元集成平台提供开票结果回调功能。 |
回调前提 | 商户需提供可接收回调请求的api接口,并事先告知我方负责人配置回调api接口。 |
是否验签 | 是 |
验签方式 | 按商户调用标普智元集成平台的方式验签(详见开发指南中《开发指南》的1.2章节),签名加签的apiKey 和商户编号同标普智元集成平台分配给商户的apiKey和商户编号。 |
请求参数
参数 | 类型(长度) | 必填 | 描述 |
---|---|---|---|
merBusinessNo | String(64) | Y | 企业订单号 |
receivableNo | String(64) | Y | 系统应收单号 |
salesTaxNo | String(20) | Y | 销方税号 |
qdInvoiceNum | String(64) | N | 全电发票号码 |
invoiceTime | String(20) | N | 开票时间 |
pdfUrl | String(256) | N | 发票PDF地址 |
ofdUrl | String(256) | N | 发票OFD地址 |
xmlUrl | String(256) | N | 发票XML地址 |
invoiceStatus | Integer(1) | Y | 发票状态:0-待开 1-开票中 2-开票成功 3-开票失败 4-无需开票 5-已手工开票 |
failReason | String(256) | N | 失败原因 |
disconnFlag | Integer(1) | N | 掉线标识 1:是 0:否;如果值=1,则说明已掉线,需要重新发起登录操作 |
回调示例
{
"merBusinessNo": "638196589927",
"receivableNo": "719329551882547201",
"salesTaxNo": "1403016L1NN5336",
"qdInvoiceNum": "55188254720",
"invoiceTime": "2022-08-24 12:23:39",
"pdfUrl": "https://xxxx",
"ofdUrl": null,
"xmlUrl": null,
"invoiceStatus": 2,
"failReason": null
}
响应示例
当接收到回调请求之后,请响应如下,以便告知我们已接收
{
"code": 200,
"msg": "success"
}