㉔ 按月对账(蓝票红票税额)
财务每月月底那张对账表,数据就从这里来:这个月开了几张蓝票、冲了几张红票、金额税额各多少、税交了没有、汇总确认了没有。 可以查本地(快)也可以查税局(权威),queryRange=1 还能把这家企业在所有平台开的票一起拉出来。 数据类:POST 进 / 工行原样 JSON 出。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/invoice/summary-confirm
鉴权:请求头 X-App-Key + X-Sign + X-Timestamp(同其它开灵接口)。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
taxpayerNo | 必填 | 开票企业的税号(统一社会信用代码) |
queryRange | 必填 | 查询范围:0-只查本平台开的票 / 1-查这家企业在所有平台开的票(含别家平台,对账查漏用) |
dataResource | 必填 | 数据来源:0-本地(乐企平台侧,快) / 1-税局(以税局为准,慢但权威) |
month | 选填 | 月份 yyyy-MM。不传就返回所有历史月份 |
{
"taxpayerNo": "11000000000000003705",
"queryRange": "0",
"dataResource": "0",
"month": "2026-08"
}返回(工行原样返回)
| 工行字段 | 大白话说明 |
|---|---|
returnCode | 返回码(0-成功,其它-失败) |
returnMsg | 返回信息 |
summaryConfirmInfoList | 按月汇总的发票确认信息,数组,字段见下表 |
summaryConfirmInfoList 按月汇总明细
| 工行字段 | 大白话说明 |
|---|---|
authorizaAccessCode | 平台编号(只有查税局端 dataResource=1 时才有值,用来区分是哪家平台开的) |
month | 月份 yyyy-MM |
blueInvoiceNum | 蓝字发票张数(正常开出去的票) |
blueInvoiceAmount | 蓝字发票金额合计(不含税) |
blueInvoiceTaxAmount | 蓝字发票税额合计 |
redInvoiceNum | 红字发票张数(冲红掉的票) |
redInvoiceAmount | 红字发票金额合计 |
redInvoiceTaxAmount | 红字发票税额合计 |
payTaxAmountTotal | 已缴税费合计(这个月实际交上去多少税) |
statisticalTime | 统计时间 yyyyMMddHHmmss |
confirmStatus | 确认状态:0-确认 / 1-取消确认 / 2-未确认 / 3-确认失败 |
errorInfo | 错误信息(confirmStatus=3 确认失败时看这里) |
怎么用
- 月度对账:拿
blueInvoiceAmount/blueInvoiceTaxAmount和自己系统的收购台账对,差额就是要查的票。 - 查漏:
queryRange=1+dataResource=1,能看到这家企业在别的平台也开了票,避免额度被别家用掉还不知道。 - 催确认:
confirmStatus=2(未确认)说明这个月的汇总还没确认,税可能没申报上去,要提醒企业。 confirmStatus=3(确认失败)看errorInfo原文。
本地和税局两边数可能有延迟差,以税局(dataResource=1)为准。未配工行凭据时返回 { mock: true }。