更新记录

2024.08.02 - v2.4.2

• 升级了3款票据的识别模型，优化了识别率
  • 全面数字化电子发票
  • 增值税普通发票(卷票)
  • 非税收统一票据
• 新增了2个API调用的入参功能
  • coord_restore
    • 调整各字段的返回坐标逻辑，1代表坐标以原图为基准，0代表坐标以票据切图为基准，默认为0
  • specific_pages
    • 指定多页样本中需要识别的样本，可以使用"1,3,2"形式来逐页选择，或"2-4"形式来连续选择，返回结果会重新排序以遵照源文件顺序，默认为空，识别所有页面

2024.07.08 - ver.2.3.0

• 调整了“全面数字化电子发票”的“vat_invoice_title”字段key，调整后的key为“title”，与其他票据统一。
• 调整了“全面数字化电子发票”的“vat_invoice_title_certificate_number”字段key，调整后的key为“vat_invoice_certificate_number”，纠正了与实际票面的差异。
• 新增了印章检测识别功能，在每个票面的object下，会增加一个stamp_list，每个印章作为一个object返回，返回值详见response内的stamp_list部分。

2024.07.01 - ver.2.2.0

• 国内通用票据识别v2版本更新，公开上线，支持23大类票据识别。

功能描述

国内通用票据v2接口识别

请求URL

https://api.textin.com/ai/service/v1/bill_recognize_v2

HTTP请求方法（Method）

HTTP POST

请求头说明（Request Headers）

请在HTTP请求中添加以下自定义标头（Header）。

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

URL参数（Parameters）

URL参数指以 {参数名}={参数值} 形式拼接到 URL 上的键值对。它以 ? 开头，不同参数之间使用 & 连接。形如 ?p1=v1&p2=v2

参数名	数据类型	是否必填	允许的值	描述
coord_restore	integer	否	0, 1	调整各字段的返回坐标逻辑，1代表坐标以原图为基准，0代表坐标以票据切图为基准，默认为0
specific_pages	string	否	见描述	指定多页样本中需要识别的样本，可以使用"1,3,2"形式来逐页选择，或"2-4"形式来连续选择，返回结果会重新排序以遵照源文件顺序，默认为空，识别所有页面

请求体说明（Request Body）

Content-Type: application/octet-stream

要上传的图片，目前支持jpg, png, bmp, pdf, tiff, ofd, 单帧gif等大部分格式.

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

响应体说明（Response）

Content-Type: application/json

JSON结构说明如下：

字段名	类型	描述
code	integer	错误码，详见“错误码说明”
message	string	错误信息
pageNum	integer	总页数
pages	array	样本每页的识别结果
+ result	object
++ object_list	array
+++ type	string	切分后单张票据类型 vat_invoice 增值税发票 vat_digital_invoice 数电票(增值税专用发票/普通发票) railway_digital_ticket 数电票(铁路电子客票) flight_digital_ticket 数电票(航空运输电子客票行程单) electronic_medical_invoice 电子医疗发票 outpatient_medical_invoice 纸质门诊发票 inpatient_medical_invoice 纸质住院发票 train_ticket 火车票 taxi_ticket 出租车票 quota_invoice 通用定额发票 ride_receipt 网约车行程单 used_car_purchase_invoice 二手车销售统一发票 car_purchase_invoice 机动车销售统一发票 other 其他 unauthorized_type 未授权的类型 vehicle_toll 过路过桥费发票 vat_invoice_sales_list 增值税销货清单 highway_passenger_invoice 公路客运发票 passenger_transport_invoice 旅客运输发票 parking_invoice 停车费发票 shipping_invoice 船运客票 flight_itinerary 航空运输电子客票行程单 vat_volume_invoice 增值税普通发票(卷票) non_tax_income_unified_bill 非税收入统一票据 general_machine_invoice 通用机打发票
+++ type_description	string	切分后单张票据类型中文描述
+++ image_angle	integer	切分后单张票据的角度
+++ rotated_image_width	integer	切分后单张票据转正后的宽度
+++ rotated_image_height	integer	切分后单张票据转正后的高度
+++ kind	string	切分后单张票据的使用类型 communication 通讯 daily 日用 digital_appliance 数码电器 education 教育 foodstuff 食品 lodging 住宿 medical_treatment 医疗 office 办公 other 其他 post 邮寄 raiment 服饰 rent_decoration 房租装饰 repast 餐饮 service 服务 traffic 交通 vehicle 用车
+++ kind_description	string	切分后单张票据使用类型中文描述
+++ position	array
+++ item_list	array	识别字段
++++ key	string	识别字段名称
++++ value	string	识别字段值
++++ position	array
++++ description	string	识别字段中文描述
+++ stamp_list	array	票据中的印章结果
++++ key	string	stamp_info 印章内容 stamp_type 印章类型 stamp_invoice_seller_id 印章销售方纳税人识别号 其中印章类型, 当前支持以下类型的判断： 全国统一发票监制章 发票专用章 其他
++++ value	string	字段识别结果
++++ description	string	字段中文描述
+ duration	integer	识别耗时
+ page_number	integer	页码, 从0开始计算

结构体说明

各类型返回的字段及字段定义说明如下：

Type_vat_invoice

字段名	类型	描述
type	string	切分后单张票据类型 vat_invoice 增值税发票
item_list	array
+ key	string	识别字段key title 标题 vat_invoice_machine_no 机器编号 vat_invoice_correct_code 校验码 vat_invoice_daima 发票代码 vat_invoice_haoma 发票号码 vat_invoice_issue_date 开票日期 vat_invoice_payer_name 购买方名称 vat_invoice_payer_bank_account 购买方开户行及账号 vat_invoice_rate_payer_id 购买方纳税人识别号 vat_invoice_payer_addr_tell 购买方地址、电话 vat_invoice_seller_name 销售方名称 vat_invoice_seller_bank_account 销售方开户行及帐号 vat_invoice_seller_id 销售方纳税人识别号 vat_invoice_seller_addr_tell 销售方地址、电话 vat_invoice_tax_total 税额合计 vat_invoice_total 金额合计 vat_invoice_total_cover_tax 价税合计大写 vat_invoice_total_cover_tax_digits 价税合计小写 vat_invoice_total_note 备注 vat_invoice_cipher_field 密码区 digital_elec_invoice_number 数电票号码 vat_invoice_payee 收款人 vat_invoice_review 复核 vat_invoice_drawer 开票人 vat_invoice_page_number 发票联次
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	增票中商品信息（行输出）
+ key	string	识别字段key vat_invoice_product_name 项目名称 vat_invoice_tax 税额 vat_invoice_tax_rate 税率/征收率 vat_invoice_price 金额 vat_invoice_unit_price 单价 vat_invoice_quantity 数量 vat_invoice_unit 单位 vat_invoice_specification 规格型号 vat_invoice_license_plate_number 车牌号 (通行费特有字段) vat_invoice_goods_type 类型 (通行费特有字段) vat_invoice_pass_end_date 通行日期止 (通行费特有字段) vat_invoice_pass_start_date 通行日期起 (通行费特有字段)
+ value	string	字段识别结果
+ description	string	字段中文描述

TypeOther

字段名	类型	描述
type	string	切分后单张票据类型 other 其他票据 unauthorized_type 未授权的类型
kind	string	切分后单张票据的使用类型 other 其他

Type_vat_digital_invoice

字段名	类型	描述
type	string	切分后单张票据类型 vat_digital_invoice 数电票(增值税专用发票/普通发票)
item_list	array
+ key	string	识别字段key - title 标题 识别字段key - vat_invoice_service_type 全电票标签 识别字段key vat_invoice_number 发票号码 vat_invoice_issue_date 开票日期 vat_invoice_payer_name 购买方名称 vat_invoice_rate_payer_id 购买方纳税人识别号 vat_invoice_seller_name 销售方名称 vat_invoice_seller_id 销售方纳税人识别号 vat_invoice_subtotal 金额小计 vat_invoice_tax_subtotal 税额小计 vat_invoice_total 金额合计 vat_invoice_tax_total 税额合计 vat_invoice_total_cover_tax 价税合计大写 vat_invoice_total_cover_tax_digits 价税合计小写 vat_invoice_total_note 备注 vat_invoice_drawer 开票人
+ value	string	字段识别结果 - 电子发票(普通发票) - 电子发票(增值税专用发票) 建筑服务 货物运输服务 不动产经营租赁服务 旅客运输服务 稀土 卷烟 不动产销售 农产品收购 光伏收购 代收车船税 自产农产品 差额征税-差额开票 差额征税-全额开票 成品油 "" 字段识别结果
+ description	string	字段中文描述
product_list	array	票据中的明细信息（行输出）
+ key	string	通用版式包括以下key: vat_invoice_product_name 项目名称 vat_invoice_specification 规格型号 vat_invoice_tax 税额 vat_invoice_tax_rate 税率/征收率 vat_invoice_price 金额 vat_invoice_unit_price 单价 vat_invoice_quantity 数量 vat_invoice_unit 单位 建筑服务版式包括以下key: vat_invoice_product_name 项目名称 vat_invoice_specification 规格型号 vat_invoice_tax 税额 vat_invoice_tax_rate 税率/征收率 vat_invoice_price 金额 vat_invoice_unit_price 单价 vat_invoice_quantity 数量 vat_invoice_unit 单位 vat_invoice_place_of_building_service 建筑服务发生地 vat_invoice_building_name 建筑项目名称 不动产销售、不动产经营租赁版式包括以下key: vat_invoice_product_name 项目名称 vat_invoice_specification 规格型号 vat_invoice_tax 税额 vat_invoice_tax_rate 税率/征收率 vat_invoice_price 金额 vat_invoice_unit_price 单价 vat_invoice_quantity 数量 vat_invoice_unit 单位 vat_invoice_certificate_number 产权证书/不动产权证号 vat_invoice_area_unit 面积单位
+ value	string	字段识别结果
+ description	string	字段中文描述
transport_list	array	票据中的运输服务信息（行输出）
+ key	string	货物运输服务版式包括以下key: vat_invoice_transport_type 运输工具类型 vat_invoice_transport_number 运输工具牌号 vat_invoice_from 起运地 vat_invoice_to 到达地 vat_invoice_goods_name 运输货物名称 旅客运输服务版式包括以下key: vat_invoice_transport_type 交通工具类型 vat_invoice_from 起始地 vat_invoice_to 到达地 vat_invoice_passenger 出行人 vat_invoice_user_id 有效身份证号 vat_invoice_date 出行日期 vat_invoice_seat 等级
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_railway_digital_ticket

字段名	类型	描述
type	string	切分后单张票据类型 railway_digital_ticket 数电票(铁路电子客票)
item_list	array
+ key	string	识别字段key departure_station 出发地 train_number 车次号 arrival_station 目的地 seat_number 座位号 price 票价 class 座位类别 passenger_id 乘客身份证 passenger_name 乘客名称 ticket_id 电子客票号 number 发票号码 date_of_issue 开票日期 phonics_of_departure_station 出发地拼音 phonics_of_arrival_station 目的地拼音 pretax_amount 税前金额 tax_rate 税率 tax 税额 buyer 购买方名称 buyer_tax_id 社会统一信用代码 number_of_original_invoice 原发票号码 departure_date 乘车时间
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_flight_digital_ticket

字段名	类型	描述
type	string	切分后单张票据类型 flight_digital_ticket 数电票(航空运输电子客票行程单)
item_list	array
+ key	string	识别字段key agentcode 销售网点代号 passenger_name 旅客姓名 id_no 身份证件号码 total 合计金额 fare 票价 civil_aviation_fund 民航发展基金 fuel_surcharge 燃油附加费 other_taxes 其他税费 issued_date 填开日期 issued_by 填开单位 e_ticket_no 电子客票号码 restriction 签注 insurance 保险费 international_flag 国内国际标签 number_of_original_invoice 原发票号码 tax_rate 增值税税率 tax 增值税税额 check_code 验证码 prompt_information 提示信息 buyer 购买方名称 buyer_tax_id 统一社会信用代码/购买方纳税人识别号 invoice_number 发票号码 issuing_status 开票状态
+ value	string	识别字段结果
+ description	string	识别字段中文描述
flight_data_list	array	飞机行程单中行本信息（行输出）
+ key	string	识别字段key from 出发站 to 到达站 carrier 承运人 flight_number 航班号 seat_class 座位等级 date 航班日期 time 航班时间 fare_basis 客票级别/客票类别 allow 免费行李 not_valid_before 客票生效日期 not_valid_after 有效截至日期
+ value	string	字段识别结果
+ description	string	识别字段中文描述

Type_electronic_medical_invoice

字段名	类型	描述
type	string	切分后单张票据类型 electronic_medical_invoice 电子医疗发票
item_list	array
+ key	string	识别字段key title 标题 invoice_code 票据代码 invoice_number 票据号码 payer_uniform_social_credit_code 交款人统一社会信用代码 payer 交款人 correct_code 校验码 date 开票日期 amount_char 合计大写 amount_digital 合计小写 cashier_company 收款单位 reviewer 复核人 cashier 收款人 workflow_number 业务流水号 patient_number 门诊号 visit_date 就诊时间/就诊日期 medical_institution_type 医疗机构类型 medical_insurance_type 医保类型 medical_insurance_number 医保编号 sex 性别 medical_pooling_payment 医保统筹基金支付 other_payment 其他支付 personal_account_payment 个人账户支付 cash_payment 个人现金支付 individual_payment 个人自付 personal_payment 个人自负 self_payment 个人自费 medical_record_number 病历号 hospitalized_number 住院号 hospitalization_department 住院科别 hospitalization_date 住院时间 advance_payment 预缴金额 supplementary_payment 补缴金额 refund_amount 退费金额
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	表格信息（行输出）
+ key	string	识别字段key project_code_table 表格项目编码 project_name_table 表格项目名称 unit_table 表格单位 number_table 表格数量 amount_table 表格金额
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_outpatient_medical_invoice

字段名	类型	描述
type	string	切分后单张票据类型 outpatient_medical_invoice 纸质门诊发票
item_list	array
+ key	string	识别字段key title 标题 invoice_number 票据号码 date 开票日期 amount_char 合计大写 amount_digital 合计小写 cashier_company 收款单位 cashier 收款人 workflow_number 业务流水号 patient_number 门诊号 medical_institution_type 医疗机构类型 medical_insurance_type 医保类型 medical_insurance_number 医保编号 sex 性别 medical_pooling_payment 医保统筹基金支付 personal_account_payment 个人账户支付 cash_payment 个人现金支付 personal_payment 个人自负 self_payment 个人自费
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	表格信息（行输出）
+ key	string	识别字段key project_code_table 表格项目编码 project_name_table 表格项目名称 specs_table 表格规格 unit_table 表格单位 unit_price_table 表格单价 number_table 表格数量 amount_table 表格金额
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_inpatient_medical_invoice

字段名	类型	描述
type	string	切分后单张票据类型 inpatient_medical_invoice 纸质住院发票
item_list	array
+ key	string	识别字段key title 标题 invoice_number 票据号码 date 开票日期 amount_char 合计大写 amount_digital 合计小写 cashier_company 收款单位 cashier 收款人 workflow_number 业务流水号 medical_institution_type 医疗机构类型 medical_insurance_type 医保类型 medical_insurance_number 医保编号 sex 性别 medical_pooling_payment 医保统筹基金支付 personal_account_payment 个人账户支付 cash_payment 个人现金支付 medical_record_number 病历号 hospitalized_number 住院号 hospitalization_department 住院科别 admission_date 住院日期 discharge_date 住院日期 advance_payment 预缴金额 supplementary_payment 补缴金额 refund_amount 退费金额
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	表格信息（行输出）
+ key	string	识别字段key project_name_table 表格项目名称 amount_table 表格金额
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_train_ticket

字段名	类型	描述
type	string	切分后单张票据类型 train_ticket 火车票
item_list	array
+ key	string	识别字段key ticket_number 火车票红色编码 boarding_gate 检票口 departure_station 出发地 train_number 车次号 arrival_station 目的地 departure_date 乘车时间 seat_number 座位号 price 价格 class 座位类别 passenger_id 乘客身份证 passenger_name 乘客名称 ticket_id 火车票ID refund 退票费
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_taxi_ticket

字段名	类型	描述
type	string	切分后单张票据类型 taxi_ticket 出租车票
item_list	array
+ key	string	识别字段key invoice_code 发票代码 invoice_no 发票号码 date 日期 taxi_no 车号 boarding_time 上车时间 landing_time 下车时间 mileage 里程 price 票面金额 surcharge 附加费 location 发票所在地
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_quota_invoice

字段名	类型	描述
type	string	切分后单张票据类型 quota_invoice 通用定额发票
item_list	array
+ key	string	识别字段key title 标题 quota_invoice_code 发票代码 quota_invoice_number 发票号码 amount_char 金额(大写)
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_ride_receipt

字段名	类型	描述
type	string	切分后单张票据类型 ride_receipt 网约车行程单
item_list	array
+ key	string	识别字段key title 标题 application_date 申请日期 trip_date 行程日期 trip_number 合计行程数量 amount_total 合计金额 phone_number 行程人手机号/预定人手机号 other_expenses_total 其他费用合计
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	表格信息（行输出）
+ key	string	识别字段key serial_no_table 表格序号 order_no_table 表格订单号 service_type_table 表格订单/服务类型 supplier_table 表格服务商 car_type_table 表格车型 departure_point_table 表格起点 destination_table 表格终点 city_table 表格城市 driving_time_table 表格行驶时长 order_time_table 表格下单时间 pick_up_time_table 表格上车时间 using_time_table 表格用车时间 mileage_table 表格行程里程 journey_amount_table 表格行程金额 notes_table 表格备注 other_expenses_table 表格其他费用
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_used_car_purchase_invoice

字段名	类型	描述
type	string	切分后单张票据类型 used_car_purchase_invoice 二手车销售统一发票
item_list	array
+ key	string	识别字段key title 标题 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_total_price_char 车价合计(大写) 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_account 二手车市场开户银行、账号 vehicle_invoice_market_phone 二手车市场电话 vehicle_invoice_issue_date 开票日期 vehicle_invoice_machine_id 机器编号 vehicle_invoice_note 备注 vehicle_invoice_tax_code 税控码 vehicle_invoice_issued_by 开票人 vehicle_invoice_jida_daima 机打代码 vehicle_invoice_jida_haoma 机打号码
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_car_purchase_invoice

字段名	类型	描述
type	string	切分后单张票据类型 car_purchase_invoice 机动车销售统一发票
item_list	array
+ key	string	识别字段key title 标题 vehicle_invoice_daima 发票代码 vehicle_invoice_haoma 发票号码 vehicle_invoice_issue_date 开票日期 vehicle_invoice_machine_id 机器编号 vehicle_invoice_jida_daima 机打代码 vehicle_invoice_jida_haoma 机打号码 vehicle_invoice_tax_code 税控码 vehicle_invoice_buyer 购货单位(人)/购买方名称 vehicle_invoice_buyer_id 购方身份证号码/组织机构代码 vehicle_invoice_buyer_tax_id 购方纳税人识别号 vehicle_invoice_vehicle_type 车辆类型 vehicle_invoice_car_made_place 产地 vehicle_invoice_car_model 厂牌型号 vehicle_invoice_car_vin 车辆识别代号/车架号码 vehicle_invoice_cert_id 合格证号 vehicle_invoice_commodity_inspection_id 商检单号 vehicle_invoice_engine_id 发动机号码 vehicle_invoice_import_certificate_id 进口证明书号 vehicle_invoice_total_price_char 价税合计(大写) vehicle_invoice_total_price_digits 价税合计(小写) vehicle_invoice_seller 销货单位名称 vehicle_invoice_seller_address 销货单位地址 vehicle_invoice_seller_bank_account 销货单位账号 vehicle_invoice_seller_bank_name 销货单位开户银行 vehicle_invoice_seller_tax_id 销货单位纳税人识别号 vehicle_invoice_seller_telephone 销货单位电话 vehicle_invoice_tax_rate 增值税税率或征收率 vehicle_invoice_tax_amount 增值税税额 vehicle_invoice_tax_authority 主管税务机关 vehicle_invoice_tax_authority_id 主管税务机关代码 vehicle_invoice_price_without_tax 不含税价 vehicle_invoice_tax_payment_certificate_number 完税凭证号 vehicle_invoice_tonnage 吨位 vehicle_invoice_limit_number 限乘人数 vehicle_invoice_issued_by 开票人
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_vehicle_toll

字段名	类型	描述
type	string	切分后单张票据类型 vehicle_toll 过路过桥费发票
item_list	array
+ key	string	识别字段key toll_code 车辆通行费代码 toll_number 车辆通行费号码 money 收费金额 date 收费日期 time 收费时间 location 发票所在地
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_vat_invoice_sales_list

字段名	类型	描述
type	string	切分后单张票据类型 vat_invoice_sales_list 增值税销货清单
item_list	array
+ key	string	识别字段key purchaser_name 购买方名称 seller_name 销售方名称 invoice_code 发票代码 invoice_number 发票号码 total_page 合计页码 page 当前页码 total 金额合计 tax_total 税额合计 issued_date 填开日期 subtotal 金额小计 tax_subtotal 税额小计
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_highway_passenger_invoice

字段名	类型	描述
type	string	切分后单张票据类型 highway_passenger_invoice 公路客运发票
item_list	array
+ key	string	识别字段key invoice_code 发票代码 invoice_number 发票号码 money 金额 date 日期 time 时间 passenger_name 乘客姓名 passenger_id 乘客身份证号码
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_passenger_transport_invoice

字段名	类型	描述
type	string	切分后单张票据类型 passenger_transport_invoice 旅客运输发票
item_list	array
+ key	string	识别字段key invoice_code 发票代码 invoice_number 发票号码 money 金额 date 日期 time 时间 passenger_name 乘客姓名 passenger_id 乘客身份证号码
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_parking_invoice

字段名	类型	描述
type	string	切分后单张票据类型 parking_invoice 停车费发票
item_list	array
+ key	string	识别字段key invoice_number 发票号码 money 金额
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_shipping_invoice

字段名	类型	描述
type	string	切分后单张票据类型 shipping_invoice 船运客票
item_list	array
+ key	string	识别字段key invoice_code 发票代码 invoice_number 发票号码 money 金额 date 日期 time 时间
+ value	string	识别字段结果
+ description	string	识别字段中文描述

Type_flight_itinerary

字段名	类型	描述
type	string	切分后单张票据类型 flight_itinerary 航空运输电子客票行程单
item_list	array
+ key	string	识别字段key agentcode 销售单位代号 passenger_name 旅客姓名 id_no 身份证件号码 serial_number 印刷序号 total 合计金额 fare 票价 civil_aviation_fund 民航发展基金 fuel_surcharge 燃油附加费 other_taxes 其他税费 issued_date 填开日期 issued_by 填开单位 e_ticket_no 电子客票号码 insurance 保险费 restriction 签注
+ value	string	识别字段结果
+ description	string	识别字段中文描述
flight_data_list	array	飞机行程单中行本信息（行输出）
+ key	string	识别字段key from 出发站 to 到达站 carrier 承运人 flight_number 航班号 seat_class 座位等级 date 航班日期 time 航班时间 fare_basis 客票级别 allow 免费行李
+ value	string	字段识别结果
+ description	string	识别字段中文描述

Type_vat_volume_invoice

字段名	类型	描述
type	string	切分后单张票据类型 vat_volume_invoice 增值税普通发票(卷票)
item_list	array
+ key	string	识别字段key title 标题 invoice_number 发票号码 invoice_code 发票代码 machine_number 机打号码 machine_code 机器编码 total_digits 合计金额(小写) total_char 合计金额(大写) date_of_invoice 开票日期 check_number 校验码 buy_name 购方名称 buy_tax_number 购方纳税人识别号 sold_name 销售方名称 sold_tax_number 销售方纳税人识别号 cashier_name 收款员
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	增票中商品信息（行输出）
+ key	string	识别字段key goods_name_list 项目名称明细 goods_unit_price_list 项目单价明细 goods_number_list 项目数量明细 goods_money_list 项目金额明细
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_non_tax_income_unified_bill

字段名	类型	描述
type	string	切分后单张票据类型 non_tax_income_unified_bill 非税收入统一票据
item_list	array
+ key	string	识别字段key title 标题 payer 交款人 invoice_number 票据号码 check_code 校验码 issued_date 开票日期 total_char 金额合计(大写) total_digits 金额合计(小写) checker 复核人 invoice_code 票据代码 payer_tax_id 交款人统一社会信用代码 payee 收款人 invoicing_party_name 收款单位 remark 其他信息
+ value	string	字段识别结果
+ description	string	字段中文描述
product_list	array	增票中商品信息（行输出）
+ key	string	识别字段key item_code 项目编码 item_name 项目名称 item_unit 单位 item_quantity 数量 item_std 标准 item_amount 金额 item_ext 备注
+ value	string	字段识别结果
+ description	string	字段中文描述

Type_general_machine_invoice

字段名	类型	描述
type	string	切分后单张票据类型 general_machine_invoice 通用机打发票
item_list	array
+ key	string	识别字段key title 标题 invoice_code 发票代码 invoice_number 发票号码 seller 收款方名称 seller_tax_id 收款方证件号 buyer 付款方名称 buyer_tax_id 付款方证件号 total 金额 date 开票日期
+ value	string	识别字段结果
+ description	string	识别字段中文描述

JSON结构示例

{
    "pages": [
        {
            "page_number": 0,
            "duration": 1116,
            "result": {
                "object_list": [
                    {   //每张票据对应一个object list
                        "transport_list": [],   //交通信息字段列表，每张票唯一当前为空
                        "type_description": "数电票(增值税专用发票/普通发票)",  //票据类型描述
                        "rotated_image_width": 1647,    //旋转后的图像宽度，单位为像素
                        "image_angle": 0,   //票据旋转角度，表示顺时针旋转X度后，票据的方向转正
                        "rotated_image_height": 1114,   //旋转后的图像高度，单位为像素
                        "item_list": [   //常规字段列表，每张票唯一
                            {   //每个字段对应一个item object
                                "value": "电子发票(增值税专用发票)",   //字段值
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],   //字段坐标，单位为像素，坐标顺序为左上角、左下角、右下角、右上角，title和type字段没有真实坐标
                                "key": "title",   //字段键
                                "description": "标题"   //字段描述
                            },
                            {
                                "value": "",
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                "key": "vat_invoice_service_type",
                                "description": "全电票标签"
                            },
                            {
                                "value": "000000000000000",
                                "position": [1321, 107, 1572, 107, 1572, 137, 1321, 137],
                                "key": "vat_invoice_number",
                                "description": "发票号码"
                            },
                            {
                                "value": "2022年06月22日",
                                "position": [1323, 153, 1489, 153, 1489, 184, 1323, 184],
                                "key": "vat_invoice_issue_date",
                                "description": "开票日期"
                            },
                            {
                                "value": "上海合合信息科技股份有限公司",
                                "position": [179, 309, 455, 309, 455, 338, 179, 338],
                                "key": "vat_invoice_payer_name",
                                "description": "购买方名称"
                            },
                            {
                                "value": "000000000000000000",
                                "position": [437, 353, 778, 353, 778, 387, 437, 387],
                                "key": "vat_invoice_rate_payer_id",
                                "description": "购买方纳税人识别号"
                            },
                            {
                                "value": "上海合合信息科技股份有限公司",
                                "position": [929, 314, 1206, 314, 1206, 343, 929, 343],
                                "key": "vat_invoice_seller_name",
                                "description": "销售方名称"
                            },
                            {
                                "value": "9144010169154142X5",
                                "position": [880, 359, 1197, 362, 1197, 392, 880, 390],
                                "key": "vat_invoice_seller_id",
                                "description": "销售方纳税人识别号"
                            },
                            {
                                "value": "1320.74",
                                "position": [1083, 728, 1196, 728, 1196, 757, 1083, 757],
                                "key": "vat_invoice_total",
                                "description": "金额合计"
                            },
                            {
                                "value": "79.24",
                                "position": [1506, 731, 1593, 731, 1593, 758, 1506, 758],
                                "key": "vat_invoice_tax_total",
                                "description": "税额合计"
                            },
                            {
                                "value": "",
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                "key": "vat_invoice_subtotal",
                                "description": "金额小计"
                            },
                            {
                                "value": "",
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                "key": "vat_invoice_tax_subtotal",
                                "description": "税额小计"
                            },
                            {
                                "value": "壹仟叁佰玖拾玖圆玖角捌分",
                                "position": [459, 764, 1330, 767, 1331, 809, 459, 810],
                                "key": "vat_invoice_total_cover_tax",
                                "description": "价税合计大写"
                            },
                            {
                                "value": "1399.98",
                                "position": [459, 764, 1330, 767, 1331, 809, 459, 810],
                                "key": "vat_invoice_total_cover_tax_digits",
                                "description": "价税合计小写"
                            },
                            {
                                "value": "743234",
                                "position": [102, 819, 180, 818, 180, 845, 102, 844],
                                "key": "vat_invoice_total_note",
                                "description": "备注"
                            },
                            {
                                "value": "合小合",
                                "position": [264, 1011, 319, 1011, 319, 1038, 264, 1038],
                                "key": "vat_invoice_drawer",
                                "description": "开票人"
                            }
                        ],
                        "kind": "lodging",   //票据种类
                        "product_list": [   //表格字段列表，每张票唯一
                            [
                                {
                                    "value": "*住宿服务*住宿服务",
                                    "position": [50, 453, 274, 453, 274, 483, 50, 483],
                                    "key": "vat_invoice_product_name",
                                    "description": "项目名称"
                                },
                                {
                                    "value": "",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "vat_invoice_specification",
                                    "description": "规格型号"
                                },
                                {
                                    "value": "79.24",
                                    "position": [1527, 464, 1596, 464, 1596, 490, 1527, 490],
                                    "key": "vat_invoice_tax",
                                    "description": "税额"
                                },
                                {
                                    "value": "6%",
                                    "position": [1274, 462, 1308, 462, 1308, 488, 1274, 488],
                                    "key": "vat_invoice_tax_rate",
                                    "description": "税率/征收率"
                                },
                                {
                                    "value": "1320.74",
                                    "position": [1101, 461, 1192, 461, 1192, 488, 1101, 488],
                                    "key": "vat_invoice_price",
                                    "description": "金额"
                                },
                                {
                                    "value": "",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "vat_invoice_unit_price",
                                    "description": "单价"
                                },
                                {
                                    "value": "",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "vat_invoice_quantity",
                                    "description": "数量"
                                },
                                {
                                    "value": "次",
                                    "position": [549, 456, 581, 456, 581, 486, 549, 486],
                                    "key": "vat_invoice_unit",
                                    "description": "单位"
                                }
                            ]
                        ],
                        "position": [238, 89, 1858, 82, 1869, 1170, 233, 1183],
                        "kind_description": "住宿",
                        "type": "vat_digital_invoice"
                    },
                    {
                        "image_angle": 0,
                        "type_description": "数电票(航空运输电子客票行程单)",
                        "rotated_image_width": 1837,
                        "flight_data_list": [
                            [
                                {
                                    "value": "上海",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "from",
                                    "description": "出发站"
                                },
                                {
                                    "value": "成都",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "to",
                                    "description": "到达站"
                                },
                                {
                                    "value": "东航",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "carrier",
                                    "description": "承运人"
                                },
                                {
                                    "value": "MU5405",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "flight_number",
                                    "description": "航班号"
                                },
                                {
                                    "value": "G",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "seat_class",
                                    "description": "座位等级"
                                },
                                {
                                    "value": "2023-11-30",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "date",
                                    "description": "航班日期"
                                },
                                {
                                    "value": "09:20",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "time",
                                    "description": "航班时间"
                                },
                                {
                                    "value": "D",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "fare_basis",
                                    "description": "客票级别/客票类别"
                                },
                                {
                                    "value": "2023-11-30",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "not_valid_before",
                                    "description": "客票生效日期"
                                },
                                {
                                    "value": "2023-11-30",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "not_valid_after",
                                    "description": "有效截至日期"
                                },
                                {
                                    "value": "1PC",
                                    "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                    "key": "allow",
                                    "description": "免费行李"
                                }
                            ]
                        ],
                        "rotated_image_height": 994,
                        "kind": "traffic",
                        "position": [154, 1243, 1941, 1250, 1953, 2206, 151, 2217],
                        "item_list": [
                            {
                                "value": "",
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                "key": "agentcode",
                                "description": "销售网点代号"
                            },
                            {
                                "value": "合小合",
                                "position": [139, 261, 223, 261, 223, 293, 139, 293],
                                "key": "passenger_name",
                                "description": "旅客姓名"
                            },
                            {
                                "value": "310222********0000",
                                "position": [506, 268, 759, 268, 759, 286, 506, 286],
                                "key": "id_no",
                                "description": "身份证件号码"
                            },
                            {
                                "value": "3180.00",
                                "position": [1599, 671, 1700, 667, 1700, 694, 1599, 688],
                                "key": "total",
                                "description": "合计金额"
                            },
                            {
                                "value": "2752.29",
                                "position": [532, 668, 631, 668, 631, 685, 532, 685],
                                "key": "fare",
                                "description": "票价"
                            },
                            {
                                "value": "50.00",
                                "position": [1140, 666, 1291, 666, 1291, 693, 1140, 693],
                                "key": "civil_aviation_fund",
                                "description": "民航发展基金"
                            },
                            {
                                "value": "119",
                                "position": [645, 665, 810, 665, 810, 691, 645, 691],
                                "key": "fuel_surcharge",
                                "description": "燃油附加费"
                            },
                            {
                                "value": "0.00",
                                "position": [1344, 666, 1466, 666, 1466, 693, 1344, 693],
                                "key": "other_taxes",
                                "description": "其他税费"
                            },
                            {
                                "value": "2023-11-03",
                                "position": [1538, 792, 1691, 792, 1691, 821, 1538, 821],
                                "key": "issued_date",
                                "description": "填开日期"
                            },
                            {
                                "value": "上海合合信息科技股份有限公司",
                                "position": [677, 785, 1011, 785, 1011, 815, 677, 815],
                                "key": "issued_by",
                                "description": "填开单位"
                            },
                            {
                                "value": "0000000000000",
                                "position": [265, 718, 446, 718, 446, 745, 265, 745],
                                "key": "e_ticket_no",
                                "description": "电子客票号码"
                            },
                            {
                                "value": "Q/不得签改退票收费",
                                "position": [1011, 261, 1237, 261, 1237, 293, 1012, 293],
                                "key": "restriction",
                                "description": "签注"
                            },
                            {
                                "value": "XXX",
                                "position": [1536, 724, 1588, 724, 1588, 751, 1536, 751],
                                "key": "insurance",
                                "description": "保险费"
                            },
                            {
                                "value": "国内",
                                "position": [293, 123, 347, 123, 347, 153, 293, 153],
                                "key": "international_flag",
                                "description": "国内国际标签"
                            },
                            {
                                "value": "红冲",
                                "position": [1423, 119, 1479, 119, 1479, 150, 1423, 150],
                                "key": "issuing_status",
                                "description": "开票状态"
                            },
                            {
                                "value": "00000000000000000000",
                                "position": [1447, 155, 1700, 155, 1700, 182, 1447, 182],
                                "key": "number_of_original_invoice",
                                "description": "原发票号码"
                            },
                            {
                                "value": "00000000000000000000",
                                "position": [1423, 187, 1676, 187, 1676, 214, 1423, 214],
                                "key": "invoice_number",
                                "description": "发票号码"
                            },
                            {
                                "value": "9%",
                                "position": [901, 665, 937, 665, 937, 691, 901, 691],
                                "key": "tax_rate",
                                "description": "增值税税率"
                            },
                            {
                                "value": "258.44",
                                "position": [946, 665, 1113, 665, 1113, 691, 946, 691],
                                "key": "tax",
                                "description": "增值税税额"
                            },
                            {
                                "value": "",
                                "position": [0, 0, 0, 0, 0, 0, 0, 0],
                                "key": "check_code",
                                "description": "验证码"
                            },
                            {
                                "value": "成都国内进出港在T2航站楼",
                                "position": [874, 718, 1169, 718, 1169, 749, 874, 749],
                                "key": "prompt_information",
                                "description": "提示信息"
                            },
                            {
                                "value": "上海合合信息科技股份有限公司",
                                "position": [245, 852, 577, 854, 577, 885, 245, 883],
                                "key": "buyer",
                                "description": "购买方名称"
                            },
                            {
                                "value": "000000000000000000",
                                "position": [1273, 862, 1533, 862, 1533, 889, 1273, 889],
                                "key": "buyer_tax_id",
                                "description": "统一社会信用代码/购买方纳税人识别号"
                            }
                        ],
                        "kind_description": "交通",
                        "type": "flight_digital_ticket"
                    }
                ]
            }
        }
    ]
}

错误码说明

错误码	描述
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	上传文件大小不符，文件大小不超过 30M
40303	文件类型不支持
40304	图片尺寸不符，图像宽高须介于 20 和 10000（像素）之间
40305	识别文件未上传
30203	基础服务故障，请稍后重试
500	服务器内部错误