⑤ 计算代缴税费＋下单(核心)
核心动词:只传不含税金额与票面口径,内置算税引擎按官方《算税规则》算出五税种应缴税额(增值税/城建税/教育费附加/地方教育附加/个人所得税),经乐企校验通过后返回电子税票号码与逐项税额明细。号段取号、自然人未登记自动登记、补缴合并全部内部完成。数据类接口。
属「乐企联用 · 报废产品收购(9 个业务接口)」——底层编排 乐企原子接口,你只调这一个。
接口(数据类)
POST https://openapi.kailingteck.com/api/v1/invoice/reverse/lqbiz/tax/calc-order
鉴权:X-App-Key + X-Timestamp(Unix 秒) + X-Sign(= sha256(appKey + 时间戳 + 报文 + appSecret))。正式 AppKey／AppSecret 请联系开灵商务或您的开灵项目经理获取,联调期可先用演示密钥。
内置能力:内置算税引擎＋预赋码号段池自动取号＋自然人未登记自动登记兜底 内部编排:CXZRRKPXX → CXFXKPSSCS → 内置算税 → BFCPSGDJSFJY → CXDJSFJKXX(池:QDFPPLFM;兜底:YZYHKHXX＋ZRRJJDJ)
请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
djxh | 必填 | 回收企业登记序号(接口①返回) |
nsrsbh | 必填 | 回收企业纳税人识别号 |
nsrmc | 必填 | 回收企业名称 |
sjswjgdm | 必填 | 省级税务机关代码(算税参数取数用) |
zrrxm | 必填 | 出售人姓名 |
sfzjhm | 必填 | 出售人身份证件号码;sfzjlx 默认 201,gjDm 默认 156 |
hjje | 必填 | 不含税金额(number)——内置算税引擎的计税基数 |
ykfplx | 选填 | 01 增值税专用发票／02 普通发票,默认 02 |
sfxszy | 选填 | Y/N 是否销售自用,默认 N;销售自用普票免税,个税按财产转让所得 20% |
sfxsyhjm | 选填 | Y/N 专票是否享受 1% 优惠减免,默认 Y;传 N 按 3% |
bjsfbz | 选填 | Y/N 补缴税费标志,默认 Y(月累计超 10 万时合并补缴前期免税发票税费) |
ccyz | 选填 | 财产原值(number),sfxszy=Y 时用于个税;转让收入不超原值则不缴个税 |
sfjnfs | 选填 | 税费缴纳方式:0 自然人自行办理(默认)／1 企业委托扣缴 |
yhzh / khhszsf | 选填 | 银行账号／开户行省份;自然人未登记导致预开失败时自动验卡＋间接登记后重试 |
yjsfList | 选填 | 高级模式:自行算税传入应缴税费list,内置引擎跳过、原样透传乐企校验 |
返回参数(data)
| 参数 | 说明 |
|---|---|
ykfphm | 预开发票号码(号段池自动取号;开票时即发票号码,接口⑦要用) |
dzsphm | 电子税票号码——银行侧缴款(TIPS 财政缴银/三方协议扣款)的唯一凭据 |
sjse | 实缴税额(乐企缴款信息返回) |
tax.cumMonth | 当前累计金额＝一人式月累计＋本单金额(10 万起征分界的依据) |
tax.items[] | 五税种应缴明细,逐项:zsxmDm/zsxmmc 税种、zspmDm/zspmmc 品目、jsyj 计税依据、slzsl 税率、yjse 应缴税额、yjhkce 已缴或扣除额、jmxzDm 减免性质代码、note 计算说明 |
tax.yjsfhj | 应缴税费合计(本单需代缴总额,即从交易款中代扣的钱) |
tax.face | 票面口径:hjje 不含税额/zzssl 票面税率/hjse 票面税额/jshj 价税合计/msbz 免税标志 |
steps[] | 执行痕迹:累计取数→算税参数→内置算税引擎→待缴税费校验→查询缴款信息,排障与沙箱对账用 |
请求示例
{
"djxh": "10113700000123456", "nsrsbh": "91371100MA3XXXXX0X", "nsrmc": "某再生资源回收有限公司",
"sjswjgdm": "13700000000",
"zrrxm": "李建国", "sfzjhm": "37061119790101001X",
"hjje": 120000,
"ykfplx": "02", "sfxszy": "N", "bjsfbz": "Y", "sfjnfs": "0",
"yhzh": "6222020000012345678", "khhszsf": "370000"
}返回示例(成功)
{ "code": "CYT_00000", "msg": "success", "requestId": "cyt_xxx", "data": {
"ykfphm": "24371100000012345678",
"dzsphm": "37202607000123456789",
"sjse": 2165.6,
"tax": {
"cumMonth": 176000, "yjsfhj": 2165.6,
"items": [
{ "zsxmDm": "10101", "zsxmmc": "增值税", "zspmDm": "101014001", "zspmmc": "商业",
"jsyj": 176000, "slzsl": 0.01, "yjse": 1760, "yjhkce": 0, "jmxzDm": "0001011608",
"note": "当张发票+本月待补缴普票合并按 1%" },
{ "zsxmDm": "10109", "zsxmmc": "城市维护建设税", "zspmDm": "101090100", "zspmmc": "增值税城市维护建设税",
"jsyj": 1760, "slzsl": 0.07, "yjse": 61.6, "yjhkce": 0, "jmxzDm": "0007049901",
"note": "按应缴增值税为基数计征,六税两费减征 50%" },
{ "zsxmDm": "30203", "zsxmmc": "教育费附加", "zspmDm": "302030100", "zspmmc": "增值税教育费附加",
"jsyj": 1760, "slzsl": 0.03, "yjse": 26.4, "yjhkce": 0, "jmxzDm": "0061049901",
"note": "六税两费减征 50%,含本月待补缴普票/专票两教" },
{ "zsxmDm": "30216", "zsxmmc": "地方教育附加", "zspmDm": "302160100", "zspmmc": "增值税地方教育附加",
"jsyj": 1760, "slzsl": 0.02, "yjse": 17.6, "yjhkce": 0, "jmxzDm": "0099049901",
"note": "六税两费减征 50%,含本月待补缴普票/专票两教" },
{ "zsxmDm": "10106", "zsxmmc": "个人所得税", "zspmDm": "101060200", "zspmmc": "经营所得",
"jsyj": 420000, "slzsl": 0.0025, "yjse": 300, "yjhkce": 750,
"note": "年度累计不超 60 万,按 0.25% 计征" }
],
"face": { "hjje": 120000, "zzssl": 0.01, "hjse": 1200, "jshj": 121200, "msbz": "N", "sfxsyhjm": "" }
},
"steps": [ { "step": "自然人累计取数" }, { "step": "算税参数" }, { "step": "内置算税引擎" },
{ "step": "待缴税费校验(预开票)" }, { "step": "查询缴款信息" } ],
"hint": "税额明细见 tax.items(应缴合计 tax.yjsfhj);持电子税票号码完成缴款(TIPS/三方协议扣款),缴款后调 tax/pay-status 确认,再调 invoice/create 开票"
} }返回示例(失败/业务拦截)
{ "code": "CYT_50200", "msg": "查验源暂时不可用,请稍后再试", "requestId": "cyt_xxx", "data": {
"hint": "待缴税费校验失败:算税校验不通过",
"data": { "steps": [ "…含乐企返回的算税校验结果;沙箱环境含标准答案,用于校准…" ],
"tax": { "yjsfhj": 2165.6, "items": [ "…引擎计算结果,便于比对差异…" ] } }
} }异常与报错
| 情形 | 含义与处理 |
|---|---|
| HTTP 502 · 缺少 hjje | 未传不含税金额且未走高级模式;补传 hjje 即可 |
| HTTP 502 · 号段池为空且补领失败 | 预赋码额度用尽:联系平台补充赋额额度后重试 |
| HTTP 502 · 待缴税费校验失败(ssjyjg=N) | 算税结果与乐企不一致:沙箱环境 steps 里有标准答案用于校准,生产仅返回算错项;已自动做「自然人间接登记→重试」兜底,仍失败时号码自动回池 |
| HTTP 502 · BF9031(查缴款信息) | 单张发票产生多张税票的地区不支持乐企开具:调接口⑨取消交易,改走电子发票服务平台 |
前端怎么用
const r = await post('/lqbiz/tax/calc-order', { djxh, nsrsbh, nsrmc, sjswjgdm, zrrxm, sfzjhm, hjje });
showTaxDetail(r.data.tax.items, r.data.tax.yjsfhj); // 逐项税额展示给操作员确认
order.ykfphm = r.data.ykfphm; // 存:开票用
order.dzsphm = r.data.dzsphm; // 存:交银行缴款用(TIPS)实付给出售人的钱＝jshj(价税合计)−tax.yjsfhj(代缴税费),资金/发票/税款三流在此对齐。乐企不算税只校验:税额由本接口内置引擎按官方《算税规则》计算(详见主页「内置算税引擎」),每单都过乐企校验闸。