多票據/發票ocr接口文檔——薪火科技
支持類型：
增值稅專用發票，機動車銷售統一發票，貨物運輸業增值稅專用發票，增值稅普通發票，增值稅電子普通發票，增值稅普通發票（卷票），增值稅電子普通發票（通行費），二手車銷售統一發票，通用機打發票，通用定額發票，旅客運輸普票，公路客運發票，船運客票，出租車發票，停車費發票，過路過橋費發票、汽車通行費，醫療費收據，教育費收據，行程單，火車票，增值稅銷貨清單，商戶小票，其它類型
多票據OCR識別在線演示網址
接口地址
http://api.xinhuokj.com:40072/ocr
HTTP頭字段
Content-Type: application/json
HTTP正文體
{
"image": "/9j/4AAQSkZ......./9k=", //圖片文件二進制數組經過base64編碼后的字符串，目前支持jpg、tif、png、bmp等多種格式
"type": "9" ,
"token": "ef9c*************dbca", //請在用戶中心獲取token，網址：http://www.qdtingmei.com/user
}
可用postman工具調試，結果如下圖所示：
返回字段描述
|
字段 |
說明 |
|
code |
返回狀態碼。200:正常返回; 500:服務器內部錯誤 |
|
message |
返回對應code的狀態說明 |
|
result |
圖片結果信息 |
|
+ object_list |
多張票據OCR識別結果集合 |
|
++ image_angle |
切割后的單張票據圖像角度 |
|
++ rotated_image_width |
切割后的單張票據旋轉后圖片寬度 |
|
++ rotated_image_height |
切割后的單張票據旋轉后圖片高度 |
|
++ position |
切割后的單張票據在圖片中的坐標 |
|
++ class |
切割后的單張票據大類類型 |
|
++ type |
切割后的單張票據具體類型 |
|
++ type_description |
切割后的單張票據type字段對應的中文描述 |
|
++ kind |
票據使用類型 |
|
++ kind_description |
票據使用類型對應中文名描述 |
|
++ item_list |
切割后的單張票據OCR識別結果 |
|
++ product_list |
增值稅發票項目明細(僅type為增值稅發票出現) |
|
+++ key |
識別字段類型 |
|
+++ value |
識別字段結果 |
|
+++ position |
識別字段在原圖中的坐標位置 |
|
+++ description |
識別字段key中文描述 |
class中返回的類型結果描述：
|
字段 |
說明 |
|
nation_tax_invoice |
國稅 |
|
local_invoice |
地方票種 |
|
other_invoice |
其他票種 |
kind中返回的類型結果描述：
|
字段 |
說明 |
|
vehicle |
用車 |
|
traffic |
交通 |
|
education |
教育 |
|
daily |
日用 |
|
office |
辦公 |
|
service |
服務 |
|
digital_appliance |
數碼電器 |
|
rent_decoration |
房租裝飾 |
|
communication |
通訊 |
|
lodging |
住宿 |
|
post |
郵寄 |
|
repast |
餐飲 |
|
foodstuff |
食品 |
|
raiment |
服飾 |
|
other |
其他 |
type返回的類型列表：
|
字段 |
說明 |
|
vat_special_invoice |
增值稅專用發票 |
|
motor_vehicle_sale_invoice |
機動車銷售統一發票 |
|
vat_transport_invoice |
貨物運輸業增值稅專用發票 |
|
vat_common_invoice |
增值稅普通發票 |
|
vat_electronic_invoice |
增值稅電子普通發票 |
|
vat_roll_invoice |
增值稅普通發票（卷票） |
|
vat_electronic_toll_invoice |
增值稅電子普通發票（通行費） |
|
used_car_purchase_invoice |
二手車銷售統一發票 |
|
general_machine_invoice |
通用機打發票 |
|
quota_invoice |
通用定額發票 |
|
passenger_transport_invoice |
旅客運輸普票 |
|
highway_passenger_invoice |
公路客運發票 |
|
shipping_invoice |
船運客票 |
|
taxi_ticket |
出租車發票 |
|
parking_invoice |
停車費發票 |
|
vehicle_toll |
過路過橋費發票、汽車通行費 |
|
education_receipt |
教育費收據 |
|
air_transport |
行程單 |
|
train_ticket |
火車票 |
|
vat_invoice_sales_list |
增值稅銷貨清單 |
|
shop_receipt |
商戶小票 |
|
other |
其它類型 |
type為 vat_special_invoice、vat_electronic_invoice、vat_common_invoice、vat_electronic_toll_invoice, key返回的類型列表：
|
結果 |
說明 |
|
vat_invoice_correct_code |
校驗碼 |
|
vat_invoice_daima |
發票代碼 |
|
vat_invoice_haoma |
發票號碼 |
|
vat_invoice_haoma_large_size |
增值稅發票No號碼 |
|
vat_invoice_issue_date |
開票日期 |
|
vat_invoice_rate_payer_id |
納稅人識別號 |
|
vat_invoice_total |
合計 |
|
vat_invoice_tax_rate |
增值稅稅率 |
|
vat_invoice_seller_name |
銷售方名稱 |
|
vat_invoice_seller_bank_account |
銷售方開戶行及帳號 |
|
vat_invoice_seller_id |
銷售方納稅人識別號 |
|
vat_invoice_seller_addr_tell |
銷售方地址、電話 |
|
vat_invoice_payer_name |
購買方名稱 |
|
vat_invoice_payer_bank_account |
購買方開戶行及帳號 |
|
vat_invoice_payer_addr_tell |
購買方地址、電話 |
|
vat_invoice_total_cover_tax |
價稅合計大寫 |
|
vat_invoice_total_cover_tax_digits |
價稅合計小寫 |
|
vat_invoice_tax_total |
稅額合計 |
|
vat_invoice_goods_list |
貨物或服務名稱 |
|
vat_invoice_price_list |
金額明細 |
|
vat_invoice_tax_rate_list |
稅率明細 |
|
vat_invoice_tax_list |
稅額明細 |
|
vat_invoice_zhuan_yong_flag |
專票/普票 |
|
vat_invoice_dai_kai_flag |
代開(非代開條目為空) |
|
vat_invoice_plate_specific |
規格型號明細 |
|
vat_invoice_electrans_unit |
單位明細 |
|
vat_invoice_electrans_quantity |
數量明細 |
|
vat_invoice_electrans_unit_price |
單價明細 |
|
vat_invoice_daima_right_side |
右側打印發票代碼 |
|
vat_invoice_haoma_right_side |
右側打印發票號碼 |
|
vat_invoice_page_number |
抵扣聯/發票聯 |
|
vat_invoice_type |
發票類型 |
|
vat_invoice_total_note |
備注 |
|
vat_invoice_cipher_field |
密碼區 |
|
vat_invoice_drawer |
開票人 |
|
vat_invoice_review |
復核 |
|
vat_invoice_payee |
收款人 |
|
exist_stample |
蓋章存在性判斷 |
|
vat_invoice_headline_page_number |
標題發票聯 |
|
vat_invoice_corrent_code_print |
打印校驗碼 |
|
vat_invoice_total_print |
打印合計 |
|
vat_invoice_note_correct_code |
備注校驗碼 |
|
vat_invoice_machine_no |
機器編號 |
|
vat_invoice_daima_print |
打印發票代碼 |
|
vat_invoice_elec_payment_id |
電子支付標識 |
|
vat_invoice_issue_date_print |
右側打印開票日期 |
|
vat_invoice_qr_code |
qr碼 |
|
vat_invoice_credit_memo |
紅沖/非紅沖 |
|
sub_type |
子類型 |
|
vat_invoice_qr_code |
qr碼 |
|
vat_invoice_tax |
稅額明細 |
|
vat_invoice_tax_rate |
稅率明細 |
|
vat_invoice_price |
金額明細 |
|
vat_invoice_electrans_unit_price |
單價明細 |
|
vat_invoice_electrans_quantity |
數量明細 |
|
vat_invoice_electrans_unit |
單位明細 |
|
vat_invoice_plate_specific |
規格型號 |
|
vat_invoice_goods |
貨物或服務名稱 |
type為 motor_vehicle_sale_invoice, key返回的類型列表：
|
字段 |
說明 |
|
vehicle_invoice_buyer |
購買方名稱 |
|
vehicle_invoice_buyer_id |
購買方名稱的身份證號碼或組織機構代碼 |
|
vehicle_invoice_car_model |
廠牌型號 |
|
vehicle_invoice_car_made_place |
產地 |
|
vehicle_invoice_cert_id |
合格證號 |
|
vehicle_invoice_engine_id |
發動機號碼 |
|
vehicle_invoice_car_vin |
車輛識別代號/車架號 |
|
vehicle_invoice_total_price |
價稅合計 |
|
vehicle_invoice_total_price_digits |
價稅合計小寫 |
|
vehicle_invoice_price_without_tax |
不含稅價 |
|
vehicle_invoice_tax_rate |
稅率 |
|
vehicle_invoice_tax_amount |
稅額 |
|
vehicle_invoice_telephone |
電話 |
|
vehicle_invoice_issue_date |
開票日期 |
|
vehicle_invoice_daima |
發票代碼 |
|
vehicle_invoice_haoma |
發票號碼 |
|
vehicle_invoice_dealer |
銷貨單位 |
|
vehicle_invoice_jida_daima |
機打代碼 |
|
vehicle_invoice_jida_haoma |
機打號碼 |
|
vehicle_invoice_machine_id |
機器編碼 |
|
vehicle_invoice_tax_author_id |
主管稅務代碼 |
|
vehicle_invoice_tax_author_name |
主管稅務機關 |
|
vehicle_invoice_seller_bank_name |
開戶銀行 |
|
vehicle_invoice_seller_bank_account |
賬號 |
|
vehicle_invoice_seller_tax_id |
納稅人識別號 |
|
vehicle_invoice_commodity_inspection_id |
商檢單號 |
|
vehicle_invoice_import_certificate_id |
進口證明書號 |
|
vehicle_invoice_seller_address |
地址 |
|
vehicle_invoice_tax_payment_certificate_number |
完稅憑證號 |
|
vehicle_invoice_issued_by |
開票人 |
|
vehicle_invoice_tax_code |
稅控碼 |
|
vehicle_invoice_limit_number |
限乘人數 |
|
vehicle_invoice_vehicle_type |
車輛類型 |
|
vehicle_invoice_tonnage |
噸位 |
|
vehicle_invoice_page_number |
發票聯 |
|
vehicle_invoice_qr_code |
二維碼 |
|
vehicle_invoice_buyer_tax_id |
購方納稅人識別號 |
type為 used_car_purchase_invoice, key返回的類型列表：
|
字段 |
說明 |
|
vehicle_invoice_daima |
購車發票代碼 |
|
vehicle_invoice_haoma |
購車發票號碼 |
|
vehicle_invoice_buyer |
購貨單位(人) |
|
vehicle_invoice_buyer_id |
購買身份證號碼/組織機構代碼 |
|
vehicle_invoice_buyer_addr |
購買方地址 |
|
vehicle_invoice_buyer_phone |
購買方電話號碼 |
|
vehicle_invoice_seller |
賣方單位(人) |
|
vehicle_invoice_seller_id |
賣方身份證號碼/組織機構代碼 |
|
vehicle_invoice_seller_addr |
賣方地址 |
|
vehicle_invoice_seller_phone |
賣方電話號碼 |
|
vehicle_invoice_plate_num |
車牌照號 |
|
vehicle_invoice_register_num |
登記證號 |
|
vehicle_invoice_vehicle_type |
車輛類型 |
|
vehicle_invoice_vin |
車架號/車輛識別代碼 |
|
vehicle_invoice_car_model |
廠牌型號 |
|
vehicle_invoice_dmv |
轉入地車輛管理所名稱 |
|
vehicle_invoice_price_total_price |
價稅合計 |
|
vehicle_invoice_total_price_digits |
價稅合計小寫 |
|
vehicle_invoice_auction_house |
經營、拍賣單位 |
|
vehicle_invoice_auction_house_addr |
經營、拍賣單位地址 |
|
vehicle_invoice_auction_house_tax_id |
經營、拍賣單位納稅人識別號 |
|
vehicle_invoice_auction_house_bank_account |
經營、拍賣單位開戶銀行、賬號 |
|
vehicle_invoice_auction_house_phone |
經營、拍賣單位電話 |
|
vehicle_invoice_market |
二手車市場 |
|
vehicle_invoice_market_addr |
二手車市場地址 |
|
vehicle_invoice_market_tax_id |
二手車市場納稅人識別號 |
|
vehicle_invoice_market_bank_acount |
二手車市場開戶銀行、賬號 |
|
vehicle_invoice_market_phone |
二手車市場電話 |
|
vehicle_invoice_note |
備注 |
|
vehicle_invoice_issue_date |
購車發票開票日期 |
|
exist_stample |
蓋章存在性判斷 |
type為 vat_roll_invoice, key返回的類型列表：
|
字段 |
說明 |
|
invoice_head |
發票票頭 |
|
invoice_number |
發票號碼 |
|
invoice_code |
發票代碼 |
|
machine_number |
機器號碼 |
|
machine_code |
機器編碼 |
|
total_money |
合計金額(小寫) |
|
total_money_big |
合計金額(大寫) |
|
date_of_invoice |
開票日期 |
|
check_number |
校驗碼 |
|
buy_name |
購方名稱 |
|
buy_tax_number |
購方納稅人識別號 |
|
sold_name |
銷方名稱 |
|
sold_tax_number |
銷方納稅人識別號 |
|
cashier_name |
收款員 |
type為 vehicle_toll, key返回的類型列表：
|
字段 |
說明 |
|
toll_code |
車輛通行費代碼 |
|
toll_number |
車輛通行費號碼 |
|
date |
收費時間 |
|
time |
收費時間 |
|
money |
收費金額 |
type為 quota_invoice, key返回的類型列表：
|
字段 |
說明 |
|
quota_invoice_code |
發票代碼 |
|
quota_invoice_number |
發票號碼 |
|
money_small |
金額(小寫) |
|
money_big |
金額(大寫) |
|
location |
發票所在地 |
type為 taxi_ticket, key返回的類型列表：
|
字段 |
說明 |
|
invoice_code |
發票代碼 |
|
invoice_no |
發票號碼 |
|
date |
日期 |
|
taxi_no |
車號 |
|
boarding_time |
上車時間 |
|
landing_time |
下車時間 |
|
mileage |
里程 |
|
sum |
金額 |
|
location |
發票所在地 |
type為 air_transport, key返回的類型列表：
|
字段 |
說明 |
|
passenger_name |
旅客姓名 |
|
id_no |
身份證件號碼 |
|
serial_number |
印刷序號 |
|
total |
合計金額 |
|
fare |
票價 |
|
civil_aviation_fund |
民航發展基金 |
|
fuel_surcharge |
燃油附加費 |
|
other_taxes |
其他稅費 |
|
issued_date |
填開日期 |
|
issued_by |
填開單位 |
|
e_ticket_no |
電子客票號碼 |
|
from |
出發站 |
|
to |
到達站 |
|
flight_number |
航班號 |
|
seat_class |
座位等級 |
|
date |
航班日期 |
|
time |
航班時間 |
|
fare_basis |
客票級別 |
type為 train_ticket, key返回的類型列表：
|
字段 |
說明 |
|
passenger_name |
乘客名稱 |
|
passenger_id |
乘客身份證 |
|
train_number |
車次號 |
|
departure_station |
出發地 |
|
departure_date |
乘車時間 |
|
class |
座位類別 |
|
ticket_number |
火車票紅色編碼 |
|
arrival_station |
目的地 |
|
seat_number |
座位號 |
|
price |
價格 |
|
check |
檢票口 |
|
ticket_id |
火車票ID |
type為 general_machine_invoice、shipping_invoice, key返回的類型列表：
|
字段 |
說明 |
|
invoice_code |
發票代碼 |
|
invoice_number |
發票號碼 |
|
money |
金額 |
|
date |
日期 |
|
time |
時間 |
object_key為 highway_passenger_invoice、passenger_transport_invoice, key返回的類型列表：
|
字段 |
說明 |
|
invoice_code |
發票代碼 |
|
invoice_number |
發票號碼 |
|
money |
金額 |
|
date |
日期 |
|
time |
時間 |
|
passenger_name |
乘客姓名 |
|
passenger_id |
乘客身份證號碼 |
type為 parking_invoice, key返回的類型列表：
|
字段 |
說明 |
|
invoice_number |
發票號碼 |
|
money |
金額 |
type為 vat_invoice_sales_list, key返回的類型列表：
|
字段 |
說明 |
|
purchaser_name |
購買方名稱 |
|
seller_name |
銷售方名稱 |
|
invoice_code |
發票代碼 |
|
invoice_number |
發票號碼 |
|
total_page |
合計頁碼 |
|
page |
當前頁碼 |
|
total |
金額合計 |
|
tax_total |
稅額合計 |
|
has_stamp |
銷售方蓋章存在性判斷 |
|
issued_date |
填開日期 |
type為 shop_receipt, key返回的類型列表：
|
字段 |
說明 |
|
money |
金額 |
|
date |
時間 |
|
no |
單號 |
|
shop |
商戶 |
|
sku |
商品 |
type為 education_receipt、vat_transport_invoice, 目前僅支持分類，暫無結構化識別。
正常返回示例
{
"code":200,
"message":"success",
"result":{
"object_list":[
{
"image_angle":270,
"rotated_image_width":1440,
"rotated_image_height":1080,
"position":[
300,
394,
1059,
411,
1059,
481,
300,
459
],
"class":"local_invoice",
"type":"quota_invoice",
"type_description":"通用定額發票",
"item_list":[
{
"key":"quota_invoice_code",
"value":"131001827953",
"position":[
752,
532,
1256,
535,
1256,
573,
752,
567
],
"description":"發票代碼"
},
{
"key":"money_small",
"value":"10.00",
"position":[
300,
394,
1059,
411,
1059,
481,
300,
459
],
"description":"金額(小寫)"
}
]
},
{
"image_angle":270,
"rotated_image_width":1330,
"rotated_image_height":1280,
"position":[
300,
394,
1059,
411,
1059,
481,
300,
459
],
"class":"other",
"type":"train_ticket",
"type_description":"火車票",
"item_list":[
{
"key":"departure_station",
"value":"上海站",
"position":[
126,
275,
700,
270,
700,
311,
126,
320
],
"description":"出發地"
},
{
"key":"arrival_station",
"value":"131001827953",
"position":[
177,
159,
1127,
149,
1127,
206,
177,
217
],
"description":"目的地"
}
]
}
]
}
}
識別服務返回的code與message定義：
| code | message | 含義 |
|---|---|---|
| 200 | Success | 請求成功 |
| 500 | Server error | 服務器內部錯誤 |
| 40001 | Access server error | 驗證服務器錯誤，請再次請求， 如果持續出現此類錯誤，請聯系技術支持團隊 |
| 40002 | Service temporarily unavailable | 服務暫不可用，請再次請求， 如果持續出現此類錯誤，請聯系技術支持團隊 |
| 40003 | Unsupported openapi method | 調用的API不存在，請檢查后重新嘗試 |
| 40004 | Open api request limit reached | 集群超限額 |
| 40017 | Open api daily request limit reached | 每天請求量超限額 |
| 40018 | Open api qps request limit reached | QPS超限額 |
| 40019 | Open api total request limit reached | 請求總量超限額 |
| 40020 | Open api daily testing limit reached. | 今日測試次數已達上限 |
| 40100 | Empty App key or app secret | app_key 或 app_secret 為空 |
| 40101 | App does not exist | 實例不存在，請檢查 app_key |
| 40102 | Invalid app secret | 實例驗證失敗，請檢查 app_secret |
| 40103 | Invalid App | 實例已失效 |
| 40104 | App has expired | 實例已超過有效期 |
| 40105 | Invalid IP source | 無效的IP來源 |
| 40106 | App does not match service | 實例與service不匹配 |
| 40107 | App has been overdrawn by 5% of the total count. Please use it after recharging. | 實例額度已透支總額度的5%，請充值后使用 |
| 40110 | App key or app secret invalid | app_key 或 app_secret無效 |
| 40200 | Internal error | 服務器內部錯誤 |
| 40201 | Not enough param | 缺少必須的參數，請檢查參數是否有遺漏 |
| 40202 | Service not support | 請求了不支持的服務，請檢查調用的url |
| 40300 | Empty image | 圖片為空，請檢查后重新嘗試 |
| 40301 | Image format error | 上傳的圖片格式錯誤，現階段我們支持的圖片格式為：PNG、JPG、JPEG、BMP，請進行轉碼或更換圖片 |
| 40302 | Image size error | 上傳的圖片大小錯誤 |
| 40303 | File type unsupport | 文件類型不支持 |
| 40400 | Recognize error | 識別錯誤，請再次請求 |
| 40401 | Image recognize error | 圖像識別錯誤 |
| 40500 | Classify failed | 未能成功分類 |
| 40600 | Missing request body | 缺少 request body |
| 50001 | Time out | 超時 |
| 90099 | Unknown error | 未知錯誤 |