注册
文档中心
API调试

功能描述

支持对多种票据类型(多票据)票据切分、票据分类、票据识别,包括增值税普通发票、增值税普通发票(卷票)、增值税专用发票、增值税电子专用发票、增值税电子普通发票、货物运输业增值税专用发票、机动车销售统一发票、二手车销售统一发票、通用机打发票、通用定额发票、旅客运输普票、公路客运发票、船运客票、出租车发票、停车费发票、过路过桥费发票、教育费收据、行程单、火车票、增值税销货清单和其他可报销票据。

请求URL

https://api.textin.com/robot/v1.0/api/bills_crop

HTTP请求方法

HTTP POST

请求头说明(Request Header)

请在HTTP请求中添加以下自定义Header。

header 名
x-ti-app-id 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-app-id
x-ti-secret-code 请登录后前往 “工作台-账号设置-开发者信息” 查看 x-ti-secret-code

URL 参数

参数名 描述
crop_complete_image 选填,选择是否需要输出各票据图片,1为输出各票据图片,0为不输出各票据图片,默认为0
crop_complete_image_resize 选填,crop_complete_image为1时控制返回图片缩放比,传入参数大于0,默认为1
crop_value_image 选填,选择是否返回关键字段切图图片,1为输出字段图片,0为不输出字段图片,默认为0

请求体说明(Request Body)

Content-Type: application/octet-stream

待识别的文件二进制流,支持jpg、jpeg、png、bmp、pdf(支持识别pdf第一页)、ofd (增值税ofd格式)等文件格式。

请注意,请求体的数据格式为文件的二进制流,非 FormData 或其他格式。文件大小不超过 10M,图像宽高须介于 20 和 10000(像素)之间。

响应体说明(Response Data)

Content-Type:application/json

JSON结构说明如下:

字段名 类型 描述
code integer 错误码,详见“错误码说明”
message string 返回对应code的状态说明
result object 识别结果
+ object_list array 多张票据OCR识别结果集合
++ image_angle integer 切分后单张票据的角度
++ rotated_image_width integer 切分后单张票据转正后的宽度
++ rotated_image_height integer 切分后单张票据转正后的高度
++ position array 切分后单张票据在原图中的坐标位置[0,1,2,3,4,5,6,7],(0, 1) 左上角坐标,(2, 3) 右上角坐标,(4, 5) 右下角坐标,(6, 7) 左下角坐标
++ class string 切分后单张票据的大类类型,详见下方 class 返回值说明
++ type string 切分后单张票据类型,详见下方 type 返回值说明
++ type_description string 切分后单张票据类型中文描述
++ kind string 切分后单张票据的使用类型,详见下方 kind 返回值说明
++ kind_description string 切分后单张票据使用类型中文描述
++ item_list array 切割后的单张票据OCR识别结果
+++ key string 识别字段key
+++ value string 识别字段结果
+++ position array 识别字段在切分后票据转正后的坐标位置[0,1,2,3,4,5,6,7],(0, 1) 左上角坐标,(2, 3) 右上角坐标,(4, 5) 右下角坐标,(6, 7) 左下角坐标
+++ description string 识别字段中文描述
++ product_list array 增票中商品信息(行输出)(仅票据类型为增值税发票时返回)
+++ key string 识别字段key
+++ value string 字段识别结果
+++ description string 字段中文描述

class 返回值说明:

字段 说明
nation_tax_invoice 国税
local_invoice 地方票种
other_invoice 其他票种

kind 返回值说明:

字段 说明
traffic 交通
office 办公
daily 日用
service 服务
digital_appliance 数码电器
rent_decoration 房租装饰
communication 通讯
lodging 住宿
post 邮寄
medical_treatment 医疗
repast 餐饮
foodstuff 食品
raiment 服饰
service 服务
vehicle 用车
education 教育
other 其他

type 返回值说明:

字段 说明
vat_special_invoice 增值税专用发票
motor_vehicle_sale_invoice 机动车销售统一发票
vat_transport_invoice 货物运输业增值税专用发票
vat_common_invoice 增值税普通发票
vat_electronic_invoice 增值税电子普通发票
vat_electronic_special_invoice 增值税电子专用发票
machine_printed_invoice 机打发票
blockchain_electronic_invoice 区块链电子发票
vat_roll_invoice 增值税普通发票(卷票)
vat_electronic_toll_invoice 增值税电子普通发票(通行费)
used_car_purchase_invoice 二手车销售统一发票
general_machine_invoice 通用机打发票
quota_invoice 通用定额发票
passenger_transport_invoice 旅客运输普票
highway_passenger_invoice 公路客运发票
shipping_invoice 船运客票
taxi_ticket 出租车发票
parking_invoice 停车费发票
vehicle_toll 过路过桥费发票
medical_receipt 医疗费收据
education_receipt 教育费收据
air_transport 行程单
train_ticket 火车票
shop_receipt 商户小票
vat_invoice_sales_list 增值税销货清单
travel_transport 出行行程单
non_tax_income_unified_bill 非税收入统一发票
other 其他

增票中商品信息(行输出)product_list 的识别字段 key 说明:

字段 说明
vat_invoice_goods 货物或服务名称
vat_invoice_tax 税额明细
vat_invoice_tax_rate 税率明细
vat_invoice_price 金额明细
vat_invoice_electrans_unit_price 单价明细
vat_invoice_electrans_quantity 数量明细
vat_invoice_electrans_unit 单位明细
vat_invoice_plate_specific 规格型号

type 为 vat_special_invoice、vat_electronic_special_invoice、vat_electronic_invoice、vat_common_invoice、vat_electronic_toll_invoice、machine_printed_invoice、blockchain_electronic_invoice、general_electronic_invoice、electronic_common_invoice 时, key 返回值说明:

字段 字段描述 枚举值 枚举值说明
type 子类型 机打发票, 区块链电子发票, 增值税发票 -
sub_type 子类型 通用电子发票, 非通用电子发票, 地方/财政发票 -
vat_invoice_correct_code 校验码 - -
vat_invoice_daima 发票代码 - -
vat_invoice_haoma 发票号码 - -
vat_invoice_haoma_large_size 增值税发票No号码 - -
vat_invoice_issue_date 开票日期 - -
vat_invoice_rate_payer_id 纳税人识别号 - -
vat_invoice_total 合计 - -
vat_invoice_tax_rate 增值税税率 - -
vat_invoice_seller_name 销售方名称 - -
vat_invoice_seller_bank_account 销售方开户行及帐号 - -
vat_invoice_seller_id 销售方纳税人识别号 - -
vat_invoice_seller_addr_tell 销售方地址、电话 - -
vat_invoice_payer_name 购买方名称 - -
vat_invoice_payer_bank_account 购买方开户行及账号 - -
vat_invoice_payer_addr_tell 购买方地址、电话 - -
vat_invoice_total_cover_tax 价税合计大写 - -
vat_invoice_total_cover_tax_digits 价税合计小写 - -
vat_invoice_tax_total 税额合计 - -
vat_invoice_goods_list 货物或服务名称 - -
vat_invoice_price_list 金额明细 - -
vat_invoice_tax_rate_list 税率明细 - -
vat_invoice_tax_list 税额明细 - -
vat_invoice_zhuan_yong_flag 专票/普票 专票, 普票, 区块链发票, 通用机打发票, 通用电子发票 区块链发票:包含"电子支付凭证"字段, 通用机打发票:包含"通用机打发票"字段, 通用电子发票:包含"通用电子发票"字段, 专票:包含"专用发票"字段, 普票:包含"普通发票"字段
vat_invoice_dai_kai_flag 代开(非代开条目为空) - -
vat_invoice_plate_specific 规格型号明细 - -
vat_invoice_electrans_unit 单位明细 - -
vat_invoice_electrans_quantity 数量明细 - -
vat_invoice_electrans_unit_price 单价明细 - -
vat_invoice_daima_right_side 右侧打印发票代码 - -
vat_invoice_haoma_right_side 右侧打印发票号码 - -
vat_invoice_page_number 抵扣联/发票联 - -
vat_invoice_type 发票类型 非电子发票, 电子普通发票, 电子专用发票 -
vat_invoice_total_note 备注 - -
vat_invoice_cipher_field 密码区 - -
vat_invoice_drawer 开票人 - -
vat_invoice_review 复核 - -
vat_invoice_payee 收款人 - -
exist_stample 盖章存在性判断
vat_invoice_headline_page_number 标题发票联 - -
vat_invoice_corrent_code_print 打印校验码 - -
vat_invoice_total_print 打印合计 - -
vat_invoice_note_correct_code 备注校验码 - -
vat_invoice_machine_no 机器编号 - -
vat_invoice_daima_print 打印发票代码 - -
vat_invoice_elec_payment_id 电子支付标识 - -
vat_invoice_issue_date_print 右侧打印开票日期 - -
vat_invoice_qr_code qr码 - -
vat_invoice_credit_memo 红冲/非红冲 - -
vat_invoice_qr_code qr码 - -
vat_invoice_tax 税额明细 - -
vat_invoice_tax_rate 税率明细 - -
vat_invoice_price 金额明细 - -
vat_invoice_electrans_unit_price 单价明细 - -
vat_invoice_electrans_quantity 数量明细 - -
vat_invoice_electrans_unit 单位明细 - -
vat_invoice_plate_specific 规格型号 - -
vat_invoice_goods 货物或服务名称 - -
vat_invoice_note_handwrite 备注手写 - -
exist_invoice_seal 发票专用章存在性判断 - -
vat_invoice_seller_id_invoice_seal 销售方纳税人识别号-印章 - 增值税发票, 增值税卷式发票中 销售方盖章中的纳税人识别号

type 为 motor_vehicle_sale_invoice时, key返回的值说明:

字段 说明
type 类型
vehicle_invoice_buyer 购货单位(人)
vehicle_invoice_buyer_id 身份证号码/组织机构代码
vehicle_invoice_buyer_tax_id 购方纳税人识别号
vehicle_invoice_car_made_place 产地
vehicle_invoice_car_model 厂牌型号
vehicle_invoice_car_vin 车辆识别代号/车驾号码
vehicle_invoice_cert_id 合格证号
vehicle_invoice_commodity_inspection_id 商检单号
vehicle_invoice_daima 发票代码
vehicle_invoice_dealer 销货单位名称
vehicle_invoice_engine_id 发动机号码
vehicle_invoice_haoma 发票号码
vehicle_invoice_import_certificate_id 进口证明书号
vehicle_invoice_issue_date 开票日期
vehicle_invoice_issued_by 开票人
vehicle_invoice_jida_daima 机打代码
vehicle_invoice_jida_haoma 机打号码
vehicle_invoice_limit_number 限乘人数
vehicle_invoice_machine_id 机器编号
vehicle_invoice_page_number 发票联
vehicle_invoice_price_without_tax 不含税价
vehicle_invoice_qr_code 二维码
vehicle_invoice_seller_address 地址
vehicle_invoice_seller_bank_account 账号
vehicle_invoice_seller_bank_name 开户银行
vehicle_invoice_seller_tax_id 纳税人识别号
vehicle_invoice_tax_amount 增值税税额
vehicle_invoice_tax_author_id 主管税务机关代码
vehicle_invoice_tax_author_name 主管税务机关
vehicle_invoice_tax_authorith 主管税务机关
vehicle_invoice_tax_authorith_id 主管税务机关代码
vehicle_invoice_tax_code 税控码
vehicle_invoice_tax_payment_certificate_number 完税凭证号
vehicle_invoice_tax_rate 增值税税率
vehicle_invoice_telephone 电话
vehicle_invoice_tonnage 吨位
vehicle_invoice_total_price 价税合计
vehicle_invoice_total_price_digits 小写
vehicle_invoice_vehicle_type 车辆类型
exist_invoice_seal 发票专用章存在性判断
exist_stample 盖章存在性判断

type为 used_car_purchase_invoice时, key返回值说明:

字段 说明
vehicle_invoice_daima 购车发票代码
vehicle_invoice_haoma 购车发票号码
vehicle_invoice_buyer 购货单位(人)
vehicle_invoice_buyer_id 购买身份证号码/组织机构代码
vehicle_invoice_buyer_addr 购买方地址
vehicle_invoice_buyer_phone 购买方电话号码
vehicle_invoice_seller 卖方单位(人)
vehicle_invoice_seller_id 卖方身份证号码/组织机构代码
vehicle_invoice_seller_addr 卖方地址
vehicle_invoice_seller_phone 卖方电话号码
vehicle_invoice_plate_num 车牌照号
vehicle_invoice_register_num 登记证号
vehicle_invoice_vehicle_type 车辆类型
vehicle_invoice_vin 车架号/车辆识别代码
vehicle_invoice_car_model 厂牌型号
vehicle_invoice_dmv 转入地车辆管理所名称
vehicle_invoice_price_total_price 价税合计
vehicle_invoice_total_price_digits 价税合计小写
vehicle_invoice_auction_house 经营、拍卖单位
vehicle_invoice_auction_house_addr 经营、拍卖单位地址
vehicle_invoice_auction_house_tax_id 经营、拍卖单位纳税人识别号
vehicle_invoice_auction_house_bank_account 经营、拍卖单位开户银行、账号
vehicle_invoice_auction_house_phone 经营、拍卖单位电话
vehicle_invoice_market 二手车市场
vehicle_invoice_market_addr 二手车市场地址
vehicle_invoice_market_tax_id 二手车市场纳税人识别号
vehicle_invoice_market_bank_acount 二手车市场开户银行、账号
vehicle_invoice_market_phone 二手车市场电话
vehicle_invoice_note 备注
vehicle_invoice_machine_id 机器码
vehicle_invoice_shuikongma 税控码
vehicle_invoice_issue_date 购车发票开票日期
exist_stample 盖章存在性判断
exist_invoice_seal 发票专用章存在性判断

type 为 vat_roll_invoice 时, key 返回值说明:

字段 说明
invoice_head 发票票头
invoice_number 发票号码
invoice_code 发票代码
machine_number 机器号码
machine_code 机器编码
total_money 合计金额(小写)
total_money_big 合计金额(大写)
date_of_invoice 开票日期
check_number 校验码
buy_name 购方名称
buy_tax_number 购方纳税人识别号
sold_name 销方名称
sold_tax_number 销方纳税人识别号
goods_name_list 项目名称明细
goods_unit_price_list 项目单价明细
goods_number_list 项目数量明细
goods_money_list 项目金额明细
cashier_name 收款员
exist_invoice_seal 发票专用章存在性判断

type 为 vehicle_toll 时, key 返回值说明:

字段 说明
toll_code 车辆通行费代码
toll_number 车辆通行费号码
date 收费时间
time 收费时间
money 收费金额
exist_invoice_seal 发票专用章存在性判断

type 为 quota_invoice 时, key 返回值说明:

字段 说明
quota_invoice_code 发票代码
quota_invoice_number 发票号码
money_small 金额(小写)
money_big 金额(大写)
location 发票所在地
exist_invoice_seal 发票专用章存在性判断

type 为 taxi_ticket 时, key 返回值说明:

字段 说明
invoice_code 发票代码
invoice_no 发票号码
date 日期
taxi_no 车号
boarding_time 上车时间
landing_time 下车时间
mileage 里程
sum 总价金额
oil 燃油附加费
location 发票所在地
exist_invoice_seal 发票专用章存在性判断

type 为 air_transport 时, key 返回值说明:

字段 说明
agentcode 销售单位代号
passenger_name 旅客姓名
id_no 身份证件号码
serial_number 印刷序号
total 合计金额
fare 票价
civil_aviation_fund 民航发展基金
fuel_surcharge 燃油附加费
other_taxes 其他税费
issued_date 填开日期
issued_by 填开单位
e_ticket_no 电子客票号码
from 出发站
to 到达站
flight_number 航班号
seat_class 座位等级
date 航班日期
time 航班时间
fare_basis 客票级别
allow 行李
insurance 保险费
restriction 签注
exist_invoice_seal 发票专用章存在性判断

type 为 air_transport 时, object_list 中返回 array 类型的航班信息表 flight_data_list,其识别字段说明如下:

字段名 描述
from 出发站
flight_number 航班号
to 到达站
seat_class 座位等级
date 航班日期
time 航班时间
fare_basis 客票级别
allow 行李
carrier 承运人

type 为 train_ticket 时, key 返回值说明:

字段 说明
passenger_name 乘客名称
passenger_id 乘客身份证
train_number 车次号
departure_station 出发地
departure_date 乘车时间
class 座位类别
ticket_number 火车票红色编码
arrival_station 目的地
seat_number 座位号
price 价格
check 检票口
ticket_id 火车票ID
exist_invoice_seal 发票专用章存在性判断

type 为 general_machine_invoice 时, key 返回值说明:

字段 说明
invoice_code 发票代码
invoice_number 发票号码
money 金额
date 日期
time 时间
exist_invoice_seal 发票专用章存在性判断

type 为 shipping_invoice 时, key 返回值说明:

字段 说明
invoice_code 发票代码
invoice_number 发票号码
money 金额
date 日期
time 时间
passenger 乘船人
departure 出发点
arrival 到达点
exist_invoice_seal 发票专用章存在性判断

type 为 highway_passenger_invoice、passenger_transport_invoice 时, key 返回值说明:

字段 说明
invoice_code 发票代码
invoice_number 发票号码
money 金额
date 日期
time 时间
passenger_name 乘客姓名
passenger_id 乘客身份证号码
exist_invoice_seal 发票专用章存在性判断

type 为 parking_invoice 时, key 返回值说明:

字段 说明
invoice_number 发票号码
money 金额
exist_invoice_seal 发票专用章存在性判断
exist_invoice_seal 发票专用章存在性判断

type 为 vat_invoice_sales_list 时, key 返回值说明:

字段 说明
purchaser_name 购买方名称
seller_name 销售方名称
invoice_code 发票代码
invoice_number 发票号码
total_page 合计页码
page 当前页码
total 金额合计
tax_total 税额合计
has_stamp 销售方盖章存在性判断
issued_date 填开日期
exist_invoice_seal 发票专用章存在性判断
remarks 备注

type 为 shop_receipt 时, key 返回值说明:

字段 说明
money 金额
date 时间
no 单号
shop 商户
sku 商品
exist_invoice_seal 发票专用章存在性判断

type 为 medical_receipt 时, key 返回值说明:

字段 说明
transaction_number 交易流水号
workflow_number 业务流水号
invoice_bar_code 票据条码
invoice_number 票据编号
medical_institution_type 医疗机构类型
name 姓名
sex 性别
medical_insurance_type 医保类型
social_security_number 社会保障卡号
amount_big 大写合计
amount_small 小写合计

type 为 travel_transport 时, key 返回值说明:

字段 说明
apply_date 申请日期
start_date 起始时间
end_date 结束时间
phone_number 行程人手机号
total_money 合计金额

type 为 non_tax_income_unified_bill 时,key 返回值说明:

字段 说明
PayerPartyName 交款人名称
EInvoiceNumber 电子票据号码
RandomNumber 校验码
IssuedDate 开票日期
ItemCode 项目编码
ItemName 项目名称
ItemUnit 单位
ItemQuantity 数量
ItemStd 标准
ItemAmount 金额
ItemExt 明细信息扩展
TotalAmount_Words 金额大写
TotalAmount 总金额
Checker 复核人
EInvoiceCode 电子票据代码
PayerPartyCode 交款人代码
RecName 收款人全称
InvoicingPartyName 开票单位名称
Remark 备注

type为 education_receipt、vat_transport_invoice, 目前仅支持分类,暂无结构化识别。

JSON结构示例

{
    "code":200,
    "message":"success",
    "result":{
        "object_list":[
            {
                "image_angle":270,
                "rotated_image_width":1440,
                "rotated_image_height":1080,
                "position":[
                    300,
                    394,
                    1059,
                    411,
                    1059,
                    481,
                    300,
                    459
                ],
                "class":"local_invoice",
                "type":"quota_invoice",
                "type_description":"通用定额发票",
                "item_list":[
                    {
                        "key":"quota_invoice_code",
                        "value":"131001827953",
                        "position":[
                            752,
                            532,
                            1256,
                            535,
                            1256,
                            573,
                            752,
                            567
                        ],
                        "description":"发票代码"
                    },
                    {
                        "key":"money_small",
                        "value":"10.00",
                        "position":[
                            300,
                            394,
                            1059,
                            411,
                            1059,
                            481,
                            300,
                            459
                        ],
                        "description":"金额(小写)"
                    }
                ]
            },
            {
                "image_angle":270,
                "rotated_image_width":1330,
                "rotated_image_height":1280,
                "position":[
                    300,
                    394,
                    1059,
                    411,
                    1059,
                    481,
                    300,
                    459
                ],
                "class":"other",
                "type":"train_ticket",
                "type_description":"火车票",
                "item_list":[
                    {
                        "key":"departure_station",
                        "value":"上海站",
                        "position":[
                            126,
                            275,
                            700,
                            270,
                            700,
                            311,
                            126,
                            320
                        ],
                        "description":"出发地"
                    },
                    {
                        "key":"arrival_station",
                        "value":"131001827953",
                        "position":[
                            177,
                            159,
                            1127,
                            149,
                            1127,
                            206,
                            177,
                            217
                        ],
                        "description":"目的地"
                    }
                ]
            }
        ]
    }
}

错误码说明

错误码 描述
40101 x-ti-app-id 或 x-ti-secret-code 为空
40102 x-ti-app-id 或 x-ti-secret-code 无效,验证失败
40103 客户端IP不在白名单
40003 余额不足,请充值后再使用
40004 参数错误,请查看技术文档,检查传参
40007 机器人不存在或未发布
40008 机器人未开通,请至市场开通后重试
40301 图片类型不支持
40302 上传文件大小不符,文件大小不超过 10M
40303 文件类型不支持
40304 图片尺寸不符,图像宽高须介于 20 和 10000(像素)之间
40305 识别文件未上传
30203 基础服务故障,请稍后重试
500 服务器内部错误
体验中心
人工客服
400-6666-582