Skip to main content

为什么使用国内通用票据识别API ?

在国内企业财务报销、税务申报、费用核算等通用票据处理场景中,人工录入增值税发票、火车票、全电票、航空运输电子客票行程单等票据信息时,常面临票据类型繁杂(覆盖 27 大类、40 小类)、格式标准不统一、关键信息分散、重复录入工作量大、人工核验易出错等痛点。而使用国内通用票据识别 API,可借助智能自动化识别技术,对 27 大类、40 小类主流通用票据实现全覆盖识别,精准提取发票号码、金额、税额、购票人信息、行程日期等关键信息,核心数据以符合企业财务与税务规范的 Key/Value 形式融入 JSON 格式返回。

如何使用国内通用票据识别API ?

您可以参考以下示例文件和步骤,快速验证并将通用票据识别API接入到您的系统和应用流程中。

先决条件:获取API Key

使用通用票据识别API处理文档时,您需要先获取API Key。请先登录后前往 TextIn工作台 - 账号与开发者信息 获取您的 x-ti-app-id 和 x-ti-secret-code 。

前置准备

您可以参考以下示例代码完成通用票据识别API请求的前置准备工作,替换您自己的 x-ti-app-id 和 x-ti-secret-code ,后续步骤可根据实际使用场景在main函数中插入代码。

请求体说明

支持以下两种请求格式
  1. Content-Type: application/octet-stream 要上传的图片,目前支持jpg、png、bmp、pdf、tiff、ofd、xml、单帧gif等大部分格式,pdf和ofd文件支持多页​请注意,请求体的数据格式为本地文件的二进制流,非 FormData 或其他格式。文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。
  2. Content-Type: text/plain 请求体的数据格式为文本,内容为在线文件的URL链接(支持http以及https协议)。在线文件大小不超过 50M,图像宽高须介于 20 和 10000(像素)之间。

URL参数说明

以下是国内通用票据识别API的URL参数,URL参数指以 参数名=参数值 形式拼接到 URL 上的键值对。它以?开头,不同参数之间使用&连接,形如?p1=v1&p2=v2。URL参数会影响文档的解析结果和JSON输出内容,您可按需进行设置。
  • coord_restore:选择你各字段的返回坐标逻辑,是以原图为基准,还是以票据切图为基准,默认为0,以票据切图为基准
    • 0 以票据切图为基准
    • 1 以原图为基准
  • specific_pages:指定多页样本中需要识别的样本,可以使用”1,3,2”形式来逐页选择,或”2-4”形式来连续选择,返回结果会重新排序以遵照源文件顺序,默认为空,识别所有页面。
  • crop_complete_image:选择是否需要输出各票据图片base64编码,默认为0,不输出图片base64编码。
    • 0 不输出
    • 1 输出
  • crop_value_image:选择是否返回关键字段切图的base64编码,默认为0,不返回关键字段切图base64编码。
    • 0 不返回
    • 1 返回
  • merge_digital_elec_invoice:选择是否将多页全电票的结果合并为一页,默认为0,不合并。当且仅当一份多页样本的每一页都是全电票,且每张发票的发票号码都一致时才可合并。
    • 0 不合并
    • 1 合并
  • return_ppi:选择是否返回pdf解码ppi信息,默认为0,不返回。
    • 0 不返回
    • 1 返回
  • verify_vat:选择是否开启验真,开启后将返回验真五要素,默认为0, 不开启验真。
    • 0 不开启
    • 1 开启

返回结果示例

票据信息结构化后的结果数据将按照以下JSON格式返回,下面为您提供了一段节选的返回示例。如果您想了解最全面的返回结果说明,可以在返回JSON结构说明中查看,也可以在API中查看和调试。

错误码说明