发票真伪查询网
搜索 K

Appearance

发票查验API接口文档 ​

简介 ​

稳定可靠、响应快速。适用于发票验真、费用报销系统、ERP 对接等业务场景，支持免费试用，已服务数百家企业客户。

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

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

请求说明 ​

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

请求参数 ​

参数名类型必填描述示例值
fpdmString否发票代码012345678901
fphmString是发票号码12345678
kprqString是开票日期（YYYYMMDD）20250101
bhsjeString否发票金额（不含税）100.00
jymString否校验码后 6 位654321
jshjString否价税合计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"、"83"）时传入以下参数：

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

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

发票类型与判断 ​

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

- 如果[发票号码]长度为 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 格式参数，例如：（此参数为示例，需要更换为真实的发票信息）
json
{
  "fpdm": "012345678901",
  "fphm": "12345678",
  "kprq": "2025-01-01",
  "bhsje": "100.00",
  "jym": "654321"
}
  1. 点击发送，查看响应结果。

使用 Curl 命令行 ​

bash
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 安全，不在公共环境中暴露。