备案控制台
文档
产品文档
输入文档关键字查找
首页 文字识别 开发参考 API参考 API目录 票据凭证识别 RecognizeNonTaxInvoice - 非税收入发票识别

RecognizeNonTaxInvoice - 非税收入发票识别

更新时间：
一键部署
提交缺陷
产品详情
我的收藏

非税收入发票识别。

接口说明

本接口适用场景

  • 阿里云非税收入发票识别，是阿里云官方自研 OCR 文字识别产品，适用于识别非税收入发票所包含的票据号码、标题、开票日期、合计金额、收款人等关键信息的场景。
  • 阿里云 OCR 产品基于阿里巴巴达摩院强大的 AI 技术及海量数据，历经多年沉淀打磨，具有服务稳定、操作简易、实时性高、能力全面等几大优势。
  • 本接口图片示例

本接口核心能力

分类概述
图像增强默认支持图像增强，包括图像自动旋转、畸变自动矫正、模糊图片自动增强等能力。
多类型覆盖支持模糊、光照不均、透视畸变、任意背景等低质量图像识别。
高精度识别总体识别准确率可达 97%。

如何使用本接口

步骤概述
1开通 票据凭证识别 服务。开通服务前后，您可以通过体验馆免费体验本功能识别效果。
2购买车辆物流识别资源包。本 API 会赠送免费额度，可使用免费额度测试。您也可以不购买资源包，系统会通过“按量付费”方式按实际调用量自动扣款。
3可以参照调试页面提供的代码示例完成 API 接入开发。接入完成后，调用 API 获取识别结果。如果使用子账号调用接口，需要阿里云账号（主账号）对 RAM 账号进行授权。创建 RAM 用户的具体操作，请参考：创建 RAM 用户。文字识别服务提供一种系统授权策略，即 AliyunOCRFullAccess。具体授权操作，请参见在用户页面为 RAM 用户授权。

重要提示

类型概述
图片格式
  • 本接口支持：PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。暂不支持 PDF 格式。
图片尺寸
  • 图片长宽需要大于 15 像素，小于 8192 像素。
  • 长宽比需要小于 50。
  • 如需达到较好识别效果，建议长宽均大于 500px。
  • 图片尺寸过小，会影响识别精度。图片内单字大小在 10-50px 内时，识别效果较好。
图片大小
  • 图片二进制文件不能超过 10MB。
  • 图片过大会影响接口响应速度，建议使用小于 1.5M 图片进行识别，且通过传图片 URL 的方式调用接口。
其他提示
  • 接口会自动处理反光、扭曲等干扰信息，但会影响精度。请尽量选择清晰度高、无反光、无扭曲的图片。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用背景高亮的方式表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
ocr:RecognizeNonTaxInvoiceRead
  • 全部资源
    *
    无
无

请求参数

名称类型必填描述示例值
Urlstring否
  • 本字段和 body 字段二选一，不可同时透传或同时为空。
  • 图片链接（长度不超 2048，不支持 base64）。
https://img.alicdn.com/tfs/TB1Wo7eXAvoK1RjSZFDXXXY3pXa-2512-3509.jpg
bodybyte否
  • 本字段和 URL 字段二选一，不可同时透传或同时为空。
  • 图片二进制文件，最大 10MB。
  • 使用 HTTP 方式调用，把图片二进制文件放到 HTTP body 中上传即可。
  • 使用 SDK 的方式调用，把图片放到 SDK 的 body 中即可。
图片二进制

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求唯一 ID

43A29C77-405E-4CC0-BC55-EE694AD00655
Datastring

返回数据

{"data": {"title": "中央非税收入统一票据(电子)", "invoiceCode": "00010120", "payerCreditCode": "", "payerName": "上饶市合诚娱乐设备有限公司", "invoiceNumber": "0026421031", "validationCode": "656aa9", "invoiceDate": "2021-03-19", "totalAmountInWords": "陆佰元整", "totalAmount": "600.00", "additionalInfo": "申请号:2012306329368 缴费日期:2021-03-17 缴费方式:网上支付 订单号:1105000114740512", "payeeName": "国家知识产权局专利局", "reviewer": "胡文举", "recipient": "刘代彬", "invoiceDetails": [{"number": "056990126100", "name": "外观设计专利第10年年费", "unit": "元", "quantity": "0.3", "specification": "2,000.00", "amount": "600.00", "remark": ""}]}, "ftype": 0, "height": 1800, "orgHeight": 1800, "orgWidth": 2977, "prism_keyValueInfo": [{"key": "title", "keyProb": 100, "value": "中央非税收入统一票据(电子)", "valuePos": [{"x": 680, "y": 63}, {"x": 1618, "y": 62}, {"x": 1618, "y": 139}, {"x": 681, "y": 141}], "valueProb": 100}, {"key": "invoiceCode", "keyProb": 100, "value": "00010120", "valuePos": [{"x": 421, "y": 228}, {"x": 421, "y": 276}, {"x": 242, "y": 276}, {"x": 242, "y": 228}], "valueProb": 100}, {"key": "payerCreditCode", "keyProb": 100, "value": "", "valueProb": 100}, {"key": "payerName", "keyProb": 100, "value": "上饶市合诚娱乐设备有限公司", "valuePos": [{"x": 189, "y": 357}, {"x": 664, "y": 356}, {"x": 664, "y": 403}, {"x": 190, "y": 404}], "valueProb": 100}, {"key": "invoiceNumber", "keyProb": 100, "value": "0026421031", "valuePos": [{"x": 1934, "y": 222}, {"x": 1935, "y": 272}, {"x": 1718, "y": 274}, {"x": 1718, "y": 224}], "valueProb": 100}, {"key": "validationCode", "keyProb": 100, "value": "656aa9", "valuePos": [{"x": 1800, "y": 303}, {"x": 1800, "y": 349}, {"x": 1666, "y": 351}, {"x": 1665, "y": 304}], "valueProb": 100}, {"key": "invoiceDate", "keyProb": 100, "value": "2021-03-19", "valuePos": [{"x": 1924, "y": 382}, {"x": 1924, "y": 431}, {"x": 1711, "y": 431}, {"x": 1711, "y": 382}], "valueProb": 100}, {"key": "totalAmountInWords", "keyProb": 100, "value": "陆佰元整", "valuePos": [{"x": 607, "y": 1110}, {"x": 607, "y": 1167}, {"x": 417, "y": 1167}, {"x": 417, "y": 1110}], "valueProb": 100}, {"key": "totalAmount", "keyProb": 100, "value": "600.00", "valuePos": [{"x": 1702, "y": 1113}, {"x": 1702, "y": 1163}, {"x": 1576, "y": 1163}, {"x": 1576, "y": 1113}], "valueProb": 100}, {"key": "additionalInfo", "keyProb": 100, "value": "申请号:2012306329368 缴费日期:2021-03-17 缴费方式:网上支付 订单号:1105000114740512", "valuePos": [{"x": 121, "y": 1197}, {"x": 1869, "y": 1194}, {"x": 1870, "y": 1252}, {"x": 122, "y": 1254}], "valueProb": 100}, {"key": "payeeName", "keyProb": 100, "value": "国家知识产权局专利局", "valuePos": [{"x": 886, "y": 1645}, {"x": 886, "y": 1698}, {"x": 424, "y": 1700}, {"x": 423, "y": 1646}], "valueProb": 100}, {"key": "reviewer", "keyProb": 100, "value": "胡文举", "valuePos": [{"x": 1559, "y": 1653}, {"x": 1559, "y": 1708}, {"x": 1418, "y": 1708}, {"x": 1418, "y": 1653}], "valueProb": 100}, {"key": "recipient", "keyProb": 100, "value": "刘代彬", "valuePos": [{"x": 2090, "y": 1653}, {"x": 2090, "y": 1708}, {"x": 1947, "y": 1708}, {"x": 1947, "y": 1653}], "valueProb": 100}, {"key": "invoiceDetails", "keyProb": 100, "value": "[{\"number\":\"056990126100\",\"name\":\"外观设计专利第10年年费\",\"unit\":\"元\",\"quantity\":\"0.3\",\"specification\":\"2,000.00\",\"amount\":\"600.00\",\"remark\":\"\"}]", "valueProb": 100}], "sliceRect": {"x0": 288, "y0": 0, "x1": 2669, "y1": 0, "x2": 2669, "y2": 1800, "x3": 287, "y3": 1800}, "width": 2977}
Codestring

状态码

200
Messagestring

详细信息

message

返回参数说明


字段类型说明
dataobject结构化信息。
prism_keyValueInfolist结构化信息的坐标信息。
ftypeint是否为复印件（1：是，0：否）。
heightint算法矫正图片后的高度。
widthint算法矫正图片后的宽度。
orgHeightint原图的高度。
orgWidthint原图的宽度。
sliceRectlist检测出的子图坐标信息。

结构化信息（data 字段）

字段类型说明
additionalInfostring其他信息。
invoiceCodestring票据代码。
invoiceDatestring开票日期。
invoiceDetailslist项目详单。
invoiceNumberstring票据号码。
payeeNamestring收款单位。
payerCreditCodestring交款人统一社会信用代码。
payerNamestring交款人。
recipientstring收款人。
reviewerstring复核人。
titlestring标题。
totalAmountstring合计金额（小写）。
totalAmountInWordsstring合计金额（大写）。
validationCodestring校验码。

发票详单信息（invoiceDetails 字段）

字段类型说明
amountstring金额。
namestring项目名称。
numberstring项目编号。
quantitystring数量。
remarkstring备注。
specificationstring标准。
unitstring单位。

结构化坐标信息（prism_keyValueInfo 字段）

字段类型说明
keystring识别出的字段名称。
keyProbint字段名称置信度。
valuestring识别出的字段名称对应的值。
valueProbint字段名称对应值的置信度。
valuePoslist字段在原图中的四个点坐标（左上、右上、右下、左下）。

示例

正常返回示例

JSON格式

{
  "RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655",
  "Data": "{\"data\": {\"title\": \"中央非税收入统一票据(电子)\", \"invoiceCode\": \"00010120\", \"payerCreditCode\": \"\", \"payerName\": \"上饶市合诚娱乐设备有限公司\", \"invoiceNumber\": \"0026421031\", \"validationCode\": \"656aa9\", \"invoiceDate\": \"2021-03-19\", \"totalAmountInWords\": \"陆佰元整\", \"totalAmount\": \"600.00\", \"additionalInfo\": \"申请号:2012306329368 缴费日期:2021-03-17 缴费方式:网上支付 订单号:1105000114740512\", \"payeeName\": \"国家知识产权局专利局\", \"reviewer\": \"胡文举\", \"recipient\": \"刘代彬\", \"invoiceDetails\": [{\"number\": \"056990126100\", \"name\": \"外观设计专利第10年年费\", \"unit\": \"元\", \"quantity\": \"0.3\", \"specification\": \"2,000.00\", \"amount\": \"600.00\", \"remark\": \"\"}]}, \"ftype\": 0, \"height\": 1800, \"orgHeight\": 1800, \"orgWidth\": 2977, \"prism_keyValueInfo\": [{\"key\": \"title\", \"keyProb\": 100, \"value\": \"中央非税收入统一票据(电子)\", \"valuePos\": [{\"x\": 680, \"y\": 63}, {\"x\": 1618, \"y\": 62}, {\"x\": 1618, \"y\": 139}, {\"x\": 681, \"y\": 141}], \"valueProb\": 100}, {\"key\": \"invoiceCode\", \"keyProb\": 100, \"value\": \"00010120\", \"valuePos\": [{\"x\": 421, \"y\": 228}, {\"x\": 421, \"y\": 276}, {\"x\": 242, \"y\": 276}, {\"x\": 242, \"y\": 228}], \"valueProb\": 100}, {\"key\": \"payerCreditCode\", \"keyProb\": 100, \"value\": \"\", \"valueProb\": 100}, {\"key\": \"payerName\", \"keyProb\": 100, \"value\": \"上饶市合诚娱乐设备有限公司\", \"valuePos\": [{\"x\": 189, \"y\": 357}, {\"x\": 664, \"y\": 356}, {\"x\": 664, \"y\": 403}, {\"x\": 190, \"y\": 404}], \"valueProb\": 100}, {\"key\": \"invoiceNumber\", \"keyProb\": 100, \"value\": \"0026421031\", \"valuePos\": [{\"x\": 1934, \"y\": 222}, {\"x\": 1935, \"y\": 272}, {\"x\": 1718, \"y\": 274}, {\"x\": 1718, \"y\": 224}], \"valueProb\": 100}, {\"key\": \"validationCode\", \"keyProb\": 100, \"value\": \"656aa9\", \"valuePos\": [{\"x\": 1800, \"y\": 303}, {\"x\": 1800, \"y\": 349}, {\"x\": 1666, \"y\": 351}, {\"x\": 1665, \"y\": 304}], \"valueProb\": 100}, {\"key\": \"invoiceDate\", \"keyProb\": 100, \"value\": \"2021-03-19\", \"valuePos\": [{\"x\": 1924, \"y\": 382}, {\"x\": 1924, \"y\": 431}, {\"x\": 1711, \"y\": 431}, {\"x\": 1711, \"y\": 382}], \"valueProb\": 100}, {\"key\": \"totalAmountInWords\", \"keyProb\": 100, \"value\": \"陆佰元整\", \"valuePos\": [{\"x\": 607, \"y\": 1110}, {\"x\": 607, \"y\": 1167}, {\"x\": 417, \"y\": 1167}, {\"x\": 417, \"y\": 1110}], \"valueProb\": 100}, {\"key\": \"totalAmount\", \"keyProb\": 100, \"value\": \"600.00\", \"valuePos\": [{\"x\": 1702, \"y\": 1113}, {\"x\": 1702, \"y\": 1163}, {\"x\": 1576, \"y\": 1163}, {\"x\": 1576, \"y\": 1113}], \"valueProb\": 100}, {\"key\": \"additionalInfo\", \"keyProb\": 100, \"value\": \"申请号:2012306329368 缴费日期:2021-03-17 缴费方式:网上支付 订单号:1105000114740512\", \"valuePos\": [{\"x\": 121, \"y\": 1197}, {\"x\": 1869, \"y\": 1194}, {\"x\": 1870, \"y\": 1252}, {\"x\": 122, \"y\": 1254}], \"valueProb\": 100}, {\"key\": \"payeeName\", \"keyProb\": 100, \"value\": \"国家知识产权局专利局\", \"valuePos\": [{\"x\": 886, \"y\": 1645}, {\"x\": 886, \"y\": 1698}, {\"x\": 424, \"y\": 1700}, {\"x\": 423, \"y\": 1646}], \"valueProb\": 100}, {\"key\": \"reviewer\", \"keyProb\": 100, \"value\": \"胡文举\", \"valuePos\": [{\"x\": 1559, \"y\": 1653}, {\"x\": 1559, \"y\": 1708}, {\"x\": 1418, \"y\": 1708}, {\"x\": 1418, \"y\": 1653}], \"valueProb\": 100}, {\"key\": \"recipient\", \"keyProb\": 100, \"value\": \"刘代彬\", \"valuePos\": [{\"x\": 2090, \"y\": 1653}, {\"x\": 2090, \"y\": 1708}, {\"x\": 1947, \"y\": 1708}, {\"x\": 1947, \"y\": 1653}], \"valueProb\": 100}, {\"key\": \"invoiceDetails\", \"keyProb\": 100, \"value\": \"[{\\\"number\\\":\\\"056990126100\\\",\\\"name\\\":\\\"外观设计专利第10年年费\\\",\\\"unit\\\":\\\"元\\\",\\\"quantity\\\":\\\"0.3\\\",\\\"specification\\\":\\\"2,000.00\\\",\\\"amount\\\":\\\"600.00\\\",\\\"remark\\\":\\\"\\\"}]\", \"valueProb\": 100}], \"sliceRect\": {\"x0\": 288, \"y0\": 0, \"x1\": 2669, \"y1\": 0, \"x2\": 2669, \"y2\": 1800, \"x3\": 287, \"y3\": 1800}, \"width\": 2977}",
  "Code": "200",
  "Message": "message"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2022-03-16新增 OpenAPI看变更集

SDK 调用 通过 SDK 调用此接口的示例请参考开发者中心
文档推荐
  • 本页导读 （0）
文档反馈