本文為您介紹文字識別(ocr)類目下的增值稅發票識別RecognizeVATInvoice的語法及示例。
功能描述
增值稅發票識別能力可以識別增值稅發票(電子發票和紙質發票)關鍵字段內容,包括:校驗碼、復核人、開票人、發票代碼、收款人等。
接入指引
1. 注冊阿里云賬號:打開阿里云官網,在阿里云官網右上角,單擊立即注冊,按照操作提示完成賬號注冊。
2. 開通能力:請確保您已開通文字識別服務,若未開通服務請立即開通。
3. 創建AccessKey:請確保您已創建AccessKey,如果您使用的是子賬號AccessKey,您需要給子賬號賦予AliyunVIAPIFullAccess權限,具體操作,請參見RAM授權。
4. 在線調試(可選):您可以通過OpenAPI Explorer在線調試能力,查看完整的調用示例代碼及SDK依賴信息,也可以下載完整的工程。
5. 開發接入步驟:
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為文字識別(ocr)的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
6. 示例代碼:該能力常用語言的示例代碼,請參見增值稅發票識別示例代碼。
7. 客戶端直接調用:該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式:PNG、JPG、JPEG、BMP、WebP、PDF。
- 圖像大小:不超過3 MB。
- 圖像分辨率:大于15×15像素,小于4096×4096像素。
- URL地址中不能包含中文字符。
計費說明
關于增值稅發票識別的計費方式及報價,請參見計費介紹。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | RecognizeVATInvoice | 系統規定參數。取值:RecognizeVATInvoice。 |
FileURL | String | 是 | http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeVATInvoice/RecognizeVATInvoice3.jpg | 圖像URL地址。推薦使用上海地域的OSS鏈接,對于文件在本地或者非上海地域OSS鏈接的情況,請參見文件URL處理。 |
FileType | String | 是 | jpg | 輸入的圖像格式參數固定為 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
RequestId | String | 56A10D65-ECE0-59DE-9775-F6494D2AF13B | 請求ID。 |
Data | Object | 返回的結果數據內容。 |
|
Box | Object | 發票關鍵字位置框,格式為[左上角點X軸坐標,左上角點Y軸坐標,右下角點X軸坐標,右下角點Y軸坐標]。 |
|
PayerRegisterNoes | Array of Float | 358,262,567,290 | 購買方納稅人識別號位置框信息。 |
PayeeAddresses | Array of Float | 355,909,734,939 | 購買方地址及電話位置框信息。 |
PayeeBankNames | Array of Float | 354,947,938,977 | 購買方開戶行及賬號位置框信息。 |
Checkers | Array of Float | 589,1003,662,1033 | 復核人位置框信息。 |
TaxAmounts | Array of Float | 1606,721,1658,748 | 合計稅額位置框信息。 |
SumAmounts | Array of Float | 32,774,629,805 | 價稅合計位置框信息。 |
Clerks | Array of Float | 986,1003,1060,1033 | 開票人位置框信息。 |
InvoiceNoes | Array of Float | 1377,78,1478,105 | 發票號碼位置框信息。 |
InvoiceDates | Array of Float | 1376,115,1596,145 | 開票日期位置框信息。 |
InvoiceCodes | Array of Float | 1378,41,1520,68 | 發票代碼位置框信息。 |
InvoiceFakeCodes | Array of Float | 1376,153,1640,181 | 校驗碼位置框信息。 |
PayerNames | Array of Float | 354,222,700,255 | 購買方名稱位置框信息。 |
PayerBankNames | Array of Float | 0,0,0,0 | 銷售方開戶行及賬號位置框信息。 |
Payees | Array of Float | 189,1003,264,1033 | 收款人位置框信息。 |
PayeeNames | Array of Float | 356,833,633,865 | 購買方名稱位置框信息。 |
InvoiceAmounts | Array of Float | 1364, 776,1438,804 | 價稅合計位置框信息。 |
WithoutTaxAmounts | Array of Float | 1265,721,1339,749 | 合計金額位置框信息。 |
PayerAddresses | Array of Float | 0,0,0,0 | 銷售方地址及電話位置框信息。 |
PayeeRegisterNoes | Array of Float | 356,873,571,902 | 銷售方納稅人識別號位置框信息。 |
ItemNames | Array of Integer | 0,0,0,0 | 貨物或應稅勞務、服務名稱位置框信息。 |
Content | Object | 合計金額識別發票各項結果。 |
|
PayerAddress | String | 浙江省杭州市西湖區杭大路9號聚龍大廈西區15-18樓0571-87901580 | 購買方地址、電話。 |
PayeeRegisterNo | String | 91420200000123403 | 銷售方納稅人識別號。 |
PayeeBankName | String | 中國銀行浙江省分行35845832**** | 銷售方開戶行及賬號。 |
InvoiceNo | String | 03753869 | 發票號碼。 |
PayerRegisterNo | String | 91420200000123403 | 購買方納稅人識別號。 |
Checker | String | 張三 | 復核人。 |
TaxAmount | String | 9.52 | 合計稅額。 |
InvoiceDate | String | 20190415 | 開票日期。 |
WithoutTaxAmount | String | 190.48 | 合計金額。 |
InvoiceAmount | String | 200.00 | 價稅合計(小寫)。 |
AntiFakeCode | String | 02702870934284730434 | 校驗碼。 |
PayerName | String | 三號技術有限責任公司 | 購買方名稱。 |
Payee | String | 張三 | 收款人。 |
SumAmount | String | 87 | 價稅合計(大寫)。 |
PayerBankName | String | 6221************1234 | 購買方開戶行及賬號。 |
Clerk | String | 張三 | 開票人。 |
PayeeName | String | 上海機場(集團)有限公司 | 銷售方名稱。 |
PayeeAddress | String | 上海虹橋機場迎賓二路161號22342185 | 銷售方地址、電話。 |
InvoiceCode | String | 031001600311 | 發票代碼。 |
ItemName | Array of String | 餐飲服務 | 貨物或應稅勞務、服務名稱。 |
SDK參考
阿里云視覺AI文字識別類目下的增值稅發票識別能力推薦使用SDK調用,支持多種編程語言,調用時請選擇AI類目為文字識別(ocr)的SDK包,文件參數通過SDK調用可支持本地文件及任意URL,具體可參見SDK總覽。
示例代碼
該能力常用語言的示例代碼,請參見增值稅發票識別示例代碼。
示例
請求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeVATInvoice //更多關于訪問域名(Endpoint)信息,請參見:http://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小時后會被系統自動清理刪除。