发票归集
调用前需要企业税号已有可用连接(见连接管理)。
查询增量下载发票信息
已上线POST /api/v2/tax/203067/CXZLXZFPXX
2026-09-12 起路径末尾不带斜杠(历史上曾一度带斜杠,属破坏性变更,详见更新日志)。
乐企官方契约按 gjrq(单日"归集日")取票,不支持按开票日期区间过滤。 需要按开票日期起止查询请使用下方 900004/FPJCXX。
请求参数(乐企官方字段)
| 参数 | 说明 |
|---|---|
| nsrsbh | 企业纳税人识别号(必填) |
| gjrq | 归集日(单日) |
| sjlx / fplx | 数据类型 / 发票类型,取值随乐企官方契约 |
| packageno | 分包序号——服务端已自动处理多包循环,ERP 无需自己传/循环 |
响应要点
sjl为业务数据数组(服务端已完成 gzip 解压)cljg=2表示"本包无符合条件的发票",不是错误;cljg=3才是真失败- 分包由服务端循环取完再合并返回,ERP 收到的是完整结果;若因量过大未能取完,
returncode会是10(处理中,需缩小范围重试),不会静默返回不完整数据
按开票日期查询发票清单
已上线本平台扩展 · 9 号段POST /api/v2/tax/900004/FPJCXX
过渡性接口:字段契约按 Web 模拟登录通道原生字段定义,与上方
CXZLXZFPXX 的乐企官方字段不是同一套,未来接入乐企直连后两者并存。 请求参数
| 参数 | 必填 | 说明 |
|---|---|---|
| nsrsbh | 是 | 企业纳税人识别号 |
| gjbq | 是 | 归集标签:1=开具/销项 2=取得/进项 |
| kprqq / kprqz | 是 | 开票日期起 / 止 |
| fpztDm | 否 | 发票状态代码数组,缺省 ['01','02','03','04'] |
| fplyDm | 否 | 发票来源代码,缺省 '0'(全部) |
| fplxDm | 否 | 发票类型代码数组,缺省全量 |
| sflzfp / dtBz | 否 | 是否蓝字发票 / 是否带图,缺省 dtBz='N' |
| pageNumber / pageSize | 否 | 分页,缺省 1 / 50 |
响应结构与 CXZLXZFPXX 一致(同一套 sjl/cljg 语义)。
203067 号段下其它接口
以下接口 tax-hub 已经实现或规划,但 ERP 当前未接入调用,不属于正式可用 API:
| 接口 | 状态 | 说明 |
|---|---|---|
| PLFPXZSQ | 规划中 | 批量发票下载申请,Web 通道无对应能力 |
| PLFPXZSQFK | 规划中 | 批量发票下载申请反馈,同上 |
| FPZTXXCX | 即将开放 | 发票用途状态信息查询,tax-hub 已实现,ERP 尚未接入 |
| FPTSTXXXCX | 即将开放 | 发票风险信息查询,tax-hub 已实现,ERP 尚未接入 |