主题
开票结果通知
接口描述
- 开票申请处理完成后会将处理结果通知给接入方。
注意事项
- 同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
- 接入方系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息的正确性，防止数据泄露导致出现"假通知"，造成损失。
- 当接入方系统收到甬易的推送通知时，必须输出 SUCCESS，甬易收到 SUCCESS，便认为接入方已收到；否则将继续发送通知，以递增的时间间隔再次重发 5 次；时间间隔分别为 24s,1m,1m,6m,12m。
请求方式
- POST
通知参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
| applyNo | 是 | string | 申请单号 | APPLY00000001 | |
| gatherMonth | 是 | string | 开票月份 | 2024-01 | |
| relegationNo | 否 | string | 发票号码 | 01234567 | |
| invoiceAmount | 是 | string | 开票金额 | 10000 | |
| pdfUrl | 否 | string | 发票PDF文件地址 | ||
| ofdUrl | 否 | string | 发票OFD文件地址 | ||
| xmlUrl | 否 | string | 发票XML文件地址 |
通知报文示例
json
{
"code": "00000000",
"message": "成功",
"signature": "pz+Z8unqO2VBjTGtzWASCCfzix5QxODSkAdKKyPiVXIXLtp574xCmuWaOeHfslnbUK2RKsYdNy/OhcMPV+GMaoXxcXuDvmVhUdKHWgYODovK5GbbqfqaT+nrzO0xnNz8rLCnevTQ3y4+Qn6++xVlwyMOW3SDw9gRM5qF40TlectpvylieoFROXzYIHXBveRrcT3FQSwnoNamNet/k7OTvotiT0Fft6SGDflqkWeHhiP83265OSMvQPwtIcEStyTv4AHLsWC5pSd7zTQ+pkvetMlm0AAwO6Jl4xUYx+OZkBM8vpgxqAQa4yzV9mTwfsaFZsKRnTXTJdFVHr9xONro5g==",
"transNonce": "43e2c287-24b1-4cd1-b3d2-e40e7840cc40",
"transDate": "1731469621597",
"applyNo": "APPLY00000001",
"gatherMonth": "2024-01",
"relegationNo": "01234567",
"invoiceAmount": "10000",
"pdfUrl": "https://example.com/invoice/202401001.pdf",
"ofdUrl": "https://example.com/invoice/202401001.ofd",
"xmlUrl": "https://example.com/invoice/202401001.xml"
}响应报文
SUCCESS