③ 企业及自然人未办结业务校验
查是否存在「已预开验证税款但未缴税」的挂起交易:有挂单时该自然人不能再开新单,须先缴款或取消预开票。建单前的第三道闸。数据类接口。
属「乐企联用 · 报废产品收购(9 个业务接口)」——底层编排 乐企原子接口,你只调这一个。
接口(数据类)
POST https://openapi.kailingteck.com/api/v1/invoice/reverse/lqbiz/pending/check
鉴权:X-App-Key + X-Timestamp(Unix 秒) + X-Sign(= sha256(appKey + 时间戳 + 报文 + appSecret))。正式 AppKey／AppSecret 请联系开灵商务或您的开灵项目经理获取,联调期可先用演示密钥。
内置能力:含未缴税／扣款失败已作废记录识别;命中时需先缴款或调接口⑨取消 内部编排:CXQYWJSJL
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
nsrsbh | 选填 | 回收企业纳税人识别号(只传税号＝查全企业) |
zrrxm | 选填 | 自然人姓名(与 sfzjhm 同传＝查该自然人) |
sfzjhm | 选填 | 自然人身份证件号码;三个参数至少传一项 |
返回参数(data)
| 参数 | 说明 |
|---|---|
blocked | boolean,存在未办结记录时为 true |
records.wjskjlsl | 未缴税款记录数量 |
records.(逐条) | ykfphm 预开发票号码、ykfprq 预开日期、ykfpje 金额、ykfpse 税额、jfzt 缴税状态(0 未缴纳／5 扣款失败已作废)、sfjnfs 缴纳方式、lrrq 录入时间 |
hint | 处理指引 |
请求示例
{ "nsrsbh": "91371100MA3XXXXX0X", "zrrxm": "李建国", "sfzjhm": "37061119790101001X" }返回示例(成功)
{ "code": "CYT_00000", "msg": "success", "requestId": "cyt_xxx", "data": {
"blocked": false,
"records": { "wjskjlsl": 0 },
"hint": "无未办结业务"
} }返回示例(失败/业务拦截)
{ "code": "CYT_00000", "msg": "success", "data": {
"blocked": true,
"records": { "wjskjlsl": 1, "list": [ { "ykfphm": "24371100000012345678", "ykfprq": "2026-07-18 10:20:00",
"ykfpje": 120000, "ykfpse": 1200, "jfzt": "0", "sfjnfs": "0", "lrrq": "2026-07-18 10:20:31" } ] },
"hint": "存在已预开未缴税记录:请先缴款,或调 order/cancel 取消预开票"
} }异常与报错
| 情形 | 含义与处理 |
|---|---|
| HTTP 200 · blocked=true | 先完成缴款(接口⑥确认 01)或调接口⑨取消该预开票,再建新单 |
| HTTP 502 · CYT_50200 | 查询失败,data.hint 透传乐企错误信息 |
前端怎么用
const r = await post('/lqbiz/pending/check', { nsrsbh, zrrxm, sfzjhm });
if (r.data.blocked) {
const od = r.data.records.list[0];
// 弹窗二选一:去缴款(带 dzsphm 走缴款流程) / 取消预开(调⑨ order/cancel 带 od.ykfphm)
}