Skip to main content

返回结果示例

当您使用国内通用票据识别API结构化票据样本时,结构化后的数据将按照以下结构的JSON格式返回。

常规字段说明

  • x_request_id:该请求的唯一标识。
  • code:错误码,200表示成功。详情见快速启动-错误码说明
  • message:错误信息,成功时为”success”。
  • version:版本号,例如”v1.0.0”。
  • duration:推理时间(毫秒),例如”999”。

全局信息说明:pages

国内通用票据识别API的返回结果会对每套票据与其在样本文件中的所在页数相关联,您可以在对应的pages中,查看任意上传文件页数内的票据的结构化结果。
  • pageNum:样本总页数,例如“10”。
  • pages:样本每页的识别结果。
    • result:主要识别结果。
    • page_number:页码,从0开始计算,例如“10”。
    • ppi:pdf解析分辨率,默认144。
    • width:原图像素宽度。
    • height:原图像素高度。

主要结果说明:result对象

国内通用票据识别API返回结果的result,其中同时包含了票据的文本结构化信息与票据的图像信息。

object_list:票据的文本结构化信息与票据的图像信息

object_list 包含票据的各类图像信息,具体包括:切分后单张票据的角度、转正后的宽度和高度(单位 px)、若为 PDF 样本则包含其所在页码、图片的 base64 编码,以及开启图片切分后单张票据在原图中的坐标位置。
  • type:单份国内通用票据的类型,例如vat_invoice。
  • type_description:单份国内通用票据类型的中文描述,例如增值税发票。
  • image_angle:切分后单张票据的角度,角度分别为0⬆️、90➡️、180⬇️、270⬅️,例如“0”。
  • rotated_image_width:切分后单张票据转正后的宽度,单位px,例如“1500”。
  • rotated_image_height:切分后单张票据转正后的高度单位px,例如“3000”。
  • kind:切分后单张票据的使用类型,例如“traffic”。
  • kind_description:切分后单张票据使用类型的中文描述,例如“交通”。
  • position:图片切分后单张票据在原图中的坐标位置,依次为左上,右上,右下,左下。例如[10, 10, 100, 10, 100, 50, 10, 50]。
  • item_list:票据文本结构化信息的识别字段。
    • key:识别字段名称,例如“title”。
    • value:识别字段值,例如“北京市医疗门诊收费票据(电子)”。
    • position:识别字段在切分后票据转正后的坐标位置,例如“[ 100, 100, 200, 100, 200, 200, 100, 200 ]”。
    • description:识别字段中文描述,例如“标题”。
  • stamp_list:票据中的印章识别结果
    • key:印章识别结果字段名,例如“stamp_info”,
      • stamp_info 印章内容
      • stamp_type 印章类型 印章类型支持以下印章判断,
        • 全国统一发票监制章
        • 发票专用章
        • 其他
      • stamp_invoice_seller_id 印章销售方纳税人识别号
    • value:印章字段识别结果,例如“全国统一发票监制章”。
    • description:印章字段识别结果的中文描述,例如“印章类型”。
    • position:印章在图中的坐标位置,例如“[ 100, 100, 200, 100, 200, 200, 100, 200 ]”。
  • qr_code_list:票据中的二维码识别结果
    • key:二维码内容,例如“qr_code_info”
    • value:二维码识别结果,例如“01,61,,24118999111000010898”
    • description:识别字段中文描述,例如“二维码内容”
    • position:二维码在图中的坐标位置,例如“[ 100, 100, 200, 100, 200, 200, 100, 200 ]”。

Type字段返回结果说明

票种字段对照表-item_list

增值税发票 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

过路过桥费发票 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

医疗收费明细 medical_invoice_list

海关进出口报关单 customs_declaration

海关专用缴款书 customs_duty_payment_certificate

税收完税证明 tax_payment_certificate

其他 other