本页描述旧版业务字段与协议。新接入请使用 统一开放 API;已有票慧联和 E6 调用保持原路径。

发票归集

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

查询增量下载发票信息

已上线

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即将开放批量发票下载申请,乐企直连(NATURAL 通道)能力,tax-hub 已实现,E6 侧对接代码已完成(2026-09-21),尚未真机/沙箱端到端验证
PLFPXZSQFK即将开放批量发票下载申请反馈,同上
FPZTXXCX即将开放发票用途状态信息查询,tax-hub 已实现,ERP 尚未接入
FPTSTXXXCX即将开放发票风险信息查询,tax-hub 已实现,ERP 尚未接入