支持包括發票代碼、開票號碼、開票日期、發票金額、增值稅稅額、合格證號、購買方名稱、購買方身份證號/代碼等關鍵字段結構化識別輸出。
接口說明
本接口適用場景
- 阿里云機動車銷售發票識別,是阿里云官方自研 OCR 文字識別產品,適用于識別購車發票上的發票金額、購買方名稱、車輛類型、廠牌型號、銷售方名稱等關鍵信息的場景。
- 阿里云 OCR 產品基于阿里巴巴達摩院強大的 AI 技術及海量數據,歷經多年沉淀打磨,具有服務穩定、操作簡易、實時性高、能力全面等幾大優勢。
- 本接口圖片示例
本接口核心能力
分類 | 概述 |
---|---|
圖片格式 | 支持 PNG、JPG、JPEG、BMP、GIF、TIFF、WebP。 |
圖像增強 | 默認支持圖像增強,包括圖像自動旋轉、畸變自動矯正、模糊圖片自動增強等能力。 |
多類型覆蓋 | 支持模糊、光照不均、透視畸變、任意背景等低質量圖像識別。 |
高精度識別 | 總體識別準確率可達 98%。 |
如何使用本接口
步驟 | 概述 |
---|---|
1 | 開通 票據憑證識別 服務。開通服務前后,您可以通過體驗館免費體驗本功能識別效果。 |
2 | 購買機動車銷售發票識別資源包。本 API 會贈送免費額度,可使用免費額度測試。您也可以不購買資源包,系統會通過“按量付費”方式按實際調用量自動扣款。 |
3 | 可以參照調試頁面提供的代碼示例完成 API 接入開發。接入完成后,調用 API 獲取識別結果。如果使用子賬號調用接口,需要阿里云賬號(主賬號)對 RAM 賬號進行授權。創建 RAM 用戶的具體操作,請參考:創建 RAM 用戶。文字識別服務提供一種系統授權策略,即 AliyunOCRFullAccess。具體授權操作,請參見在用戶頁面為 RAM 用戶授權。 |
重要提示
類型 | 概述 |
---|---|
圖片格式 |
|
圖片尺寸 |
|
圖片大小 |
|
相關能力 |
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ocr:RecognizeCarInvoice | *全部資源 * |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Url | string | 否 |
| https://img.alicdn.com/tfs/TB1hC7bXCzqK1RjSZPcXXbTepXa-832-616.jpg |
body | byte | 否 |
| 圖片二進制文件 |
返回參數
返回參數說明
字段 | 類型 | 說明 |
---|---|---|
data | object | 結構化信息。 |
sliceRect | list | 檢測出的子圖坐標信息。 |
prism_keyValueInfo | list | 結構化信息的坐標信息。 |
ftype | int | 是否為復印件(1:是,0:否)。 |
height | int | 算法矯正圖片后的高度。 |
width | int | 算法矯正圖片后的寬度。 |
orgHeight | int | 原圖的高度。 |
orgWidth | int | 原圖的寬度。 |
識別結果(data 字段)
字段 | 類型 | 說明 |
---|---|---|
taxCode | string | 稅控碼。 |
invoiceDate | string | 開票日期。 |
invoiceCode | string | 發票代碼。 |
invoiceNumber | string | 發票號碼。 |
machineCode | string | 機器編號。 |
purchaserName | string | 購買方名稱。 |
purchaseCode | string | 購買方身份證號碼/組織機構代碼。 |
vehicleType | string | 車輛類型。 |
brandMode | string | 廠牌型號。 |
origin | string | 產地。 |
certificateNumber | string | 合格證號。 |
importCertificateNumber | string | 進口證明書號。 |
commodityInspectionNumber | string | 商檢單號。 |
engineNumber | string | 發動機號碼。 |
vinCode | string | 車輛識別代號/車架號碼。 |
invoiceAmountCn | string | 價稅合計(大寫)。 |
invoiceAmount | string | 價稅合計(小寫)。 |
sellerName | string | 銷貨單位名稱。 |
sellerContact | string | 銷貨單位電話。 |
sellerTaxNumber | string | 銷貨單位納稅人識別號。 |
sellerBankAccount | string | 銷貨單位賬號。 |
sellerAddress | string | 銷貨單位地址。 |
sellerDepositaryBank | string | 銷貨單位開戶銀行。 |
taxRate | string | 增值稅稅率或征收率。 |
tax | string | 增值稅稅額。 |
taxAuthoritiesInfo | string | 主管稅務機關及代碼。 |
taxAuthoritiesName | string | 主管稅務機關。 |
taxAuthoritiesCode | string | 主管稅務代碼。 |
preTaxAmount | string | 不含稅價。 |
passengerLimitNumber | string | 限乘人數。 |
issuer | string | 開票人。 |
tonnage | string | 噸位。 |
purchaserTaxNumber | string | 購買方納稅人識別號。 |
taxPaymentNumber | string | 完稅憑證號碼。 |
結構化坐標信息(prism_keyValueInfo 字段)
字段 | 類型 | 說明 |
---|---|---|
key | string | 識別出的字段名稱。 |
keyProb | int | 字段名稱置信度。 |
value | string | 識別出的字段名稱對應的值。 |
valueProb | int | 字段名稱對應值的置信度。 |
valuePos | list | 字段在原圖中的四個點坐標(左上、右上、右下、左下)。 |
示例
正常返回示例
JSON
格式
{
"RequestId": "43A29C77-405E-4CC0-BC55-EE694AD00655",
"Data": "{\n \"data\": {\n \"taxCode\": \"0492725/*+0/法55337*<56-24/*184-/*<94 16-6+9*-897+98546/<>74*++16<43800*>+-< 116*豐1<4201/*18+-/</56-7不5<+8-3839263 +5/+-0/48<<336/30983/96550*8<+75326252 728*3+*032*9*9*900430086-956347/250+\",\n \"invoiceDate\": \"2017-12-28\",\n \"invoiceCode\": \"141001720076\",\n \"invoiceNumber\": \"00357144\",\n \"machineCode\": \"661403540093\",\n \"purchaserName\": \"國軍\",\n \"purchaseCode\": \"41052319206046072\",\n \"vehicleType\": \"轎車\",\n \"brandMode\": \"FV7152BAMBG\",\n \"origin\": \"長春市\",\n \"certificateNumber\": \"WAB011715201804\",\n \"importCertificateNumber\": \"\",\n \"commodityInspectionNumber\": \"\",\n \"engineNumber\": \"144878\",\n \"vinCode\": \"LFV2A1151H3201804\",\n \"invoiceAmountCn\": \"99000\",\n \"invoiceAmount\": \"99000.00\",\n \"sellerName\": \"安陽市汽車銷售服務有限公司\",\n \"sellerContact\": \"0372-5378818\",\n \"sellerTaxNumber\": \"914105001924458113\",\n \"sellerBankAccount\": \"41001501210050224848\",\n \"sellerAddress\": \"安陽市文峰區光專路商段路(汽車市場對面)\",\n \"sellerDepositaryBank\": \"中國建設銀行安陽分行\",\n \"taxRate\": \"17%\",\n \"tax\": \"14384.62\",\n \"taxAuthoritiesInfo\": \"安陽縣國家稅務局341052200\",\n \"taxAuthoritiesName\": \"安陽縣國家稅務局\",\n \"taxAuthoritiesCode\": \"341052200\",\n \"preTaxAmount\": \"84615.38\",\n \"passengerLimitNumber\": \"5\",\n \"issuer\": \"趙迪\",\n \"tonnage\": \"\",\n \"purchaserTaxNumber\": \"410523197206046072\",\n \"taxPaymentNumber\": \"\"\n },\n \"height\": 616,\n \"orgHeight\": 616,\n \"orgWidth\": 832,\n \"prism_keyValueInfo\": [\n {\n \"key\": \"taxCode\",\n \"keyProb\": 94,\n \"value\": \"0492725/*+0/法55337*<56-24/*184-/*<94 16-6+9*-897+98546/<>74*++16<43800*>+-< 116*豐1<4201/*18+-/</56-7不5<+8-3839263 +5/+-0/48<<336/30983/96550*8<+75326252 728*3+*032*9*9*900430086-956347/250+\",\n \"valuePos\": [\n {\n \"x\": 744,\n \"y\": 131\n },\n {\n \"x\": 744,\n \"y\": 210\n },\n {\n \"x\": 412,\n \"y\": 210\n },\n {\n \"x\": 412,\n \"y\": 131\n }\n ],\n \"valueProb\": 96\n },\n {\n \"key\": \"invoiceDate\",\n \"keyProb\": 100,\n \"value\": \"2017-12-28\",\n \"valuePos\": [\n {\n \"x\": 233,\n \"y\": 98\n },\n {\n \"x\": 233,\n \"y\": 112\n },\n {\n \"x\": 142,\n \"y\": 112\n },\n {\n \"x\": 142,\n \"y\": 98\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"invoiceCode\",\n \"keyProb\": 100,\n \"value\": \"141001720076\",\n \"valuePos\": [\n {\n \"x\": 764,\n \"y\": 72\n },\n {\n \"x\": 764,\n \"y\": 88\n },\n {\n \"x\": 647,\n \"y\": 88\n },\n {\n \"x\": 647,\n \"y\": 72\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"invoiceNumber\",\n \"keyProb\": 100,\n \"value\": \"00357144\",\n \"valuePos\": [\n {\n \"x\": 728,\n \"y\": 92\n },\n {\n \"x\": 728,\n \"y\": 108\n },\n {\n \"x\": 647,\n \"y\": 108\n },\n {\n \"x\": 647,\n \"y\": 92\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"machineCode\",\n \"keyProb\": 100,\n \"value\": \"661403540093\",\n \"valuePos\": [\n {\n \"x\": 288,\n \"y\": 188\n },\n {\n \"x\": 288,\n \"y\": 202\n },\n {\n \"x\": 176,\n \"y\": 202\n },\n {\n \"x\": 176,\n \"y\": 188\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"purchaserName\",\n \"keyProb\": 100,\n \"value\": \"國軍\",\n \"valuePos\": [\n {\n \"x\": 214,\n \"y\": 228\n },\n {\n \"x\": 214,\n \"y\": 243\n },\n {\n \"x\": 185,\n \"y\": 243\n },\n {\n \"x\": 185,\n \"y\": 228\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"purchaseCode\",\n \"keyProb\": 99,\n \"value\": \"41052319206046072\",\n \"valuePos\": [\n {\n \"x\": 326,\n \"y\": 249\n },\n {\n \"x\": 326,\n \"y\": 262\n },\n {\n \"x\": 176,\n \"y\": 262\n },\n {\n \"x\": 176,\n \"y\": 249\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"vehicleType\",\n \"keyProb\": 100,\n \"value\": \"轎車\",\n \"valuePos\": [\n {\n \"x\": 202,\n \"y\": 276\n },\n {\n \"x\": 202,\n \"y\": 291\n },\n {\n \"x\": 175,\n \"y\": 291\n },\n {\n \"x\": 175,\n \"y\": 276\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"brandMode\",\n \"keyProb\": 99,\n \"value\": \"FV7152BAMBG\",\n \"valuePos\": [\n {\n \"x\": 457,\n \"y\": 278\n },\n {\n \"x\": 457,\n \"y\": 291\n },\n {\n \"x\": 383,\n \"y\": 291\n },\n {\n \"x\": 383,\n \"y\": 278\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"origin\",\n \"keyProb\": 100,\n \"value\": \"長春市\",\n \"valuePos\": [\n {\n \"x\": 698,\n \"y\": 277\n },\n {\n \"x\": 698,\n \"y\": 293\n },\n {\n \"x\": 661,\n \"y\": 293\n },\n {\n \"x\": 661,\n \"y\": 277\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"certificateNumber\",\n \"keyProb\": 100,\n \"value\": \"WAB011715201804\",\n \"valuePos\": [\n {\n \"x\": 270,\n \"y\": 311\n },\n {\n \"x\": 270,\n \"y\": 323\n },\n {\n \"x\": 174,\n \"y\": 323\n },\n {\n \"x\": 174,\n \"y\": 311\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"importCertificateNumber\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n },\n {\n \"key\": \"commodityInspectionNumber\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n },\n {\n \"key\": \"engineNumber\",\n \"keyProb\": 100,\n \"value\": \"144878\",\n \"valuePos\": [\n {\n \"x\": 215,\n \"y\": 344\n },\n {\n \"x\": 215,\n \"y\": 356\n },\n {\n \"x\": 175,\n \"y\": 356\n },\n {\n \"x\": 175,\n \"y\": 344\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"vinCode\",\n \"keyProb\": 97,\n \"value\": \"LFV2A1151H3201804\",\n \"valuePos\": [\n {\n \"x\": 708,\n \"y\": 345\n },\n {\n \"x\": 708,\n \"y\": 359\n },\n {\n \"x\": 551,\n \"y\": 359\n },\n {\n \"x\": 551,\n \"y\": 345\n }\n ],\n \"valueProb\": 97\n },\n {\n \"key\": \"invoiceAmountCn\",\n \"keyProb\": 100,\n \"value\": \"99000\",\n \"valuePos\": [\n {\n \"x\": 270,\n \"y\": 373\n },\n {\n \"x\": 270,\n \"y\": 388\n },\n {\n \"x\": 193,\n \"y\": 388\n },\n {\n \"x\": 193,\n \"y\": 373\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"invoiceAmount\",\n \"keyProb\": 100,\n \"value\": \"99000.00\",\n \"valuePos\": [\n {\n \"x\": 631,\n \"y\": 388\n },\n {\n \"x\": 632,\n \"y\": 374\n },\n {\n \"x\": 722,\n \"y\": 375\n },\n {\n \"x\": 722,\n \"y\": 390\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"sellerName\",\n \"keyProb\": 100,\n \"value\": \"安陽市汽車銷售服務有限公司\",\n \"valuePos\": [\n {\n \"x\": 363,\n \"y\": 406\n },\n {\n \"x\": 363,\n \"y\": 421\n },\n {\n \"x\": 176,\n \"y\": 421\n },\n {\n \"x\": 176,\n \"y\": 406\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"sellerContact\",\n \"keyProb\": 100,\n \"value\": \"0372-5378818\",\n \"valuePos\": [\n {\n \"x\": 647,\n \"y\": 408\n },\n {\n \"x\": 647,\n \"y\": 421\n },\n {\n \"x\": 570,\n \"y\": 421\n },\n {\n \"x\": 570,\n \"y\": 408\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"sellerTaxNumber\",\n \"keyProb\": 96,\n \"value\": \"914105001924458113\",\n \"valuePos\": [\n {\n \"x\": 363,\n \"y\": 436\n },\n {\n \"x\": 363,\n \"y\": 452\n },\n {\n \"x\": 176,\n \"y\": 454\n },\n {\n \"x\": 175,\n \"y\": 438\n }\n ],\n \"valueProb\": 96\n },\n {\n \"key\": \"sellerBankAccount\",\n \"keyProb\": 100,\n \"value\": \"41001501210050224848\",\n \"valuePos\": [\n {\n \"x\": 696,\n \"y\": 441\n },\n {\n \"x\": 696,\n \"y\": 454\n },\n {\n \"x\": 569,\n \"y\": 454\n },\n {\n \"x\": 569,\n \"y\": 441\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"sellerAddress\",\n \"keyProb\": 80,\n \"value\": \"安陽市文峰區光專路商段路(汽車市場對面)\", \"valuePos\": [\n {\n \"x\": 175,\n \"y\": 473\n },\n {\n \"x\": 403,\n \"y\": 472\n },\n {\n \"x\": 403,\n \"y\": 484\n },\n {\n \"x\": 176,\n \"y\": 486\n }\n ],\n \"valueProb\": 80\n },\n {\n \"key\": \"sellerDepositaryBank\",\n \"keyProb\": 100,\n \"value\": \"中國建設銀行安陽分行\",\n \"valuePos\": [\n {\n \"x\": 632,\n \"y\": 471\n },\n {\n \"x\": 632,\n \"y\": 485\n },\n {\n \"x\": 506,\n \"y\": 487\n },\n {\n \"x\": 505,\n \"y\": 472\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"taxRate\",\n \"keyProb\": 99,\n \"value\": \"17%\",\n \"valuePos\": [\n {\n \"x\": 203,\n \"y\": 510\n },\n {\n \"x\": 203,\n \"y\": 524\n },\n {\n \"x\": 176,\n \"y\": 524\n },\n {\n \"x\": 176,\n \"y\": 510\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"tax\",\n \"keyProb\": 100,\n \"value\": \"14384.62\",\n \"valuePos\": [\n {\n \"x\": 413,\n \"y\": 509\n },\n {\n \"x\": 413,\n \"y\": 524\n },\n {\n \"x\": 323,\n \"y\": 524\n },\n {\n \"x\": 323,\n \"y\": 509\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"taxAuthoritiesInfo\",\n \"keyProb\": 100,\n \"value\": \"安陽縣國家稅務局341052200\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"taxAuthoritiesName\",\n \"keyProb\": 100,\n \"value\": \"安陽縣國家稅務局\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"taxAuthoritiesCode\",\n \"keyProb\": 100,\n \"value\": \"341052200\",\n \"valuePos\": [\n {\n \"x\": 633,\n \"y\": 498\n },\n {\n \"x\": 633,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 525\n },\n {\n \"x\": 537,\n \"y\": 498\n }\n ],\n \"valueProb\": 99\n },\n {\n \"key\": \"preTaxAmount\",\n \"keyProb\": 97,\n \"value\": \"84615.38\",\n \"valuePos\": [\n {\n \"x\": 216,\n \"y\": 557\n },\n {\n \"x\": 216,\n \"y\": 543\n },\n {\n \"x\": 305,\n \"y\": 544\n },\n {\n \"x\": 305,\n \"y\": 559\n }\n ],\n \"valueProb\": 97\n },\n {\n \"key\": \"passengerLimitNumber\",\n \"keyProb\": 100,\n \"value\": \"5\",\n \"valuePos\": [\n {\n \"x\": 723,\n \"y\": 545\n },\n {\n \"x\": 723,\n \"y\": 557\n },\n {\n \"x\": 714,\n \"y\": 557\n },\n {\n \"x\": 714,\n \"y\": 545\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"issuer\",\n \"keyProb\": 100,\n \"value\": \"趙迪\",\n \"valuePos\": [\n {\n \"x\": 437,\n \"y\": 573\n },\n {\n \"x\": 437,\n \"y\": 588\n },\n {\n \"x\": 410,\n \"y\": 588\n },\n {\n \"x\": 410,\n \"y\": 573\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"tonnage\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n },\n {\n \"key\": \"purchaserTaxNumber\",\n \"keyProb\": 100,\n \"value\": \"410523197206046072\",\n \"valuePos\": [\n {\n \"x\": 730,\n \"y\": 240\n },\n {\n \"x\": 730,\n \"y\": 253\n },\n {\n \"x\": 569,\n \"y\": 253\n },\n {\n \"x\": 569,\n \"y\": 240\n }\n ],\n \"valueProb\": 100\n },\n {\n \"key\": \"taxPaymentNumber\",\n \"keyProb\": 100,\n \"value\": \"\",\n \"valueProb\": 100\n }\n ],\n \"width\": 832\n}",
"Code": "200",
"Message": "message"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2022-11-25 | API 內部配置變更,不影響調用 | 查看變更詳情 |
2021-08-17 | OpenAPI 入參發生變更 | 查看變更詳情 |