简要描述:

  • 输入发票号码、发票代码等信息,输出核验结果
  • 支持增值税发票、全电发票、新车销售发票、二手车销售发票的真假验证;

请求URL:

请求方式:

  • 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参数:
参数名 是否必须 类型 说明
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