Skip to main content
POST
/
doc-agent
/
api
/
v1
/
capability
/
vat-invoice
/
verify
cURL
curl --request POST \
  --url https://agents.textin.com/doc-agent/api/v1/capability/vat-invoice/verify \
  --header 'Content-Type: application/json' \
  --header 'x-ti-app-id: <x-ti-app-id>' \
  --header 'x-ti-secret-code: <x-ti-secret-code>' \
  --data '
{
  "invoice_code": "",
  "invoice_date": "20260202",
  "invoice_no": "26330000009400012345",
  "invoice_sum": "7282.03",
  "verify_code": ""
}
'
{
  "code": 200,
  "data": {
    "result": {
      "code": "001",
      "data": {
        "all_tax": "436.92",
        "all_valorem_tax": "7718.95",
        "check_code": "26330000009400012345",
        "cyjgxx": "查验成功发票一致",
        "detail_list": [
          {
            "all_tax": "436.92",
            "detail_amount": "7282.03",
            "detail_no": "1",
            "goods_name": "*企业管理服务*市场管理",
            "row_no": "1",
            "tax_classify_code": "3040801990000000000",
            "tax_rate": "6"
          }
        ],
        "inspection_amount": "5",
        "invalid_mark": "N",
        "invoice_code": "",
        "invoice_date": "20260202",
        "invoice_money": "7282.03",
        "invoice_number": "26330000009400012345",
        "invoice_type": "31",
        "machine_code": "",
        "note": "购方开户银行:招商银行股份有限公司某某支行 银行账号:120919530XXXXXX",
        "purchaser_bank_and_number": "购方开户银行:招商银行股份有限公司某某支行 银行账号:120919530XXXXXX",
        "purchaser_name": "某某互联网科技有限公司",
        "purchaser_taxpayer_number": "91440101MAXXXXXXX3",
        "saler_address_or_phone": "浙江省杭州市滨江区某某路1750号某某中心2005室 138****8845",
        "saler_bank_and_number": "销方开户银行:杭州银行股份有限公司滨江支行 银行账号:330104106000XXXXXXX",
        "saler_name": "某某贸易有限公司",
        "saler_taxpayer_number": "91330108MAXXXXXXX7",
        "seller_unit_or_individual": "某某贸易有限公司"
      },
      "invalid_mark": "N",
      "invoice_code": "",
      "invoice_date": "20260202",
      "invoice_number": "26330000009400012345",
      "invoice_type": "31",
      "message": "成功",
      "purchaser_taxpayer_number": "91440101MAXXXXXXX3"
    }
  },
  "message": "OK"
}

支持的发票类型

类型代码发票类型
01增值税专用发票
02货运运输业增值税专用发票
03机动车销售统一发票
04增值税普通发票
10增值税普通发票(电子)
11增值税普通发票(卷式)
14增值税普通发票(通行费)
15二手车销售统一发票
20增值税电子专用发票
31电子发票(增值税专用发票)
32电子发票(增值税普通发票)
51电子发票(铁路电子客票)
61电子发票(航空运输电子客票行程单)
83电子发票(机动车销售统一发票)
84电子发票(二手车销售统一发票)
85全电发票(纸质专用发票)
86数电纸质发票(普通发票)
87电子发票(通行费)

参数必填规则

invoice_code(发票代码)

全电发票(类型代码 31, 32, 51, 61, 83, 84, 87)时非必填,其他发票类型必填

invoice_sum(金额)

发票类型代码为 01, 03, 15, 20, 31, 32, 51, 61, 83, 84, 85, 87 时必填,填写内容因类型而异:
适用类型代码填写内容
01, 03, 20, 85不含税金额
15, 84车价合计
31, 32, 51, 61, 83, 87含税金额

verify_code(校验码)

发票类型代码为 04, 10, 11, 14, 86 时必填,取后六位。其中类型 86 填写密码区数电票号码后六位。

作废标志(invalid_mark)

标志含义
N正常
Y已作废
H红冲
7部分红冲
8全额红冲

验证状态码与扣费说明

响应中 data.result.code 的含义如下:
错误码说明是否扣费
001成功,验证为真
002此发票今日查询次数已达上限(5次),请次日查询
005请求不合法,请核对验真参数
006发票信息不一致,请核对发票信息
009查无此票,请核对发票信息
104已超过最大查验量
105查询发票不规范,请核对发票信息
106查验异常,国税局/发票查验地区升级维护,请稍后重试
107鉴权失败
108参数不为空
109参数长度不正确
110参数 invoice_code 的格式或取值范围错误
111参数 invoice_sum 的格式或取值范围错误
112参数 verify_code 的格式或取值范围错误
113参数 invoice_no 的格式或取值范围错误
114校验码不正确,应为后六位
115超过服务有效期限限制
116此发票今日查询次数已达上限(5次),请次日查询
1005请核对验真参数是否符合发票规范
1010日期格式不正确(YYYYMMDD)
1011请求参数不完整
1021查验异常,国税局/发票查验地区升级维护,请稍后重试
10014日期当天不能查验
10015开票金额:不合法的格式
10016检验码:不能为空
10017超过五年的不能查验
10018检验码:不合法的长度
10020没有查验权限

Headers

x-ti-app-id
string
required
x-ti-secret-code
string
required

Body

application/json
invoice_code
string

发票代码,全电发票(发票类型代码为 31, 32, 51, 61, 83, 84, 87)时非必填,其他发票类型必填

invoice_date
string

开票日期(必填,格式: yyyyMMdd,如 "20190203")

invoice_no
string

发票号码(必填)

invoice_sum
string

金额,非必填。发票类型代码为 01, 03, 15, 20, 31, 32, 51, 61, 85, 83, 84, 87 时必填:

  • 为 01, 03, 20, 85 时填写发票不含税金额
  • 为 15, 84 时填写发票车价合计
  • 为 31, 32, 51, 61, 83, 87 时填写含税金额
  • 其它可为空
verify_code
string

机器验证码,非必填,取后六位。发票类型代码为 04, 10, 11, 14, 86 时必填(填写密码区数电票号码后六位), 发票类型代码为 86 时填写密码区数电票号码后六位,其他发票种类可为空

Response

200 - application/json

OK

code
integer

业务状态码

Example:

200

data
object
message
string

状态说明

Example:

"OK"