一、接口簡介
1、版權說明：
未經翔云人工智能開放平臺授權，不得擅自進行使用。
2、調用客戶端運行環境
當客戶端使用的編程語言為Java時，請使用1.5及以上版本JRE。
3、服務主要功能描述
翔云發票驗真服務，實時聯網核查驗5年內增值稅發票管理系統開具的發票，如果發票為真則返回全票面信息，可查詢票種包含：增值稅專用發票、增值稅電子專用發票、增值稅普通發票（折疊票）、增值稅普通發票（卷票）、增值稅電子普通發票（含收費公路通行費增值稅電子普通發票）、機動車銷售統一發票、二手車銷售統一發票。

通過https協議post方法上傳發票要素信息；

將查驗結果以XML或json格式返回給用戶；
4、服務調用約束
請您在調用發票識別接口前，確保客戶端程序或設備網絡連接通暢，如使用發票識別接口自動提取發票要素信息，要求發票圖像文件大小在200KB左右，掃描圖像建議分辨率為300DPI，圖像小于3M，電子發票請上傳PDF格式。
二、前提準備
1、用戶登錄 https://www.netocr.com/register.html注冊賬號，如圖:
2、輸入注冊信息，確認無誤后點擊同意條款并注冊，如圖:

3、注冊成功后點擊右上角的賬號名稱-個人中心，進入管理頁面:

4、點擊“用戶管理-基礎信息”，查看OCRKey以及OCRSecret：

5、點擊“服務列表”，查看服務次數及余額(每調用一次https接口消耗一次)，可點擊立即購買直接跳轉到購買頁面購買API服務次數：

6、購買成功后,會顯示購買的總次數及剩余次數，例如下圖所示：

7、設置剩余條數提醒，進入個人中心-用戶管理-剩余條數提醒，設置提醒下線、通知手機號及服務類型，設置成功后到達用戶設置的服務剩余條數下限，系統會發短息至預留手機號。

三、接口說明
接口地址，https://netocr.com/verapi/verInvoice.do
接口調用方法：post

3、請求參數
接口說明
接口地址： https://netocr.com/verapi/verInvoice.do
接口調用方法： post
接口接收參數：
序號 名稱 類型 必填 說明
1 key String 是 用戶ocrKey
2 secret String 是 用戶ocrSecrert
3 invoiceCode String 是 發票代碼
4 invoiceNumber String 是 發票號碼
5 billingDate String 是 開票日期：YYYY-MM-DD
6 totalAmount String 是 合計金額（不含稅），必須精確到兩位小數（專票、貨運專票、機動車專票必填）
7 checkCode String 是 校驗碼后6位（普票、電子普票、卷式普票必填）
8 salesTaxNo String 否 銷方稅號（區塊鏈必填）
9 typeId Integer 是 發票驗真：3007
10 format String 是 返回格式(xml或者json)，如果format為空，則默認返回xml
接口返回值參數說明：
序號 名稱 類型 說明
1 invoiceType String 發票類型
增值稅專用發票　　　　　　01
貨運運輸業增值稅專用發票　02
機動車銷售統一發票　　　　03
增值稅普通發票　　　　　　04
增值稅普通發票（電子）　　10
增值稅普通發票（卷式）　　11
增值稅普通發票（通行費）　14
二手車銷售統一發票 15
2 administrativeDivisionName String 所屬行政區名稱
3 invoiceCode String 發票代碼
4 invoiceNumber String 發票號碼
5 billingDate String 開票日期：YYYY-MM-DD
6 purchaserName String 購方名稱
7 purchaserTaxNo String 購方稅號
8 purchaserBank String 購方開戶行賬戶
9 purchaserAddressPhone String 購方地址電話
10 salesName String 銷方名稱
11 salesTaxNo String 銷方稅號
12 salesAddressPhone String 銷方地址電話
13 salesBank String 銷方開戶行賬戶
14 totalAmount String 合計金額
15 totalTax String 合計稅額
16 amountTax String 價稅合計
17 amountTaxCN String 價稅合計_中文
18 remarks String 備注
19 machineCode String 機器編碼
20 checkCode String 校驗碼
21 state String 發票狀態
未作廢　1
作廢　　2
22 invoiceList String 發票詳細信息列表
23 commodityName String 貨物或應稅勞務名稱
24 specificationMode String 規格型號
25 unit String 單位
26 quantity String 數量
27 unitPrice String 單價
28 amount String 金額
29 taxRate String 稅率
30 tax String 稅額
31 carrierName String 承運人名稱
32 carrierTaxNo String 承運人識別號
33 draweeName String 受票方名稱
34 draweeTaxNo String 受票方識別號
35 cargoInformation String 運輸貨物信息
36 transportRoute String 起運地、經由、到達地
37 machineCode String 稅控盤號
38 automobileType String 車種車號
39 tonnage String 車船噸位
40 taxAuthorityNo String 主管稅務機關
41 taxAuthorityName String 主管稅務名稱
42 remarks String 備注
43 iDCardNo String 身份證號碼/組織機構代碼
44 purchaserTaxNo String 購方稅號
46 vehicleType String 車輛類型
46 brandModel String 廠牌型號
47 originPlace String 產地
48 certificateNo String 合格證號
49 inspectionListNo String 商檢單號
50 engineNo String 發動機號
51 vehicleNo String 車輛識別代號/車架號碼
52 importCertificateNo String 進口證明書號
53 salesPhone String 銷方地址電話
54 salesTaxNo String 銷方稅號
55 salesBankNo String 賬號
56 salesAddress String 銷方地址
57 paymentVoucherNo String 完稅憑證號碼
58 passengersLimited String 限乘人數
狀態碼說明：
status code message
2 查驗成功發票一致（扣費）
5 請求不合法
6 發票信息不一致
9 所查發票不存在
20 超過該張票當天查驗次數
30+code 該票在本平臺核驗失敗已超5次（扣費）
1004 已超過最大查驗量
1005 查詢發票不規范
1006 查驗異常
1008 參數不能為空
1009 參數長度不正確
1014 日期當天的不能查驗
1015 超過一年的不能查驗
1021 網絡超時
100000 缺少參數
100001 參數取值范圍錯誤
100005 請求過于頻繁
100006 遠程訪問錯誤
100010 請求超時
60 未知錯誤
返回結果字符串
標簽顯示了識別狀態，大于等于“0”代表識別成功【“0”代表查詢成功，“1”代表未查到數據，“2”代表查詢失敗】，小于“0”代表識別失敗，失敗的原因在中描述。
調用錯誤碼
status值 描述
-1 用戶已屏蔽
-2 用戶key或secret驗證錯誤
-3 服務次數不足
-4 用戶未找到
-6 系統異常
-7 圖片不可為空，參數不可為空
-8 類型錯誤
調用方式(java客戶端基于httpclient4.3)
1.依賴庫: \java客戶端\httpClient4.3庫\，如圖:

2.示例程序代碼詳見: \java客戶端\httpClientDemo\中的Client類，如圖:

在main方法定義參數，并傳入 doPost(url, file, key, secret, typeId, format) 方法中。如圖:

執行main方法返回結果如下：
增值稅發票：

剩余條數查詢接口(所有產品類型)
接口地址： https://netocr.com/api/accountLift.do
接口調用方法： post
接口接收參數：
String key： 用戶ocrKey
String secret： 用戶ocrSecret
String format： 返回格式(xml或者json)，如果format為空，則默認返回xml

總結

以上是生活随笔為你收集整理的发票验真API开发文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。