简要描述:
- 输入发票号码、发票代码等信息,输出核验结果
- 支持增值税发票、全电发票、新车销售发票、二手车销售发票的真假验证;
请求URL:
请求方式:
请求数据类型:
请求头:
参数名 |
是否必须 |
类型 |
说明 |
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参数:
参数名 |
是否必须 |
类型 |
说明 |
type |
是 |
string |
发票类型 |
no |
是 |
string |
发票号码 |
code |
是 |
string |
发票代码(全电专票/全电普票为空) |
codeLast6 |
是 |
string |
校验码后六位(专票/机动车统一销售发票/二手车销售发票/全电发票,为空) |
total |
是 |
string |
不含税金额,普票可为空(全电专票/全电普票/二手车销售发票,则填写“价税合计”金额) |
createDate |
是 |
string |
开票日期 yyyyMMdd |
outside_no |
是 |
string |
外部订单编号 |
timestamp |
是 |
string |
yyyy-MM-dd-HH-mm-ss格式时间 |
发票类型取值:
取值 |
说明 |
01 |
增值税专票 |
02 |
货运运输业增值税专票 |
03 |
机动车统一销售发票 |
04 |
增值税普票 |
09 |
增值税电子专票/ 全电普票 / 全电专票 |
10 |
增值税电子普票 |
11 |
增值税普票(卷式) |
14 |
通行费发票 |
15 |
二手车销售发票 |
返回示例:
正确时返回:
{
"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",
"inv_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 |
是否扣费 |
outside_no |
是 |
string |
外部订单编号 |
data |
否 |
json |
识别数据 |
error_code |
否 |
string |
错误代码 |
message |
否 |
string |
错误描述 |
data参数说明:
01 、04 、10返回参数说明
参数名 |
说明 |
invoice_code |
发票代码 |
invoice_no |
发票号码 |
verify_count |
查验次数 |
create_date |
开票日期 |
buyer_name |
购方名称 |
inv_status |
发票状态(详情见inv_status参数说明) |
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 |
税额子节点 |
inv_status参数说明
参数名 |
说明 |
0 |
蓝票 |
10 |
作废 |
20 |
红票 |
30 |
红冲 |
11返回参数说明
参数名 |
说明 |
invoice_code |
发票代码 |
invoice_no |
发票号码 |
verify_count |
查验次数 |
create_date |
开票日期 |
buyer_name |
购方名称 |
seller_name |
销方名称 |
seller_tax_no |
销方纳税人识别号 |
buyer_tax_no |
购方纳税人识别号 |
machine_no |
机器编号 |
total_tax |
合计税额 |
amount |
价税合计 |
note |
备注 |
check_code |
校验码 |
total |
合计金额 |
receiver |
收款员 |
cancel_flag |
作废标志,取值Y/N |
productO_oil_flag |
成品油标志,取值Y/N |
verify_date |
查验时间 |
detail_list |
货物明细列表 |
item |
项目子节点 |
count |
单价子节点 |
unit_price |
含税单价 子节点 |
amount |
含税金额 子节点 |
03机动车销售统一发票返回参数说明
参数名 |
说明 |
invoice_code |
发票代码 |
invoice_no |
发票号码 |
verify_count |
查验次数 |
create_date |
开票日期 |
chinese_key |
机器编码 |
buyer_tax_name |
购买方名称 |
buyer_id |
身份证号码/组织机构代码 |
buyer_tax_no |
购方纳税人识别号 |
seller_name |
车辆类型 |
vehicle_type |
厂牌型号 |
production_addr |
产地 |
cert_no |
合格证号 |
total |
不含税价(合计) |
test_no |
商检单号(合计) |
engine_no |
发动机号 |
note |
车辆识别代号/车架号码 |
import_no |
进口证明书号 |
tounit_name |
销货单位名称 |
phone |
电话 |
seller_tax_no |
销方纳税人识别号 |
account |
账号 |
address |
地址 |
receive_bank |
开户银行 |
zztax_rate |
增值税税率或征收率 |
zztax |
增值税税额 |
tax_authority_code |
主管税务机关代码 |
amount |
价税合计 |
proof_num |
完税凭证号码 |
tonnage |
吨位 |
limit_num |
限乘人数 |
cancel_flag |
作废标志 |
tax_authority_name |
主管税务机关名称 |
verify_date |
查验时间 |
03二手车发票返回参数说明
参数名 |
说明 |
invoice_code |
发票代码 |
invoice_no |
发票号码 |
verify_count |
查验次数 |
create_date |
开票日期 |
chinese_key |
机器编码 |
buyer_tax_name |
购买方名称 |
buyer_tax_no |
买方单位代码/身份证号 |
buyer_tax_address |
买方单位/个人住址 |
buyer_tax_phone |
买方电话 |
car_license |
车牌照号 |
register_no |
登记证号 |
seller_name |
车辆类型 |
total |
车价合计 |
car_no |
车辆识别代号/车架号码 |
vehicle_type |
厂牌型号 |
unit_name |
转入地车辆车管所名称 |
selier_name |
卖方单位/个人 |
selier_id |
卖方单位代码/身份证号 |
selier_tax_address |
卖方单位/个人住址 |
selier_tax_phone |
卖方电话 |
jy_unit |
经营、拍卖单位 |
jy_address |
经营、拍卖单位地址 |
jy_tax_no |
经营、拍卖单位纳税人识别号 |
bank_account |
经营、拍卖单位开户银行及账号 |
jy_phone |
经营、拍卖单位电话 |
Used_car_market |
二手车市场 |
Used_car_no |
二手车市场纳税人识别号 |
Used_car_address |
二手车市场地址 |
Used_car_bankno |
二手车市场开户银行及账号 |
Usedcar_matker_phone |
二手车市场电话 |
cancel_flag |
作废标志 |
remark |
备注 |
verify_date |
查验时间 |
error_code参数说明:
参数名 |
说明 |
404 |
发票不一致 |
401 |
查无记录 |
402 |
所查发票不存在 |
403 |
超过该张票当天查验次数 |
405 |
查询发票不规范 |
406 |
发票代码格式错误 |
400 |
请求参数错误 |
文档更新时间: 2024-06-04 16:34 作者:admin