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

发票查验

已上线

POST /api/v2/tax/203059/FPCY_NEW

2026-09-21 合并进乐企官方能力编码:请求字段统一乐企官方形状;响应按通道诚实 分道,不强行统一——NATURAL 通道真实调用乐企返回完整发票内容(cyjgxx), ETAX_HALL 通道(含未指定通道时的默认行为)返回查验状态元数据(List)。 这是两个不对等的能力("查验并下载发票完整内容" vs "查验这张票是否有效"),不是同一能力的两种 编码,调用方必须按自己配置的通道解析对应形状。

请求参数(乐企官方字段)

参数必填说明
nsrsbh是企业纳税人识别号
fplx是发票类型,19 项枚举(详见乐企官方《乐企发票查验能力说明文档》)
fphm是发票号码——fplx 为 81/82/51/61/83/84 时传 20 位数字化电子发票号码,其余类型传纸质发票号码
kprq是开票日期,格式 YYYYMMDD(不带分隔符,注意与「发票明细」的 kprq 格式不同)
fpdm否纸质发票代码,数电票留空
jym否校验码(后六位)
kpje否开票金额

响应要点(按通道诚实分道)

  • NATURAL 通道:返回 {returncode, returnmsg, cyjgxx}——cyjgxx 是 gzip+base64 编码的完整发票内容,需按 fplx 自行解压/解析对应结构,本平台不做结构化
  • ETAX_HALL 通道(含未传通道时的历史默认行为):返回 {returncode, returnmsg, List}——List 内容为税局原生查验结果字段,本平台不裁剪、不加工,原样透传;只验证过 fplx 为数电发票(81/82/51/61/83/84)的路径,其余类型如实拒绝(returncode=11)
  • 无查验记录/数据时返回 returncode=04