# 作废结果异步通知

# 接口说明

由于发票开具的异步处理机制,开发者发起的作废发票申请,开放平台会根据传入的异步通知地址 callback_url(开具时传入),通过POST请求的形式将结果作为参数通知给开发者。

  1. 作废发票接口由本接口回调
  2. 异步通知是由高灯平台主动发起通知给开发者,只有在高灯平台的开票数据中存在该笔开票申请,且发生了开票状态的改变,才会发送通知。
  3. 开放平台用POST Content-Type:Application/Json方式发送通知信息
  4. 开发者接口端程序执行完后返回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":{}
}