发票归集

调用前需要企业税号已有可用连接(见连接管理)。

查询增量下载发票信息

已上线

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 尚未接入