发票查验 API 文档

简介

支持多种增值税发票的信息核验：

增值税专用发票、增值税普通发票、增值税普通发票（卷式）、增值税电子专用发票、增值税电子普通发票、增值税电子普通发票（通行费）、二手车销售统一发票、机动车销售统一发票、铁路电子客票、航空运输电子客票行程单、数电发票，支持返回票面的全部信息。

请求说明

• 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

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"、"83"）时传入以下参数：

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

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

发票类型与判断

发票类型	发票类型代码
增值税专用发票	01
机动车销售统一发票	03
增值税普通发票	04
增值税电子专用发票	08
增值税电子普通发票	10
增值税普通发票(卷票)	11
增值税电子普通发票(通行费)	14
二手车销售统一发票	15
数电票（增值税专用发票）	31
数电票（普通发票）	32
航空运输电子客票行程单	61
铁路电子客票	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": "012345678901",
  "fphm": "12345678",
  "kprq": "2025-01-01",
  "bhsje": "100.00",
  "jym": "654321"
}

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

使用 Curl 命令行

curl -X POST https://fpzwcx.com/v1/check_zzs/info \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your_AppCode>" \
-d '{
  "fpdm": "012345678901",
  "fphm": "12345678",
  "kprq": "2025-01-01",
  "bhsje": "100.00",
  "jym": "654321"
}'

SDK 代码示例

点击查看SDK 代码示例

---

备注

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