⑪ 下载发票
开票成功后,调本接口把发票文件下载下来(支持蓝票 / 红票,格式 PDF / OFD / XML)。数据类:POST 进 / 工行原样 JSON 出,发票文件在 byteData 里(Base64)。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/invoice/download
鉴权:X-App-Key + X-Sign + X-Timestamp。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填) |
outOrderId | 必填 | 订单号(和下单 / 付款时一致) |
isRedOrblue | 选填 | 下蓝票还是红票:01-蓝票(正常发票)/ 02-红票(冲销票);不传默认下蓝票 |
outRedOffsetId | 下红票必填 | 红冲流水号(isRedOrblue=02 下红票时必填) |
invoiceFormat | 选填 | 发票格式:1-OFD / 2-PDF / 3-XML(默认 PDF) |
outInvoiceId | 选填 | 开票请求流水号 |
partnerMerTrueAppId | 选填 | 真实商户 appId(合作机构模式用) |
{ "outOrderId": "你们的订单号", "invoiceFormat": "2" }返回(工行原样返回)
| 工行字段 | 大白话说明 |
|---|---|
return_code | 返回码 |
return_msg | 返回信息 |
byteData | 发票文件内容(Base64 编码的字节数组;解码后就是发票文件 PDF/OFD/XML) |
拿到 byteData 后 Base64 解码写成文件即可(invoiceFormat 决定是 PDF / OFD / XML)。未配凭据时返回 { mock: true }。