本文介紹文字識別(ocr)類目下的增值稅發票卷票識別RecognizeTicketInvoice的語法及示例。

功能描述

增值稅發票卷票識別能力支持對卷票上包括價稅合計、發票代碼、發票號碼、合計稅額、合計金額、密碼區、開票日期、稅率、購買方識別號、銷售方識別號等結構化識別。

說明
  • 增值稅發票卷票識別接口僅識別發票中的文本內容,不支持辨別發票真偽。
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產品體驗,您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等,請通過釘釘群(23109592)加入阿里云視覺智能開放平臺咨詢群聯系我們。

應用場景

  • 發票驗真:智能識別發票代碼、號碼、開具金額、開票日期四個關鍵字段,以便快速接入稅務機關發票查驗平臺進行真偽查驗,有效降低人力成本,控制業務風險。
  • 賬單記錄:對發票金額、開票日期等信息進行自動識別和錄入,應用于理財記賬場景,幫助用戶快速錄入賬單信息,降低用戶輸入成本,提升使用體驗。

特色優勢

  • 全字段識別:支持對值稅發票卷票關鍵字段的結構化識別,能夠滿足財稅報銷等場景中對票據字段的識別需求。
  • 節約成本:識別發票信息后,根據需求錄入發票信息,有效降低用戶輸入成本,提升用戶使用體驗。

接入指引

1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。

2. 開通能力:請確保您已開通文字識別服務,若未開通服務請立即開通

3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權

4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。

5. 開發接入步驟:

  • SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為文字識別(ocr)的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼:該能力常用語言的示例代碼,請參見增值稅發票卷票識別示例代碼

7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。

輸入限制

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

計費說明

關于增值稅發票卷票識別的計費方式及報價,請參見計費介紹

說明 下方調試接口為付費接口,如需免費體驗調試請前往體驗中心

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String RecognizeTicketInvoice

系統規定參數。取值:RecognizeTicketInvoice

ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeTicketInvoice/RecognizeTicketInvoice1.png

圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理

返回數據

名稱 類型 示例值 描述
RequestId String 063C0178-7EA3-4754-96FB-C0C9AE6B9AAE

請求ID。

Data Object

返回的結果數據內容。

Count Long 1

票據數量。

Height Long 594

票據旋轉后的高度。

Width Long 594

票據旋轉后的寬度。

OrgHeight Long 1417

原圖高度。

OrgWidth Long 1417

原圖寬度。

Results Array of results

識別結果。

Index Long 1

票據在圖像中的索引。

Content Object

識別內容。

InvoiceCode String 044031860107

發票代碼。

InvoiceNumber String 09267581

發票號碼。

InvoiceDate String 2018-09-20

開票日期。

AntiFakeCode String 81931914902643039780

校驗碼。

PayeeName String 深圳市xxxx有限公司

銷售方名稱。

PayeeRegisterNo String 914403002794492693

銷售方稅號。

PayerName String 深圳市xxxx有限公司

購買方名稱。

PayerRegisterNo String 91440300MA5EXWHW6F

購買方稅號。

SumAmount String ¥220.00

總價。

Type String 卷票

票據類型。支持識別以下幾種:

  • 增值稅發票
  • 出租車票
  • 定額發票
  • 機動車銷售發票
  • 卷票
KeyValueInfos Array of keyValueInfos

位置信息。

Key String 發票代碼

被識別字段名稱。

Value String 044031860107

被識別字段的值。

ValuePositions Array of valuePositions

被識別字段位置信息。四個角的坐標順時針排列。

X Long 586

矩形框X坐標。

Y Long 16

矩形框Y坐標。

ValueScore Float 100

被識別字段Value值置信度,范圍0~100。

SliceRectangle Array of sliceRectangle

票據識別矩形框四個角的坐標順時針排列。

X Long 586

矩形框X坐標。

Y Long 16

矩形框Y坐標。

SDK參考

阿里云視覺AI文字識別類目下的增值稅發票卷票識別能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為文字識別(ocr)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽

示例代碼

該能力常用語言的示例代碼,請參見增值稅發票卷票識別示例代碼

示例

請求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeTicketInvoice      //更多關于訪問域名(Endpoint)信息,請參見:http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeTicketInvoice/RecognizeTicketInvoice1.png
&公共請求參數

正常返回示例

XML格式

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

<RecognizeTicketInvoiceResponse>
    <RequestId>063C0178-7EA3-4754-96FB-C0C9AE6B9AAE</RequestId>
    <Data>
        <OrgWidth>594</OrgWidth>
        <Results>
            <Type>卷票</Type>
            <SliceRectangle>
                <X>2</X>
                <Y>19</Y>
            </SliceRectangle>
            <SliceRectangle>
                <X>586</X>
                <Y>16</Y>
            </SliceRectangle>
            <SliceRectangle>
                <X>580</X>
                <Y>1408</Y>
            </SliceRectangle>
            <SliceRectangle>
                <X>0</X>
                <Y>1410</Y>
            </SliceRectangle>
            <KeyValueInfos>
                <Value>44031860107</Value>
                <ValueScore>100</ValueScore>
                <Key>發票代碼</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>9267581</Value>
                <ValueScore>100</ValueScore>
                <Key>發票號碼</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>2018-09-20</Value>
                <ValueScore>100</ValueScore>
                <Key>開票日期</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>81931914902643030000</Value>
                <ValueScore>100</ValueScore>
                <Key>校驗碼</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>深圳市xxxx有限公司</Value>
                <ValueScore>100</ValueScore>
                <Key>銷售方名稱</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>914403002794492700</Value>
                <ValueScore>100</ValueScore>
                <Key>銷售方稅號</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>深圳市xxxx有限公司</Value>
                <ValueScore>100</ValueScore>
                <Key>購買方名稱</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>91440300MA5EXWHW6F</Value>
                <ValueScore>99</ValueScore>
                <Key>購買方稅號</Key>
            </KeyValueInfos>
            <KeyValueInfos>
                <Value>¥220.00</Value>
                <ValueScore>99</ValueScore>
                <Key>總價</Key>
            </KeyValueInfos>
            <Content>
                <PayeeName>深圳市xxxx有限公司</PayeeName>
                <AntiFakeCode>81931914902643030000</AntiFakeCode>
                <InvoiceCode>44031860107</InvoiceCode>
                <PayeeRegisterNo>914403002794492700</PayeeRegisterNo>
                <PayerRegisterNo>91440300MA5EXWHW6F</PayerRegisterNo>
                <InvoiceNumber>9267581</InvoiceNumber>
                <InvoiceDate>2018-09-20</InvoiceDate>
                <PayerName>深圳市xxxx有限公司</PayerName>
                <SumAmount>¥220.00</SumAmount>
            </Content>
            <Index>1</Index>
        </Results>
        <OrgHeight>1417</OrgHeight>
        <Height>1417</Height>
        <Count>1</Count>
        <Width>594</Width>
    </Data>
</RecognizeTicketInvoiceResponse>

JSON格式

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

{
  "RequestId" : "063C0178-7EA3-4754-96FB-C0C9AE6B9AAE",
  "Data" : {
    "OrgWidth" : 594,
    "Results" : {
      "Type" : "卷票",
      "SliceRectangle" : [ {
        "X" : 2,
        "Y" : 19
      }, {
        "X" : 586,
        "Y" : 16
      }, {
        "X" : 580,
        "Y" : 1408
      }, {
        "X" : 0,
        "Y" : 1410
      } ],
      "KeyValueInfos" : [ {
        "Value" : 44031860107,
        "ValueScore" : 100,
        "Key" : "發票代碼"
      }, {
        "Value" : 9267581,
        "ValueScore" : 100,
        "Key" : "發票號碼"
      }, {
        "Value" : "2018-09-20",
        "ValueScore" : 100,
        "Key" : "開票日期"
      }, {
        "Value" : 81931914902643030000,
        "ValueScore" : 100,
        "Key" : "校驗碼"
      }, {
        "Value" : "深圳市xxxx有限公司",
        "ValueScore" : 100,
        "Key" : "銷售方名稱"
      }, {
        "Value" : 914403002794492700,
        "ValueScore" : 100,
        "Key" : "銷售方稅號"
      }, {
        "Value" : "深圳市xxxx有限公司",
        "ValueScore" : 100,
        "Key" : "購買方名稱"
      }, {
        "Value" : "91440300MA5EXWHW6F",
        "ValueScore" : 99,
        "Key" : "購買方稅號"
      }, {
        "Value" : "¥220.00",
        "ValueScore" : 99,
        "Key" : "總價"
      } ],
      "Content" : {
        "PayeeName" : "深圳市xxxx有限公司",
        "AntiFakeCode" : 81931914902643030000,
        "InvoiceCode" : 44031860107,
        "PayeeRegisterNo" : 914403002794492700,
        "PayerRegisterNo" : "91440300MA5EXWHW6F",
        "InvoiceNumber" : 9267581,
        "InvoiceDate" : "2018-09-20",
        "PayerName" : "深圳市xxxx有限公司",
        "SumAmount" : "¥220.00"
      },
      "Index" : 1
    },
    "OrgHeight" : 1417,
    "Height" : 1417,
    "Count" : 1,
    "Width" : 594
  }
}

錯誤碼

關于增值稅發票卷票識別的錯誤碼,詳情請參見常見錯誤碼

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規。
  • 通過體驗調試上傳的臨時文件有效期為1小時,在24小時后會被系統自動清理刪除。