# 开票结果异步通知
# 接口说明
由于发票开具的异步处理机制,开发者发起的蓝票开具、红冲发票申请,开放平台会根据传入的异步通知地址 callback_url(开具时传入),通过POST请求的形式将结果作为参数通知给开发者。
- 蓝票开具结果、发票冲红结果都由本接口回调
- 异步通知是由高灯平台主动发起通知给开发者,只有在高灯平台的开票数据中存在该笔开票申请,且发生了开票状态的改变,才会发送通知。
- 开放平台用POST Content-Type:Application/Json方式发送通知信息
- 开发者接口端程序执行完后返回json,成功时code为0;如果开发者反馈给平台返回的code不是0,平台会不断重发通知。【一般情况下,最多完成10次通知(通知的间隔频率一般是:1m, 10m, 10m, 30m, 30m, 60m, 60m, 120m, 180m, 360m)】
# 返回字段说明
参数 | 是否必须 | 类型 | 最大长度 | 说明 |
---|---|---|---|---|
appkey | 是 | string | 32 | 开发者appkey |
message | 是 | string | 100 | 返回结果详情 |
notify_type | 是 | string | 20 | 通知类型: invoice.blue(蓝票回调) invoice.red(红票回调) |
notify_time | 是 | string | 20 | 通知时间:格式"1640966400" |
order_id | 是 | string | 64 | 商户订单号:开发者接入方业务订单唯一标识(开具蓝票开具时填入值) |
g_unique_id | 是 | string | 64 | 高灯方商户订单号:开发者商户订单号对应的高灯方商户订单唯一标识(与order_sn一致,兼容老平台开发者,新开发者请使用order_sn) |
order_sn | 是 | string | 64 | 高灯方商户订单号:开发者商户订单号对应的高灯方商户订单唯一标识 |
ticket_sn | 是 | string | 8 | 发票号码:如果开票失败时值为空 |
ticket_code | 是 | string | 12 | 发票代码:如果开票失败时值为空 |
ticket_date | 是 | string | 20 | 开票时间 |
ticket_status | 是 | string | 1 | 发票状态: 1:开票中 2:开票失败 3:开票成功 4:开票成功作废中 5:开票成功作废失败 6:开票成功作废成功 |
ticket_total_amount_has_tax | 是 | string | 20 | 发票含税总价:开票失败时值为空 |
ticket_total_amount_no_tax | 是 | string | 20 | 发票去税总价:开票失败时值为空 |
ticket_tax_amount | 是 | string | 20 | 发票税额:开票失败时值为空 |
qrcode | 是 | text | - | 发票二维码base64内容:最大10Kb,渠道不同可能返回为空,以实际结果为准 |
check_code | 是 | string | 50 | 发票校验码:开票失败时值为空,以实际结果为准 |
cipher_text | 是 | string | 200 | 发票密文,以实际结果为准 |
pdf_url | 是 | string | 200 | 发票PDFurl地址:开票失败时值为空(若开具为纸票没有pdf),以实际结果为准 |
# 异步通知示例
{
"appkey":"2017112457241500",
"order_id":"200000001327144140800000020",
"check_code":"64445110173853614637",
"cipher_text":"",
"g_unique_id":"20171222000000066215139296047040",
"order_sn":"20171222000000066215139296047040",
"pdf_url":"http://kpserverdev-1251506165.cossh.myqcloud.com/upload/fp_file/fp_15139296061565.pdf",
"qrcode":"Qk3CAwAAAAAAAD4AAAAoAAAASwAAAEsAAAABAAEAAAAAAIQDAAAAAAAAAAAAAAAAAAACAAAAAAAA///////////////////gAAAAAwAAAPzM8DAgAAAAAwAAAPzM8DAgAAA/88zDMz8A8PPgAAA/88zDMz8A8PPgAAAwMwM/DDDD8w/gAAAwMwM/DDDD8w/gAAAwMwP88wA/MA8gAAAwMwP88wA/MA8gAAAwM8Pz8/M/ADwgAAAwM8Pz8/M/ADwgAAA/8wDM/PA/PzzgAAA/8wDM/PA/PzzgAAAAAzwwz8/DMw8gAAAAAzwwz8/DMw8gAAD//z/MA/zAPzAgAAD//z/MA/zAPzAgAAAM8DDMP88DAADgAAAM8DDMP88DAADgAADDDPwDP888M8zgAADDDPwDP888M8zgAAA/M8/wAD8D/8PgAAA/M8/wAD8D/8PgAAAPPAP/Aw/M8w8gAAAPPAP/Aw/M8w8gAAAMwzMw8wPMMDAgAAAMwzMw8wPMMDAgAADzDzMAMMADwPMgAADzDzMAMMADwPMgAAA888D/zwDDDAzgAAA888D/zwDDDAzgAAA8//8z/Pw/z8zgAAA8//8z/Pw/z8zgAADDADDzzwM//w/gAADDADDzzwM//w/gAADPDwAzwPMwzzzgAADPDwAzwPMwzzzgAAADA8PAMP88M88gAAADA8PAMP88M88gAAD/D/8zPDzAAMAgAAD/D/8zPDzAAMAgAAD8MD/PAz8DDMPgAAD8MD/PAz8DDMPgAAADP8/zw8M/zM8gAAADP8/zw8M/zM8gAADMAzwzAPPzz/PgAADMAzwzAPPzz/PgAADwzP/w8DP88wMgAADwzP/w8DP88wMgAAAMM8M/w//MMDMgAAAMM8M/w//MMDMgAADADPMM/P/M/PDgAADADPMM/P/M/PDgAAD8MzM8z8D/zDzgAAD8MzM8z8D/zDzgAAAzz8P8P8wzz//gAAAzz8P8P8wzz//gAAAwwPA8Pz8/88wgAAAwwPA8Pz8/88wgAAD//w8Pw8ww///gAAD//w8Pw8ww///gAAAAAzMzMzMzMAAgAAAAAzMzMzMzMAAgAAA/88w//M8D8/8gAAA/88w//M8D8/8gAAAwM/A/AAP88wMgAAAwM/A/AAP88wMgAAAwMzDDwDzMMwMgAAAwMzDDwDzMMwMgAAAwM8DM/z/DMwMgAAAwM8DM/z/DMwMgAAA/8zPz/AADM/8gAAA/8zPz/AADM/8gAAAAAwwP8w8z8AAgAAAAAwwP8w8z8AAgAAA=",
"notify_time":"2017-12-22 16:00:06",
"notify_type":"invoice.blue",
"message":"SUCCESS",
"ticket_code":"150003533340",
"ticket_date":"1640966400",
"ticket_sn":"35685773",
"ticket_status":3,
"ticket_tax_amount":"0.00",
"ticket_total_amount_has_tax":"5.00",
"ticket_total_amount_no_tax":"5.00"
}
# 返回示例
{
"code":0,
"message":"success",
"data":{}
}
← 上一篇:开具发票查询 下一篇:发送发票邮件 →