文档中心
API调试

更新记录

ver.2.3.0 - 2024.07.08

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

ver.2.2.0 - 2024.07.01

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

功能描述

多票据多页接口识别

请求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

请求体说明(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

识别字段中文描述

product_list array

增票中商品信息(行输出)

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 服务器内部错误
官方社群
体验中心

联系我们