# 作废结果异步通知

# 接口说明

由于发票开具的异步处理机制,开发者发起的作废发票申请,开放平台会根据传入的异步通知地址 callback_url(开具时传入),通过POST请求的形式将结果作为参数通知给开发者。
>1. 作废发票接口由本接口回调
>2. 异步通知是由高灯平台主动发起通知给开发者,只有在高灯平台的开票数据中存在该笔开票申请,且发生了开票状态的改变,才会发送通知。
>3. 开放平台用<font color=#FF0000 >POST Content-Type:Application/Json</font>方式发送通知信息
>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 发票状态:<br>4:开票成功作废中<br>5:开票成功作废失败<br>6:开票成功作废成功

# 异步通知示例

	{
		&quot;appkey&quot;:&quot;2017112457241500&quot;,
		&quot;order_id&quot;:&quot;200000001327144140800000020&quot;,
		&quot;g_unique_id&quot;:&quot;20171222000000066215139296047040&quot;,
		&quot;notify_time&quot;:&quot;2017-12-22 16:00:06&quot;,
		&quot;notify_type&quot;:&quot;invoice.invalid&quot;,
		&quot;message&quot;:&quot;SUCCESS&quot;,
		&quot;ticket_code&quot;:&quot;150003533340&quot;,
		&quot;ticket_date&quot;:&quot;1640966400&quot;,
		&quot;ticket_sn&quot;:&quot;35685773&quot;,
		&quot;ticket_status&quot;:7
	}

# 返回示例

{
	&quot;code&quot;:0,
	&quot;message&quot;:&quot;success&quot;,
	&quot;data&quot;:{}
}