广东通用机打发票查验 API 接口文档

简介

广东通用机打发票查验 API 提供 覆盖全省的机打发票验真与核验能力，适用于广东省所有地市机打发票的查验场景。
接口具备以下核心优势：

• 稳定高效：支持大规模并发访问，保证企业级应用场景下的性能表现。
• 易于集成：标准化 RESTful 接口设计，开发者可快速完成对接。
• 合规专业：符合财政部门标准，帮助企业与机构降低财务风险。
• 智能扩展：可与财务、ERP、票据管理等系统无缝对接，实现自动化发票验真与归档。

无论是企业财务合规、第三方SaaS平台接入，还是政府事业单位票据核验，我们都能为您提供安全、可靠、专业的查验服务。

请求说明

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

请求参数

参数名	类型	必填	描述	示例值
fpdm	String	是	发票代码	012345678901
fphm	String	是	发票号码	12345678

响应参数

成功响应

此时 HTTP 状态码为200

字段名	类型	描述
success	Boolean	查验状态 (true)
code	Number	业务状态码
data	Object	发票详细信息
requestId	String	唯一请求 ID

成功响应示例:

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

响应 JSON 示例

{
  "code": 0,
  "data": {
    "xfsbh": "销方税号",
    "xfmc": "销方名称",
    "fplxmc": "发票类型名称",
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "lyrq": "发票领用日期"
  },
  "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 格式参数，例如：（此参数为示例，需要更换为真实的发票信息）

{
  "fpdm": "123456789111",
  "fphm": "12345678"
}

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

使用 Curl 命令行

curl -X POST https://fpzwcx.com/v1/check_czpj/info \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <your_AppCode>" \
-d '{
  "fpdm": "123456789111",
  "fphm": "12345678"
}'

SDK 代码示例

点击查看 SDK 代码示例