云南省通用电子发票（区块链发票）查验 API 接口文档

简介

云南省通用电子发票（区块链发票）查验 API ，适用于各类通用电子发票查验场景。
接口具备以下核心优势：

• 覆盖全面：支持云南省的通用电子发票查验。
• 高效稳定：适应大规模并发需求，保持快速响应与高可用性。
• 易于对接：标准 RESTful API 设计，几分钟即可完成集成。
• 智能集成：可无缝对接财务系统、ERP、票据管理平台，实现自动化查验与归档。

无论是企业财务合规、互联网 SaaS 平台集成，还是政府事业单位的票据核验，云南省通用电子发票（区块链发票）查验 API 都能为您提供专业、稳定、可信赖的解决方案。

请求说明

• 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
jym	String	是	发票校验码后 5 位	54321
xfsbh	String	是	发票销方识别号	0123456789123456789

响应参数

成功响应

此时 HTTP 状态码为200

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

成功响应示例:

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

响应 JSON 示例

{
  "code": 0,
  "data": {
    "fpdm": "发票代码",
    "fphm": "发票号码",
    "xfsbh": "销方税号",
    "xfmc": "销方名称",
    "gfmc": "购方名称",
    "kprq": "开票日期",
    "jym": "校验码",
    "jshj": "价税合计",
    "fpzt": "发票状态",
    "wxbz": "无效标志"
  },
  "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": "233002200111",
  "fphm": "35929452",
  "jym": "54321",
  "xfsbh": "0123456789123456789"
}

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

使用 Curl 命令行

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",
  "jym": "54321",
  "xfsbh": "0123456789123456789"
}'

SDK 代码示例

点击查看 SDK 代码示例