功能描述

增值稅發票識別能力可以識別增值稅發票（電子發票和紙質發票）關鍵字段內容，包括：校驗碼、復核人、開票人、發票代碼、收款人等。

接入指引

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

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

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

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

5. 開發接入步驟：

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

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

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

• Web前端直接調用
• 小程序場景下直接調用
• Android端直接調用
• iOS端直接調用

輸入限制

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

計費說明

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

請求參數

返回數據

SDK參考

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

示例代碼

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

示例

請求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeVATInvoice      //更多關于訪問域名（Endpoint）信息，請參見：http://m.bestwisewords.com/document_detail/143103.html
&FileType=jpg
&FileURL=https://vision.aliyun.com/experience/detail?&tagName=ocr&children=RecognizeVATInvoice
&<公共請求參數>

正常返回示例

XML格式

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

<RecognizeVATInvoiceResponse>
    <RequestId>56A10D65-ECE0-59DE-9775-F6494D2AF13B</RequestId>
    <Data>
        <Content>
            <Checker/>
            <PayeeAddress>浙江省杭州市西湖區杭大路9號聚龍大廈西區15-18樓0571-87901580</PayeeAddress>
            <PayeeName>三號技術有限責任公司</PayeeName>
            <PayerAddress/>
            <AntiFakeCode>60966753003521159330</AntiFakeCode>
            <PayerBankName/>
            <InvoiceNo>3753869</InvoiceNo>
            <PayerRegisterNo>91420200000123403</PayerRegisterNo>
            <WithoutTaxAmount>82.08</WithoutTaxAmount>
            <InvoiceAmount>87</InvoiceAmount>
            <PayerName>三號技術有限責任公司</PayerName>
            <TaxAmount>4.92</TaxAmount>
            <PayeeBankName>中國銀行浙江省分行35845832****</PayeeBankName>
            <Clerk/>
            <ItemName>餐飲服務</ItemName>
            <PayeeRegisterNo>91420200000123403</PayeeRegisterNo>
            <InvoiceCode>33002000411</InvoiceCode>
            <InvoiceDate>2020年12月15日</InvoiceDate>
            <SumAmount>87</SumAmount>
            <Payee/>
        </Content>
        <Box>
            <PayerRegisterNoes>118</PayerRegisterNoes>
            <PayerRegisterNoes>128</PayerRegisterNoes>
            <PayerRegisterNoes>278</PayerRegisterNoes>
            <PayerRegisterNoes>138</PayerRegisterNoes>
            <PayerAddresses>0</PayerAddresses>
            <PayerAddresses>0</PayerAddresses>
            <PayerAddresses>0</PayerAddresses>
            <PayerAddresses>0</PayerAddresses>
            <InvoiceAmounts>207</InvoiceAmounts>
            <InvoiceAmounts>347</InvoiceAmounts>
            <InvoiceAmounts>278</InvoiceAmounts>
            <InvoiceAmounts>355</InvoiceAmounts>
            <InvoiceDates>585</InvoiceDates>
            <InvoiceDates>60</InvoiceDates>
            <InvoiceDates>675</InvoiceDates>
            <InvoiceDates>69</InvoiceDates>
            <PayeeAddresses>118</PayeeAddresses>
            <PayeeAddresses>407</PayeeAddresses>
            <PayeeAddresses>407</PayeeAddresses>
            <PayeeAddresses>415</PayeeAddresses>
            <Clerks>0</Clerks>
            <Clerks>0</Clerks>
            <Clerks>0</Clerks>
            <Clerks>0</Clerks>
            <WithoutTaxAmounts>546</WithoutTaxAmounts>
            <WithoutTaxAmounts>327</WithoutTaxAmounts>
            <WithoutTaxAmounts>584</WithoutTaxAmounts>
            <WithoutTaxAmounts>337</WithoutTaxAmounts>
            <Checkers>0</Checkers>
            <Checkers>0</Checkers>
            <Checkers>0</Checkers>
            <Checkers>0</Checkers>
            <TaxAmounts>696</TaxAmounts>
            <TaxAmounts>328</TaxAmounts>
            <TaxAmounts>724</TaxAmounts>
            <TaxAmounts>335</TaxAmounts>
            <InvoiceCodes>583</InvoiceCodes>
            <InvoiceCodes>16</InvoiceCodes>
            <InvoiceCodes>643</InvoiceCodes>
            <InvoiceCodes>25</InvoiceCodes>
            <SumAmounts>207</SumAmounts>
            <SumAmounts>347</SumAmounts>
            <SumAmounts>278</SumAmounts>
            <SumAmounts>355</SumAmounts>
            <ItemNames>0</ItemNames>
            <ItemNames>0</ItemNames>
            <ItemNames>0</ItemNames>
            <ItemNames>0</ItemNames>
            <PayerNames>119</PayerNames>
            <PayerNames>109</PayerNames>
            <PayerNames>237</PayerNames>
            <PayerNames>118</PayerNames>
            <InvoiceFakeCodes>583</InvoiceFakeCodes>
            <InvoiceFakeCodes>82</InvoiceFakeCodes>
            <InvoiceFakeCodes>700</InvoiceFakeCodes>
            <InvoiceFakeCodes>90</InvoiceFakeCodes>
            <PayeeBankNames>119</PayeeBankNames>
            <PayeeBankNames>423</PayeeBankNames>
            <PayeeBankNames>282</PayeeBankNames>
            <PayeeBankNames>431</PayeeBankNames>
            <PayeeNames>117</PayeeNames>
            <PayeeNames>371</PayeeNames>
            <PayeeNames>226</PayeeNames>
            <PayeeNames>381</PayeeNames>
            <Payees>0</Payees>
            <Payees>0</Payees>
            <Payees>0</Payees>
            <Payees>0</Payees>
            <InvoiceNoes>582</InvoiceNoes>
            <InvoiceNoes>38</InvoiceNoes>
            <InvoiceNoes>623</InvoiceNoes>
            <InvoiceNoes>46</InvoiceNoes>
            <PayerBankNames>0</PayerBankNames>
            <PayerBankNames>0</PayerBankNames>
            <PayerBankNames>0</PayerBankNames>
            <PayerBankNames>0</PayerBankNames>
            <PayeeRegisterNoes>119</PayeeRegisterNoes>
            <PayeeRegisterNoes>389</PayeeRegisterNoes>
            <PayeeRegisterNoes>247</PayeeRegisterNoes>
            <PayeeRegisterNoes>400</PayeeRegisterNoes>
        </Box>
    </Data>
</RecognizeVATInvoiceResponse>

JSON格式

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

{
  "RequestId" : "56A10D65-ECE0-59DE-9775-F6494D2AF13B",
  "Data" : {
    "Content" : {
      "Checker" : "",
      "PayeeAddress" : "浙江省杭州市西湖區杭大路9號聚龍大廈西區15-18樓0571-87901580",
      "PayeeName" : "三號技術有限責任公司",
      "PayerAddress" : "",
      "AntiFakeCode" : "60966753003521159330",
      "PayerBankName" : "",
      "InvoiceNo" : 3753869,
      "PayerRegisterNo" : "91420200000123403",
      "WithoutTaxAmount" : 82.08,
      "InvoiceAmount" : 87,
      "PayerName" : "三號技術有限責任公司",
      "TaxAmount" : 4.92,
      "PayeeBankName" : "中國銀行浙江省分行35845832****",
      "Clerk" : "",
      "ItemName" : "餐飲服務",
      "PayeeRegisterNo" : "91420200000123403",
      "InvoiceCode" : 33002000411,
      "InvoiceDate" : "2020年12月15日",
      "SumAmount" : 87,
      "Payee" : ""
    },
    "Box" : {
      "PayerRegisterNoes" : [ 118, 128, 278, 138 ],
      "PayerAddresses" : [ 0, 0, 0, 0 ],
      "InvoiceAmounts" : [ 207, 347, 278, 355 ],
      "InvoiceDates" : [ 585, 60, 675, 69 ],
      "PayeeAddresses" : [ 118, 407, 407, 415 ],
      "Clerks" : [ 0, 0, 0, 0 ],
      "WithoutTaxAmounts" : [ 546, 327, 584, 337 ],
      "Checkers" : [ 0, 0, 0, 0 ],
      "TaxAmounts" : [ 696, 328, 724, 335 ],
      "InvoiceCodes" : [ 583, 16, 643, 25 ],
      "SumAmounts" : [ 207, 347, 278, 355 ],
      "ItemNames" : [ 0, 0, 0, 0 ],
      "PayerNames" : [ 119, 109, 237, 118 ],
      "InvoiceFakeCodes" : [ 583, 82, 700, 90 ],
      "PayeeBankNames" : [ 119, 423, 282, 431 ],
      "PayeeNames" : [ 117, 371, 226, 381 ],
      "Payees" : [ 0, 0, 0, 0 ],
      "InvoiceNoes" : [ 582, 38, 623, 46 ],
      "PayerBankNames" : [ 0, 0, 0, 0 ],
      "PayeeRegisterNoes" : [ 119, 389, 247, 400 ]
    }
  }
}

錯誤碼

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

安全聲明

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