⑩ 查开票状态
主动去工行查这一票开到哪一步了(确认 / 支付 / 开票 / 上传 / 缴税 五个状态)。数据类:POST 进 / 工行原样 JSON 出。 和 ⑨ 开票通知是两条路:⑨ 是工行推给你,⑩ 是你主动查,都行。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/invoice/query
鉴权:X-App-Key + X-Sign + X-Timestamp。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填) |
outOrderId | 必填 | 订单号(和下单 / 付款时一致) |
outVendorId | 选填 | 收方(散户)编号 |
outUserId | 选填 | 付方(企业)编号 |
outRedOffsetId | 选填 | 红冲流水号(想查红冲信息时传) |
outInvoiceId | 选填 | 开票请求流水号 |
partnerMerTrueAppId | 选填 | 真实商户 appId(合作机构模式用) |
{ "outOrderId": "你们的订单号" }返回(工行响应字段很多 · 全字段原样返回,这里列常用的)
| 工行字段 | 大白话说明 |
|---|---|
returnCode | 返回码(10100000-自然人确认成功) |
returnMsg | 返回码说明 |
confirmStatus | 自然人确认状态:00-未确认 / 01-自然人确认完成 / 02-全部确认完成 |
payStatus | 支付状态:02-成功 …(工行字典) |
invoiceStatus | 预开票状态:00-初始 / 01-开票中 / 02-开票成功 / 03-失败 … |
uploadStatus | 发票上传状态:04-上传成功 … |
taxStatus | 缴税状态:04-缴税成功 … |
invoiceCode | 发票号码 |
invoiceDate | 预开票日期 |
payAmount | 合计金额(票面含税) |
taxAmount | 合计税额 |
invoiceDetailResponse | 发票明细集合(商品名/数量/单价/金额/税额…) |
invoiceLevyItemResponse | 征收信息明细集合 |
redOffsetStatus | 红字确认单状态(有红冲时) |
工行这个响应字段特别多(还有支付方式、优惠、红冲明细、还款、退税等一大堆),开灵全字段原样返回、不挑不改;完整字典以工行文档为准。看进度主要盯这 5 个: confirmStatus / payStatus / invoiceStatus / uploadStatus / taxStatus。未配凭据时返回 { mock: true }。