2.02 发票识别查验

快速开始环境

https://cosmic-sandbox.piaozone.com/jdpjykjyxgs

POST

/kapi/app/rim/message

接口说明：
一、增值税发票
1 电子普通发票
2 电子专用发票
3 纸质普通发票
4 纸质专用发票
5 普通纸质卷票
12 机动车销售发票
13 二手车销售发票
15 通行费电子发票
26 数电发票（普通发票）
27 数电发票（增值税专用发票）
28 数电发票（航空运输电子客票行程单）
29 数电发票（铁路电子客票）
83 数电发票（机动车销售统一发票）
84 数电发票（二手车销售统一发票）
以上可查验的增值税发票调用后，返回查验后的发票数据，如果因为识别数据不准确导致查验失败，可以调【2.01发票查验】接口，修改传入正确的数据再次查验
二、非增值税发票，返回识别数据，如果识别数据有误，可以调【2.04发票编辑】接口，变更发票信息
三、本接口返回的发票结构参见：发票数据结构

请求参数

Query 参数

Header 参数

Body 参数application/json

示例

{
    "messageType": "recognitionCheck",
    "messageId": "string",
    "data": {
        "base64": "string",
        "fileDownUrl": "string",
        "fileType": "string",
        "verifyFlag": "string",
        "notCheck": "string",
        "billType": "string",
        "billId": "string",
        "orgNumber": "string",
        "taxNo": "string",
        "resource": "string",
        "companyInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ],
        "salerInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ]
    }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://cosmic-sandbox.piaozone.com/jdpjykjyxgs/kapi/app/rim/message?access_token=' \
--header 'access_token: {{access_token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "messageType": "recognitionCheck",
    "messageId": "string",
    "data": {
        "base64": "string",
        "fileDownUrl": "string",
        "fileType": "string",
        "verifyFlag": "string",
        "notCheck": "string",
        "billType": "string",
        "billId": "string",
        "orgNumber": "string",
        "taxNo": "string",
        "resource": "string",
        "companyInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ],
        "salerInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

示例

{
    "success": "string",
    "errorCode": "string",
    "message": "string",
    "data": [
        "string"
    ]
}

修改于 2025-09-15 03:13:45

2.01 发票查验

2.03 文件上传