Skip to content

浙江通用电子发票查验 API 接口文档

简介

浙江通用电子发票查验 API 提供 覆盖全省的发票验真与核验能力,包括宁波等在内的所有地区均可使用。
接口具备以下优势:

  • 稳定可靠:高并发环境下仍能保持快速响应,适合企业级应用。
  • 易于集成:支持标准 RESTful 风格接口,接入成本低,几分钟即可完成对接。
  • 专业合规:符合财政部门规范,帮助企业降低财务风险。
  • 智能扩展:可与财务、ERP、票据管理等系统无缝融合,实现自动化验真。

无论是企业财务合规、第三方SaaS平台接入,还是政府事业单位的票据核验场景,我们都能提供稳定高效的解决方案。

请求说明

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

请求参数

参数名类型必填描述示例值
fpdmString发票代码012345678901
fphmString发票号码12345678
kprqString开票日期(YYYYMMDD)20250101
jshjString价税合计100.00
xfsbhString发票销方识别号0123456789123456789

响应参数

成功响应

此时 HTTP 状态码为200

字段名类型描述
successBoolean查验状态 (true)
codeNumber业务状态码
dataObject发票详细信息
requestIdString唯一请求 ID

成功响应示例:

json
{
  "success": true,
  "code": 0,
  "data": {}, // 具体发票数据
  "requestId": "唯一请求ID"
}

响应 JSON 示例

json
{
  "code": 0,
  "data": {
    "fplbmc": "发票类别名称",
    "kprq": "开票日期",
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "jshj": "价税合计",
    "xfmc": "销方名称",
    "xfsbh": "销方税号",
    "gfmc": "购方名称",
    "gfsbh": "购方税号",
    "fpzt": "发票状态 0正常 2作废 3红冲 7部分红冲 8全额冲红",
    "cycs": "查验次数",
    "fplxName": "浙江通用(电子)发票",
    "fplx": "131",
  },
  "requestId": "requestId",
  "success": true
}

业务状态码

点击查看所有业务状态码

使用示例

使用 Postman 进行测试

  1. 设置请求方式为POST
  2. 输入 URL:https://fpzwcx.com/v1/check_fp/info
  3. 在 Headers 中添加:
    • Content-Type: application/json
    • Authorization: Bearer <your_AppCode>
  4. 在 Body 中填写 JSON 格式参数,例如:(此参数为示例,需要更换为真实的发票信息)
json
{
  "fpdm": "233002200111",
  "fphm": "35929452",
  "kprq": "20220730",
  "jshj": "1663.32",
  "xfsbh": "92330402MA2JFM6162"
}
  1. 点击发送,查看响应结果。

使用 Curl 命令行

bash
curl -X POST https://fpzwcx.com/v1/check_czpj/info \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your_AppCode>" \
-d '{
  "fpdm": "233002200111",
  "fphm": "35929452",
  "kprq": "2025-01-01",
  "jshj": "1663.32",
  "xfsbh": "92330402MA2JFM6162"
}'

SDK 代码示例

点击查看 SDK 代码示例