发票查验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 代码示例

---

备注

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

常见问题

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

实时查验返回结果。

是否支持高并发？

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

是否提供测试或试用？

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