# 作废结果异步通知
# 接口说明
由于发票开具的异步处理机制,开发者发起的作废发票申请,开放平台会根据传入的异步通知地址 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.invalid |
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 | 发票状态: 4:开票成功作废中 5:开票成功作废失败 6:开票成功作废成功 |
# 异步通知示例
{
"appkey":"2017112457241500",
"order_id":"200000001327144140800000020",
"g_unique_id":"20171222000000066215139296047040",
"notify_time":"2017-12-22 16:00:06",
"notify_type":"invoice.invalid",
"message":"SUCCESS",
"ticket_code":"150003533340",
"ticket_date":"1640966400",
"ticket_sn":"35685773",
"ticket_status":7
}
# 返回示例
{
"code":0,
"message":"success",
"data":{}
}