发票查验API接口文档

简介

稳定可靠、响应快速。适用于发票验真、费用报销系统、ERP 对接等业务场景，支持免费试用，已服务数百家企业客户。支持全部增值税发票信息核验，全面支持数电发票（全电发票）查验，覆盖专票、普票、机动车、二手车、通行费及火车票、航空行程单等票种。

什么是增值税发票查验 API？

增值税发票查验 API 是用于 核验增值税发票真伪 获取发票信息的接口服务。
企业系统通过提交发票的关键字段，可自动获取发票查验结果和发票信息，无需人工登录税务平台进行查询。

该接口主要用于 所有增值税发票 的真伪核验。

增值税发票查验流程

1. 企业系统收集发票基础信息
2. 调用增值税发票查验 API
3. 系统自动完成真伪核验
4. 返回查验状态与结果信息
5. 企业系统根据结果进行后续处理

扩展功能

如需获取下载发票原件，请参考：获取发票原件 如需获取税局查验成功截图，请参考：发票查验截图接口

请求说明

• URL: /v1/check_zzs/info
• 完整 URL: https://fpzwcx.com/v1/check_zzs/info
• 请求方法: POST、GET
• 请求头: (查看构建方式)
• Authorization: Bearer <your AppCode>

请求参数

参数名	类型	必填	描述	示例值
fpdm	String	否	发票代码	012345678901
fphm	String	是	发票号码	12345678
kprq	String	是	开票日期（YYYYMMDD）	20250101
bhsje	String	否	发票金额（不含税）	100.00
jym	String	否	校验码后 6 位	654321
jshj	String	否	价税合计	100.00

TIP

1. 增值税专用发票、机动车销售统一发票、增值税电子专用发票、二手车销售统一发票（发票种类："01"，"03"，"08"，"15"）时传入以下参数：

   • fpdm：发票代码（必选）
   • fphm：发票号码（必选）
   • kprq：开票日期（必选）
   • bhsje：不含税金额（必选） // 二手车销售统一发票("15") 传车价合计

2. 增值税电子普通发票、增值税电子专用发票、增值税普通发票(卷票)、增值税电子普通发票(通行费)（发票种类："04"、"10"、"11"、"14"）时传入以下参数：

   • fpdm：发票代码（必选）
   • fphm：发票号码（必选）
   • kprq：开票日期（必选）
   • jym：校验码后 6 位（必选）

3. 数电票（增值税专用发票）、数电票（普通发票）、航空运输电子客票行程单、数电票（通行费发票）、铁路电子客票（发票种类："31"、"32"、"61"、"72"、"83"）时传入以下参数：

   • fphm：发票号码（必选）
   • kprq：开票日期（必选）
   • jshj：价税合计（必选）

请根据对应发票的种类提供正确的入参进行查询操作，确保参数的准确性和完整性。

发票类型与判断

发票类型	发票类型代码
增值税专用发票	01
机动车销售统一发票	03
增值税普通发票	04
增值税电子专用发票	08
增值税电子普通发票	10
增值税普通发票(卷票)	11
增值税电子普通发票(通行费)	14
二手车销售统一发票	15
数电票（增值税专用发票）	31
数电票（普通发票）	32
航空运输电子客票行程单	61
数电票（通行费发票）	72
铁路电子客票	83

如何判断发票类型

自然语言

- 如果[发票号码]长度为 20 位， 则是数电票类型

- 如果发票代码长度为 12 位

如果发票代码第一位不是 0 且第八位是 '2'，则发票类型为 '03'（机动车销售统一发票）。

如果发票代码以 0 开头且最后两位是 '04' 或 '05'，则发票类型为 '04'（增值税普通发票）。

如果发票代码以 0 开头且最后两位是 '13'，则发票类型为 '08'（增值税电子专用发票）。

如果发票代码以 0 开头且最后两位是 '11'，则发票类型为 '10'（增值税电子普通发票）。

如果发票代码以 0 开头且最后两位是 '06' 或 '07'，则发票类型为 '11'（增值税普通发票(卷票)）。

如果发票代码以 0 开头且最后两位是 '12'，则发票类型为 '14'（增值税电子普通发票(通行费)）。

如果发票代码以 0 开头且最后两位是 '17'，则发票类型为 '15'（二手车销售统一发票）。

- 如果发票代码长度为 10 位

如果发票代码第八位是 '1' 或 '5'，则发票类型为 '01'（增值税专用发票）。

如果发票代码第八位是 '7' 或 '2'，则发票类型为 '02'（货物运输业增值税专用发票）。

如果发票代码第八位是 '6' 或 '3'，则发票类型为 '04'（增值税普通发票）。


如果以上判断条件都不满足，则是不支持的发票。
根据以上代码的逻辑，您可以使用该函数传入发票代码来获取相应的发票类型和发票类型名称。

响应参数

点击查看响应参数

业务状态码

点击查看所有业务状态码

使用示例

使用 Postman 进行测试

1. 设置请求方式为POST。
2. 输入 URL：https://fpzwcx.com/v1/check_zzs/info。
3. 在 Headers 中添加：
   • Content-Type: application/json
   • Authorization: Bearer <your_AppCode>。
4. 在 Body 中填写 JSON 格式参数，例如：（此参数为示例，需要更换为真实的发票信息）

{
  "fpdm": "4200232130",
  "fphm": "03815055",
  "kprq": "2023-11-21",
  "bhsje": "328318.58",
  "jym": ""
}

5. 点击发送，查看响应结果。

使用 Curl 命令行

curl -X POST https://fpzwcx.com/v1/check_zzs/info \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your_AppCode>" \
-d '{
  "fpdm": "4200232130",
  "fphm": "03815055",
  "kprq": "2023-11-21",
  "bhsje": "328318.58",
  "jym": ""
}'

SDK 代码示例

点击查看SDK 代码示例

数电发票查验（全电发票查验）

数电发票（全面数字化的电子发票，也称全电发票）是税务机关推行的下一代发票形态：开票无需税控设备、无需领用纸质票，通过税务数字账户即可完成开具、交付与入账。本接口对数电发票与传统增值税发票提供统一的查验入口，全面支持数电发票（全电发票）查验。

数电发票与增值税发票的关系

数电发票是增值税发票的数字化形态，仍属于增值税发票体系——数电专票（fplx=31）对应增值税专用发票，数电普票（fplx=32）对应增值税普通发票。对报销、入账、归档系统而言，查验入口完全一致，差异主要体现在票面要素上：

对比项	传统纸票/电票	数电发票
发票号码	8 位	20 位
发票代码	10 位或 12 位	无发票代码
开票介质	税控设备	税务数字账户，无需税控设备
版式文件	PDF / OFD	PDF / OFD / XML（数据文件）
查验要素	发票代码+号码+日期+金额/校验码	号码+日期+价税合计

数电发票查验要素

数电票（专票 "31"、普票 "32"、通行费 "72"）查验只需三要素，参数说明见上方请求参数：

• fphm：20 位发票号码（必填）
• kprq：开票日期（必填）
• jshj：价税合计（必填）

发票号码为 20 位即为数电票，且无需传入发票代码——这也是接入系统自动区分数电票与传统发票的最快判断方式。

数电发票专属能力

• 红冲状态实时同步：查验结果返回数电票的最新状态（正常/红冲/作废），报销系统可据此自动拦截已红冲发票。
• 版式文件与 XML 数据文件获取：数电票的 PDF/OFD/XML 文件可通过获取发票原件接口下载，满足电子会计档案入账要求。
• 电票平台查验截图：可通过发票查验截图接口获取查验成功的官方截图，作为报销合规留档凭证。

适用场景

• 电子会计档案归档：数电票 XML 数据文件直接入账
• 报销自动化：OCR/二维码采集票面信息后自动验真、自动拦截红冲票
• SaaS 平台 / ERP 集成：全部增值税票种统一查验入口，一套参数适配新旧票

---

备注

• 确保 Token 安全，不在公共环境中暴露。

常见问题

增值税发票查验 API 是否实时？

实时查验返回结果。

是否支持高并发？

支持企业级并发，可根据业务需求进行扩展。

是否提供测试或试用？

新用户注册后可获得测试额度，用于接口联调。

数电发票和全电发票是一回事吗？

是同一票种的两种习惯叫法，全称"全面数字化的电子发票"，本接口对二者均支持查验。

数电发票查验需要提供哪些要素？

20 位发票号码、开票日期、价税合计三项即可，无需传入发票代码。

数电发票红冲后还能查到吗？

可以。查验会返回发票最新状态（正常/红冲/作废），红冲发票会明确标记，便于报销系统拦截。