票据识别API

API说明：票据识别接口，可根据上传的pdf、odf文件或图片识别票据信息
调用方式：HTTP协议
API编码：pdf.ofd.ocr.sync.request
调用方法：json格式

请求报文规范

{
    "data":"图片或PDF或OFD文件base64字符串",
    "multiple":"是否为多票据"
}

字段说明

数据项 名称 类型 长度 必须 说明
data 图片或PDF或OFD文件base64字符串 varchar 是 图片或PDF或OFD文件base64字符串，小于6M
multiple 是否为多票据 varchar 否 传1开启

返回报文规范

{
    "data": [{
        "request_id": "请求编号",
        "error_code": "0",
        "error_msg": "success",
        "count": 2,
        "list": [{
            "invoice_type": "0001",
            "check_status": "1",
            "ocr_data_list": [{
                "key": "invoice_code",
                "value": "1234567890"
            },{
                "key": "invoice_no",
                "value": "12345678"
            },{
                "key": "detail_list",
                "value": [[
                    {"key": "goods_name", "value": "商品1"},
                    ......
                ],
                [
                    {"key": "goods_name", "value": "商品2"},
                    ......


                ], 
                ......
                ]
            },
            {
                "key":"seal",
                "value":[
                    {"tax_id":"000000000000000"},
                    {"name":"公司名称"}
                ]
             } 
            ......     
            ]},
            ......   
            ]
        }
    ]
}

字段说明

数据项 名称 类型 长度 必须 说明
error_code 错误编码 varchar 10 0：识别成功
3115：部分票据无法识别
3116：部分票据请求失败
error_msg 错误信息 varchar
count 发票张数 varchar 10 部分识别成功时，返回数据条数可能小于发票张数
quest_id 请求编码 varchar 25
invoice_type 发票类型 varchar 10 票种编码表序号
check_status 查验状态 varchar 1 0：未查验
1：查验成功
2：查验失败
invoiceList 发票信息 List 详见增值税专用/普通/电子普票/电子专票
详见通行费电子普票
详见增值税卷式发票
详见机动车销售统一发票
详见二手车销售统一发票
详见出租车票
详见火车票
详见客运汽车票
详见机票行程单
详见车辆通行费
详见定额发票
详见其他类型

增值税专用/普通/电子普票/电子专票/数电专票/数电普票

数据项 名称 类型 长度 说明
invoice_code 发票代码 varchar 15
invoice_no 发票号码 varchar 15
electronic_number 数电发票号码 varchar 20
invoice_no_large_size 发票号码(大字) varchar 15 发票上方字体较大的发票号码;电子普票/电子专票该字段为空值
date 开票日期 varchar 20 格式：yyyy年MM月dd日
check_code 校验码 varchar 25 专用发票该字段为空值
pretax_amount 不含税金额 varchar 20
tax_amount_digits 价税合计(小写) varchar 20
tax_amount 价税合计(大写) varchar 30
tax_total 税额合计 varchar 20
sheet_type 发票联次 varchar 8 发票联/抵扣联,电子普票/电子专票该字段为空值
note 备注 varchar
payer_name 购方名称 varchar 100
payer_tax_id 购方纳税人识别号 varchar 25
payer_address 购方地址、电话 varchar 100
payer_bank_info 购方开户行及账号 varchar 100
seller_name 销方名称 varchar 100
seller_tax_id 销方纳税人识别号 varchar 25
seller_address 销方地址、电话 varchar 100
seller_bank_info 销方开户行及账号 varchar 100
receiptor 收款人 varchar 15
checker 复核人 varchar 15
issuer 开票人 varchar 15
machine_code 机器编号 varchar 20
cipher_text 密码区 varchar
detail_list 发票明细信息 数组 父节点，包含下面的字段
detail_no 明细编号 varchar 10
goods_name 货物名称 varchar 40
detail_amount 明细金额 varchar 22
num 数量 varchar 24
detail_tax_rate 税率 varchar 24
detail_tax_amount 税额 varchar 24
price 明细单价 varchar 24
specification_model 规格型号 varchar 100
unit 计量单位 varchar 10
tax_id 发票章税号 varchar 25
name 发票章公司名称 varchar 100
company_seal 是否有公司印章 varchar 0：没有；1：有
sheet_name 发票联 varchar
kind 发票消费类型 varchar
transit_mark 通行费标志 varchar
oil_mark 成品油标志 varchar
travel_tax 车船税 varchar
province 省 varchar
city 市 varchar
service_name 服务类型 varchar
item_names 品名 varchar
agent_mark 是否代开 varchar
acquisition_mark 是否收购 varchar
producer_stamp 监制单位 varchar
title 发票标题 varchar
print_code 机打代码 varchar
electronic_mark 电子标志 varchar
compa ny_seal_mark 是否有 “销售方（章）” 标记 varchar 0：没有；1：有

通行费电子普票

数据项 名称 类型 长度 说明
invoice_code 发票代码 varchar 15
invoice_no 发票号码 varchar 15
date 开票日期 varchar 20 格式：yyyy年MM月dd日
check_code 校验码 varchar 25
pretax_amount 不含税金额 varchar 20
tax_amount_digits 价税合计(小写) varchar 20
tax_amount 价税合计(大写) varchar 30
tax_total 税额合计 varchar 20
note 备注 varchar
payer_name 购方名称 varchar 100
payer_tax_id 购方纳税人识别号 varchar 25
payer_address 购方地址、电话 varchar 100
payer_bank_info 购方开户行及账号 varchar 100
seller_name 销方名称 varchar 100
seller_tax_id 销方纳税人识别号 varchar 25
seller_address 销方地址、电话 varchar 100
seller_bank_info 销方开户行及账号 varchar 100
machine_code 机器编号 varchar 20
receiptor 收款人 varchar OFD识别有该字段
checker 复核人 varchar OFD识别有该字段
issuer 开票人 varchar OFD识别有该字段
cipher_text 密码区 varchar OFD识别有该字段
detail_list 发票明细信息 数组 父节点，包含下面的字段
detail_no 明细编号 varchar 10
goods_name 货物名称 varchar 40
detail_amount 明细金额 varchar 22
detail_tax_rate 税率 varchar 24
detail_tax_amount 税额 varchar 24
plate_no 车牌号 varchar 40
type 类型 varchar 32
traffic_date_start 通行日期起 varchar 8 格式：yyyyMMdd
traffic_date_end 通行日期止 varchar 8 格式：yyyyMMdd
company_seal 是否有公司印章 varchar 0：没有；1：有
company_seal_mark 是否有 “销售方（章）” 标记 varchar 0：没有；1：有
kind 发票消费类型 varchar
transit_mark 通行费标志 varchar
province 省份 varchar
city 市 varchar
service_name 服务类型 varchar
item_names 品名 varchar
title 发票标题 varchar

增值税卷式发票

数据项 名称 类型 长度 说明
roll_invoice_code 发票代码 varchar 15
roll_invoice_no 发票号码 varchar 15
date 开票日期 varchar 20 格式：yyyy年MM月dd日
check_code 校验码 varchar 25
tax_amount_digits 价税合计(小写) varchar 20
tax_amount 价税合计(大写) varchar 30
payer_name 购方名称 varchar 100
payer_tax_id 购方纳税人识别号 varchar 25
seller_name 销方名称 varchar 100
seller_tax_id 销方纳税人识别号 varchar 25
category 种类 varchar 30 恒为空字符串
company_seal 是否有公司印章 varchar 1 恒为空字符串
province 省份 varchar 10 恒为空字符串
note 备注 varchar
receiptor 收款人 varchar 15
machine_code 机器编号 varchar 20
detail_list 发票明细信息 数组 父节点，包含下面的字段
goods_name 货物名称 varchar 40
num 数量 varchar 22
price 明细单价 varchar 24
detail_amount 明细金额 varchar 24
detail_tax_rate 税率 varchar 24
kind 发票消费类型 varchar
city 市 varchar
service_name 服务类型 varchar
item_names 品名 varchar
title 发票标题 varchar
print_code 机打代码 varchar
print_no 机打号码 varchar

机动车销售统一发票

数据项 名称 类型 长度 说明
vehicle_sales_invoice_code 发票代码 varchar 15
vehicle_sales_invoice_no 发票号码 varchar 15
print_code 机打代码 varchar 20
print_no 机打号码 varchar 20
date 开票日期 varchar 20 格式：yyyy年MM月dd日
amount 车价合计(小写) varchar 20
amount_capitalization 车价合计(大写) varchar 30
tax 增值税税额 varchar 30
sheet_type 发票联次 varchar 8 发票联/抵扣联
buyer_id 买方单位代码/身份证号码 varchar 30
buyer_tax_id 购方纳税人识别号 varchar 30
buyer_name 购方名称 varchar 50
certificate_no 合格证号 varchar
cipher_text 税控码 varchar
import_no 进口证明书号 varchar
inspection_no 商检单号 varchar
issuer 开票人 varchar
limit_passengers 限乘人数 varchar
machine_code 机器编号 varchar
production_place 产地 varchar
seller_address 销方地址 varchar
seller_bank 销方开户行 varchar
seller_bank_account 销方账号 varchar
seller_name 销方名称 varchar
seller_phone 销方电话 varchar
seller_tax_id 销方纳税人识别号 varchar
tax_gov_name 主管税务机关 varchar
tax_gov_no 主管税务机关代码 varchar
tax_payment_receipt 完税凭证号码 varchar
tax_rate 税率 varchar
ton 吨位 varchar
vehicle_engine_no 发动机号码 varchar
vehicle_model 厂牌型号 varchar
vehicle_type 车辆类型 varchar
vehicle_vin 车辆识别代码 varchar
province 省份 varchar
city 市 varchar
producer_stamp 监制单位 varchar
title 发票标题 varchar
buyer_bank_account 买方开户行 varchar
company_seal 是否有公司印章 varchar 0：没有；1：有
sheet_name 发票联 varchar
sheet_type 发票联次 varchar
max_people_num 限乘人数 varchar

二手车销售统一发票

数据项 名称 类型 长度 说明
used_vehicle_sales_invoice_code 发票代码 varchar 15
used_vehicle_sales_invoice_no 发票号码 varchar 15
print_code 机打代码 varchar 20
print_no 机打号码 varchar 20
date 开票日期 varchar 20 格式：yyyy年MM月dd日
amount 价税合计(小写) varchar 20
amount_capitalization 价税合计(大写) varchar 30
sheet_type 发票联次 varchar 8 发票联/抵扣联
auction_company 经营拍卖单位 varchar
auction_company_address 经营拍卖单位地址 varchar
auction_company_bank_account 经营拍卖单位开户银行账号 varchar
auction_company_phone 经营拍卖单位电话 varchar
auction_company_tax_id 经营拍卖单位纳税人识别号 varchar
buyer_address 买方单位/个人住址 varchar
buyer_id 买方单位代码/身份证号码 varchar
buyer_name 买方单位/个人 varchar
buyer_phone 买方电话 varchar
cipher_text 税控码 varchar
gov_name_from 转入地车辆管理所名称 varchar
issuer 开票人 varchar
license_plate 车牌照号 varchar
machine_code 机器编号 varchar
market_address 二手车市场单位地址 varchar
market_bank_account 二手车市场开户银行账号 varchar
market_name 二手车市场名称 varchar
market_phone 二手车市场电话 varchar
market_tax_id 二手车市场纳税人识别号 varchar
notes 备注 varchar
register_no 登记证号 varchar
seller_address 卖方单位/个人住址 varchar
seller_id 卖方单位代码/身份证号码 varchar
seller_name 卖方单位/个人 varchar
seller_phone 卖方电话 varchar
vehicle_model 厂牌型号 varchar
vehicle_type 车辆类型 varchar
vehicle_vin 车架号/车辆识别代码 varchar
kind 发票消费类型 varchar
province 省份 varchar
city 市 varchar
producer_stamp 监制单位 varchar
title 发票标题 varchar
company_seal 是否有公司印章 varchar 0：没有；1：有
sheet_name 发票联 varchar
sheet_type 发票联次 varchar

出租车票

数据项 名称 类型 长度 说明
taxi_ticket_code 发票代码 varchar 15
taxi_ticket_no 发票号码 varchar 15
date 开票日期 varchar 20 格式：yyyy年MM月dd日
amount 金额 varchar 20
boarding_time 上车时间 varchar 10 格式：HH:mm
landing_time 下车时间 varchar 10 格式：HH:mm
province 乘车省份 varchar 10
taxi_no 车号 varchar 10
mileage 里程 varchar 10
surcharge 附加费 varchar
place 发票所在地 varchar
kind 发票消费类型 varchar
city 乘车市 varchar
producer_stamp 监制章 varchar
fare 车费 varchar

火车票

数据项 名称 类型 长度 说明
date_time 乘车时间 varchar 20 格式：yyyy年MM月dd日HH:mm
amount 金额 varchar 20
passenger_name 乘客名称 varchar 15
passenger_id 乘客身份证 varchar 30
train_no 车次号 varchar 10
departure_station 出发地 varchar 15
terminus 目的地 varchar 15
seat_type 座位类别 varchar 10
seat_info 座位号 varchar 30
train_ticket_invoice_no 票据编号 varchar 20
serial_number 火车票ID varchar 30
purchase_type 购票方式 varchar 10
issuing_station 售票站 varchar 15
boarding_gate 检票口 varchar 20
date 乘车日期 varchar
kind 发票消费类型 varchar

客运汽车票

数据项 名称 类型 长度 说明
bus_ticket_code 发票代码 varchar 15
bus_ticket_no 发票号码 varchar 15
date 发车日期 varchar 20 格式：yyyy年MM月dd日
amount 合计金额(小写) varchar 20
time 发车时间 varchar 10 格式：HH:mm
departure_station 出发站 varchar 15
terminus 到达站 varchar 15
passenger_name 姓名 varchar 15
kind 发票消费类型 varchar
passenger_id 身份证号 varchar
producer_stamp 监制章 varchar
title 发票标题 varchar
insurance 保险费 varchar

机票行程单

数据项 名称 类型 长度 说明
issue_date 开票日期 varchar 20 格式：yyyy-MM-dd
amount 合计金额 varchar 20
e_ticket_no 电子客票号码 varchar 20
passenger_id 身份证件号码 varchar 30
passenger_name 旅客姓名 varchar 15
agent_code 销售单位代码 varchar 20
agent_num 销售单位号码 varchar 30
air_transport_serial_number 印刷序号 varchar 20
caac 民航发展基金 varchar 20
check_code 验证码 varchar 25
fare 票价 varchar 20
fuel_surcharge 燃油附加费 varchar 20
GPCN 政府采购监管号 varchar 20
insurance 保险费 varchar 10
other_taxes 其它税费 varchar 20
issued_by 填开单位 varchar 50
flights 航班信息 数组 不定 父节点，包含下面的字段
depart 出发站 varchar 15
arrive 到达站 varchar 15
seat_type 座位等级 varchar 10
flight_date 航班日期 varchar 10 格式：yyyy-MM-dd
flight_time 航班时刻 varchar 5 格式：HH:mm
flight_no 航班号 varchar 20
carrier 承运人 varchar
allow 免费行李 varchar
kind 发票消费类型 varchar
international_flag 国内国际标签 varchar
endorsement 签注 varchar
title 标题 varchar
voucher_mark 电子凭证标记 varchar

车辆通行费

数据项 名称 类型 长度 说明
vehicle_toll_code 发票代码 varchar 15
vehicle_toll_no 发票号码 varchar 15
date 开票日期 varchar 20 格式：yyyy年MM月dd日
amount 合计金额(小写) varchar 20
time 时间 varchar 10 格式：HH:mm
entrance 入口 varchar 15
exit 出口 varchar 15
kind 发票消费类型 varchar
highway_flag 高速标志 varchar 0：没有；1：有
producer_stamp 监制单位 varchar
title 标题 varchar

定额发票

数据项 名称 类型 长度 说明
quota_invoice_code 发票代码 varchar 15
quota_invoice_no 发票号码 varchar 15
amount 合计金额(小写) varchar 20
amount_capitalization 金额(大写) varchar 10
company_seal 是否有公司印章 varchar 20 0：没有；1：有
province 省份 varchar 15 恒为空字符串
kind 发票消费类型 varchar
city 市 varchar
producer_stamp 监制单位 varchar
title 发票抬头 varchar
stamp_info 发票专用章内容 varchar
non_commercial_mark 非经营性标志 varchar 0：没有；1：有

完税证明

数据项 名称 类型 长度 说明
paid_tax_no 发票号码 varchar
tax_amount_digits 价税合计(小写) varchar
tax_amount 价税合计(大写) varchar
payer_name 购方名称 varchar
payer_tax_id 购方纳税人识别号 varchar
date 开票日期 varchar 格式：yyyy年MM月dd日
seller_name 销方名称 varchar
seller_tax_id 销方纳税人识别号 varchar
company_seal 是否有公司印章 varchar 0：没有；1：有
sheet_type 发票联次 varchar
kind 发票消费类型 varchar
issuer 开票人 varchar
note 备注 varchar
goods_name 品目名称 varchar
title 标题 varchar

机打发票

数据项 名称 类型 长度 说明
machine_invoice_code 发票代码 varchar
machine_invoice_no 发票号码 varchar
date 开票日期 varchar
time 开票时间 varchar
check_code 校验码 varchar
category 种类 varchar
tax_amount_digits 价税合计(小写) varchar
tax_amount 价税合计(大写) varchar
seller_name 销方名称 varchar
seller_tax_id 销方纳税人识别号 varchar
payer_name 购方名称 varchar
payer_tax_id 购方纳税人识别号 varchar
kind 发票消费类型 varchar
province 省份 varchar
city 市 varchar
company_seal 是否有公司印章 varchar 0：没有；1：有
producer_stamp 监制单位 varchar
title 标题 varchar
goods_name 货物名称 varchar
unit 计量单位 varchar
num 数量 varchar
price 明细单价 varchar
detail_amount 明细金额 varchar

网约车出行行程单

数据项 名称 类型 长度 说明
date 申请日期 varchar
date_start 行程开始时间 varchar
date_end 行程结束时间 varchar
passenger_phone 行程人手机号 varchar
amount 合计金额(小写) varchar
car_type 车型 varchar
time_geton 上车时间 varchar
city 城市 varchar
title 标题 varchar
station_geton 起点 varchar
station_getoff 终点 varchar
mileage 里程（公里） varchar
items_amount 行程金额 varchar
producer 服务商 varchar
time_order 下单时间 varchar
kind 发票消费类型 varchar

火车票退票费

数据项 名称 类型 长度 说明
refund_trainticket_code 发票代码 varchar
refund_trainticket_no 发票号码 varchar
amount 合计金额(小写) varchar
kind 发票消费类型 varchar
province 省份 varchar
city 市 varchar
company_seal 是否有公司印章 varchar 0：没有；1：有
title 标题 varchar
stamp_info 发票章内容 varchar

船票

数据项 名称 类型 长度 说明
steamer_ticket_code 发票代码 varchar
steamer_ticket_no 发票号码 varchar
date 日期 varchar
time 时间 varchar
station_geton 起点 varchar
station_getoff 终点 varchar
amount 合计金额(小写) varchar
passenger_name 乘客名称 varchar
kind 发票消费类型 varchar
province 省份 varchar
city 市 varchar
currency_code 币种 varchar

其他类型

数据项 名称 类型 长度 说明
other_invoice_code 发票代码 varchar 15
other_invoice_no 发票号码 varchar 15
date 开票日期 varchar 20 格式：yyyy-MM-dd
amount 合计金额(小写) varchar 20
kind 发票消费类型 varchar

票种编码表

序号 说明
0001 增值税专用发票
0003 机动车销售统一发票
0004 增值税普通发票
0008 增值税电子专票
0009 通行费电子普票
0010 增值税电子普票
0011 增值税卷式发票
0012 数电专票
0013 数电普票
0014 车辆通行费发票
0015 二手车销售统一发票
0016 机打发票
1001 出租车发票
1002 火车票
1003 客运汽车票
1004 航空运输电子客票行程单
1005 船票
1006 网约车出行行程单
1007 火车票退票费
1010 定额发票（包含停车票、地铁票、手撕票等多种定额票据）
1014 完税证明
1111 其他类型
Copyright © Shanghai Aisino Co.,Ltd 版权所有 侵权必究该文件修订时间： 2025-03-31 16:08:29

results matching ""

    No results matching ""