本文介绍定额发票识别RecognizeQuotaInvoice的语法及示例。

功能描述

定额发票识别可以对定额发票上的发票号码、发票代码、发票金额进行结构化识别。

应用场景

  • 财税报销:识别录入各类定额发票票面关键信息,应用于税务核算及内部报销场景,有效减少人工核算工作量,简化报销流程,实现财务报销的自动化。
  • 账单记录:识别提取发票金额信息,应用于理财记账场景,快速录入账单信息,有效降低用户输入成本,提升用户使用体验。

特色优势

  • 实现自动化:有效减少人工核算工作量,简化报销流程,实现财务报销的自动化。
  • 节约成本:快速录入账单信息,有效降低用户输入成本,提升用户使用体验。

前提条件

请确保您已开通文字识别服务,若未开通服务请立即开通

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过4M。
  • 图像分辨率:大于15×15像素,小于4096×4096像素。
  • URL地址中不能包含中文字符。

计费说明

关于定额发票识别的计费方式及报价,请参见计费介绍

说明 下方调试接口为付费接口。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizeQuotaInvoice

系统规定参数。取值:RecognizeQuotaInvoice

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/ocr/%E5%AE%9A%E9%A2%9D%E5%8F%91%E7%A5%A87.jpg

图像URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
RequestId String BC4C12D0-7FD3-419A-B997-A91212DF6D82

请求ID。

Data Object

返回的结果数据内容。

Angle Long 1

票据被旋转的角度。范围为0~360,0表示向上,90表示向右,180表示向下,270度表示向左。

Height Long 624

票据旋转后的高度。

Width Long 865

票据旋转后的宽度。

OrgHeight Long 610

原图高度。

OrgWidth Long 855

原图宽度。

Content Object

识别内容。

SumAmount String 壹拾元整

大写金额。

InvoiceCode String 144031800103

发票代码。

InvoiceNo String 40637706

发票号码。

InvoiceAmount String 10

小写金额。

InvoiceDetails String 税务局代码:国税,行政区划代码:深圳市,年份:2018,发票行业代码:None,发票类别代码:None,金额版:万元版,批次号:03

发票代码解析。

KeyValueInfos Array of keyValueInfos

位置信息。

Key String 大写金额

被识别字段名称。

Value String 壹拾元整

被识别字段的值。

ValuePositions Array of valuePositions

被识别字段位置信息。四个角的坐标顺时针排列。

X Long 544

矩形框X坐标。

Y Long 387

矩形框Y坐标。

ValueScore Float 100

被识别字段Value值置信度,范围0~100。

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeQuotaInvoice
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/ocr/%E5%AE%9A%E9%A2%9D%E5%8F%91%E7%A5%A87.jpg
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizeQuotaInvoiceResponse>
    <RequestId>BC4C12D0-7FD3-419A-B997-A91212DF6D82</RequestId>
    <Data>
        <OrgWidth>855</OrgWidth>
        <Angle>1</Angle>
        <KeyValueInfos>
            <ValuePositions>
                <X>544</X>
                <Y>387</Y>
            </ValuePositions>
            <ValuePositions>
                <X>544</X>
                <Y>443</Y>
            </ValuePositions>
            <ValuePositions>
                <X>308</X>
                <Y>443</Y>
            </ValuePositions>
            <ValuePositions>
                <X>308</X>
                <Y>387</Y>
            </ValuePositions>
            <Value>壹拾元整</Value>
            <ValueScore>100</ValueScore>
            <Key>大写金额</Key>
        </KeyValueInfos>
        <KeyValueInfos>
            <ValuePositions>
                <X>310</X>
                <Y>237</Y>
            </ValuePositions>
            <ValuePositions>
                <X>575</X>
                <Y>234</Y>
            </ValuePositions>
            <ValuePositions>
                <X>576</X>
                <Y>259</Y>
            </ValuePositions>
            <ValuePositions>
                <X>311</X>
                <Y>262</Y>
            </ValuePositions>
            <Value>144031800103</Value>
            <ValueScore>100</ValueScore>
            <Key>发票代码</Key>
        </KeyValueInfos>
        <KeyValueInfos>
            <ValuePositions>
                <X>480</X>
                <Y>298</Y>
            </ValuePositions>
            <ValuePositions>
                <X>480</X>
                <Y>321</Y>
            </ValuePositions>
            <ValuePositions>
                <X>309</X>
                <Y>321</Y>
            </ValuePositions>
            <ValuePositions>
                <X>309</X>
                <Y>298</Y>
            </ValuePositions>
            <Value>40637706</Value>
            <ValueScore>100</ValueScore>
            <Key>发票号码</Key>
        </KeyValueInfos>
        <KeyValueInfos>
            <Value/>
            <ValueScore>100</ValueScore>
            <Key>小写金额</Key>
        </KeyValueInfos>
        <KeyValueInfos>
            <ValuePositions>
                <X>310</X>
                <Y>237</Y>
            </ValuePositions>
            <ValuePositions>
                <X>575</X>
                <Y>234</Y>
            </ValuePositions>
            <ValuePositions>
                <X>576</X>
                <Y>259</Y>
            </ValuePositions>
            <ValuePositions>
                <X>311</X>
                <Y>262</Y>
            </ValuePositions>
            <Value>税务局代码:国税,行政区划代码:深圳市,年份:2018,发票行业代码:None,发票类别代码:None,金额版:万元版,批次号:03</Value>
            <ValueScore>100</ValueScore>
            <Key>发票代码解析</Key>
        </KeyValueInfos>
        <Content>
            <InvoiceDetails>{"批次号":"03","年份":"2018","税务局代码":"国税","发票行业代码":"None","金额版":"万元版","行政区划代码":"深圳市","发票类别代码":"None"}</InvoiceDetails>
            <InvoiceCode>144031800103</InvoiceCode>
            <InvoiceNo>40637706</InvoiceNo>
            <InvoiceAmount/>
            <SumAmount>壹拾元整</SumAmount>
        </Content>
        <OrgHeight>610</OrgHeight>
        <Height>624</Height>
        <Width>865</Width>
    </Data>
</RecognizeQuotaInvoiceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "BC4C12D0-7FD3-419A-B997-A91212DF6D82",
  "Data" : {
    "OrgWidth" : 855,
    "Angle" : 1,
    "KeyValueInfos" : [ {
      "ValuePositions" : [ {
        "X" : 544,
        "Y" : 387
      }, {
        "X" : 544,
        "Y" : 443
      }, {
        "X" : 308,
        "Y" : 443
      }, {
        "X" : 308,
        "Y" : 387
      } ],
      "Value" : "壹拾元整",
      "ValueScore" : 100,
      "Key" : "大写金额"
    }, {
      "ValuePositions" : [ {
        "X" : 310,
        "Y" : 237
      }, {
        "X" : 575,
        "Y" : 234
      }, {
        "X" : 576,
        "Y" : 259
      }, {
        "X" : 311,
        "Y" : 262
      } ],
      "Value" : 144031800103,
      "ValueScore" : 100,
      "Key" : "发票代码"
    }, {
      "ValuePositions" : [ {
        "X" : 480,
        "Y" : 298
      }, {
        "X" : 480,
        "Y" : 321
      }, {
        "X" : 309,
        "Y" : 321
      }, {
        "X" : 309,
        "Y" : 298
      } ],
      "Value" : 40637706,
      "ValueScore" : 100,
      "Key" : "发票号码"
    }, {
      "Value" : "",
      "ValueScore" : 100,
      "Key" : "小写金额"
    }, {
      "ValuePositions" : [ {
        "X" : 310,
        "Y" : 237
      }, {
        "X" : 575,
        "Y" : 234
      }, {
        "X" : 576,
        "Y" : 259
      }, {
        "X" : 311,
        "Y" : 262
      } ],
      "Value" : "税务局代码:国税,行政区划代码:深圳市,年份:2018,发票行业代码:None,发票类别代码:None,金额版:万元版,批次号:03",
      "ValueScore" : 100,
      "Key" : "发票代码解析"
    } ],
    "Content" : {
      "InvoiceDetails" : "{\"批次号\":\"03\",\"年份\":\"2018\",\"税务局代码\":\"国税\",\"发票行业代码\":\"None\",\"金额版\":\"万元版\",\"行政区划代码\":\"深圳市\",\"发票类别代码\":\"None\"}",
      "InvoiceCode" : 144031800103,
      "InvoiceNo" : 40637706,
      "InvoiceAmount" : "",
      "SumAmount" : "壹拾元整"
    },
    "OrgHeight" : 610,
    "Height" : 624,
    "Width" : 865
  }
}

错误码

关于定额发票识别的错误码,详情请参见常见错误码

SDK参考

阿里云视觉AI能力支持使用SDK调用,具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。