乐企联用 · 报废产品收购反向开票(业务型接口)
基于税务总局乐企数字开放平台「报废产品收购开票能力」(能力编码 202078)的乐企联用封装: 按接口清单提供 9 个业务接口——内置算税引擎、预赋码号段池、自然人自动登记、退税预检、限额三道线全部封装在接口内部, 客户平台只调这 9 个。34 个官方原子接口同时保留 1:1 透传通道。 未配置乐企凭证或使用演示密钥时自动走 mock(按官方能力文档报文示例返回),可先联调后接真。
调用约定
- 业务型(推荐):
POST /api/v1/invoice/reverse/lqbiz/<资源>/<动词>,如tax/calc-order - 原子型:
POST /api/v1/invoice/reverse/lq/<服务编码>,服务编码与官方能力文档一致,如BFCPSGFPSC - 鉴权:请求头
X-App-Key/X-Timestamp(Unix 秒级时间戳)/X-Sign=sha256(appKey+ts+body+appSecret) - 演示密钥
demo_app_key_001仅走 mock;正式密钥(AppKey/AppSecret)需开通「反向开票」产品权限——请联系开灵商务或您的开灵项目经理获取 - 响应:业务型返回网关统一信封(code/msg/requestId/data);原子型原样返回乐企
Response信封(returncode=00 为成功)
泳道时序图 · 一单从校验到开票退税全流程
看 蓝色粗线 = 客户平台要调的业务接口(共 9 个);细线 = 开灵网关内部替你调的乐企原子接口;缴款一步由银行侧走 TIPS 财政缴银完成。
关键链路:⑤ 返回的 ykfphm(预开票号码)与 dzsphm(电子税票号码)贯穿缴款与开票,开票时 fphm=ykfphm; 实付出售人金额=价税合计−应缴税费合计(tax.yjsfhj),资金/发票/税款三流在 ⑤ 对齐。
9 个业务接口(34 原子 → 9 业务,与客户接口清单一一对应)
| # | 业务接口 | 路径 | 内部乐企接口 | 一句话 |
|---|---|---|---|---|
| ① | 判断纳税人开票资格 | lqbiz/taxpayer/check | CXNSRJBXX + CXNSRFXXX | 基本信息与风险信息双查合并研判,一次调用出结论 |
| ② | 企业代办税费校验 | lqbiz/agent-tax/check | CXYDBWDBSFXX | 返回 blocked 结论+逐户明细,可供平台定时轮询提醒 |
| ③ | 企业及自然人未办结业务校验 | lqbiz/pending/check | CXQYWJSJL | 含未缴税/扣款失败已作废记录识别;命中时需先缴款或调接口⑨取消 |
| ④ | 自然人开票校验 | lqbiz/seller/check | CXZRRKPXX | 内置 60 万/180 万/500 万三道年累计校验线 |
| ⑤ | 计算代缴税费+下单(核心) | lqbiz/tax/calc-order | CXZRRKPXX → CXFXKPSSCS → 内置算税 → BFCPSGDJSFJY → CXDJSFJKXX(池:QDFPPLFM;兜底:YZYHKHXX+ZRRJJDJ) | 内置算税引擎+预赋码号段池自动取号+自然人未登记自动登记兜底 |
| ⑥ | 查询税费缴纳结果 | lqbiz/tax/pay-status | CXSFJNJG | 支持单号与批量(dzsphmList) |
| ⑦ | 发票开具 | lqbiz/invoice/create | BFCPSGFPSC + CXQDFPSCJG(轮询) | 发票上传后自动轮询上传结果至终态;特定要素固定 24-报废产品收购,蓝字标志默认 0 |
| ⑧ | 申请反向开票退税 | lqbiz/refund/apply | CXTSXX → SQFXKPTS → CXBFCPTSJG | 可退税额预检 → 申请 → 受理结果,一次调用办完 |
| ⑨ | 取消预开票交易 | lqbiz/order/cancel | QXYKFPJY | 取消成功后预赋码号码自动回池;已缴税/状态不明时号码不回池 |
点接口名进入详情页:入参表/返回参数表/成功与失败报文示例/异常与报错/前端怎么用。红字确认单等清单外能力经原子接口提供,不增加业务接口数量。
内置算税引擎(接口⑤)
乐企侧不负责算税、只做校验——官方要求应缴税额(yjse)为「直连平台算税规则计算结果」。 本网关按能力文档附件《乐企废品收购企业反向开票算税规则》内置了完整算税引擎:调用方只传不含税金额与票面口径, 五税种应缴税额由平台计算、经乐企校验通过后随响应逐项返还(tax.items 与合计 tax.yjsfhj)。 月累计(一人式金额)、年度个税累计与已缴税额自动取自乐企(CXZRRKPXX),待补缴汇总与征收品目、城建税率、六税两费减征比例自动取自算税参数(CXFXKPSSCS)。
| 场景 | 规则 |
|---|---|
| 月累计<10万·普票 | 免征(减免性质按额度分档 0001042804/…806/…807),应缴 0 |
| 月累计≥10万·普票 | 按 1% 计征(0001011608);补缴标志 Y 时与本月待补缴普票合并计税 |
| 专票 | 享受优惠减免按 1%,否则按 3%;超 10 万且补缴时,3% 当张与 1% 补缴分两条计算 |
| 销售自用普票 | 免征增值税(任何额度) |
| 场景 | 规则 |
|---|---|
| 计税依据 | 应缴增值税额(不是票面税额);税率与征收品目取自算税参数(CXFXKPSSCS) |
| 减征 | 六税两费减征(0007049901),减征比例按省配置,引擎默认 50% 并以算税参数返回值为准 |
| 场景 | 规则 |
|---|---|
| 月累计≤10万 | 全额减免(0061042802/0099042802),应缴 0 |
| 月累计>10万 | 按增值税额 ×3%/×2% 计征并六税两费减征;补缴时并入本月待补缴普票两教与专票 1%/3% 累计 |
| 场景 | 规则 |
|---|---|
| 非销售自用 | 年度累计(本单+本年度乐企个税累计)≤60 万按 0.25%;>60 万按 0.5% 减速算扣除 1500;再扣除年度已缴个税——与 2026 年第 12 号公告三流合一口径一致 |
| 销售自用 | 按财产转让所得:(转让收入−财产原值)×20%;收入不超原值不缴 |
校验闸:算税结果每单都经乐企 BFCPSGDJSFJY 复核(ssjyjg=Y 才放行)。沙箱环境校验失败时乐企会返回标准答案(在 steps 中可见), 联调期以沙箱对账校准;生产环境校验失败仅返回算错项。补缴发票号码清单在补缴标志为 Y 时自动携带。
🤖 AI 接入包(给贵方前端/后端的 AI 直接写对接代码)
把下面这份接入包丢给贵方的 AI(Claude / Cursor / 通义 等),它就能按本平台规范、用你指定的编程语言写出可直接运行的对接代码——覆盖鉴权签名 + 全部 9 个接口的字段/成功失败示例 + 调用顺序 + 错误处理。
接入包地址:https://openapi.kailingteck.com/api/skill/leqi-scrap(纯 Markdown,可直接被程序抓取)。
公共错误码(网关层)
以下错误对 9 个业务接口与 34 个原子接口通用;接口内的业务异常见各接口详情页「异常与报错」表。
| HTTP | code | 含义与处理 |
|---|---|---|
| 200 | CYT_00000 | 成功;业务结论看 data(eligible/blocked/allowed/cljg 等字段) |
| 400 | CYT_40001 | 请求体不是合法 JSON,或参数缺失/格式错误 |
| 401 | CYT_40100/40101/40102 | 缺少鉴权头/密钥不存在或停用/签名校验失败 |
| 401 | CYT_40103 | 时间戳过期或缺失——X-Timestamp 必须为 Unix 秒级(毫秒必错),校准时间后重试 |
| 403 | CYT_40301 | 密钥未开通「反向开票」产品权限——请联系开灵商务或您的开灵项目经理开通 |
| 404 | CYT_40001(hint:未知业务接口) | 业务接口仅接口清单 9 个;清单外能力走原子通道 /lq/<服务编码> |
| 429 | CYT_42901 | 请求过于频繁,稍后重试 |
| 502 | CYT_50200 | 上游乐企返回失败:data.hint 为失败原因(透传乐企 returncode/returnmsg),data.data.steps 为已执行步骤 |
原子接口(34 个,与官方能力文档一一对应)
点击展开查看每个接口的请求/返回参数表(内容提取自官方能力说明文档)。
1. 获取数电票批量预赋码信息 POST /api/v1/invoice/reverse/lq/QDFPPLFM
向纳税人提供批量预赋码功能,用于企业给发票自动赋发票号码。
企业使用开票前置判断企业发票库存低于“20%”阈值时,调用此接口申请预分配置新号码段。
企业每次获取数电票批量预赋码信息时,需要上传业务流水号,由“使用单位id”+“直连单位id”+“32位随机生成码”组成,若企业由于网络超时等原因没有收到获取结果,可以通过该业务流水号重新请求,重新请求时领用数量需要保持不变,企业每次最多申请5000份发票。
当企业完成跨省迁移后,不能再使用跨省迁移前下载的发票号码段,应当重新下载发票号码段,使用迁移后下载的发票号码段开具上传发票。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 申领发票的纳税人识别号或统一社会信用代码 |
| lysl | 领用数量 | number(10) | 是 | 申领数量最大值为:5000 |
| ywlsh | 业务流水号 | varchar(100) | 是 | “使用单位id”+“直连单位id”+“32位随机生成数” |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| fpqshm | 发票起始号码 | varchar(20) | 是 | |
| fpzzhm | 发票终止号码 | varchar(20) | 是 | |
| lysl | 领用数量 | number(10) | 是 |
2. 查询赋额额度 POST /api/v1/invoice/reverse/lq/CXSXED
向纳税人提供赋额额度查询功能,可查询企业当前在税务局端的赋额额度信息,包括:暂停授信标志、本月赋额额度、可用剩余额度、已下载额度、已下载未使用额度、属期。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 申领发票的纳税人识别号或统一社会信用代码 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| ztsxbz | 暂停授信标志 | varchar(2) | 是 | Y:暂停 N:未暂停 |
| bysxed | 本月赋额额度 | number(18,2) | 是 | 本月总赋额额度 |
| kysyed | 可用剩余额度 | number(18,2) | 是 | 本月可用赋额额度 |
| yxzed | 已下载额度 | number(18,2) | 是 | 本月乐企1.5已下载的全部赋额额度 |
| yxzwsyed | 已下载未使用额度 | number(18,2) | 是 | 本月乐企1.5已下载的全部赋额额度减已上传的开票日期为本月的发票的总金额 |
| sq | 属期 | varchar(6) | 是 | 格式:yyyyMM |
3. 下载/退回赋额额度 POST /api/v1/invoice/reverse/lq/XZTHSXED
向纳税人提供下载/退回赋额额度功能,企业可通过接口从税务局端下载或退回赋额额度。
企业每次下载/退回发票额度时,需要上传业务流水号,由“使用单位id”+“直连单位id”+“32位随机生成码”组成,若企业由于网络超时等原因没有收到发票额度下载/退回结果,可以通过该业务流水号重新获取,使用相同业务流水号申请下载/退回发票额度时申请类型与申请额度需要相同。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 申领发票的纳税人识别号或统一社会信用代码 |
| ptbh | 平台编号 | varchar(20) | 是 | |
| sqlx | 申请类型 | varchar(2) | 是 | 0:下载 1:退回 |
| sqed | 申请额度 | number(20,2) | 是 | |
| ywlsh | 业务流水号 | varchar(100) | 是 | “使用单位id”+“直连单位id”+“32位随机生成数” |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| syqjq | 赋额额度使用区间起 | date | 否 | 下载赋额额度时,有此节点 发票开票日期在赋额额度使用区间(含)时才可以使用.格式:yyyymmdd |
| syqjz | 赋额额度使用区间止 | date | 否 | 下载赋额额度时,有此节点 发票开票日期在赋额额度使用区间(含)时才可以使用.格式:yyyymmdd |
4. 调整赋额额度有效期 POST /api/v1/invoice/reverse/lq/TZSXEDYXQ
给企业提供调整赋额额度有效期接口,企业在月初未申报时下载的赋额额度的有效期止为当月申报截止日期,超过赋额额度有效期止后,无法开具报废产品收购发票,企业在完成申报或到达赋额额度有效期止后,通过此接口调整赋额额度有效期,并根据税局端返回的有效期更新本地赋额额度有效期。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| xsfnsrsbh | 统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | 开票方纳税人识别号 |
| sxedsq | 赋额额度属期 | varchar(7) | 是 | 格式:yyyy-MM |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| sxedsq | 赋额额度属期 | varchar(7) | 是 | 格式:yyyy-MM |
| syqjq | 赋额额度使用区间起 | date | 否 | 下载赋额额度时,有此节点;发票开票日期在赋额额度使用区间(含)时才可以使用,格式:yyyymmdd |
| syqjz | 赋额额度使用区间止 | date | 否 | 下载赋额额度时,有此节点;发票开票日期在赋额额度使用区间(含)时才可以使用,格式:yyyymmdd |
5. 查询纳税人风险信息 POST /api/v1/invoice/reverse/lq/CXNSRFXXX
向企业提供查询纳税人风险信息的功能,企业可将查询的风险信息保存在本地。在开票时自校验该接口获取的风险信息是否满足开具发票的条件,控制高风险企业操作涉税业务。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 开票纳税人识别号/统一社会信用代码 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | |
| fxnsrlx | 风险纳税人类型 | varchar(2) | 否 | 空:非风险纳税人 01:Ⅰ类(高风险)纳税人 02:Ⅱ类(中风险)纳税人 03:Ⅲ类(低风险)纳税人 04:Ⅳ类(无风险)纳税人 |
| nsrxydj | 纳税人信用等级 | varchar(20) | 是 | A,B,C,D,M |
| nsryjjb | 纳税人预警级别 | varchar(1) | 否 | 空:无预警 01:红色预警 02:黄色预警 03:蓝色预警 |
| fxnsrbz | 风险纳税人标志 | varchar(1) | 是 | Y:风险纳税人 N:正常纳税人 |
6. 查询纳税人基本信息 POST /api/v1/invoice/reverse/lq/CXNSRJBXX
向企业提供查询纳税人基本信息的功能,企业可将查询的基本信息,包括生产经营信息、税务机关信息、企业性质、消费税性质等保存在本地。在开票时自校验该接口获取的纳税人基本信息是否满足开具发票的条件。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 开票纳税人识别号/统一社会信用代码 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | |
| djxh | 登记序号 | varchar(20) | 否 | |
| ssdabh | 税收档案编号 | varchar(20) | 否 | |
| nsrmc | 纳税人名称 | varchar(300) | 是 | |
| nsrlx | 纳税人类型标签 | varchar(300) | 是 | 1:一般纳税人 2:小规模纳税人 3:转登记小规模纳税人 4:辅导期一般纳税人 5:自然人 |
| scjydz | 生产经营地址 | varchar(300) | 是 | |
| zcdyzbm | 注册地邮政编码 | varchar(6) | 是 | |
| zcdlxdh | 注册地联系电话 | varchar(60) | 否 | |
| fddbrxm | 法人名称(法定代表人姓名 | varchar(150) | 是 | |
| djzclxdm | 登记注册类型(国标) | varchar(3) | 否 | |
| hydm | 行业代码 | varchar(4) | 是 | 主行业代码特定征收部门可空 |
| qxjswjgdm | 区县级税务机关代码 | varchar(11) | 是 | |
| zgswskfjdm | 税务机关代码 | varchar(11) | 是 | 主管税务所科分局 |
| zgswskfjmc | 税务机关名称 | varchar(300) | 是 | 主管税务所科分局 |
| cwfzrxm | 财务负责人姓名 | varchar(150) | 是 | |
| khhmc | 账户名称 | varchar(300) | 是 | |
| yhzh | 账号 | varchar(50) | 否 | 首选账户账号 |
| bsrxm | 企业办税人员姓名 | varchar(150) | 否 | |
| xdpsdqybz | 数字化电子票试点企业标识 | varchar(20) | 是 | Y:数字化电子票试点企业 N:不是数字化电子票试点企业 |
| ckqyfldm | 出口企业分类 | varchar(20) | 是 | 空:非出口企业 01:一类出口企业 02:二类出口企业 03:三类出口企业 04:四类出口企业 |
| zfjglxdm | 总分机构类型 | varchar(20) | 是 | 0:非总分机构 1:总机构 2:分支机构 3:分总机构 |
| yhyywddm | 银行营业网点 | varchar(13) | 否 | |
| nsrztdm | 开票方纳税人状态 | varchar(2) | 是 | 01:受理 02:筹建期 03:正常 04:停业 05:非正常 06:清算 07:注销 08:非正常户注销 09:报验 10:核销报验 11:中断缴费 12:恢复缴费 13:简易注销无异议 99:其他 |
| yxqq | 纳税人类型标签有效期起 | date | 否 | 格式: yyyy-MM-dd |
| yxqz | 纳税人类型标签有效期止 | date | 否 | 格式: yyyy-MM-dd |
| qyhyxzdm | 企业行业性质 | varchar(300) | 否 | 01:成品油生产企业 02:成品油经销企业 03:国内机动车生产企业 04:进口机动车生产企业驻我国办事机构或总授权代理机构 05:机动车授权经销企业 06:其他机动车贸易商 07:二手车市场 08:二手车经销企业 09:二手车拍卖企业 10:稀土矿产企业 11:稀土冶炼分离企业 12:稀土其他企业 13:稀土矿产企业、稀土冶炼分离企业、稀土其他企业 14:稀土矿产企业、稀土冶炼分离企业 15:稀土矿产企业、稀土其他企业 16:稀土冶炼分离企业、稀土其他企业 17:卷烟生产企业 18:卷烟批发企业 19:卷烟出口企业 20:生产型出口企业 21:外贸型出口企业 22:外贸综合服务企业 23:自贸区试点企业 24:特殊监管区内企业 25:增值税一般纳税人资格试点 26:市场采购试点 27:退税商店 28:电子商务出口企业 29:享受出口退税政策的融资租赁企业 30:增值税零税率应税服务提供者 31:房地产开发企业 32:农产品深加工企业 33:外购石脑油、燃料油用于消费税退税企业 34:从事机动车进口的其他贸易商 35:自产农产品者 36:报废产品收购企业 37:光伏收购企业 38:住房租赁企业 39:冬奥会退税企业50:资源回收企业反向开票-一般计税 51:资源回收企业反向开票-简易计税 |
| xfsnsrlxdm | 消费税纳税人类型 | varchar(20) | 否 | 01:卷烟生产消费税纳税人 02:卷烟批发消费税纳税人 03:白酒生产消费税纳税人 04:黄酒生产消费税纳税人 05:啤酒生产消费税纳税人 06:其他酒生产消费税纳税人 07:小汽车生产消费税纳税人 08:超豪华小汽车消费税纳税人 09:汽油生产消费税纳税人 10:石脑油生产消费税纳税人 11:溶剂油生产消费税纳税人 12:润滑油生产消费税纳税人 13:柴油生产消费税纳税人 14:航空煤油生产消费税纳税人 15:燃料油生产消费税纳税人 16:电池生产消费税纳税人 17:涂料生产消费税纳税人 18:高档化妆品生产消费税纳税人 19:金银首饰铂金首饰和钻石及钻石饰品零售消费税纳税人 20:其他贵重首饰和珠宝玉石生产消费税纳税人 21:鞭炮焰火生产消费税纳税人 22:摩托车生产消费税纳税人 23:高尔夫球及球具生产消费税纳税人 24:高档手表生产消费税纳税人 25:游艇生产消费税纳税人 26:木制一次性筷子生产消费税纳税人 27:实木地板生产消费税纳税人 28:雪茄烟生产消费税纳税人 29:烟丝生产消费税纳税人 |
7. 查询可用税率信息 POST /api/v1/invoice/reverse/lq/CXKYSL
向企业提供查询可用税率信息的功能,企业可将查询的基本信息保存在本地。在开票时选择保存在本地的可用税率。
请求参数(body):无
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| count | 总数量 | number(10) | 是 | |
| csxz | 参数性质 | varchar(2) | 是 | 1:税率,2:征收率 |
| slzsl | 税率征收率 | number(16,6) | 是 | |
| yslbz | 原税率标志 | varchar(1) | 是 | Y:是原税率,N:非原税率 |
| dyysl | 对应原税率 | varchar(150) | 否 | 百分比形式、逗号间隔 |
| cszt | 参数状态 | varchar(1) | 是 | 0:启用,1:停用 |
| yxqq | 有效期起 | date | 是 | 时间格式:yyyy-MM-dd |
| yxqz | 有效期止 | date | 否 | 时间格式:yyyy-MM-dd |
| tyrq | 停用日期 | date | 否 | 时间格式:yyyy-MM-dd |
8. 查询税收分类编码信息 POST /api/v1/invoice/reverse/lq/CXSSFLBM
向企业提供查询商品税收分类编码信息的功能,企业可将查询的编码信息保存在本地。在开票时选择保存在本地的税收分类编码。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号/统一社会信用代码 | varchar(20) | 是 | 开票纳税人识别号/统一社会信用代码 |
| sjc | 时间戳 | date | 否 | 格式:yyyyMMddHHmmss 首次下载时为空; 非首次下载时,传入上次下载返回的时间戳.格式:yyyyMMddHHmmss |
| sjswjgdm | 省级税务机关代码 | varchar(11) | 否 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| sjc | 时间戳 | date | 是 | 格式:yyyyMMddHHmmss 用于增量下载 |
| count | 总数量 | number(10) | 是 | |
| fjbm | 父级编码 | varchar(19) | 是 | |
| sphfwssflhbbm | 商品和服务税收分类合并编码 | varchar(19) | 是 | |
| tdyslxdm | 特定要素标签归类 | varchar(2) | 是 | 01:成品油 02:稀土 03:建筑服务 04:货物运输 05:不动产销售 06:不动产租赁 07:代收车船使用税 08:通行费 09:旅客运输 10:医疗服务 11:农产品 12:拖拉机和联合收割机 13:机动车 14:光伏收购 15:卷烟 17:报废产品 |
| cezs | 差额征税 | varchar(1) | 否 | Y:是,N:否 |
| bzs | 不征税 | varchar(1) | 否 | Y:是,N:否 |
| jzjtdm | 即征即退代码集合 | varchar(150) | 否 | 01:增值税即征即退-软件产品 02:增值税即征即退-资源综合利用产品 03:增值税即征即退-管道运输服务 04:增值税即征即退-有形动产融资租赁服务 05:增值税即征即退-有形动产融资性售后回租服务 06:增值税即征即退-新型墙体材料 07:增值税即征即退-风力发电产品 08:增值税即征即退-光伏发电产品 09:增值税即征即退-动漫软件产品 10:增值税即征即退-飞机维修劳务 11:增值税即征即退-黄金 12:增值税即征即退-铂金 |
| sphfwmc | 商品和服务名称 | varchar(150) | 是 | |
| sphfwfljc | 商品和服务分类简称 | varchar(120) | 是 | |
| sm | 说明 | varchar | 否 | |
| zzssl | 增值税税率 | varchar(50) | 否 | 取值返回是中文顿号连接的百分数。例如3%、5% |
| zsl | 征收率 | varchar(50) | 否 | 取值返回是中文顿号连接的百分数。例如3%、5% |
| zzstsgl | 增值税特殊管理 | varchar(150) | 否 | |
| zzszcyj | 增值税政策依据 | varchar(300) | 否 | |
| zzstsnrdm(zzsjmszcdmb) | 增值税特殊内容代码(增值税减免税政策代码表) | varchar(300) | 否 | |
| xfsgl | 消费税管理 | varchar(150) | 否 | |
| xfszcyj | 消费税政策依据 | varchar(300) | 否 | |
| xfstsnrdm | 消费税特殊内容代码 | varchar(300) | 否 | |
| gjz | 关键字 | mediumtext | 否 | |
| sfhzx | 是否汇总项 | varchar(1) | 是 | Y:是,N:否 |
| dytjjbm | 对应统计局编码(2011年版)或国民行业代码 | mediumtext | 否 | |
| hgjcksppm | 海关进出口商品品目 | mediumtext | 否 | |
| qyrq | 启用日期 | date | 是 | 格式:yyyy-MM-dd |
| tyrq | 停用日期 | date | 否 | 格式:yyyy-MM-dd |
| hydm | 行业代码 | varchar(4) | 否 | 主行业代码特定征收部门可空 |
| dydhy | 对应的行业 | varchar(68) | 否 | |
| hydydzspm1 | 行业对应的征收品目一 | varchar(9) | 否 | |
| hydydzsmc1 | 行业对应的征收名称一 | varchar(210) | 否 | |
| hydydzspm2 | 行业对应的征收品目二 | varchar(9) | 否 | |
| hydydzsmc2 | 行业对应的征收名称二 | varchar(210) | 否 |
9. 查询自然人开票信息 POST /api/v1/invoice/reverse/lq/CXZRRKPXX
提供查询自然人出售者开票信息,包括自然人月累计开票金额、是否阻断反向开票自然人,用于开票前的校验规则处理。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| zrrxm | 自然人姓名 | varchar(100) | 是 | |
| sfzjlx | 身份证件类型 | char(3) | 是 | 201:居民身份证 |
| sfzjhm | 身份证件号码 | varchar(20) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| zrrxm | 自然人姓名 | varchar(100) | 是 | |
| sfzjlx | 身份证件类型 | char(3) | 是 | 201-居民身份证 |
| sfzjhm | 身份证件号码 | varchar(20) | 是 | |
| zdfxkpzrrbz | 阻断反向开票自然人标志 | char(1) | 是 | Y:需要阻断 N:无需阻断 |
| kpyf | 开票月份 | varchar(10) | 是 | 格式:yyyyMM |
| yljkpzje | 月累计开票总金额 | number(18,2) | 是 | 当月累计开票总金额 |
| lqfxkpppje | 乐企反向开票普票金额 | number(18,2) | 是 | |
| lqfxkpzpje | 乐企反向开票专票金额 | number(18,2) | 是 | |
| lqfxkpppse | 乐企反向开票普票税额 | number(18,2) | 是 | |
| lqfxkpfs | 乐企反向开票份数 | int | 是 | |
| lqfxkpppmsje | 乐企反向开票普票免税金额 | number(18,2) | 是 | |
| dpfxkpppje | 电票反向开票普票金额 | number(18,2) | 是 | |
| dpfxkpzpje | 电票反向开票专票金额 | number(18,2) | 是 | |
| dpfxkpppse | 电票反向开票普票税额 | number(18,2) | 是 | |
| dpfxkpfs | 电票反向开票份数 | int | 是 | |
| skfxkpppje | 税控反向开票普票金额 | number(18,2) | 是 | |
| skfxkpzpje | 税控反向开票专票金额 | number(18,2) | 是 | |
| skfxkpppse | 税控反向开票普票税额 | number(18,2) | 是 | |
| skfxkpfs | 税控反向开票份数 | int | 是 | |
| lqgsljje | 乐企个税累计金额 | number(18,2) | 是 | |
| yjgsljse | 已缴个税累计税额 | number(18,2) | 是 |
10. 报废产品收购发票上传 POST /api/v1/invoice/reverse/lq/BFCPSGFPSC
给企业提供上传开具的报废产品收购预开发票功能,上传成功后给企业返回信息。
税务局端接收到企业上传的报废产品收购发票后,依次校验企业是具备开票条件、发票信息是否合规、是否超过赋额额度、报废产品收购发票号码是否合法等,当校验不通过时,不接收企业上传的报废产品收购发票,返回具体错误信息。每次上传最大票量为100张数字化电子发票。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| ptbh | 平台编号 | varchar(20) | 是 | 直连单位ID |
| fppz | 发票票种 | varchar(2) | 是 | 01:增值税专用发票 02:普通发票 |
| fphm | 发票号码 | varchar(20) | 是 | |
| lzfpbz | 蓝字发票标志 | varchar(1) | 是 | 0:蓝字发票 1:红字发票 |
| kprq | 开票日期 | datetime | 是 | 格式: yyyy-MM-dd HH:mm:ss |
| kpr | 开票人 | varchar(300) | 是 | |
| kprzjhm | 开票人证件号码 | varchar(30) | 是 | |
| kprzjlx | 开票人证件类型 | varchar(4) | 是 | |
| skrxm | 收款人姓名 | varchar(150) | 否 | |
| fhrxm | 复核人姓名 | varchar(75) | 否 | |
| tdys | 特定要素 | varchar(2) | 是 | 24:报废产品收购 |
| qyDm | 区域代码 | varchar(20) | 是 | |
| sfxszrrsygdbfcp | 是否销售自然人使用过的报废产品 | char(1) | 是 | Y:销售自己使用过的报废产品 N:销售收购的报废产品 红字发票填写时与蓝票一致 |
| grsdsxm | 个人所得税项目 | varchar(2) | 是 | 1:财产转让所得 2:经营所得,红字发票需与蓝字发票一致 |
| grsdssf | 个人所得税 | number(18.2) | 否 | 蓝字发票必填 免税发票传0 |
| zzsjfjsf | 增值税及附加税费 | number(18.2) | 否 | 蓝字发票必填 无需补缴税费的免税发票传0 |
| sgfplxDm | 收购发票类型代码 | varchar(2) | 是 | 04:报废产品收购发票 |
| xsfmc | 销售方姓名 | varchar(300) | 是 | |
| xsfnsrsbh | 销售方统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | 必须与自然人身份证件号码一致 |
| xsfzrrbz | 销售方自然人标志 | char(1) | 是 | Y:是 |
| xsfzrrzjlxDm | 销售方自然人证件类型 | varchar(3) | 是 | 201:居民身份证; |
| xsfzrrzjhm | 销售方自然人证件号码 | varchar(30) | 是 | |
| xsfzrrgjDm | 销售方自然人国籍代码 | varchar(3) | 是 | 156:中国 |
| xsfdz | 销售方地址 | varchar(300) | 否 | 蓝票必填,红票与蓝票一致 填写自然人销售方居住地信息 |
| xsfdh | 销售方电话 | varchar(60) | 否 | 蓝票必填,红票与蓝票一致 填写自然人销售方手机号码 |
| xsfkhh | 销售方开户行 | varchar(120) | 否 | |
| xsfzh | 销售方账号 | varchar(50) | 否 | |
| skyhmc | 收款银行名称 | varchar(120) | 否 | |
| skyhzh | 收款银行账号 | varchar(100) | 否 | |
| gmfnsrsbh | 购买方统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | |
| gmfmc | 购买方名称 | varchar(300) | 是 | |
| gmfdz | 购买方地址 | varchar(300) | 否 | |
| gmfdh | 购买方电话 | varchar(60) | 否 | |
| gmfkhh | 购买方开户行 | varchar(120) | 否 | |
| gmfzh | 购买方账号 | varchar(50) | 否 | |
| gmfjbr | 购买方经办人姓名 | varchar(150) | 否 | |
| jbrsfzjhm | 购买方经办人证件号码 | varchar(30) | 否 | |
| gmfjbrlxdh | 购买方经办人联系电话 | varchar(60) | 否 | |
| hjje | 合计金额 | number(18,2) | 是 | |
| hjse | 合计税额 | number(18,2) | 是 | |
| jshj | 价税合计 | number(18,2) | 是 | |
| jsfs | 结算方式 | varchar(2) | 是 | 01:现金 02:银行转账 03:票据 04:第三方支付 05:预付卡 99:其他 |
| ysxwfsd | 应税行为发生地 | varchar(11) | 否 | |
| dylzfphm | 对应蓝字发票号码 | varchar(20) | 否 | 是否蓝字发票标志为1时,必填。如果红冲的是税控发票,对应蓝字发票号码的填写规则为税控发票的发票代码+发票号码。 |
| hzqrxxdbh | 红字确认信息单编号 | varchar(20) | 否 | 是否蓝字发票标志为1时,此节点有内容 红票开具时必传 |
| hzqrduuid | 红字确认单uuid | varchar(32) | 否 | 是否蓝字发票标志为1时,此节点有内容红票开具时必传 |
| bz | 备注 | varchar(450) | 否 | 蓝票最长450位,红票最长382位。 |
| ip | 服务器地址 | varchar(20) | 是 | 需自行采集开票申请设备 |
| macdz | mac地址 | char(20) | 是 | 需自行采集开票申请设备 |
| cpuid | CPU序列号 | char(20) | 否 | |
| zbxlh | 主板序列号 | varchar(20) | 否 | |
| sfzsxsfyhzhbq | 是否展示销售方银行账号标签 | varchar(1) | 否 | Y:展示 N:不展示 |
| sfzsgmfyhzhbq | 是否展示购买方银行账号标签 | varchar(1) | 否 | Y:展示 N:不展示 |
| sfzsxsfdzdh | 是否展示销售方地址电话 | varchar(1) | 否 | Y:展示 N:不展示 |
| sfzsgmfdzdh | 是否展示购买方地址电话 | varchar(1) | 否 | Y:展示 N:不展示 |
| jazslxDm | 减按征税类型代码 | varchar(2) | 否 | 放弃免税、3%减按1%开票优惠政策原因代码,可选54、55、空。 空:使用1%或免税开票 54:前期已开具3%征收率的发票,发生销售折让、中止或者退回等情形需要开具3%征收率的红字发票,或者开票有误需要重新开具3%征收率的发票; 55:因为实际经营业务需要,放弃享受减按1%征收率征收增值税政策; |
| fpkjfsDm | 发票开具方式代码 | varchar(1) | 是 | 4:第三方平台开票(乐企联用、他用开票) 5:自建平台开票(乐企自用开票) |
| lqkpmsDm | 乐企开票模式代码 | varchar(2) | 否 | 01:乐企自用支付即开票; 02:乐企联用支付即开票; 03:乐企他用支付即开票; 04:乐企自用交易即开票; 05:乐企联用交易即开票; 06:乐企他用交易即开票; 07:乐企自用自主开票; 08:乐企联用自主开票; 09:乐企他用自主开票 |
| jyxxlyqdDm | 交易信息来源渠道 | varchar(2) | 否 | 01:线上交易平台; 02:企业自有业务系统; 03:线上支付平台; |
| jylsh | 交易流水号 | varchar(50) | 否 | 缓冲期结束后联用模式蓝票必须传入交易流水号。 交易流水号指的是订单号。 |
| zfqdDm | 支付渠道 | varchar(3) | 否 | 001:现金; 002:银行转账; 003:票据; 004:借记卡; 005:信用卡; 006:购物卡/券; 007:优惠券; 008:商场积分; 009:支付宝; 010:微信支付; 011:云闪付; 012:Apple Pay; 013:Samsung Pay ; 014:赊销; 099:其他 |
| jydh | 交易单号 | varchar(40) | 否 | 传入支付单号,当没有支付单号时该字段也传值订单号。 |
| mxxh | 明细序号 | Number(8) | 是 | |
| dylzfpmxxh | 对应蓝字发票明细序号 | Number(8) | 否 | 红票必传 |
| hwhyslwfwmc | 货物或应税劳务、服务名称 | varchar(300) | 是 | 拼装规则:“*商品服务简称(spfwjc)*”+“项目名称(xmmc)” |
| spfwjc | 商品服务简称 | varchar(120) | 是 | |
| xmmc | 项目名称 | varchar(600) | 是 | |
| ggxh | 规格型号 | varchar(150) | 否 | |
| dw | 单位 | varchar(300) | 否 | 蓝票必填,折扣行除外 |
| sl | 数量 | varchar(25) | 否 | 蓝票必填,折扣行除外 |
| dj | 单价 | varchar(25) | 否 | 蓝票必填,折扣行除外 |
| je | 金额 | number(18,2) | 是 | |
| slv | 增值税税率/征收率 | number(16,6) | 是 | |
| se | 税额 | number(18,2) | 是 | |
| hsje | 含税金额 | number(18,2) | 是 | |
| sphfwssflhbbm | 商品和服务税收分类合并编码 | varchar(19) | 是 | |
| fphxz | 发票行性质 | varchar(2) | 是 | 00:正常行 01:折扣行 02:被折扣行 |
| yhzcbs | 优惠政策标识 | varchar(2) | 否 | 03:免税 08:按3%简易征收 |
| fjysmc | 附加要素名称 | String(200) | 否 | |
| fjyslx | 附加要素类型 | String(200) | 否 | |
| fjysz | 附加要素值 | String(200) | 否 | |
| dzsphmList | 电子税票号码 | List(20) | 否 | 蓝票只有无需补缴税费的免税发票可以传空,其他情况必填; 红票传空。 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| sllsh | 受理流水号 | String(40) | 是 |
11. 查询发票上传结果 POST /api/v1/invoice/reverse/lq/CXQDFPSCJG
给企业提供查询发票上传结果的功能,预发票上传后由税务局端对发票再次进行校验,如果校验通过则表明发票开具成功。此时企业根据上传返回的信息查询发票开具的状态。
发票上传结果只能在发票上传后12小时内查询,如果超过12小时只能重新上传发票再获取上传结果。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| sllsh | 受理流水号 | String(40) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| fphm | 发票号码 | varchar(20) | 是 | |
| status | 上传状态 | varchar(2) | 是 | 00:上传成功 01:发票上传处理中 02:上传失败 03:发票号码在数据库已存在 |
| message | 详细信息 | varchar(30) | 否 | |
| Code | 错误码 | varchar(20) | 否 | 未查询到上传结果会返回固定的Code值 |
12. 数字化电子发票红字确认单申请 POST /api/v1/invoice/reverse/lq/QDHZQRDSQ
提供红字确认单申请功能。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| lrfsf | 录入方身份 | varchar(2) | 是 | 1:购方 |
| xsfnsrsbh | 销售方纳税人识别号 | varchar(20) | 否 | |
| xsfmc | 销售方名称 | varchar(300) | 是 | |
| gmfnsrsbh | 购买方纳税人识别号 | varchar(20) | 是 | |
| gmfmc | 购买方名称 | varchar(300) | 是 | |
| lzfpdm | 蓝字发票代码 | varchar(12) | 否 | |
| lzfphm | 蓝字发票号码 | varchar(20) | 是 | |
| sfzzfpbz | 是否纸质发票标志 | varchar(1) | 是 | Y:纸质发票,N:电子发票 |
| lzkprq | 蓝字发票开票日期 | datetime | 是 | yyyy-MM-dd HH:mm:ss |
| lzhjje | 蓝字发票合计金额 | number(18,2) | 是 | |
| lzhjse | 蓝字发票合计税额 | number(18,2) | 是 | |
| lzfppzDm | 蓝字发票票种代码 | varchar(2) | 是 | 01: 增值税专用发票 02: 普通发票 |
| lzfpTdyslxDm | 蓝字发票特定要素类型代码 | varchar(2) | 是 | 24:报废产品收购 |
| hzcxje | 红字冲销金额 | number(18,2) | 是 | |
| hzcxse | 红字冲销税额 | number(18,2) | 是 | |
| chyyDm | 红字发票冲红原因代码 | varchar(2) | 是 | 01:开票有误 02:销货退回 04:销售折让 |
| lzmxxh | 蓝字发票明细序号 | number(8) | 是 | |
| xh | 序号 | number(8) | 是 | |
| sphfwssflhbbm | 商品和服务税收分类合并编码 | String(19) | 是 | |
| hwhyslwfwmc | 货物或应税劳务、服务名称 | varchar(300) | 是 | |
| spfwjc | 商品服务简称 | String(120) | 是 | |
| xmmc | 项目名称 | varchar(600) | 是 | |
| ggxh | 规格型号 | varchar(150) | 否 | |
| dw | 单位 | varchar(300) | 否 | 必须与蓝票“单位”保持一致。 |
| fpspdj | 单价 | varchar(25) | 否 | 如“数量”栏次非空,则本栏次必须非空 |
| fpspsl | 数量 | varchar(25) | 否 | 如“单价”栏次非空,则本栏次必须非空 |
| je | 金额 | number(18,2) | 是 | |
| sl1 | 税率 | number(16,6) | 是 | |
| se | 税额 | number(18,2) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| hzfpxxqrdbh | 红字确认单编号 | varchar(20) | 否 | |
| uuid | 红字确认单UUID | varchar(32) | 否 | |
| hzqrxxztDm | 红字确认单状态 | varchar(2) | 否 | 01:无需确认 02:销方录入待购方确认 03:购方录入待销方确认 04:购销双方已确认 05:作废(销方录入购方否认) 06:作废(购方录入销方否认) 07:作废(超72小时未确认) 08:作废(发起方撤销) 09:作废(确认后撤销) 10:作废(异常凭证) 11:作废(纳税人状态异常阻断) 12:作废(自然人拒收) 13:作废(已开具退税申请单) |
13. 数字化电子发票确认单确认 POST /api/v1/invoice/reverse/lq/QDHZQRDQR
提供红字确认单确认接口,进行红字确认单撤销操作。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| xsfnsrsbh | 统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | |
| uuid | 红字确认单UUID | varchar(32) | 是 | |
| hzqrdbh | 红字确认单编号 | varchar(20) | 是 | |
| qrlx | 确认类型 | varchar(1) | 是 | C:撤销 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| qrrq | 确认日期 | datetime | 否 | 格式: yyyy-MM-dd HH:mm:ss |
14. 查询数字化电子发票红字确认单列表 POST /api/v1/invoice/reverse/lq/CXQDHZQRDLB
向企业提供查询报废产品收购红字确认单列表信息的功能,企业可通过购买方纳税人识别号、销售方纳税人识别号、蓝字发票号码、录入日期起、录入日期止等条件查询报废产品收购红字确认单列表信息,并将查询的结果保存在本地。使用此信息可以在申请报废产品收购红字确认单时校验报废产品收购蓝字发票是否可以红冲;在开具报废产品收购红字发票时校验是否有报废产品收购红字确认单。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| yhjslx | 用户角色类型 | varchar(2) | 是 | 0:销方 1:购方 |
| xsfnsrsbh | (销售方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 否 | 条件必录,作为销方,必录 |
| xsfmc | (销售方)名称 | varchar(300) | 否 | 条件必录,作为销方,必录 |
| gmfnsrsbh | (购买方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 否 | 条件必录,作为购方,必录 |
| gmfmc | (购买方)名称 | varchar(300) | 否 | 条件必录,作为购方,必录 |
| lrfsf | 录入方身份 | varchar(2) | 否 | 0:销方 1:购方 |
| lrrqq | 录入日期起 | date(20) | 否 | yyyy-MM-dd |
| lrrqz | 录入日期止 | date(20) | 否 | yyyy-MM-dd |
| lzfpdm | 蓝字发票代码 | varchar(12) | 否 | |
| lzfphm | 蓝字发票号码 | varchar(20) | 否 | |
| hzfpxxqrdbh | 红字确认单编号 | varchar(20) | 否 | |
| hzqrxxztDm | 红字确认信息状态代码 | varchar(2) | 否 | 01:无需确认 02:销方录入待购方确认 03:购方录入待销方确认 04:购销双方已确认 05:作废(销方录入购方否认) 06:作废(购方录入销方否认) 07:作废(超72小时未确认) 08:(发起方撤销) 09:作废(确认后撤销) 10:作废(异常凭证) |
| fppzDm | 发票票种代码 | varchar(2) | 否 | 01: 增值税专用发票 02: 普通发票 03: 机动车统一销售发票 04: 二手车统一销售发票 05:铁路客票电子发票 06:航空运输电子客票行程单 |
| pageNumber | 页码 | number(10) | 否 | |
| pageSize | 每页数量 | number(10) | 否 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| total | 总数量 | varchar(10) | 是 | |
| uuid | 红字确认单UUID | varchar(32) | 是 | |
| hzfpxxqrdbh | 红字发票信息确认单编号 | varchar(20) | 是 | |
| lrfsf | 录入方身份 | varchar(2) | 是 | 0:销方 1:购方 |
| xsfnsrsbh | (销售方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 否 | |
| xsfmc | (销售方)名称 | varchar(300) | 是 | |
| gmfnsrsbh | (购买方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | |
| gmfmc | (购买方)名称 | varchar(300) | 是 | |
| lzfpdm | 蓝字发票代码 | varchar(12) | 否 | |
| lzfphm | 蓝字发票号码 | varchar(20) | 否 | |
| sfzzfpbz | 是否纸质发票标志 | varchar(1) | 是 | Y:纸质发票,N:电子发票 |
| lzkprq | 蓝字发票开票日期 | datetime | 否 | yyyy-MM-dd HH:mm:ss |
| lzhjje | 蓝字发票合计金额 | number(18,2) | 否 | |
| lzhjse | 蓝字发票合计税额 | number(18,2) | 否 | |
| lzfppzDm | 蓝字发票票种代码 | varchar(2) | 否 | 01: 增值税专用发票 02: 普通发票 03: 机动车统一销售发票 04: 二手车统一销售发票 05:铁路客票电子发票 06:航空运输电子客票行程单 |
| lzfpTdyslxDm | 蓝字发票特定要素类型代码 | varchar(2) | 是 | 01:成品油发票 02:稀土发票 03:建筑服务发票 04:货物运输服务发票 05:不动产销售服务发票 06:不动产租赁服务发票 07:代收车船税 08:通行费 09:旅客运输服务发票 10:医疗服务(住院)发票 11:医疗服务(门诊)发票 12:自产农产品销售发票 13 拖拉机和联合收割机发票 14:机动车 15:二手车 16:农产品收购发票 17:光伏收购发票 18:卷烟发票 20:农产品发票 21:铁路客票电子发票 22:航空运输电子客票行程单 23:白酒 24:报废产品收购 25:反向开票(通用) 26:金银首饰批发 27:金银首饰零售 28:金融商品转让 29:客运场站服务 31:二手车* 32:电子烟 33:黄金交易结算(交易所购入) 34:黄金交易结算(交易所销售) 35:会员单位投资性黄金 36:会员单位非投资性黄金 37:客户标准黄金 51:正常开具(针对二手车销售统一发票) 52:反向开具(针对二手车销售统一发票) |
| hzcxje | 红字冲销金额 | number(18,2) | 是 | |
| hzcxse | 红字冲销税额 | number(18,2) | 是 | |
| hzqrdmxsl | 红字确认单明细数量 | number(10) | 是 | |
| chyyDm | 红字发票冲红原因代码 | varchar(2) | 是 | 01:开票有误 02:销货退回 03:服务中止 04:销售折让 |
| hzqrxxztDm | 红字确认信息状态代码 | varchar(2) | 是 | |
| qrrq | 确认日期 | datetime | 否 | yyyy-MM-dd HH:mm:ss |
| ykjhzfpbz | 已开具红字发票标志 | varchar(1) | 否 | Y:已开具 N:未开具 |
| hzfphm | 红字发票号码 | varchar(20) | 否 | |
| hzkprq | 红字开票日期 | datetime | 是 | yyyy-MM-dd HH:mm:ss |
| yxbz | 有效标志 | varchar(1) | 是 | Y:有效 N:无效 |
| lrrq | 录入日期 | datetime | 是 | yyyy-MM-dd HH:mm:ss |
15. 查询数字化电子发票红字确认单明细 POST /api/v1/invoice/reverse/lq/CXQDHZQRDMX
向企业提供报废产品收购红字确认单明细查询的功能,企业可通过红字确认单UUID、销售方纳税人识别号查询报废产品收购红字确认单明细信息,并将查询的结果保存在本地。使用此信息可以在申请报废产品收购红字确认单时校验蓝票是否可以红冲;在开具报废产品收购红字发票时校验是否有报废产品收购红字确认单明细。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| uuid | 红字确认单UUID | varchar(32) | 是 | |
| xsfnsrsbh | 销售方统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 否 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| uuid | 红字确认单UUID | varchar(32) | 是 | |
| hzfpxxqrdbh | 红字发票信息确认单编号 | varchar(20) | 是 | |
| lrfsf | 录入方身份 | varchar(1) | 是 | 0:销方,1:购方 |
| xsfnsrsbh | (销售方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 是 | |
| xsfmc | (销售方)名称 | varchar(300) | 是 | |
| gmfnsrsbh | (购买方)统一社会信用代码/纳税人识别号/身份证件号码 | varchar(20) | 否 | |
| gmfmc | (购买方)名称 | varchar(300) | 是 | |
| lzfpdm | 蓝字发票代码 | number(12) | 否 | |
| lzfphm | 蓝字发票号码 | number(20) | 否 | |
| sfzzfpbz | 是否纸质发票标志 | varchar(1) | 是 | Y:纸质发票,N:电子发票 |
| lzkprq | 蓝字发票开票日期 | datetime | 否 | yyyy-MM-dd HH:mm:ss |
| lzhjje | 蓝字发票合计金额 | number(18,2) | 否 | |
| lzhjse | 蓝字发票合计税额 | number(18,2) | 否 | |
| lzfppzDm | 蓝字发票票种代码 | varchar(2) | 否 | 01: 增值税专用发票 02: 普通发票 03: 机动车统一销售发票 04: 二手车统一销售发票 |
| lzfpTdyslxDm | 蓝字发票特定要素类型代码 | varchar(2) | 是 | 01:成品油发票 02:稀土发票 03:建筑服务发票 04:货物运输服务发票 05:不动产销售服务发票 06:不动产租赁服务发票 07:代收车船税 08:通行费 09:旅客运输服务发票 10:医疗服务(住院)发票 11:医疗服务(门诊)发票 12:自产农产品销售发票 13 拖拉机和联合收割机发票 14:机动车 15:二手车 16:农产品收购发票 17:光伏收购发票 18:卷烟发票 20:农产品 24:报废产品收购 |
| hzcxje | 红字冲销金额 | number(18,2) | 是 | |
| hzcxse | 红字冲销税额 | number(18,2) | 是 | |
| chyyDm | 红字发票冲红原因代码 | varchar(2) | 是 | 01:开票有误 02:销货退回 03:服务中止 04:销售折让 |
| hzqrxxztDm | 红字确认单状态 | varchar(2) | 是 | 01:无需确认 02:销方录入待购方确认 03:购方录入待销方确认 04:购销双方已确认 05:作废(销方录入购方否认) 06:作废(购方录入销方否认) 07:作废(超72小时未确认) 08:(发起方撤销) 09:作废(确认后撤销) 10:作废(异常凭证) 11:作废(纳税人状态异常阻断) 12:作废(自然人拒收) 13:作废(已开具退税申请单) |
| qrrq | 确认日期 | datetime | 否 | yyyy-MM-dd HH:mm:ss |
| ykjhzfpbz | 已开具红字发票标志 | varchar(1) | 否 | Y:已开具 N:未开具 |
| hzfphm | 红字发票号码 | String(20) | 否 | |
| hzkprq | 红字开票日期 | datetime | 是 | yyyy-MM-dd HH:mm:ss |
| yxbz | 有效标志 | varchar(1) | 是 | Y:有效 N:无效 |
| cezslxDm | 差额征税类型代码 | varchar(2) | 否 | 空:非差额发票 01:全额开票 02:差额开票 |
| lrrq | 录入日期 | datetime | 是 | yyyy-MM-dd HH:mm:ss |
| lzmxxh | 蓝字发票明细序号 | number(8) | 是 | |
| xh | 序号 | number(8) | 是 | |
| sphfwssflhbbm | 商品和服务税收分类合并编码 | varchar(19) | 是 | |
| hwhyslwfwmc | 货物或应税劳务、服务名称 | varchar(300) | 是 | |
| spfwjc | 商品服务简称 | varchar(120) | 是 | |
| xmmc | 项目名称 | varchar(600) | 是 | |
| ggxh | 规格型号 | varchar(150) | 否 | |
| dw | 单位 | varchar(300) | 否 | 空 |
| fpspdj | 单价 | varchar(25) | 否 | 如“数量”栏次非空,则本栏次必须非空 |
| fpspsl | 数量 | varchar(25) | 否 | 如“单价”栏次非空,则本栏次必须非空 |
| je | 金额 | number(18,2) | 是 | |
| sl1 | 税率 | number(16,6) | 是 | |
| se | 税额 | number(18,2) | 是 |
16. 上传发票汇总确认信息 POST /api/v1/invoice/reverse/lq/SCFPHZQRXX
给企业提供按月上传发票汇总信息接口,以避免由于企业未及时上传发票而带来的问题。企业在每月13日零点前需按自然月汇总上月在本平台开具的数字化电子发票的数量、金额和已缴税额上传至乐企服务端,与乐企服务端汇总接收到的数字化电子发票信息进行比对,若比对一致,返回比对成功;若比对不一致,返回具体失败信息,由企业核实后,再次上传。
若企业在每月13日零点前未上传上个月的发票汇总确认信息,乐企服务端将在13日零点汇总乐企服务端接收到的上个月的数字化电子发票、税款缴纳数据,若自动汇总确认的发票应缴税费与已缴税费记录不一致,将阻断自动汇总确认。
当企业上传发票汇总确认信息后,发现已确认的月份还有数字化电子发票未上传,可以取消发票汇总确认,把未上传的数字化电子发票上传至乐企服务端后再次上传发票汇总确认信息。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| xsfnsrsbh | 销售方纳税人识别号 | varchar(20) | 是 | 报废产品收购企业税号 |
| xsfsjswjgdm | 销售方省级税务机关代码 | varchar(11) | 是 | 报废产品收购企业省级税务机关代码 |
| ywlx | 业务类型 | varchar(1) | 是 | 0:确认 1:取消 |
| ptbh | 平台编号 | varchar(20) | 是 | |
| yf | 月份 | varchar(7) | 是 | 格式:yyyy-MM |
| lzfpsl | 蓝字发票数量 | number(10) | 否 | 业务类型为“0”时必填 |
| lzfpje | 蓝字发票金额 | number(18,2) | 否 | 业务类型为“0”时必填 |
| lzfpse | 蓝字发票税额 | number(18,2) | 否 | 业务类型为“0”时必填 |
| hzfpsl | 红字发票数量 | number(10) | 否 | 业务类型为“0”时必填 |
| hzfpje | 红字发票金额 | number(18,2) | 否 | 业务类型为“0”时必填 |
| hzfpse | 红字发票税额 | number(18,2) | 否 | 业务类型为“0”时必填 |
| yjsfhj | 已缴税费合计 | number(18,2) | 否 | 业务类型为“0”且包含报废产品发票时必填 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
17. 查询发票汇总确认信息 POST /api/v1/invoice/reverse/lq/CXFPHZQRXX
给企业提供发票汇总确认信息查询功能,企业可以通过此接口查询历史发票汇总确认信息。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| xsfnsrsbh | 销售方纳税人识别号 | varchar(20) | 是 | 报废产品收购企业纳税人识别号 |
| xsfsjswjgdm | 销售方省级税务机关代码 | varchar(11) | 是 | 报废产品收购企业的省级税务机关代码 |
| ptbh | 平台编号 | varchar(20) | 否 | 若为空,则查询纳税人在所有平台的开票汇总信息 |
| yf | 月份 | varchar(7) | 否 | 格式:yyyy-MM若为空,则查询所有历史月份数据 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功,其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| xsfnsrsbh | 销售方纳税人识别号 | varchar(20) | 是 | |
| 发票汇总确认信息(多条记录时,循环以下节点) | 发票汇总确认信息(多条记录时,循环以下节点) | 发票汇总确认信息(多条记录时,循环以下节点)(发票汇总确认信息(多条记录时,循环以下节点)) | 发票汇总确认信息(多条记录时,循环以下节点) | 发票汇总确认信息(多条记录时,循环以下节点) |
| ptbh | 平台编号 | varchar(20) | 否 | |
| yf | 月份 | varchar(7) | 否 | 格式:yyyy-MM |
| lzfpsl | 蓝字发票数量 | number(10) | 否 | |
| lzfpje | 蓝字发票金额 | number(18,2) | 否 | |
| lzfpse | 蓝字发票税额 | number(18,2) | 否 | |
| hzfpsl | 红字发票数量 | number(10) | 否 | |
| hzfpje | 红字发票金额 | number(18,2) | 否 | |
| hzfpse | 红字发票税额 | number(18,2) | 否 | |
| yjsfhj | 已缴税费合计 | number(18,2) | 否 |
18. 查询企业未缴税记录 POST /api/v1/invoice/reverse/lq/CXQYWJSJL
提供直连平台查询收购企业、自然人在乐企全部平台已预开验证税款但未缴税的数据记录(包含缴税状态为未缴税、扣款失败税费已作废),纳税人识别号和自然人姓名+身份证件号码能且只能传入一组数据,传入纳税人识别号时按照企业返回未缴税发票交易数据,传入自然人姓名+身份证号码时按照自然人返回未缴税发票交易数据。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号 | varchar2(20) | 否 | 回收企业的纳税人识别号 |
| zrrxm | 自然人姓名 | varchar2(300) | 否 | 自然人姓名 |
| sfzjhm | 身份证件号码 | varchar2(20) | 否 | 自然人身份证件号码 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| nsrsbh | 纳税人识别号 | varchar(20) | 是 | 收购企业纳税人识别号 |
| wjskjlsl | 未缴税款记录数量 | varchar(10) | 是 | 大于等于0的整数 |
| ykfphm | 预开发票号码 | varchar(20) | 否 | wjskjlsll=0时无数据 |
| ykfprq | 预开发票日期 | date(-) | 否 | wjskjlsl=0时无数据 |
| zrrxm | 自然人姓名 | varchar(300) | 否 | wjskjlsl=0时无数据 |
| ykfpje | 预开发票金额 | number(18,2) | 否 | wjskjlsl=0时无数据 |
| ykfpse | 预开发票税额 | number(18,2) | 否 | wjskjlsl=0时无数据 |
| sfjnfs | 税费缴纳方式 | char(1) | 是 | 0:自然人自行办理 1:企业委托扣缴 |
| lrrq | 录入日期 | datetime(-) | 是 | yyyy-MM-dd HH:mm:ss |
| jfzt | 缴税状态 | char(1) | 是 | 0:未缴纳 5:税费扣款失败,税费信息已被作废 |
19. 报废产品收购待缴税费校验 POST /api/v1/invoice/reverse/lq/BFCPSGDJSFJY
提供给企业在完成算税数据后,进行算税结果校验的接口。每次开票算税前,都需要调用“查询反向开票算税参数”接口查询最新的开票数据,根据返回的开票数据进行算税,并传入算税相关数据。
当出现乐企平台当次交易额不足以补缴前期税费的特殊情况时,需要补缴的发票税费由自然人扫码缴税或回收企业委托代办,此情形下,需经自然人确认是否由自然人扫码补缴前期税费,如是,则计算补缴税费+单笔税费,补缴税费标志传Y。如否,仅计算当次交易税费且当次交易税费从交易款中扣缴并反向开票,前期应补缴的税费部分由回收企业次月委托代办,补缴税费标志传N。其他场景补缴税费标志必须传Y。
当涉及补缴历史发票税费的场景,补缴发票号码列表需要传入本次补缴的历史发票号码,补缴发票号码按照算税前查询“反向算税参数查询”获取到的发票号码返回。
增值税税额列表,当不涉及历史发票税费补缴时,传入当前发票的类型及增值税税额;涉及历史发票税费补缴时,按照历史发票+本次交易的增值税税额分专票、普票两组数据返回,该增值税税额为本次应缴纳增值税税额,非票面增值税税额。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| djxh | 登记序号 | number(20) | 是 | 回收企业登记序号 |
| nsrsbh | 纳税人识别号 | varchar2(20) | 是 | 回收企业的纳税人识别号 |
| nsrmc | 纳税人名称 | varchar2(300) | 是 | 回收企业纳税人名称 |
| zrrxm | 自然人姓名 | varchar2(300) | 是 | 自然人姓名 |
| sfzjlx | 身份证件类型 | char(4) | 是 | 201-身份证; |
| sfzjhm | 身份证件号码 | varchar2(20) | 是 | |
| gjDm | 国籍代码 | char(3) | 是 | 156-中国 自然人国籍代码,目前仅支持中国 |
| ykfphm | 预开发票号码 | varchar2(20) | 是 | |
| ykfplx | 预开发票类型 | varchar(2) | 是 | 01:增值税专用发票 02:普通发票 |
| ykprq | 预开票日期 | datetime(-) | 是 | yyyy-MM-dd HH:mm:ss |
| hjje | 合计金额 | Number(18,2) | 是 | 不含税金额 |
| zzssl | 增值税税率 | Number(16,6) | 是 | 票面增值税税率 |
| hjse | 合计税额 | Number(18,2) | 是 | 必须大于等于0 |
| jshj | 价税合计 | Number(18,2) | 是 | |
| sfxsyhjm | 是否享受优惠减免 | char(1) | 否 | Y:是;N:否; 普票传空; 专票按实际税率1%为Y,其他为N。 |
| msbz | 免税标志 | char(1) | 是 | 预开发票类型为普票,且为免税发票时传Y,其他情形传N。 |
| bjsfbz | 补缴税费标志 | char(1) | 是 | Y:补缴 N:不补缴 |
| sfjnfs | 税费缴纳方式 | char(1) | 否 | 0:自然人自行办理 1:企业委托扣缴 |
| (增值税)补缴发票号码list | (增值税)补缴发票号码list | (增值税)补缴发票号码list((增值税)补缴发票号码list) | (增值税)补缴发票号码list | (增值税)补缴发票号码list |
| fpDm | 发票代码 | varchar2(12) | 否 | 当补缴发票类型为01、04、08、10时必填 |
| fphm | 发票号码 | varchar2(30) | 否 | 当补缴增值税时,返回开票前查询“反向开票算税参数查询”接口取得的待补缴增值税发票号码 |
| 本月乐企待补缴两教发票号码list | 本月乐企待补缴两教发票号码list | 本月乐企待补缴两教发票号码list(本月乐企待补缴两教发票号码list) | 本月乐企待补缴两教发票号码list | 本月乐企待补缴两教发票号码list |
| fpDm | 发票代码 | varchar2(12) | 否 | 当补缴发票类型为01、04、08、10时必填 |
| fphm | 发票号码 | varchar2(30) | 否 | 当补缴两教税费时,返回开票前查询“反向开票算税参数查询”接口取得的待补缴两教税费发票号码 |
| 增值税税额list | 增值税税额list | 增值税税额list(增值税税额list) | 增值税税额list | 增值税税额list |
| selx | 税额类型 | char(2) | 是 | 01:普票 02:专票 |
| zzsse | 增值税税额 | number(18,2) | 是 | 传入应缴增值税税额,而非票面税额 |
| 应缴税费list | 应缴税费list | 应缴税费list(应缴税费list) | 应缴税费list | 应缴税费list |
| zsxmDm | 征收项目代码 | varchar2(5) | 是 | |
| zsxmmc | 征收项目名称 | varchar2(100) | 是 | |
| zspmDm | 征收品目代码 | char(9) | 是 | |
| zspmmc | 征收品目名称 | varchar2(100) | 是 | |
| jsyj | 计税依据 | number(22,2) | 是 | 增值税、个人所得税为不含税金额 |
| slzsl | 税率征收率 | number(16,6) | 是 | |
| yjse | 应缴税额 | number(18,2) | 是 | 直连平台算税规则计算结果,必须大于0 |
| yjhkce | 已缴或扣除额 | number(18,2) | 是 | 1、当征收项目为个人所得税且年度内乐企非销售自用普票+专票金额(当前开具发票金额+本年度乐企个税累计金额)合计大于60万,为扣除数1500+年度内已缴个税累计税额; 2、当征收项目为个人所得税且年度内乐企非销售自用普票+专票金额(当前开具发票金额+本年度乐企个税累计金额)合计小于等于60万,为年度内已缴个税累计税额; 3、征收项目不为个人所得税时传0 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| ykfphm | 预开发票号码 | varchar(20) | 是 | 预开发票数电票号码 |
| ssjyjg | 算税校验结果 | char(1) | 是 | Y:校验通过; N:校验失败; |
| 自然人信息(算税通过时返回) | 自然人信息(算税通过时返回) | 自然人信息(算税通过时返回)(自然人信息(算税通过时返回)) | 自然人信息(算税通过时返回) | 自然人信息(算税通过时返回) |
| zrrdjxh | 自然人登记序号 | number(20) | 否 | 算税通过不可空 |
| zrrnsrsbh | 自然人纳税人识别号 | varchar2(20) | 否 | 算税通过不可空 |
| zrrdah | 自然人档案号 | number(20) | 否 | |
| 应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。) | 应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。) | 应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。)(应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。)) | 应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。) | 应缴税费信息 (生产环境算税失败时返回,返回的数据为企业算税错误的应缴税费信息,正确的不返回; 沙箱环境返回正确的算税数据,企业应当在沙箱环境完成正确算税规则调试。) |
| zsxmDm | 征收项目代码 | varchar2(5) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| zsxmmc | 征收项目名称 | varchar2(100) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| zspmDm | 征收品目代码 | char(9) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| zspmmc | 征收品目名称 | varchar2(100) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| yjse | 应缴税额 | number(18,2) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| sl | 税率 | number(16,6) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
| jsyj | 计税依据 | number(22,2) | 否 | 乐企平台算税规则计算结果,仅当校验失败时返回 |
20. 查询待缴税费缴款信息 POST /api/v1/invoice/reverse/lq/CXDJSFJKXX
提供企业查询缴款信息的接口。
部分报废产品收购企业所在地区由于税费缴纳入库的相关规则设置,单张发票会产生多张税票,该场景不支持在乐企开具报废产品收购发票,此时调用此接口查询缴款信息会报错,报错返回码为BF9031,需要企业调用“取消预开发票交易”接口取消该笔交易,触发该场景报错的企业可前往电票平台开具报废产品收购发票。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| djxh | 登记序号 | number(20) | 是 | 回收企业登记序号 |
| nsrsbh | 纳税人识别号 | varchar2(20) | 是 | 回收企业的纳税人识别号 |
| ykfphm | 预开发票号码 | varchar2(20) | 是 | |
| ykprq | 预开票日期 | datetime(-) | 是 | yyyy-MM-dd HH:mm:ss |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| dzsphm | 电子税票号码 | number(20) | 是 | |
| sjse | 实缴税额 | number(18,2) | 是 | |
| yzpzxh | 应征凭证序号 | number(20) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| yzpzmxxh | 应征凭证明细序号 | number(8) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| ybtse | 应补退税额 | number(18,6) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| zsswjgDm | 征收税务机关代码 | char(11) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细,此字段返回为缴款书的税款所属税务机关代码 |
| zsxmDm | 征收项目代码 | varcahr2(5) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| zspmDm | 征收品目代码 | char(9) | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| zszmDm | 征收子目代码 | char(16) | 否 | 多条(缴款书明细,一个dzsphm对应多条明细) |
| skssqq | 税款所属期起 | date | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) yyyy-MM-dd |
| skssqz | 税款所属期止 | date | 是 | 多条(缴款书明细,一个dzsphm对应多条明细) yyyy-MM-dd |
21. 查询税费缴纳结果 POST /api/v1/invoice/reverse/lq/CXSFJNJG
提供根据缴款信息查询税费缴款结果的接口。税款缴纳结果返回03状态不明时,需要调用“确认电子税票扣款状态”获取最新的状态;税款缴纳结果返回04税费已作废,需要调用“查询待缴税费缴款信息”获取新的税费完成缴款。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| dzsphmList | 电子税票号码列表 | List(-) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| dzsphm | 电子税票号码 | Varchar(20) | 是 | |
| skjnjg | 税款缴纳结果 | char(2) | 是 | 01:已缴纳 02:未缴纳 03:状态未明 04:税费已作废 |
22. 取消预开发票交易 POST /api/v1/invoice/reverse/lq/QXYKFPJY
已经完成报废产品收购待缴税费校验的预开具发票(未完成税费缴纳并上传乐企,已缴纳税款的只能上传发票再进行红冲处理),若收购方与自然人取消了交易并完成了退款,企业可通过此接口取消交易信息。只能当月取消当月的预开票交易,次月1日0:00起不能取消上月的预开发票交易。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| nsrsbh | 纳税人识别号 | varchar(20) | 是 | 回收企业税号 |
| zrrxm | 自然人姓名 | varchar(150) | 是 | |
| zrrzjhm | 自然人证件号码 | varchar(30) | 是 | |
| ykfphm | 预开发票号码 | varcahr(20) | 是 | |
| ykfprq | 预开发票日期 | datetime(-) | 是 | 格式:yyyy-MM-dd HH:mm:ss |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| cljg | 处理结果 | varchar(2) | 否 | 00:税费扣款状态不明,请稍后再尝试作废 01:取消交易成功 02:税款已缴纳,取消交易失败 |
| cljgxx | 处理结果信息 | varchar(75) | 否 | 当处理结果为00时返回具体信息 |
23. 查询反向开票算税参数 POST /api/v1/invoice/reverse/lq/CXFXKPSSCS
查询企业反向开票算税参数。每次开票前必须调用该接口根据自然人信息查询缴税相关数据,并且返回的数据完成算税校验。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| djxh | 登记序号 | varchar(20) | 是 | 回收企业登记序号 |
| nsrsbh | 纳税人识别号 | varchar(20) | 是 | 回收企业税号 |
| sjswjgdm | 省级税务机关代码 | varchar(11) | 是 | 回收企业省级税务机关代码 |
| sfzjlxDm | 身份证件类型代码 | varchar(3) | 是 | 限制身份证件类型只能为: 201:居民身份证 |
| sfzjhm | 身份证件号码 | varchar(20) | 是 | |
| xm | 姓名 | varchar(300) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| 算税参数list | 算税参数list | 算税参数list(算税参数list) | 算税参数list | 算税参数list |
| zsxmDm | 征收项目代码 | varchar2(5) | 是 | |
| zsxmmc | 征收项目名称 | varchar2(100) | 是 | |
| zspmDm | 征收品目代码 | char(9) | 是 | |
| zspmmc | 征收品目名称 | varchar2(100) | 是 | |
| zsl | 征收率 | varchar2(100) | 否 | 只有城建税返回 |
| jzbl | 减征比例 | varchar2(50) | 否 | |
| 待补缴税费金额汇总 | 待补缴税费金额汇总 | 待补缴税费金额汇总(待补缴税费金额汇总) | 待补缴税费金额汇总 | 待补缴税费金额汇总 |
| dbjzpljje1 | 待补缴专票累计金额1% | number(18,2) | 是 | 一人式金额小于等于10万时未缴纳教育费附加及地方教育费附加的专票1%税率的发票金额合计 |
| dbjzpljje2 | 待补缴专票累计金额3% | number(18,2) | 是 | 一人式金额小于等于10万时未缴纳教育费附加及地方教育费附加的专票3%税率的发票金额合计 |
| dbjppljje1 | 待补缴普票累计金额1% | number(18,2) | 是 | 一人式金额小于10万时未缴纳增值税的普票1%税率的发票金额合计 |
| bylqdbjppljljje | 本月乐企待补缴普票两教累计金额 | number(18,2) | 是 | 当月一人式金额小于等于10万时未缴纳教育费附加及地方教育费附加的普票的发票金额合计 |
| (增值税)应补缴发票明细list | (增值税)应补缴发票明细list | (增值税)应补缴发票明细list((增值税)应补缴发票明细list) | (增值税)应补缴发票明细list | (增值税)应补缴发票明细list |
| nsrsbh | 纳税人识别号 | varchar2(20) | 否 | 回收企业的纳税人识别号 |
| nsrmc | 纳税人名称 | varchar2(300) | 否 | 回收企业的纳税人名称 |
| fpDm | 发票代码 | varchar2(12) | 否 | 当发票类型为01、04、08、10时,不为空 |
| fphm | 发票号码 | varchar2(30) | 否 | |
| kprq | 开票日期 | date | 否 | yyyy-m-dd |
| fpje | 发票金额 | number(18,2) | 否 | 不含税金额,红字发票为负数金额 |
| fplxDm | 发票类型代码 | varchar2(2) | 否 | 81电子发票(增值税专用发票) 82电子发票(普通发票) 85:数电纸质发票(增值税专用发票) 86:数电纸质发票(普通发票) 01增值税专用发票 04增值税普通发票 08增值税电子专用发票 10增值税电子普通发票 |
| kpqd | 开票渠道 | varchar2(10) | 否 | 乐企平台:LQPT; 电子发票服务平台:DPPT; 税控系统:SKXT |
| 本月乐企待补缴两教发票明细list(bylqdbjljfpList) | 本月乐企待补缴两教发票明细list(bylqdbjljfpList) | 本月乐企待补缴两教发票明细list(bylqdbjljfpList)(本月乐企待补缴两教发票明细list(bylqdbjljfpList)) | 本月乐企待补缴两教发票明细list(bylqdbjljfpList) | 本月乐企待补缴两教发票明细list(bylqdbjljfpList) |
| nsrsbh | 纳税人识别号 | varchar2(20) | 否 | 回收企业的纳税人识别号 |
| nsrmc | 纳税人名称 | varchar2(300) | 否 | 回收企业的纳税人名称 |
| fpDm | 发票代码 | varchar2(12) | 否 | 当发票类型为01、04、08、10时,不为空 |
| fphm | 发票号码 | varchar2(30) | 否 | |
| kprq | 开票日期 | date | 否 | yyyy-m-dd |
| fpje | 发票金额 | number(18,2) | 否 | 不含税金额,红字发票为负数金额 |
| fplxDm | 发票类型代码 | varchar2(2) | 否 | 81电子发票(增值税专用发票) 82电子发票(普通发票) 85:数电纸质发票(增值税专用发票) 86:数电纸质发票(普通发票) 01增值税专用发票 04增值税普通发票 08增值税电子专用发票 10增值税电子普通发票 |
| kpqd | 开票渠道 | varchar2(10) | 否 | 乐企平台:LQPT; 电子发票服务平台:DPPT; 税控系统:SKXT |
24. 查询应代办未代办税费信息 POST /api/v1/invoice/reverse/lq/CXYDBWDBSFXX
平台侧企业可按属期查询在平台已开票的自然人是否存在需委托代办申报的税费信息,用于企业在申报期进行委托代办申报处理,委托代办由企业在电子税务局完成,本接口仅支持按属期(仅支持本月或上月)、企业维度查询企业应委托代办补缴税款的数据。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| dbnsrdjxh | 代办纳税人登记序号 | number(20) | 是 | 收购企业登记序号 |
| dbnsrsbh | 代办纳税人识别号 | varchar2(20) | 是 | 收购企业纳税人识别号 |
| sq | 属期 | varchar2(6) | 是 | 举例:yyyyMM 202402 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:存在应代办未代办申报的数据,并返回代办税费列表 01:存在已代办申报数据,不需要返回代办税费列表 02:无代办税费信息,不返回代办税费列表 |
| returnmsg | 返回信息 | varchar(2000) | 否 | |
| ydbsehj | 应代办税额合计 | number(18,6) | 是 | 代办税额合计 |
| skssqq | 税款所属期起 | date(-) | 是 | yyyy-MM-dd |
| skssqz | 税款所属期止 | date(-) | 是 | yyyy-MM-dd |
| sbqx | 申报期限 | Date | 是 | yyyy-MM-dd |
| dbhs | 代办户数 | int(-) | 是 | 按自然人身份证件号码和姓名统计应代办未代办自然人户数 |
| 代办税费明细list | 代办税费明细list | 代办税费明细list(代办税费明细list) | 代办税费明细list | 代办税费明细list |
| dbsfmxxh | 代办税费明细序号 | number(10) | 是 | |
| zrrsfzjlx | 自然人身份证件类型 | varchar2(4) | 是 | |
| zrrsfzjhm | 自然人身份证件号码 | varchar2(30) | 是 | |
| zrrxm | 自然人姓名 | varchar2(150) | 否 | |
| ydbse | 应代办税额 | number(18,6) | 是 |
25. 查询退税信息 POST /api/v1/invoice/reverse/lq/CXTSXX
当报废产品企业作废交易或者开具红字发票成功后,可以调用该接口查询产生的自然人应退税费信息。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| sfzjlxDm | 身份证件类型代码 | char(3) | 是 | 201:居民身份证 |
| sfzjhm | 身份证件号码 | varchar2(30) | 是 | 自然人身份证件号码 |
| zrrxm | 自然人姓名 | varchar2(150) | 是 | |
| gjDm | 国籍代码 | char(3) | 是 | 156-中国 |
| zrrdah | 自然人档案号 | number(20) | 否 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| ytssehj | 应退税税额合计 | number(18,2) | 是 | 未产生应退税税额返回0,为0时应退税款明细list为空 |
| 应退税款明细list | 应退税款明细list | 应退税款明细list(应退税款明细list) | 应退税款明细list | 应退税款明细list |
| zrrdah | 自然人档案号 | number(20) | 否 | |
| djxh | 登记序号 | number(20) | 是 | |
| zsxmDm | 征收项目代码 | varchar2(5) | 是 | |
| zspmDm | 征收品目代码 | char(9) | 是 | |
| zgswskfjDm | 主管税务所科分局代码 | char(11) | 是 | |
| zgswjgDm | 主管税务机关代码 | char(11) | 是 | 同税款所属机关 |
| skssswjgDm | 税款所属税务机关代码 | char(11) | 是 | |
| jdxzDm | 街道乡镇代码 | char(9) | 否 | |
| ytse | 应退税额 | number(18,6) | 是 | 返回两位小数 |
| sl | 税率 | number(16,6) | 是 | |
| spuuid | 税票UUID | varchar2(32) | 是 | |
| dzsphm | 电子税票号码 | number(20) | 是 | |
| skssqq | 税款所属期起 | date | 是 | yyyy-MM-dd |
| skssqz | 税款所属期止 | date | 是 | yyyy-MM-dd |
26. 申请反向开票退税 POST /api/v1/invoice/reverse/lq/SQFXKPTS
当纳税人作废交易或者开具红字发票成功查询到存在可退税税额后,可以调用该接口进行反向开票退税申请。若自然人当月一人式归集金额为负数则不允许发起退税申请。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| sfzjlxDm | 身份证件类型代码 | char(3) | 是 | 201:居民身份证 |
| sfzjhm | 身份证件号码 | varchar2(30) | 是 | 自然人身份证件号码 |
| zrrxm | 自然人姓名 | varchar2(150) | 是 | |
| zrrdah | 自然人档案号 | number(20) | 否 | |
| gjDm | 国籍代码 | char(3) | 是 | 156-中国 |
| khhszsf | 开户银行所在省份 | char(13) | 是 | 省级行政区划代码 110000:北京市 120000:天津市 130000:河北省 140000:山西省 150000:内蒙古自治区 210000:辽宁省 220000:吉林省 230000:黑龙江省 310000:上海市 320000:江苏省 330000:浙江省 340000:安徽省 350000:福建省 360000:江西省 370000:山东省 410000:河南省 420000:湖北省 430000:湖南省 440000:广东省 450000:广西壮族自治区 460000:海南省 500000:重庆市 510000:四川省 520000:贵州省 530000:云南省 540000:西藏自治区 610000:陕西省 620000:甘肃省 630000 青海省 640000:宁夏回族自治区 650000:新疆维吾尔自治区 |
| yhzh | 银行账号 | varchar2(50) | 是 | 自然人银行账号 |
| tdssqly | 退抵税申请理由 | varchar2(200) | 否 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| 申请结果明细list | 申请结果明细list | 申请结果明细list(申请结果明细list) | 申请结果明细list | 申请结果明细list |
| skssswjgDm | 税款所属税务机关代码 | char(11) | 是 | |
| skssswjgmc | 税款所属税务机关名称 | varchar(300) | 是 | |
| sqjg | 申请结果 | char(1) | 是 | 0:申请成功 1:申请失败 |
| sbyy | 失败原因 | varchar(200) | 否 | 失败时有值 |
| tdssqxh | 退抵税申请序号 | number(18) | 否 | 成功时有值 |
27. 查询报废产品退税结果 POST /api/v1/invoice/reverse/lq/CXBFCPTSJG
企业完成退税申请后,可调用此接口使用乐企退税申请接收成功后返回的业务流水号查询报废产品退税结果。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| sfzjlxDm | 身份证件类型代码 | char(3) | 是 | 201:居民身份证 |
| sfzjhm | 身份证件号码 | varchar2(30) | 是 | 自然人身份证件号码 |
| zrrxm | 自然人姓名 | varchar2(150) | 是 | |
| zrrdah | 自然人档案号 | number(20) | 否 | |
| gjDm | 国籍代码 | char(3) | 是 | 156-中国 |
| 退税序号列表 | 退税序号列表 | 退税序号列表(退税序号列表) | 退税序号列表 | 退税序号列表 |
| tdssqxhList | 退抵税申请序号列表 | number(18) | 否 | 传入对应申请序号则返回对应的退税结果,不传入申请序号返回最近两个月发起退税申请的全部退税结果。 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| 退税结果list | 退税结果list | 退税结果list(退税结果list) | 退税结果list | 退税结果list |
| skssswjgDm | 税款所属税务机关代码 | char(11) | 是 | 区县级税务机关 |
| skssswjgmc | 税务所属税务机关名称 | varchar(300) | 是 | |
| tdssqxh | 退抵税申请序号 | number(18) | 是 | |
| tssqzt | 退税申请状态 | char(2) | 是 | 01审批中; 02审核不同意; 03 审核同意; 04 申请表作废; 05 收入退还书全部开具未销号; 06 收入退还书部分开具未销号; 07 收入退还书全部销号; 08收入退还书部分销号 |
| spbtyyy | 审批不同意原因 | varchar(500) | 否 | 当退税申请状态为02时返回不同意原因 |
28. 第三方平台提交缴款请求 POST /api/v1/invoice/reverse/lq/DSFPTTJJKQQ
企业可调用此接口生成生成第三方平台(微信、支付宝、云闪付)缴款二维码,用于扫码缴纳税款,二维码有效期为30分钟,若未在30分钟内完成扫码缴款,可调用此接口重新生成二维码完成缴款。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| dzsphm | 电子税票号码 | number(20) | 是 | |
| nsrsbh | 纳税人识别号 | varchar2(20) | 是 | 自然人纳税人识别号 |
| skjnfsDm | 税款缴纳方式代码 | varchar2(2) | 是 | 云闪付:99 微信:A1 支付宝:A2 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| qrCodeText | 二维码字符串 | varchar(2000) | 是 |
29. 确认电子税票扣款状态 POST /api/v1/invoice/reverse/lq/QRDZSPKKZT
当查询缴纳结果、第三方支付扣款状态返回状态不明时,需要直连单位调用电子税票扣款状态接口确认扣款状态,处理结果返回01扣款成功可以上传发票,处理结果返回02不存在扣款信息即未缴款需要完成缴款,处理结果返回03状态不明需要重新确认状态,建议间隔5分钟以上;处理结果返回04需要重新查询待缴税费获取新的缴费信息完成缴税。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| dzsphm | 电子税票号码 | number(20) | 是 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| cljg | 处理结果 | varchar(2) | 否 | 01:税费扣款成功; 02:不存在扣款信息; 03:税费扣款状态不明; 04:税费扣款失败,税费信息已被作废 |
| cljgxx | 处理结果信息 | varchar(75) | 否 | 处理结果为03时返回 |
30. 验证银行卡号信息 POST /api/v1/invoice/reverse/lq/YZYHKHXX
反向开票退税申请确认时,可调用该接口验证将用于退税申请的银行卡是否可使用。若验证不通过,则不可用于退税。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| yhzh | 银行账号 | varchar(50) | 是 | |
| khyhszsf | 开户行所在省份 | char(6) | 是 | 省级行政区划代码 110000:北京市 120000:天津市 130000:河北省 140000:山西省 150000:内蒙古自治区 210000:辽宁省 220000:吉林省 230000:黑龙江省 310000:上海市 320000:江苏省 330000:浙江省 340000:安徽省 350000:福建省 360000:江西省 370000:山东省 410000:河南省 420000:湖北省 430000:湖南省 440000:广东省 450000:广西壮族自治区 460000:海南省 500000:重庆市 510000:四川省 520000:贵州省 530000:云南省 540000:西藏自治区 610000:陕西省 620000:甘肃省 630000 青海省 640000:宁夏回族自治区 650000:新疆维吾尔自治区 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| yztgbz | 验证通过标志 | char(1) | 是 | 0:不通过 1:通过 |
31. 自然人间接登记 POST /api/v1/invoice/reverse/lq/ZRRJJDJ
当直连单位第一次接收到某自然人的开票申请时,先调用自然人间接登记接口为自然人进行间接登记,减少算税校验接口处理时间。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| xm | 姓名 | varchar2(150) | 是 | 自然人姓名 |
| sfzjlxDm | 身份证件类型 | char(3) | 是 | 201-身份证; |
| sfzjhm | 身份证件号码 | varchar2(30) | 是 | |
| gjDm | 国籍代码 | char(3) | 是 | 156-中国 自然人国籍代码,目前仅支持中国 |
| csrq | 出生日期 | varchar2(10) | 否 | yyyy-MM-dd |
| xb | 性别 | char(1) | 否 | 1:男 2:女 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
32. 上传发票对账数据 POST /api/v1/invoice/reverse/lq/SCFPDZSJ
为保障资源回收企业的“三流合一反向开票”围绕发票数据的真实性和准确性,以资金收付、税费计算、税费入库为重点开展对账,确保支付即反向开票、开票即缴税、缴税即入库的执行。
直连单位可调用此接口上传前一日上传的报废产品收购发票各项数据,与税局端数据进行对账,确认局端数据与企业端数据一致性。
发票上传日期必须为当前系统时间的前一天,只允许对前一天上传的发票数据进行对账,单次最多可上传500条数据。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| uuid | uuid | CHAR(32) | 是 | 主键,各联用平台生成 |
| ptbm | 平台编码 | VARCHAR(20) | 是 | 直连单位ID |
| djxh | 登记序号 | NUMBER(20) | 是 | 回收企业登记序号 |
| nsrsbh | 纳税人识别号 | VARCHAR(20) | 是 | 回收企业的纳税人识别号 |
| nsrmc | 纳税人名称 | VARCHAR(300) | 是 | 回收企业纳税人名称 |
| sfzjlxDm | 身份证件类型代码 | CHAR(3) | 是 | 201-居民身份证 |
| sfzjhm | 身份证件号码 | VARCHAR(30) | 是 | 自然人的身份证件号码 |
| zrrxm | 自然人姓名 | VARCHAR(300) | 是 | 自然人姓名 |
| gjDm | 国籍代码 | CHAR(3) | 否 | 156-中国 |
| fphm | 发票号码 | VARCHAR(30) | 是 | |
| kprq | 开票日期 | DATE(-) | 是 | YYYY-MM-DD |
| hsqyzfjyje | 回收企业支付交易金额 | NUMBER(18,2) | 否 | 含税金额,红字发票默认为空 |
| zrrskje | 自然人收款金额 | NUMBER(18,2) | 否 | 红字发票默认为空 |
| zfskze | 支付税款总额 | NUMBER(18,2) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品,且不存在补税情况时可空,红字发票默认为空,未缴纳税款时默认为空,其他情形不可空; 自然人(或回收企业)支付税款的总额,含被补缴发票的税额,包括增值税及附征、个人所得税 |
| zfzzsse | 支付增值税税额 | NUMBER(18,2) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品时可空,红字发票默认为空,未缴纳增值税默认为空,其他情形不可空; 自然人(或回收企业)支付增值税税额,只是当前开具发票的增值税税额,且为实际缴纳的税款,非发票上的增值税税额 |
| je | 金额 | NUMBER(18,2) | 是 | 发票的不含税金额,红字发票传负数金额 |
| bfcpxslxbq | 报废产品销售类型标签 | CHAR(2) | 是 | 01销售自己使用过的报废产品; 02销售收购的报废产品 |
| sczt | 上传状态 | CHAR(1) | 是 | 1上传成功; 2上传失败 |
| sfjnfs | 税费缴纳方式 | CHAR(1) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品,且不存在补税情况时可空,红字发票默认为空,其他情形不可空; 0自然人自行缴纳; 1回收企业代缴 |
| fpscrq | 发票上传日期 | DATE(-) | 是 | YYYY-MM-DD 只能为当前系统时间前一天 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
33. 查询发票对账不符数据 POST /api/v1/invoice/reverse/lq/CXFPDZBFSJ
直连单位可调用此接口查询前一日上传的发票对账数据结果,该接口会返回对账不符的数据及原因,建议企业于上传对账数据后第二天下午进行查询,可获取到完整的对账不符数据结果。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| uuid | uuid | CHAR(32) | 否 | |
| ptbm | 平台编码 | VARCHAR(20) | 是 | 直连单位ID |
| nsrsbh | 纳税人识别号 | VARCHAR(20) | 是 | 回收企业的纳税人识别号 |
| fpscrq | 发票上传日期 | DATE(-) | 是 | YYYY-MM-DD 只能为当前系统时间两天前 如当前为1-3,可查询1-1上传发票的对账数据 |
| pageNumber | 页码 | number(10) | 否 | 批量查询时必填 |
| pageSize | 每页数量 | number(3) | 否 | 批量查询时必填 最多500条 |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | varchar(2) | 是 | 00:成功 其它:失败 |
| returnmsg | 返回信息 | varchar(2000) | 否 | 错误信息说明 |
| zsl | 总数量 | number(8) | 否 | 批量查询时返回 |
| pageNumber | 页码 | number(4) | 否 | 批量查询时返回 |
| uuid | uuid | CHAR(32) | 是 | 主键,各联用平台生成 |
| ptbm | 平台编码 | VARCHAR(20) | 是 | 直连单位ID |
| djxh | 登记序号 | NUMBER(20) | 是 | 回收企业登记序号 |
| nsrsbh | 纳税人识别号 | VARCHAR(20) | 是 | 回收企业的纳税人识别号 |
| nsrmc | 纳税人名称 | VARCHAR(300) | 是 | 回收企业纳税人名称 |
| sfzjlxDm | 身份证件类型代码 | CHAR(3) | 是 | |
| sfzjhm | 身份证件号码 | VARCHAR(30) | 是 | 自然人的身份证件号码 |
| zrrxm | 自然人姓名 | VARCHAR(300) | 是 | 自然人姓名 |
| gjDm | 国籍代码 | CHAR(3) | 否 | 参见dm_gy_gjhdq,如果办理业务时未选择国际,则默认为“156”(中国) |
| fphm | 发票号码 | VARCHAR(30) | 是 | |
| kprq | 开票日期 | DATE(-) | 是 | YYYY-MM-DD |
| hsqyzfjyje | 回收企业支付交易金额 | NUMBER(18,2) | 否 | 含税金额 红字发票默认为空; 其他情形不可空; |
| zrrskje | 自然人收款金额 | NUMBER(18,2) | 否 | 红字发票默认为空; 其他情形不可空; |
| zfskze | 支付税款总额 | NUMBER(18,2) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品,且不存在补税情况时可空;红字发票默认为空;未缴纳税款时默认为空;其他情形不可空; 自然人(或回收企业)支付税款的总额,含被补缴发票的税额,包括增值税及附征、个人所得税 |
| zfzzsse | 支付增值税税额 | NUMBER(18,2) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品时可空;当对账类型为04时可空;红字发票默认为空;未缴纳增值税默认为空;其他情形不可空; 自然人(或回收企业)支付增值税税额,只是当前开具发票的增值税税额,且为实际缴纳的税款,非发票上的增值税税额 |
| je | 金额 | NUMBER(18,2) | 是 | 发票的不含税金额,红字发票传负数金额 |
| bfcpxslxbq | 报废产品销售类型标签 | CHAR(2) | 是 | 01销售自己使用过的报废产品; 02销售收购的报废产品 |
| sczt | 上传状态 | CHAR(1) | 是 | 1上传成功; 2上传失败 |
| sfjnfs | 税费缴纳方式 | CHAR(1) | 否 | 当报废产品销售类型标签为01销售自己使用过的报废产品,且不存在补税情况时可空;其他情形不可空; 0自然人自行缴纳; 1回收企业代缴 |
| fpscrq | 发票上传日期 | DATE(-) | 是 | YYYY-MM-DD |
| dzbflx | 对账不符类型 | VACHAR(50) | 是 | 多个以英文逗号分隔 01:发票账户价税合计与回收企业(银行或平台账户)支付金额的对账; 0201:自然人支付账户收款金额与发票价税合计数的对账; 0202:自然人银行账户支付(缴税)金额与算税规则计算的应缴税费的对账; 0203:自然人银行账户收款金额与(发票价税合计数-算税规则计算的应缴税费)的对账; 03:自然人(或回收企业)支付增值税金额与发票上的税额对账; 05:发票上的交易金额与纳税账户算税结果对账; 06:发票账户上已生效发票与联用平台开具发票对账。 |
34. 发票用途状态信息查询 POST /api/v1/invoice/reverse/lq/FPZTXXCX
企业业务系统通过此接口查询单张发票状态、红字开具确认状态、发票用途等信息。此接口用途为辅助乐企开票企业发起红字确认单申请时的业务校验,实际以生成红字确认单时的业务校验结果为准。
发票用途状态信息查询结果仅供企业参考,在综服平台进行发票勾选的企业,其查询到的发票状态可能存在延时问题。
为保障乐企平稳运行,该接口对直连单位每秒调用接口次数进行限制,请直连单合理安排接口调用时间。
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| fplx | 发票类型 | String(2) | 是 | 01:增值税专用发票 02:货物运输业增值税专用发票 03:机动车销售统一发票 04:增值税普通发票 08:增值税电子专用发票 10:增值税电子普通发票 11:卷式发票 14:通行费发票 15:二手车销售统一发票 81:电子发票(增值税专用发票) 82:电子发票(普通发票) 85:纸质发票(增值税专用发票) 86:纸质发票(普通发票) 51:电子发票(铁路电子客票) 61:电子发票(航空运输客票电子行程单) 83:机动车销售电子统一发票 84:二手车销售电子统一发票 87:纸质发票(机动车销售统一发票) 88:纸质发票(二手车销售统一发票) |
| fpdm | 发票代码 | String(12) | 否 | 发票类型为:01、02、03、04、08、10、11、14、15传纸质发票代码,其他发票类型无需传入 |
| fphm | 发票号码 | String(20) | 是 | 发票类型为:01、02、03、04、08、10、11、14、15传纸质发票号码 发票类型为:51、61、81、82、83、84、85、86、87、88传20位数字化电子发票号码 |
| kprq | 开票日期 | String(8) | 是 | YYYYMMDD |
| 数据项标识 | 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| returncode | 返回码 | String(2) | 是 | 详情可参照“六、附件:1.返回码代码表” |
| returnmsg | 返回信息 | String(2000) | 否 | 错误信息说明 |
| fpdm | 发票代码 | String(12) | 是 | 数字化电子发票发票代码可为空 |
| fphm | 发票号码 | String(20) | 是 | 数字化电子发票,发票号码20位 |
| kprq | 开票日期 | String(19) | 是 | YYYY-MM-DD HH:mm:ss |
| fpzt | 发票状态 | String(1) | 否 | 0:正常 2:作废 3:已红冲 7:部分红冲 8:全额冲红 |
| ycpzzt | 异常凭证状态 | String(1) | 否 | 01:正常 02:异常凭证 03:疑似异常凭证 |
| hzsdbs | 红字锁定标识 | String(1) | 否 | Y:锁定 N:未锁定 |
| fpyt | 发票用途 | String(2) | 否 | 0:未使用 1:已申请抵扣 2:已申请退税 3:已申请代办退税 4:已勾选不抵扣(历史数据) 5:已申请代办退税(历史数据) 6:已申请不抵扣 7:内销转出口 8:出口转内销 9:准予退税 10:不予退税 11:冬奥退税 |
| rzzt | 入账状态 | String(2) | 否 | 01:未入账 02:已入账 03:已入账撤销 |
| cpyycbs | 成品油异常标识 | String(1) | 否 | 9:正常 1:成品油单价异常 2:成品油超库存异常 8:正常,需全额红冲 |
| cktsldm | 出口退税类代码 | String(2) | 否 | 01:增值税专用发票可用于代办退税标签(仅用于代办退税) |
| zzsyhyt | 增值税优惠用途(农产品加计扣除) | String(2) | 否 | 0:未使用 1:全部项目加计 2:全部项目不加计 3:部分项目加计 |
| xfsyt | 消费税用途 | String(2) | 否 | 00:未勾选库存 01:已勾选库存 |
| jdcycbs | 机动车异常标识 | String(1) | 否 | 0:无风险 1:低风险 2:中风险 3:高风险 |
| skssq | 税款所属期 | String(6) | 否 | 返回格式:yyyymm |
| xgmqjqdfpfhgxtjbs | 小规模期间取得发票符合勾选条件标识 | String(1) | 否 | 当为小规模期间取得发票时,返回是否符合勾选条件标识: 0:符合 1:不符合,登记为一般纳税人之前取得且不符合勾选抵扣条件的发票 2:不符合,转登记为小规模纳税人期间取得且不符合勾选抵扣条件的发票 当码值为1或2时不可勾选,为0时可勾选 |
| cekcycbs | 差额扣除异常标识 | String(1) | 否 | 当为差额扣除凭证的发票时,返回是否符合勾选条件标识: 0:正常,可用于勾选 1:异常,不能用于勾选 |
接入前提与说明
- 企业需在税局乐企数字开放平台完成能力 202078 订阅并取得接入凭证;凭证在后台「乐企联用配置」录入(沙箱/生产两套)
- 报文传输封装(含国密 SM4)以《乐企平台统一接入规范》为准;本网关已预留 SM4 开关,联调期按实际规范对齐
- 算税引擎联调:沙箱环境算税校验失败会返回标准答案,作为对账基准完成校准后再切生产
- 税款缴纳的执行方式(TIPS 财政缴银/三方协议扣款/第三方平台缴款)请与主管税务机关及银行确认后选用
- 代办税费须在开票次月征期内完成申报缴纳,逾期将被暂停反向开票资格(详见能力文档业务规则)
