② 企业代办税费校验
查收购企业是否存在「应代办未代办」税费:反向开票后企业须在次月征期内代办申报缴纳,逾期未办会被税局暂停反向开票资格。适合做成每日定时任务,blocked=true 时推送提醒。数据类接口。
属「乐企联用 · 报废产品收购(9 个业务接口)」——底层编排 乐企原子接口,你只调这一个。
接口(数据类)
POST https://openapi.kailingteck.com/api/v1/invoice/reverse/lqbiz/agent-tax/check
鉴权:X-App-Key + X-Timestamp(Unix 秒) + X-Sign(= sha256(appKey + 时间戳 + 报文 + appSecret))。正式 AppKey／AppSecret 请联系开灵商务或您的开灵项目经理获取,联调期可先用演示密钥。
内置能力:返回 blocked 结论＋逐户明细,可供平台定时轮询提醒 内部编排:CXYDBWDBSFXX
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
dbnsrdjxh | 必填 | 收购企业登记序号(接口①返回的 base.djxh) |
dbnsrsbh | 必填 | 收购企业纳税人识别号 |
sq | 必填 | 属期,格式 yyyyMM,如 202607(查该属期的应代办税费) |
返回参数(data)
| 参数 | 说明 |
|---|---|
blocked | boolean,存在应代办未代办税费时为 true |
records.ydbsehj | 应代办税额合计 |
records.sbqx | 申报期限 yyyy-MM-dd(超过此日未代办即被阻断开票) |
records.dbhs | 应代办自然人户数 |
records.(明细list) | 逐条:zrrxm 自然人姓名、zrrsfzjhm 证件号、税额、skssqq/skssqz 税款所属期 |
hint | 处理指引 |
请求示例
{ "dbnsrdjxh": "10113700000123456", "dbnsrsbh": "91371100MA3XXXXX0X", "sq": "202607" }返回示例(成功)
{ "code": "CYT_00000", "msg": "success", "requestId": "cyt_xxx", "data": {
"blocked": false,
"records": { "ydbsehj": 0, "dbhs": 0 },
"hint": "无应代办未代办记录"
} }返回示例(失败/业务拦截)
{ "code": "CYT_00000", "msg": "success", "data": {
"blocked": true,
"records": { "ydbsehj": 3560.5, "sbqx": "2026-08-15", "dbhs": 2,
"list": [ { "zrrxm": "李建国", "zrrsfzjhm": "3706111979XXXXXXXX", "se": 2165.6 },
{ "zrrxm": "赵有才", "zrrsfzjhm": "3706111982XXXXXXXX", "se": 1394.9 } ] },
"hint": "存在应代办未代办税费,请先在电子税务局完成代办申报,否则开票将被阻断"
} }异常与报错
| 情形 | 含义与处理 |
|---|---|
| HTTP 502 · CYT_50200 | 查询失败;常见:登记序号与税号不匹配、属期格式错误(必须 yyyyMM) |
| HTTP 200 · blocked=true | 先在电子税务局完成代办申报缴纳,完成后开票自动恢复;临近 sbqx 应升级提醒 |
前端怎么用
// 每日 09:00 定时任务
const r = await post('/lqbiz/agent-tax/check', { dbnsrdjxh, dbnsrsbh, sq: lastMonth() });
if (r.data.blocked) notifyFinance(r.data.records); // 推送财务:限期内去电子税务局代办申报