2.01 发票查验 - 发票云(旗舰版)API文档

请求参数

Query 参数

access_token

string

token

必需

Header 参数

access_token

string

可选

默认值:

Body 参数application/json

messageType

enum<string>

必需

接口类型:invoiceCheck

枚举值:

invoiceCheck

messageId

string

请求id

必需

data

object

请求参数

必需

invoiceCode

string

可选

发票代码，数电票不填

<= 12 字符

invoiceNo

string

发票号码

必需

<= 20 字符

invoiceDate

string

开票日期

必需

checkCode

string

可选

校验码，增值税普通发票、通行费必填

<= 20 字符

invoiceAmount

number

可选

发票金额，增值税专用发票不含税金额，数电票是价税合计

resource

string

可选

数据来源，系统默认值“第三方”

<= 10 字符

orgNumber

string

可选

星瀚组织编码，用于查询星瀚的核算组织组织，覆盖更新发票在全票池的所属核算组织；

<= 30 字符

taxNo

string

可选

企业税号，用于查询星瀚的核算组织，，覆盖更新发票在全票池的所属核算组织；需要在“发票云-基础资料-企业管理-企业信息”列表中维护税号与组织的关系

<= 20 字符

verifyFlag

string

可选

是否返回合规性校验结果, 1-是，0-否

billType

string

可选

单据类型，verifyFlag为1时必填

<= 20 字符

companyInfo

array [object {2}]

合规性校验企业信息

可选

示例

{
    "messageType": "invoiceCheck",
    "messageId": "string",
    "data": {
        "invoiceCode": "string",
        "invoiceNo": "string",
        "invoiceDate": "string",
        "checkCode": "string",
        "invoiceAmount": 0,
        "resource": "string",
        "orgNumber": "string",
        "taxNo": "string",
        "verifyFlag": "string",
        "billType": "string",
        "companyInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ]
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

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": "invoiceCheck",
    "messageId": "string",
    "data": {
        "invoiceCode": "string",
        "invoiceNo": "string",
        "invoiceDate": "string",
        "checkCode": "string",
        "invoiceAmount": 0,
        "resource": "string",
        "orgNumber": "string",
        "taxNo": "string",
        "verifyFlag": "string",
        "billType": "string",
        "companyInfo": [
            {
                "taxNo": "string",
                "name": "string"
            }
        ]
    }
}'

返回响应

🟢200成功

application/json

Body

success

string

必需

true或false

errorCode

string

必需

0000：成功
1001:该发票今日已查验5次，超过税局当日查验次数，请明日再上传
1002:地方税局网络不稳定，请稍后再试
3109:该企业查验次数已用完，请联系管理员
0005:请求参数不合法
0006:数据不符，请点【编辑】检查*号项与票面是否一致，不一致项可修改后再查验
0009:所查发票不存在，请联系开票方确认
1007:鉴权失败，请联系管理员确认企业有可用权益
1004:该企业查验次数已用完，请联系管理员
1005:发票不规范，请点编辑按钮检查必填字段是否正确
1006:地方税局网络不稳定，请稍后再试
1008:必传参数不能为空
1009:参数长度不正确
1021:网络超时
3110:地区税局发票查验服务暂停，请联系管理员
1015:抱歉，超过5年的发票不可查验！若发票信息有误可编辑保存后再查验
1014:该发票暂未上传税局底账库，请明天再试
0301:查验服务异常，请联系管理员
0313:发票日期格式错误
0314:校验码与不含税金额不能同时为空
0315:发票代码不能为空
0316:发票号码不能为空
0001:该应用没有查验权限
0002:该应用查验权限过期
1132:调用接口服务错误，请稍后再试
4003:发票代码长度只能为12或者10
4005:发票号码长度只能为8
4006:发票类型不能为空
4007:发票类型内容错误
4008:开票日期不能为空
4012:校验码长度必须为6
3999:税局端口异常，请稍后重新进行查验
4999:不查验
1022:查验请求超时，请稍后再试
A0201:非法的客户ID，请联系管理员

message

string

结果描述

必需

data

object

必需

发票结构：发票数据结构

示例

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