⑥ 查询税费缴纳结果
缴款结果确认:银行侧持电子税票号码完成缴税后,以此接口确认「已缴纳」才能进入开票。支持单号与批量。数据类接口。
属「乐企联用 · 报废产品收购(9 个业务接口)」——底层编排 乐企原子接口,你只调这一个。
接口(数据类)
POST https://openapi.kailingteck.com/api/v1/invoice/reverse/lqbiz/tax/pay-status
鉴权:X-App-Key + X-Timestamp(Unix 秒) + X-Sign(= sha256(appKey + 时间戳 + 报文 + appSecret))。正式 AppKey／AppSecret 请联系开灵商务或您的开灵项目经理获取,联调期可先用演示密钥。
内置能力:支持单号与批量(dzsphmList) 内部编排:CXSFJNJG
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
dzsphm | 二选一 | 单个电子税票号码(接口⑤返回) |
dzsphmList | 二选一 | 电子税票号码数组,批量查询 |
返回参数(data)
| 参数 | 说明 |
|---|---|
dzsphm | 电子税票号码 |
skjnjg | 税款缴纳结果:01 已缴纳／02 未缴纳／03 状态未明／04 税费已作废 |
请求示例
{ "dzsphmList": ["37202607000123456789", "37202607000123456790"] }返回示例(成功)
{ "code": "CYT_00000", "msg": "success", "requestId": "cyt_xxx", "data": {
"list": [
{ "dzsphm": "37202607000123456789", "skjnjg": "01" },
{ "dzsphm": "37202607000123456790", "skjnjg": "02" }
]
} }返回示例(失败/业务拦截)
{ "code": "CYT_00000", "msg": "success", "data": {
"list": [ { "dzsphm": "37202607000123456789", "skjnjg": "04" } ]
} } // 04=税费已作废:重新走接口⑤异常与报错
| 情形 | 含义与处理 |
|---|---|
| HTTP 200 · skjnjg=02/03 | 未缴款或状态未明:TIPS 缴款到账有延迟,稍后重查;未确认 01 前不要调接口⑦开票 |
| HTTP 200 · skjnjg=04 | 税费已作废(常见于扣款失败):需重调接口⑤重新算税下单 |
前端怎么用
// 缴款发起后轮询(建议 30s 间隔)
const r = await post('/lqbiz/tax/pay-status', { dzsphm: order.dzsphm });
if (r.data.skjnjg === '01') await createInvoice(order); // 已缴纳 → 调⑦开票
if (r.data.skjnjg === '04') await recalc(order); // 已作废 → 重走⑤