跳到正文
开灵科技 - 北京开灵科技有限公司API百宝箱

乐企联用 · 报废产品收购反向开票(业务型接口)

基于税务总局乐企数字开放平台「报废产品收购开票能力」(能力编码 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 财政缴银完成。

客户平台开灵网关乐企平台银行 · TIPS一 · 开票前四道闸(每单建单前跑一遍,全过才算税)① 纳税人资格taxpayer/check基本信息+风险双查CXNSRJBXX / CXNSRFXXX② 代办税费 → ③ 未办结业务agent-tax/check · pending/check应代办未代办 / 未缴税记录CXYDBWDBSFXX / CXQYWJSJL④ 自然人校验(60/180/500万)seller/check四道闸结论:可建单eligible / blocked / allowed二 · 算税与下单(客户只传不含税金额,税由开灵算、乐企验)⑤ 计算代缴税费+下单tax/calc-order · 只传 hjje累计取数 / 算税参数CXZRRKPXX / CXFXKPSSCS内置算税引擎:五税种应缴(号段池自动取号)待缴税费校验 → 缴款信息BFCPSGDJSFJY → CXDJSFJKXX预开票号码+电子税票号码+税额明细ykfphm · dzsphm · tax.items三 · 缴款(银行侧执行,资金/税款两讫)持电子税票号码发起缴税dzsphmTIPS 财政缴银入库⑥ 查缴纳结果(轮询至 01)tax/pay-status → CXSFJNJG四 · 开票(票面标注「报废产品收购」)⑦ 发票开具invoice/create · fphm=ykfphm发票上传+结果轮询BFCPSGFPSC / CXQDFPSCJG开票终态+发票号码五 · 售后:⑨ 取消未缴款预开单(号码回池) / 红冲后 ⑧ 一键退税(预检→申请→受理)

关键链路:⑤ 返回的 ykfphm(预开票号码)与 dzsphm(电子税票号码)贯穿缴款与开票,开票时 fphm=ykfphm; 实付出售人金额=价税合计−应缴税费合计(tax.yjsfhj),资金/发票/税款三流在 ⑤ 对齐。

9 个业务接口(34 原子 → 9 业务,与客户接口清单一一对应)

#业务接口路径内部乐企接口一句话
①判断纳税人开票资格lqbiz/taxpayer/checkCXNSRJBXX + CXNSRFXXX基本信息与风险信息双查合并研判,一次调用出结论
②企业代办税费校验lqbiz/agent-tax/checkCXYDBWDBSFXX返回 blocked 结论+逐户明细,可供平台定时轮询提醒
③企业及自然人未办结业务校验lqbiz/pending/checkCXQYWJSJL含未缴税/扣款失败已作废记录识别;命中时需先缴款或调接口⑨取消
④自然人开票校验lqbiz/seller/checkCXZRRKPXX内置 60 万/180 万/500 万三道年累计校验线
⑤计算代缴税费+下单(核心)lqbiz/tax/calc-orderCXZRRKPXX → CXFXKPSSCS → 内置算税 → BFCPSGDJSFJY → CXDJSFJKXX(池:QDFPPLFM;兜底:YZYHKHXX+ZRRJJDJ)内置算税引擎+预赋码号段池自动取号+自然人未登记自动登记兜底
⑥查询税费缴纳结果lqbiz/tax/pay-statusCXSFJNJG支持单号与批量(dzsphmList)
⑦发票开具lqbiz/invoice/createBFCPSGFPSC + CXQDFPSCJG(轮询)发票上传后自动轮询上传结果至终态;特定要素固定 24-报废产品收购,蓝字标志默认 0
⑧申请反向开票退税lqbiz/refund/applyCXTSXX → SQFXKPTS → CXBFCPTSJG可退税额预检 → 申请 → 受理结果,一次调用办完
⑨取消预开票交易lqbiz/order/cancelQXYKFPJY取消成功后预赋码号码自动回池;已缴税/状态不明时号码不回池

点接口名进入详情页:入参表/返回参数表/成功与失败报文示例/异常与报错/前端怎么用。红字确认单等清单外能力经原子接口提供,不增加业务接口数量。

内置算税引擎(接口⑤)

乐企侧不负责算税、只做校验——官方要求应缴税额(yjse)为「直连平台算税规则计算结果」。 本网关按能力文档附件《乐企废品收购企业反向开票算税规则》内置了完整算税引擎:调用方只传不含税金额与票面口径, 五税种应缴税额由平台计算、经乐企校验通过后随响应逐项返还(tax.items 与合计 tax.yjsfhj)。 月累计(一人式金额)、年度个税累计与已缴税额自动取自乐企(CXZRRKPXX),待补缴汇总与征收品目、城建税率、六税两费减征比例自动取自算税参数(CXFXKPSSCS)。

增值税(10101)
场景规则
月累计<10万·普票免征(减免性质按额度分档 0001042804/…806/…807),应缴 0
月累计≥10万·普票按 1% 计征(0001011608);补缴标志 Y 时与本月待补缴普票合并计税
专票享受优惠减免按 1%,否则按 3%;超 10 万且补缴时,3% 当张与 1% 补缴分两条计算
销售自用普票免征增值税(任何额度)
城市维护建设税(10109)
场景规则
计税依据应缴增值税额(不是票面税额);税率与征收品目取自算税参数(CXFXKPSSCS)
减征六税两费减征(0007049901),减征比例按省配置,引擎默认 50% 并以算税参数返回值为准
教育费附加(30203)·地方教育附加(30216)
场景规则
月累计≤10万全额减免(0061042802/0099042802),应缴 0
月累计>10万按增值税额 ×3%/×2% 计征并六税两费减征;补缴时并入本月待补缴普票两教与专票 1%/3% 累计
个人所得税(10106)
场景规则
非销售自用年度累计(本单+本年度乐企个税累计)≤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 个原子接口通用;接口内的业务异常见各接口详情页「异常与报错」表。

HTTPcode含义与处理
200CYT_00000成功;业务结论看 data(eligible/blocked/allowed/cljg 等字段)
400CYT_40001请求体不是合法 JSON,或参数缺失/格式错误
401CYT_40100/40101/40102缺少鉴权头/密钥不存在或停用/签名校验失败
401CYT_40103时间戳过期或缺失——X-Timestamp 必须为 Unix 秒级(毫秒必错),校准时间后重试
403CYT_40301密钥未开通「反向开票」产品权限——请联系开灵商务或您的开灵项目经理开通
404CYT_40001(hint:未知业务接口)业务接口仅接口清单 9 个;清单外能力走原子通道 /lq/<服务编码>
429CYT_42901请求过于频繁,稍后重试
502CYT_50200上游乐企返回失败:data.hint 为失败原因(透传乐企 returncode/returnmsg),data.data.steps 为已执行步骤

原子接口(34 个,与官方能力文档一一对应)

点击展开查看每个接口的请求/返回参数表(内容提取自官方能力说明文档)。

1. 获取数电票批量预赋码信息 POST /api/v1/invoice/reverse/lq/QDFPPLFM

向纳税人提供批量预赋码功能,用于企业给发票自动赋发票号码。

企业使用开票前置判断企业发票库存低于“20%”阈值时,调用此接口申请预分配置新号码段。

企业每次获取数电票批量预赋码信息时,需要上传业务流水号,由“使用单位id”+“直连单位id”+“32位随机生成码”组成,若企业由于网络超时等原因没有收到获取结果,可以通过该业务流水号重新请求,重新请求时领用数量需要保持不变,企业每次最多申请5000份发票。

当企业完成跨省迁移后,不能再使用跨省迁移前下载的发票号码段,应当重新下载发票号码段,使用迁移后下载的发票号码段开具上传发票。

请求参数(body)
数据项标识名称类型必填说明
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

向纳税人提供赋额额度查询功能,可查询企业当前在税务局端的赋额额度信息,包括:暂停授信标志、本月赋额额度、可用剩余额度、已下载额度、已下载未使用额度、属期。

请求参数(body)
数据项标识名称类型必填说明
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位随机生成码”组成,若企业由于网络超时等原因没有收到发票额度下载/退回结果,可以通过该业务流水号重新获取,使用相同业务流水号申请下载/退回发票额度时申请类型与申请额度需要相同。

请求参数(body)
数据项标识名称类型必填说明
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

给企业提供调整赋额额度有效期接口,企业在月初未申报时下载的赋额额度的有效期止为当月申报截止日期,超过赋额额度有效期止后,无法开具报废产品收购发票,企业在完成申报或到达赋额额度有效期止后,通过此接口调整赋额额度有效期,并根据税局端返回的有效期更新本地赋额额度有效期。

请求参数(body)
数据项标识名称类型必填说明
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

向企业提供查询纳税人风险信息的功能,企业可将查询的风险信息保存在本地。在开票时自校验该接口获取的风险信息是否满足开具发票的条件,控制高风险企业操作涉税业务。

请求参数(body)
数据项标识名称类型必填说明
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

向企业提供查询纳税人基本信息的功能,企业可将查询的基本信息,包括生产经营信息、税务机关信息、企业性质、消费税性质等保存在本地。在开票时自校验该接口获取的纳税人基本信息是否满足开具发票的条件。

请求参数(body)
数据项标识名称类型必填说明
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

向企业提供查询商品税收分类编码信息的功能,企业可将查询的编码信息保存在本地。在开票时选择保存在本地的税收分类编码。

请求参数(body)
数据项标识名称类型必填说明
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

提供查询自然人出售者开票信息,包括自然人月累计开票金额、是否阻断反向开票自然人,用于开票前的校验规则处理。

请求参数(body)
数据项标识名称类型必填说明
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张数字化电子发票。

请求参数(body)
数据项标识名称类型必填说明
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红字确认单uuidvarchar(32)否是否蓝字发票标志为1时,此节点有内容红票开具时必传
bz备注varchar(450)否蓝票最长450位,红票最长382位。
ip服务器地址varchar(20)是需自行采集开票申请设备
macdzmac地址char(20)是需自行采集开票申请设备
cpuidCPU序列号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小时只能重新上传发票再获取上传结果。

请求参数(body)
数据项标识名称类型必填说明
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

提供红字确认单申请功能。

请求参数(body)
数据项标识名称类型必填说明
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红字确认单UUIDvarchar(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

提供红字确认单确认接口,进行红字确认单撤销操作。

请求参数(body)
数据项标识名称类型必填说明
xsfnsrsbh统一社会信用代码/纳税人识别号/身份证件号码varchar(20)是
uuid红字确认单UUIDvarchar(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

向企业提供查询报废产品收购红字确认单列表信息的功能,企业可通过购买方纳税人识别号、销售方纳税人识别号、蓝字发票号码、录入日期起、录入日期止等条件查询报废产品收购红字确认单列表信息,并将查询的结果保存在本地。使用此信息可以在申请报废产品收购红字确认单时校验报废产品收购蓝字发票是否可以红冲;在开具报废产品收购红字发票时校验是否有报废产品收购红字确认单。

请求参数(body)
数据项标识名称类型必填说明
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红字确认单UUIDvarchar(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、销售方纳税人识别号查询报废产品收购红字确认单明细信息,并将查询的结果保存在本地。使用此信息可以在申请报废产品收购红字确认单时校验蓝票是否可以红冲;在开具报废产品收购红字发票时校验是否有报废产品收购红字确认单明细。

请求参数(body)
数据项标识名称类型必填说明
uuid红字确认单UUIDvarchar(32)是
xsfnsrsbh销售方统一社会信用代码/纳税人识别号/身份证件号码varchar(20)否
返回参数
数据项标识名称类型必填说明
returncode返回码varchar(2)是00:成功,其它:失败
returnmsg返回信息varchar(2000)否错误信息说明
uuid红字确认单UUIDvarchar(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日零点汇总乐企服务端接收到的上个月的数字化电子发票、税款缴纳数据,若自动汇总确认的发票应缴税费与已缴税费记录不一致,将阻断自动汇总确认。

当企业上传发票汇总确认信息后,发现已确认的月份还有数字化电子发票未上传,可以取消发票汇总确认,把未上传的数字化电子发票上传至乐企服务端后再次上传发票汇总确认信息。

请求参数(body)
数据项标识名称类型必填说明
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

给企业提供发票汇总确认信息查询功能,企业可以通过此接口查询历史发票汇总确认信息。

请求参数(body)
数据项标识名称类型必填说明
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

提供直连平台查询收购企业、自然人在乐企全部平台已预开验证税款但未缴税的数据记录(包含缴税状态为未缴税、扣款失败税费已作废),纳税人识别号和自然人姓名+身份证件号码能且只能传入一组数据,传入纳税人识别号时按照企业返回未缴税发票交易数据,传入自然人姓名+身份证号码时按照自然人返回未缴税发票交易数据。

请求参数(body)
数据项标识名称类型必填说明
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。

当涉及补缴历史发票税费的场景,补缴发票号码列表需要传入本次补缴的历史发票号码,补缴发票号码按照算税前查询“反向算税参数查询”获取到的发票号码返回。

增值税税额列表,当不涉及历史发票税费补缴时,传入当前发票的类型及增值税税额;涉及历史发票税费补缴时,按照历史发票+本次交易的增值税税额分专票、普票两组数据返回,该增值税税额为本次应缴纳增值税税额,非票面增值税税额。

请求参数(body)
数据项标识名称类型必填说明
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,需要企业调用“取消预开发票交易”接口取消该笔交易,触发该场景报错的企业可前往电票平台开具报废产品收购发票。

请求参数(body)
数据项标识名称类型必填说明
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税费已作废,需要调用“查询待缴税费缴款信息”获取新的税费完成缴款。

请求参数(body)
数据项标识名称类型必填说明
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起不能取消上月的预开发票交易。

请求参数(body)
数据项标识名称类型必填说明
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

查询企业反向开票算税参数。每次开票前必须调用该接口根据自然人信息查询缴税相关数据,并且返回的数据完成算税校验。

请求参数(body)
数据项标识名称类型必填说明
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

平台侧企业可按属期查询在平台已开票的自然人是否存在需委托代办申报的税费信息,用于企业在申报期进行委托代办申报处理,委托代办由企业在电子税务局完成,本接口仅支持按属期(仅支持本月或上月)、企业维度查询企业应委托代办补缴税款的数据。

请求参数(body)
数据项标识名称类型必填说明
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

当报废产品企业作废交易或者开具红字发票成功后,可以调用该接口查询产生的自然人应退税费信息。

请求参数(body)
数据项标识名称类型必填说明
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税票UUIDvarchar2(32)是
dzsphm电子税票号码number(20)是
skssqq税款所属期起date是yyyy-MM-dd
skssqz税款所属期止date是yyyy-MM-dd
26. 申请反向开票退税 POST /api/v1/invoice/reverse/lq/SQFXKPTS

当纳税人作废交易或者开具红字发票成功查询到存在可退税税额后,可以调用该接口进行反向开票退税申请。若自然人当月一人式归集金额为负数则不允许发起退税申请。

请求参数(body)
数据项标识名称类型必填说明
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

企业完成退税申请后,可调用此接口使用乐企退税申请接收成功后返回的业务流水号查询报废产品退税结果。

请求参数(body)
数据项标识名称类型必填说明
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分钟内完成扫码缴款,可调用此接口重新生成二维码完成缴款。

请求参数(body)
数据项标识名称类型必填说明
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需要重新查询待缴税费获取新的缴费信息完成缴税。

请求参数(body)
数据项标识名称类型必填说明
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

反向开票退税申请确认时,可调用该接口验证将用于退税申请的银行卡是否可使用。若验证不通过,则不可用于退税。

请求参数(body)
数据项标识名称类型必填说明
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

当直连单位第一次接收到某自然人的开票申请时,先调用自然人间接登记接口为自然人进行间接登记,减少算税校验接口处理时间。

请求参数(body)
数据项标识名称类型必填说明
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条数据。

请求参数(body)
数据项标识名称类型必填说明
uuiduuidCHAR(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

直连单位可调用此接口查询前一日上传的发票对账数据结果,该接口会返回对账不符的数据及原因,建议企业于上传对账数据后第二天下午进行查询,可获取到完整的对账不符数据结果。

请求参数(body)
数据项标识名称类型必填说明
uuiduuidCHAR(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)否批量查询时返回
uuiduuidCHAR(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

企业业务系统通过此接口查询单张发票状态、红字开具确认状态、发票用途等信息。此接口用途为辅助乐企开票企业发起红字确认单申请时的业务校验,实际以生成红字确认单时的业务校验结果为准。

发票用途状态信息查询结果仅供企业参考,在综服平台进行发票勾选的企业,其查询到的发票状态可能存在延时问题。

为保障乐企平稳运行,该接口对直连单位每秒调用接口次数进行限制,请直连单合理安排接口调用时间。

请求参数(body)
数据项标识名称类型必填说明
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 财政缴银/三方协议扣款/第三方平台缴款)请与主管税务机关及银行确认后选用
  • 代办税费须在开票次月征期内完成申报缴纳,逾期将被暂停反向开票资格(详见能力文档业务规则)