发票状态变更回调通知接口文档

1. 接口说明

该接口用于在发票状态变更时，向服务商（外部API来源）发起异步回调通知。

2. 通知触发条件

• 商户已配置有效的回调地址（notify_url）

3. 请求参数

3.1 公共字段

3.2 事件特定字段

4. 事件类型说明

5. 请求示例

5.1 INVOICE_SUCCESS（开票成功）

{
  "fapiaoApplyId": "INV202406220001",
  "outerApplyId": "OUTER202406220001",
  "eventType": "INVOICE_SUCCESS",
  "invoiceStatus": "SUCCESS",
  "invoiceNo": "1234567890",
  "invoiceCode": "011001900211",
  "failReason": null,
  "notifyTime": "2024-06-22T14:30:00"
}

5.2 INVOICE_FAIL（开票失败）

{
  "outerApplyId": "OUTER202406220001",
  "eventType": "INVOICE_FAIL",
  "invoiceStatus": "FAIL",
  "invoiceNo": null,
  "invoiceCode": null,
  "failReason": "开票失败：购方税号格式错误",
  "notifyTime": "2024-06-22T14:30:00"
}

5.3 INVOICE_APPLYING（开票受理成功）

{
  "outerApplyId": "OUTER202406220001",
  "eventType": "INVOICE_APPLYING",
  "invoiceStatus": "APPLYING",
  "invoiceNo": null,
  "invoiceCode": null,
  "failReason": null,
  "notifyTime": "2024-06-22T14:25:00"
}

5.4 REVERSE_SUCCESS（冲红成功）

{
  "outerApplyId": "OUTER202406220001",
  "eventType": "REVERSE_SUCCESS",
  "invoiceStatus": "REVERSED",
  "invoiceNo": "1234567890",
  "invoiceCode": "011001900211",
  "failReason": null,
  "notifyTime": "2024-06-22T15:00:00"
}

5.5 REVERSE_FAIL（冲红失败）

{
  "outerApplyId": "OUTER202406220001",
  "eventType": "REVERSE_FAIL",
  "invoiceStatus": "REVERSE_FAILED",
  "invoiceNo": "1234567890",
  "invoiceCode": "011001900211",
  "failReason": "红冲失败：发票已作废",
  "notifyTime": "2024-06-22T15:00:00"
}

5.6 TITLE_FILLED（发票抬头填写完成）

{
    "buyerAddress": "陕西省西安市xx区xXX路XXX号楼XXX室",
    "buyerPhone": "13211221223",
    "buyerTaxNo": "9xxxxxxxxxxx2",
    "buyerBankAccount": "6xxxxxxxxxxxxxxxxxx2",
    "merchantId": "8xxxxxxxx4",
    "buyerBankName": "中国建设银行股份有限公司xxxxx支行",
    "notifyTime": "2026-08-31T09:13:24.626",
    "buyerType": "ORGANIZATION",        //抬头类型：个人/单位（微信透传）
    "fapiaoBillType": "COMM_FAPIAO",    //发票类型：增值税普通/专用发票（微信透传）
    "channelOrderNo": "4xxxxxxxxxxxxxxxxxxxxx6",
    "eventType": "TITLE_FILLED",
    "buyerName": "陕西xxxxxxxxxxx有限公司"
}

6. 响应要求

接收方收到通知后，应在 5秒内 返回 HTTP 响应，响应内容为字符串 success（不区分大小写）：