简要描述:
- 输入发票号码、发票代码等信息,输出核验结果
- 支持增值税发票、全电发票、新车销售发票、二手车销售发票的真假验证;
- 支持近5年开具的发票查询,当天开具发票需等1-3天更新后才可查;
请求URL:
接口地址:https://gauss.shargoodata.com/gauss/api/invoice_verify.json
请求方式: POST
数据类型:x-www-form-urlencoded
请求头:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
token | 是 | string | token |
请求参数:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
serviceName | 是 | string | 输入:invoice_verify |
platformNo | 是 | string | 商户号 |
reqData | 是 | string | 请求json的字符串 示例: {“type”:”01”,”no”:”37163077”,”code”:”3100223130”,”codeLast6”:””,”total”:”24993.84”,”createDate”:”20230907”,”outside_no”:”123456”,”timestamp”:”2023-09-19-17-34-15”} |
reqData参数:
参数code | 是否必须 | 类型 | 参数名称 | 说明 |
---|---|---|---|---|
type | 是 | string | 发票类型 | 必填 |
no | 是 | string | 发票号码 | 必填 |
code | 是 | string | 发票代码 | 必填,发票类型16/18/19内容可为空,但字段要传; |
codeLast6 | 是 | string | 校验码后六位 | 必填,专票/03/15/16/18/19发票类型,内容可为空;17类型,传入5位校验码; |
total | 是 | string | 发票金额(不含税) | 必填,04/11/14可为空;02/09/10/15/16/18/19,则填写“价税合计”金额; |
createDate | 是 | string | 开票日期 yyyyMMdd | 日期格式20220804 |
outside_no | 是 | string | 外部订单编号 | |
timestamp | 是 | string | yyyy-MM-dd-HH-mm-ss格式时间 |
发票类型取值:
取值 | 说明 | 描述 |
---|---|---|
01 | 增值税专票 | |
02 | 货运运输业增值税专票 | |
03 | 机动车统一销售发票 | |
04 | 增值税普票 | |
09 | 增值税电子专票 | |
10 | 增值税电子普票 | |
11 | 增值税普票(卷式) | |
14 | 通行费发票 | |
15 | 二手车销售发票 | |
16 | 全电专票/全电普票 | |
17 | 区块链发票(目前只支持深圳地区) | |
18 | 全电发票(机动车销售统一发票) | |
19 | 全电发票(二手车销售统一发票) |
返回示例:
正确时返回:
{
"success":true,
"outside_no":"02ceafe2-fff9-4ab7-993a-544433371fa7",
"data":{
"note":"xxx",
"tounit_name":"xxx有限公司",
"production_addr":"合肥市",
"tax_authority_code":"xxx",
"import_no":"无",
"buyer_id":"6xxxx",
"status":"0",
"total":"108761.06",
"engine_no":"xxxx",
"seller_name":"多用途乘用车",
"buyer_tax_no":"",
"tonnage":"-",
"zztax":"14138.94",
"create_date":"20191208",
"cancel_flag":"N",
"receive_bank":"xxxx支行",
"amount":"122900.00",
"address":"陕西省xxxxx",
"cert_no":"Yxxxx",
"zztax_rate":"13",
"tax_authority_name":"国家税务总局xxxxxx",
"chinese_key":"xxxxx",
"invoice_no":"0xxxx",
"buyer_tax_name":"张三",
"vehicle_type":"长安牌xxxx",
"verify_date":"2020-12-17 05:02:05",
"invoice_code":"1xxxx",
"phone":"xxxxx-xxxx",
"seller_tax_no":"xxxxx",
"proof_num":"",
"verify_count":"10",
"test_no":"无",
"account":"xxxxxxxx",
"limit_num":"5"
}
}
错误时返回:
{
"success":false,
"outside_no":"a77acba0-a681-4f9c-8245-d14aa8119aa0",
"error_code":"400",
"message":"请求参数错误"
}
返回参数说明:
参数名 | 是否必须 | 类型 | 说明 |
---|---|---|---|
success | 是 | boolean | true:处理成功 false:处理失败 |
outside_no | 是 | string | 外部订单编号 |
data | 否 | json | 识别数据 |
error_code | 否 | string | 错误代码 |
message | 否 | string | 错误描述 |
data返回参数说明:
参数名 | 说明 | 描述&备注 |
---|---|---|
invoice_code | 发票代码 | |
invoice_no | 发票号码 | |
verify_count | 查验次数 | |
create_date | 开票日期 | |
buyer_name | 购方名称 | |
inv_status/status | 发票状态 | 全电发票(机动车销售发票)和全电发票(二手车销售发票)返回status,其他发票类型返回inv_status; 0 : 蓝票 ; 10 : 作废 ; 20 : 红票 ; 30 : 红冲 |
buyer_tax_no | 购方纳税人识别号 | |
buyer_address | 购方地址电话 | |
buyer_bank_info | 购方开户行及账号 | |
seller_name | 销方名称 | |
seller_tax_no | 销方纳税人识别号 | |
seller_address | 销方地址电话 | |
seller_bank_info | 销方开户行及账号 | |
total | 合计金额 | |
total_tax | 合计税额 | |
amount | 价税合计 | |
note | 备注 | |
machine_no | 机器编号 | |
check_code | 校验码 | |
cancel_flag | 作废标志,取值Y/N | |
productO_oil_flag | 成品油标志,取值Y/N | |
verify_date | 查验时间 | |
detail_list | 货物明细列表 | name 货物或应税劳务名称子节点, type 单位子节点, unit 数量子节点, count 单价子节点, unit_price 金额子节点, amount 税率子节点, tax 税额子节点 |
error_code参数说明:
参数名 | 说明 |
---|---|
404 | 发票不一致 |
401 | 查无记录 |
402 | 所查发票不存在 |
403 | 超过该张票当天查验次数 |
405 | 查询发票不规范 |
406 | 发票代码格式错误 |
400 | 请求参数错误 |
文档更新时间: 2025-08-01 09:39 作者:admin