SAP、百望，進項發票一體化對接
當前位置：點晴教程→知識管理交流
→『 技術文檔交流 』
?SAP、SRM-百望接口
SAP、SRM相關頁面中加按鈕‘導入發票號’，實現單點登錄百望界面，百望開發選擇發票號界面，選擇完成后調用接口，實現保存發票號，對SAP中參照、分配等進行賦值或對srm相關字段進行賦值。 SAP中發票預制憑證導入功能，同時保存進百望系統。
SRM相關頁面
? 百望反饋： 根據以上說明，先整理以下： ? 1.指定單點登錄規則，校驗身份的方式，和SAP提供的接口。 a)如何獲取校驗身份的token b)SAP提供接口，根據返回字段標明身份驗證成功或失敗 ? 2.百望提供頁面： a)百望提供頁面url b)參數：購方名稱，發票時間范圍起和止，其他參數？ c)頁面：發票需要顯示哪些列？實際業務中，最多可能有多少張發票？默認是否是都打勾？默認根據開票日期排序？是否需要分頁？顯示合計信息：發票張數，金額之和，稅額之和？ d)點擊確定按鈕之后，通過何種方式將這些發票信息傳給SAP？通過js傳遞給父窗口，還是在后臺通過接口傳遞？ ?
?效果圖：
百望進項標準版 對接服務接口文檔說明 一、進項介紹????百望進項管理系統是百望開發的為企業管理進項發票的系統，從發票的入庫、查驗、認證都進行數字化管控，大大增加了企業內部發票流轉的效率，提高財稅人員的工作效率。 本接口文檔是百望進項標準版接口文檔，客戶入駐標準版本后，都可使用本接口跟百望進項標準版進行交互，系統根據稅號為客戶提供進項數據接口服務。 二、加密規則??????每個接入用戶提供一個用戶名AccessKeyID、秘鑰AccessKeySecret；使用秘鑰基于HMC-SHA1算法進行請求內容的加密和解密； 三、URL生成??調用URL地址： ? ? ? ? ? ????????1>??? ? ? ? ? ????????2>??? ? ? ? ? ????????3>版本號，默認為1.0（參考文檔版本的前兩位數字）?? ? 4> URL字符說明： ?對于字符 A-Z、a-z、0-9 以及字符“-”、“_”、“.”、“~”不編碼； ?對于其他字符編碼成 “%XY” 的格式 ?對于擴展的 UTF-8 字符，編碼成 “%XY%ZA…” 的格式 ?需要說明的是英文空格（ ）要被編碼是 %20，而不是加號（+） ?時間類型"yyyy-MM-dd'T'HH:mm:ss'Z'" ?SignatureNonce為32位隨機數UUID，時效為10分鐘。 ??????? 5> Signature生成規則： ?連接內容排序：將本URL中，除Signature外其他所有參數，按照參數名稱的字典順序 ?使用AccessKeySecret基于HMC-SHA1算法加密 ?對加密結果用MD5加密 ? ? ? ? ?? 舉例參數： ?AccessKeyID=userid ?AccessKeySecret=password ?TimeStamp=2016-02-23 12:46:24 ?SignatureNonce=123456 ?根據參數名排序后： AccessKeyID=userid&SignatureNonce=123456&TimeStamp=2016-02-23T12:46:24 ?使用AccessKeySecret基于HMC-SHA1算法加密及MD5加密算法示范：?? ?
?輸出結果：D29569843EB9DFA0F59E921F32D24973 ? ? ? ? ?? 四、標準接口列表??（一）初始化數據??說明:?? ? 初始化發票數據，當前申報期內可認證所有發票狀態改成“未同步”。 ? ? ? ? ??
? ? ? ? ?? 入參說明
? ? ? ? ?? ? ? ? ? ?? JSON入參說明： { ???????“TaxNo”:””??????????????????//初始化發票的稅號 } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{ ????????Success:"",??????????????//調用API是否成功：true/false ??????????????Code:"",?????????????????????//返回碼(見附表一) ??????????????Message:""??????????????//返回碼對應信息(見附表一) ????},? ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{?? ? ????????"success_message":?"調用[初始化]接口成功！" ????},? "success": true } ? ? ? ? ?? 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } ? ? ? ? ?? 出參說明：
? ? ? ? ?? （二）取數??說明： ????獲取任務結果，一次最多返回一千條發票；每天調用一次、初始化成功后調用。可獲取當前申報期內可認證的所有發票。
? ? ? ? ?? 入參說明
? ? ? ? ?? ? ? ? ? ?? JSON入參說明： { ???????“TaxNo”:””??????????????????????//取數稅號 } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{ ????????TaskNo:””,?????????????????????//任務編號 ??????????????InvoiceQuantity:””,??????????????//發票數量 ??????????????PeriodYear:””,?????????????????????//當前稅款所屬期年份 ??????????????PeriodMonth:””,??????????????//當前稅款所屬期月份 ??????????????OperationDateBegin:””,???????//當前可操作時間起(YYYY-MM-DD) OperationDateEnd:””,???????//當前可操作時間止(YYYY-MM-DD) DateFrameBegin:“”,??????????????//當前可操作時間范圍起(YYYY-MM-DD)?? ? DateFrameEnd:“”,??????????????//當前可操作時間范圍止(YYYY-MM-DD) FollowTask:””,?????????????????????//是否有后續任務true/false；無后續任務則不需要再次獲取 Success:””,?????????????????????//調用API是否成功：true/false Code:“”,????????????????????????????//返回碼(見附表一) Message:””,?????????????????????//返回碼對應信息(見附表一) InvoiceList:[?????????????????????//發票列表 ???????{ ??????????????No:””,?????????????????????//序號 ???????InvoiceCode:"",???????//發票代碼 InvoiceNumber:"",???????//發票號碼 InvoiceType:””,??????????????//發票種類01-增值稅專用發票 02-貨運運輸業增值稅專用發票 03-機動車銷售統一發票 14-通行費增值稅電子普通發票 BillingDate:" ",????????//開票日期：YYYY-MM-DD State:"1",?????????????????????//發票狀態（0-正常1-失控 2-作廢 3-紅沖 4-異常） PurchaserTaxNo:"",???????//購方稅號 TotalAmount:””,???????//合計金額 TotalTax:””,??????????????//合計稅額 SalesTaxNo:"",??????????????//銷方稅號 SalesTaxName:"",???????//銷方名稱 Deductible:””,??????????????//是否認證 0-未認證 1-已認證 DeductibleDate:””,???????//認證日期 如果已認證則為YYYY-MM-DD，未認證則為空?? ? DeductiblePeriod:””,//稅款所屬期 如果已認證則為YYYYMM，未認證則為空 "IsAgencyRebate": "0", // 是否代辦退稅（1為是，0為否） "CertificationType":"1"http://認證類型 1為抵扣，2為出口退稅，3為代理出口退稅 }, ] ? ? ? ? ?? }, ????"request_id":?"", ????"message":?{ ????????"success_message":?"調用[取數]接口成功！" ????},? "success": true } ? ? ? ? ?? 失敗： { "request_id": "", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } 出參說明：
? ? ? ? ?? ? ? ? ? ???? ? （三）取數任務接收成功反饋??說明： ????當前任務號獲取成功
? ? ? ? ?? 入參說明：
? ? ? ? ?? ? ? ? ? ?? JSON入參說明： { ???????“TaxNo”:””,??????????????????????//通知取數成功稅號 ???????“TaskNo”:””,????????????//任務號 } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{?? ? ????????Success:"",??????????????//調用API是否成功：true/false ??????????????Code:"",?????????????????????//返回碼(見附表一) ??????????????Message:""??????????????//返回碼對應信息(見附表一) ????},? ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{ ????????"success_message":?"調用[取數成功反饋]接口成功！" ????},? "success": true } ? ? ? ? ?? 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } 出參說明：
? ? ? ? ???? ? （四）認證抵扣申請??說明： 確認當前稅款所屬期抵扣，申請提交后，接口會根據web端設置的一步認證標識進行判斷，如為開啟狀態，則直接提交稅局認證。如為關閉狀態，則本接口中的發票進入待認證列表，需要去web端進行確認后完成認證。
? ? ? ? ?? 入參說明：
? ? ? ? ???? ? JSON入參說明：（JSON串） { ???????“TaxNo”:””,?????????????????????//稅號 “Period”:””,?????????????????????//稅控所屬期???????（YYYYMM） “InvoiceList”:[ { InvoiceCode:"",???????//發票代碼 InvoiceNumber:"",???????//發票號碼 PurchaserTaxNo:"",???????//購方稅號 CertificationType:"" //認證類型 1為抵扣，2為出口退稅，3為代理出口退稅 } ] } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{ ????????TaskList:[????????????? ?????????????????????{ ?????????????????????InvoiceCode:"",???????//發票代碼 ?????????????????????InvoiceNumber:"",???????//發票號碼 ?????????????????????TaskNo:""?????????????????????//任務號 ?????????????????????}, ??????????????] ??????????????Success:””,??????????????//調用API是否成功：true/false ??????????????Code:"",?????????????????????//返回碼(見附表一)?? ? ??????????????Message:””??????????????//返回碼對應信息(見附表一) ????},? ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{ ????????"success_message":?"調用[申請抵扣]接口成功！" ????},? ???????"success": true } ? ? ? ? ?? 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } 出參說明：
? ? ? ? ?? ? ? ? ? ?? （五）認證抵扣結果同步??說明： ????獲取抵扣結果
? ? ? ? ?? 入參說明
? ? ? ? ?? JSON入參說明：（JSON串） { “TaxNo”:””,?????????????????????//稅號 “InvoiceCode”:"",???????//發票代碼?? ? “InvoiceNumber”:"",???????//發票號碼 “TaskNo”:””??????????????//任務號 } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{ ??????????????TaxNo:””,?????????????????????//稅號 ??????????????Success: ””,??????????????//調用API是否成功：true/false ??????????????Code: ””,?????????????????????//返回碼(見附表一) ??????????????Message: ””,??????????????//返回碼對應信息(見附表一) ??????????????InvoiceCode:"",???????//發票代碼 ??????????????InvoiceNumber:"",???????//發票號碼 ??????????????TaskNo: ””,??????????????//任務號 ??????????????ResultCode: ””,???????//處理結果 1-成功 2-無此票 3-該票異常無法認證 4-該票已經認證 5-該票已經逾期無法認證 6-該票已經申請認證 7-申請認證月份已過期 8-其它異常 11-該票已作廢 12 –該發票已紅沖 13-未到申報期 14-該發票稅號不匹配 15-紅字發票不可認證?16-認證類型錯誤0-任務執行中 ??????????????DeductibleDate: ””,???????//認證日期 如果已認證則為YYYY-MM-DD，未認證則為空 ??????????????DeductiblePeriod: ””,//稅款所屬期 如果已認證則為YYYYMM，未認證則為空 ??????????????CertificationType:"" //認證類型?1為抵扣，2為出口退稅，3為代理出口退稅?? ? ???????}, ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{ ????????"success_message":?"調用[獲取抵扣結果]接口成功！" ????},? ???????"success": true } ? ? ? ? ?? 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } 出參說明
? ? ? ? ?? ? ? ? ? ?? （六）發票查驗??
? ? ? ? ?? 入參說明
? ? ? ? ?? JSON入參說明： { “TaxNo”:””,?????????????????????//稅號 “InvoiceCode”:””,???????????//發票代碼 “InvoiceNumber”:””,???????//發票號碼 “BillingDate”:””,??????????????//開票日期：YYYY-MM-DD “CheckCode_6”:””,???????????//校驗碼后6位（普票、電子普票、卷式普票必填） “TotalAmount”:””???????????//合計金額，必須精確到兩位小數（專票、貨運專票、機動車專票必填） } ? ? ? ? ?? ? ? ? ? ?? ? ? ? ? ?? JSON出參說明： 成功： { ????"model":? ???????//1、增值稅專用發票?? ? ???????{ ??????????????InvoiceType:"01",??????????????//增值稅專用發票????????????? ??????????????Data:??????????????????????????? ??????????????{??????????????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼 ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼?????? ?????????????????????InvoiceNumber:"",??????????????//發票號碼?????? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD?????? ?????????????????????PurchaserName:"",??????????????//購方名稱?????? ?????????????????????PurchaserTaxNo:"",??????????????//購方稅號?????? ?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶?????? ?????????????????????PurchaserAddressPhone:"",//購方地址電話?????? ?????????????????????SalesName:"",?????????????????????//銷方名稱?????? ?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號?????? ?????????????????????SalesAddressPhone:"",???????//銷方地址電話?????? ?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶?????? ?????????????????????TotalAmount:"",??????????????//合計金額?????? ?????????????????????TotalTax:"",?????????????????????//合計稅額?????? ?????????????????????AmountTax:"",?????????????????????//價稅合計?????? ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文?????? ?????????????????????Remarks:"",?????????????????????//備注?????? ?????????????????????MachineCode:"",??????????????//機器編碼?????? ?????????????????????CheckCode:"",?????????????????????//校驗碼???????? ? ?????????????????????State:"",????????????????????????????//發票狀態（1：正常；2：作廢；)?????? ?????????????????????InvoiceList:[?????????????????????//發票詳細信息列表?????? ????????????????????????????{????????????? ????????????????????????????RowNo:"",????????????????????????????//行號（從1開始） ????????????????????????????CommodityCode:"",??????????????//商品編碼 ????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱 ????????????????????????????SpecificationModel:"",??????????????//規格型號 ????????????????????????????Unit:"",???????????????????????????????????//單位 ????????????????????????????Quantity:"",????????????????????????????//數量 ????????????????????????????UnitPrice:"",????????????????????????????//單價 ????????????????????????????Amount:"",????????????????????????????//金額 ????????????????????????????TaxRate:"",????????????????????????????//稅率 ????????????????????????????Tax:""???????????????????????????????????//稅額 ????????????????????????????},????????????? ?????????????????????]???????????????????? ??????????????},??????????????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false????????????? ??????????????Code:"",??????????????//返回碼(見附表一)????????????? ??????????????Message:""??????????????//返回碼對應信息(見附表一)????????????? ???????}?????? ? ? ? ? ?? ???????//2、貨運運輸業增值稅專用發票?????? ???????{?????????????????????????????????? ??????????????InvoiceType:"02",??????????????//貨運運輸業增值稅專用發票????????????? ??????????????Data:??????????????????????????? ??????????????{??????????????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼?? ? ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼?????? ?????????????????????InvoiceNumber:"",??????????????//發票號碼?????? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD?????? ?????????????????????CarrierName:"",???????????????//承運人名稱?????? ?????????????????????CarrierTaxNo:"",???????????????//承運人識別號?????? ?????????????????????DraweeName:"",??????????????//受票方名稱?????? ?????????????????????DraweeTaxNo:"",???????????????//受票方識別號?????? ?????????????????????PurchaserName:"",??????????????//收貨人名稱?????? ?????????????????????PurchaserTaxNo:"",??????????????//收貨人識別號??????? ?????????????????????SalesName:"",?????????????????????//發貨人名稱?????? ?????????????????????SalesTaxNo:"",?????????????????????//發貨人識別號?????? ?????????????????????TotalAmount:"",??????????????//合計金額?????? ?????????????????????CargoInformation:"",???????//運輸貨物信息?????? ?????????????????????TransportRoute:"",??????????????//起運地、經由、到達地?????? ?????????????????????TaxRate:"",?????????????????????//稅率?????? ?????????????????????TotalTax:"",?????????????????????//合計稅額?????? ?????????????????????MachineCode:"",??????????????//稅控盤號?????? ?????????????????????AmountTax:"",?????????????????????//價稅合計?????? ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文 ?????????????????????AutomobileType:"",???????//車種車號?????? ?????????????????????Tonnage:"",?????????????????????//車船噸位???????? ? ?????????????????????TaxAuthorityNo:"",??????????????//主管稅務機關?????? ?????????????????????TaxAuthorityName:"",???????//主管稅務名稱?????? ?????????????????????Remarks:"",?????????????????????//備注?????? ?????????????????????State:"",????????????????????????????//發票狀態（1：正常；2：作廢；)?????? ?????????????????????InvoiceList:[???????????????????? ????????????????????????????{????????????? ????????????????????????????RowNo:"",?????????????????????//行號（從1開始）\ ????????????????????????????CommodityCode:"",??????????????//商品編碼 ????????????????????????????CommodityName:"",???????//費用項目 ????????????????????????????Amount:""?????????????????????//金額 ????????????????????????????},????????????? ?????????????????????]???????????????????? ??????????????},??????????????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false????????????? ??????????????Code:"",?????????????????????//返回碼(見附表一)????????????? ??????????????Message:""??????????????//返回碼對應信息(見附表一)????????????? ???????}?????????????????????????????????? ? ? ? ? ?? ???????//3、機動車銷售統一發票 ???????{??????????????????????????? ??????????????InvoiceType:"03",??????????????//機動車銷售統一發票?????? ??????????????Data:???????????????????? ??????????????{???????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼 ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼 ?????????????????????InvoiceNumber:"",??????????????//發票號碼?? ? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD ?????????????????????MachineCode:"",??????????????//機器編碼 ?????????????????????PurchaserName:"",??????????????//購方名稱 ?????????????????????IDCardNo:"",?????????????????????//身份證號碼/組織機構代碼 ?????????????????????PurchaserTaxNo:"",??????????????//購方稅號 ?????????????????????VehicleType:"",??????????????//車輛類型 ?????????????????????BrandModel:"",??????????????//廠牌型號 ?????????????????????OriginPlace:"",?????????????????????//產地 ?????????????????????CertificateNo:"",??????????????//合格證號 ?????????????????????Amount:"",?????????????????????//不含稅價 ?????????????????????InspectionListNo:"",???????//商檢單號 ?????????????????????EngineNo:"",?????????????????????//發動機號 ?????????????????????VehicleNo:"",?????????????????????//車輛識別代號/車架號碼 ?????????????????????ImportCertificateNo:"",???????//進口證明書號 ?????????????????????SalesName:"",?????????????????????//銷方名稱 ?????????????????????SalesPhone:"",?????????????????????//銷方地址電話 ?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號 ?????????????????????SalesBankNo:"",??????????????//賬號 ?????????????????????SalesAddress:"",??????????????//銷方地址 ?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶 ?????????????????????TaxRate:"",?????????????????????//稅率 ?????????????????????Tax:""????????????????????????????//稅額?? ? ?????????????????????TaxAuthorityNo:"",??????????????//主管稅務機關 ?????????????????????AmountTax:"",?????????????????????//價稅合計 ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文 ?????????????????????PaymentVoucherNo:"",???????//完稅憑證號碼 ?????????????????????Tonnage:"",?????????????????????//噸位 ?????????????????????PassengersLimited:"",???????//限乘人數 ?????????????????????State:"",????????????????????????????//發票狀態（1：正常；2：作廢；) ?????????????????????TaxAuthorityName:"",???????//主管稅務名稱 ??????????????},???????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false?????? ??????????????Code:"",?????????????????????//返回碼(見附表一)?????? ??????????????Message:""??????????????//返回碼對應信息(見附表一)?????? ???????}??????????????????????????? ? ? ? ? ?? ???????//4、增值稅普通發票 ???????{?????????????????????????????????? ??????????????InvoiceType:"04",??????????????//增值稅普通發票????????????? ??????????????Data:??????????????????????????? ??????????????{??????????????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼 ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼?????? ?????????????????????InvoiceNumber:"",??????????????//發票號碼?????? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD?????? ?????????????????????SalesName:"",?????????????????????//銷方名稱???????? ? ?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號?????? ?????????????????????SalesAddressPhone:"",???????//銷方地址電話?????? ?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶?????? ?????????????????????PurchaserName:"",??????????????//購方名稱?????? ?????????????????????PurchaserTaxNo:"",??????????????//購方稅號?????? ?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶?????? ?????????????????????PurchaserAddressPhone:"",//購方地址電話?????? ?????????????????????CheckCode:"",?????????????????????//校驗碼?????? ?????????????????????TotalTax:"",?????????????????????//合計稅額?????? ?????????????????????AmountTax:"",?????????????????????//價稅合計?????? ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文 ?????????????????????Remarks:"",?????????????????????//備注?????? ?????????????????????MachineCode:"",??????????????//機器編碼?????? ?????????????????????TotalAmount:"",??????????????//合計金額?????? ?????????????????????State:"",????????????????????????????//作廢標志（1：正常；2：作廢；)?????? ?????????????????????InvoiceList:[?????????????????????//發票詳細信息列表?????? ????????????????????????????{????????????? ????????????????????????????RowNo:"",????????????????????????????//行號（從1開始） ????????????????????????????CommodityCode:"",??????????????//商品編碼 ????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱 ????????????????????????????SpecificationModel:"",??????????????//規格型號 ????????????????????????????Unit:"",???????????????????????????????????//單位 ????????????????????????????Quantity:"",????????????????????????????//數量?? ? ????????????????????????????UnitPrice:"",????????????????????????????//單價 ????????????????????????????Amount:"",????????????????????????????//金額 ????????????????????????????TaxRate:"",????????????????????????????//稅率 ????????????????????????????Tax:""???????????????????????????????????//稅額 ????????????????????????????},????????????? ?????????????????????]???????????????????? ??????????????},??????????????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false????????????? ??????????????Code:"",?????????????????????//返回碼(見附表一)????????????? ??????????????Message:""??????????????//返回碼對應信息(見附表一) ???????}????????????????????????????????????????? ? ? ? ? ?? ???????//5、增值稅電子普通發票 ???????{?????????????????????????????????? ??????????????InvoiceType:"10",??????????????//增值稅電子普通發票????????????? ??????????????Data:??????????????????????????? ??????????????{??????????????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼 ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼?????? ?????????????????????InvoiceNumber:"",??????????????//發票號碼?????? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD?????? ?????????????????????SalesName:"",?????????????????????//銷方名稱?????? ?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號?????? ?????????????????????SalesAddressPhone:"",???????//銷方地址電話?????? ?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶???????? ? ?????????????????????PurchaserName:"",??????????????//購方名稱?????? ?????????????????????PurchaserTaxNo:"",??????????????//購方稅號?????? ?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶?????? ?????????????????????PurchaserAddressPhone:"",//購方地址電話?????? ?????????????????????CheckCode:"",?????????????????????//校驗碼?????? ?????????????????????TotalTax:"",?????????????????????//合計稅額?????? ?????????????????????AmountTax:"",?????????????????????//價稅合計?????? ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文 ?????????????????????Remarks:"",?????????????????????//備注?????? ?????????????????????MachineCode:"",??????????????//機器編碼?????? ?????????????????????TotalAmount:"",??????????????//合計金額?????? ?????????????????????State:"",????????????????????????????//發票狀態（1：正常；2：作廢；)?????? ?????????????????????InvoiceList:[?????????????????????//發票詳細信息列表?????? ????????????????????????????{????????????? ????????????????????????????RowNo:"",????????????????????????????//行號（從1開始） ????????????????????????????CommodityCode:"",??????????????//商品編碼 ????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱 ????????????????????????????SpecificationModel:"",??????????????//規格型號 ????????????????????????????Unit:"",???????????????????????????????????//單位 ????????????????????????????Quantity:"",????????????????????????????//數量 ????????????????????????????UnitPrice:"",????????????????????????????//單價 ????????????????????????????Amount:"",????????????????????????????//金額 ????????????????????????????TaxRate:"",????????????????????????????//稅率?? ? ????????????????????????????Tax:""???????????????????????????????????//稅額 ????????????????????????????},????????????? ?????????????????????]???????????????????? ??????????????},??????????????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false????????????? ??????????????Code:"",?????????????????????//返回碼(見附表一)????????????? ??????????????Message:""??????????????//返回碼對應信息(見附表一)????????????? ???????}?????????????????????????????????? ? ? ? ? ?? ???????//6、增值稅普通發票（卷式） ???????{?????????????????????????????????? ??????????????InvoiceType:"11",??????????????//增值稅普通發票（卷式）????????????? ??????????????Data:??????????????????????????? ??????????????{??????????????????????????? ?????????????????????AdministrativeDivisionNo:””,//所屬行政區編碼 ?????????????????????AdministrativeDivisionName:””,//所屬行政區名稱 ?????????????????????InvoiceCode:"",??????????????//發票代碼?????? ?????????????????????InvoiceNumber:"",??????????????//發票號碼?????? ?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD?????? ?????????????????????SalesName:"",?????????????????????//銷方名稱?????? ?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號?????? ?????????????????????PurchaserName:"",??????????????//購方名稱?????? ?????????????????????PurchaserTaxNo:"",??????????????//購方稅號?????? ?????????????????????CheckCode:"",?????????????????????//校驗碼?????? ?????????????????????TotalTax:"",?????????????????????//合計稅額?????? ?????????????????????AmountTax:"",?????????????????????//價稅合計???????? ? ?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文 ?????????????????????Remarks:"",?????????????????????//備注?????? ?????????????????????MachineCode:"",??????????????//機器編碼?????? ?????????????????????TotalAmount:"",??????????????//合計金額?????? ?????????????????????TotalAmountCN:"",??????????????//合計金額_中文 ?????????????????????ReceivingClerk:"",??????????????//收貨員?????? ?????????????????????State:"",????????????????????????????//發票狀態（1：正常；2：作廢；)?????? ?????????????????????InvoiceList:[?????????????????????//發票詳細信息列表?????? ????????????????????????????{????????????? ????????????????????????????RowNo:"",??????????????//行號（從1開始） ????????????????????????????CommodityCode:"",??????????????//商品編碼 ????????????????????????????CommodityName:"",//項目 ????????????????????????????Quantity:"",??????????????//數量 ????????????????????????????UnitPrice:"",??????????????//含稅單價 ????????????????????????????Amount:""??????????????//含稅金額 ????????????????????????????},????????????? ?????????????????????]???????????????????? ??????????????},??????????????????????????? ??????????????Success:"",??????????????//調用API是否成功：true/false????????????? ??????????????Code:"",?????????????????????//返回碼(見附表一)????????????? ??????????????Message:""??????????????//返回碼對應信息(見附表一)????????????? ???????}?????? ? ? ? ? ?? ????},? ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{ ????????"success_message":?"調用[全票面]接口成功！"?? ? ????},? "success": true } 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } ? ? ? ? ?? ? ? ? ? ?? //7、增值稅電子普通發票（通行費） { InvoiceType:"14",//增值稅電子普通發票（通行費） Data: { AdministrativeDivisionNo:"",//所屬行政區編碼 AdministrativeDivisionName:"",//所屬行政區名稱 InvoiceCode:"",//發票代碼 InvoiceNumber:"",//發票號碼 BillingDate:"", //開票日期：YYYY-MM-DD SalesName:"", //銷方名稱 SalesTaxNo:"", //銷方稅號 SalesAddressPhone:"", //銷方地址電話 SalesBank:"", //銷方開戶行賬戶?? ? PurchaserName:"",//購方名稱 PurchaserTaxNo:"",//購方稅號 PurchaserBank:"",//購方開戶行賬戶 PurchaserAddressPhone:"",//購方地址電話 CheckCode:"", //校驗碼 TotalTax:"", //合計稅額 AmountTax:"", //價稅合計 AmountTaxCN:"",//價稅合計_中文 Remarks:"", //備注 MachineCode:"",//機器編碼 TotalAmount:"",//合計金額 State:"", //發票狀態（1：正常；2：作廢；) TollSign: "06"http://通行費標志(06-可抵扣通行費，07-不可抵扣通行費) InvoiceList:[ //發票詳細信息列表 { RowNo:"",//行號（從1開始） CommodityCode:"",//商品編碼 CommodityName:"",//貨物或應稅勞務名稱 Amount: 7.61, //金額 TaxRate:"",//稅率 Tax:""http://稅額 CurrentDateEnd: "20171211", //通行日起止 CurrentDateStart: "20171211", //通行日期起?? ? LicensePlateNum: "粵ATST10", //車牌號 Type: "貨車"http://類型 }, ] }, Success:"",//調用API是否成功：true/false Code:"", //返回碼(見附表一) Message:""http://返回碼對應信息(見附表一) } 出參說明：
? ? ? ? ?? ? ? ? ? ?? （七）發票信息查詢??說明： 通過接口查詢發票的相關內容。
? ? ? ? ???? ? 入參說明：
? ? ? ? ?? ? ? ? ? ?? JSON入參說明：（JSON串） { ???????“TaxNo”:””,?????????????????????????//稅號 ????“InvoiceCode”:"",?????????????????//發票代碼 ???????“InvoiceNumber”:""??????????????//發票號碼 } ? ? ? ? ?? JSON出參說明： 成功： { ????"model":?{ ????????TaskNo:””,?????????????????????//任務編號 Success:””,?????????????????????//調用API是否成功：true/false Code:“”,????????????????????????????//返回碼(見附表一) Message:””,?????????????????????//返回碼對應信息(見附表一) ???????????InvoiceCode:"",???????//發票代碼 ????????InvoiceNumber:"",???????//發票號碼 ???InvoiceType:””,??????????????//發票種類01-增值稅專用發票?02-貨運運輸業增值稅專用發票 03-機動車銷售統一發票 14-通行費增值稅電子普通發票?? ? ?????????BillingDate:"?",????????//開票日期：YYYY-MM-DD ?????????State:"1",?????????????????????//發票狀態（0-正常1-失控?2-作廢 3-紅沖 4-異常） ?????????PurchaserTaxNo:"",???????//購方稅號 ?????????TotalAmount:””,???????//合計金額 ?????????TotalTax:””,??????????????//合計稅額 ?????????SalesTaxNo:"",??????????????//銷方稅號 ?????????SalesTaxName:"",???????//銷方名稱 ?????????Deductible:””,??????????????//是否認證?0-未認證 1-已認證 ?????????DeductibleDate:””,???????//認證日期?如果已認證則為YYYY-MM-DD，未認證則為空 ?????????DeductiblePeriod:””,//稅款所屬期?如果已認證則為YYYYMM，未認證則為空 }, }, ????"request_id":?"", ????"message":?{ ????????"success_message":?"調用[發票信息查詢]接口成功！" ????},? "success": true } ? ? ? ? ?? 失敗： { "request_id": "", --請求ID,用于定位問題 "message": { ????????"error_code":?"",??????--失敗的CODE?? ? ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } ? ? ? ? ?? 出參說明：
? ? ? ? ?? （八）獲取當前系統時間??說明： 獲取當前系統時間，便于時間戳的校驗
? ? ? ? ?? 特殊說明：此處Signature生成不包括TimeStamp的值。 ? ? ? ? ?? JSON入參說明：（JSON串） ? ? ? ? ?? 無 ? ? ? ? ?? JSON出參： ? ? ? ? ?? 成功： { "model": { ???????SystemTime:””,?????????????????????//當前系統時間"yyyy-MM-dd'T'HH:mm:ss'Z'" ?SystemTimeLong:””,??????????????//當前系統時間CurrentTimeMills ??????????????Success:””,?????????????????//調用API是否成功：true/false ??????????????Code:"",?????????????????????//返回碼(見附表一) ??????????????Message:””??????????????//返回碼對應信息(見附表一) ????},? ????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516", ????"message":?{ ????????"success_message":?"調用[獲取系統時間]成功！" ????},? ???????"success": true } ? ? ? ? ?? 失敗： { "request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題?? ? "message": { ????????"error_code":?"",??????--失敗的CODE ????????"error_message":?""???--失敗提示語 ????},? "success": false??--失敗標志 } ? ? ? ? ?? 出參說明
? ? ? ? ?? 五、定制接口列表??（一）單據關聯發票??說明： 嵌入SAP流程，通過參數獲取發票列表
? ? ? ? ?? 特殊說明：此處Signature生成不包括TimeStamp的值。 ? ? ? ? ?? 入參說明：URL PurchaserName:"",??????????????//購方名稱，不能為空 ???????PurchaserTaxNo:"",??????????????//購方稅號，可以為空 InvoiceNumberRang:””???????//發票號碼，不能為空，只能是數字或-/， //多個號碼段以 / 分隔，最多4個/，例如： //12345601-09/12345620/12345631-12345640 //解析時先以/分隔，在按下面邏輯解析 //如果有”-”，則自動解析發票號碼范圍 //36230244-50，則-后面的號碼，自動填充到第一個號碼的長度 //解析為：36230244到36230250的范圍 //如果沒有-，則完全匹配發票號碼 BillingDateStart:””??????????????//格式：yyyy-MM-dd BillingDateEnd:””??????????????//格式：yyyy-MM-dd ? ? ? ? ?? XML出參： ? ? ? ? ?? 成功： ? ? ? ? ? <request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id> ? ? ? ? ? ? ? ? ? ? <success_message>調用成功！success_message> ? ? ? ? ? ? ? ? ? ? ?????????????????????//返回碼(見附表一) <Success>true???????//返回碼對應信息(見附表一) ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ..... ? ? ? ? ?? 失敗：? ? ? ? ? ? ? ? ? ? <request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id> ? ? ? ? ? <error_code>error_code> <error_message>error_message> ? ? ? ? ?? （二）單據反饋接口（一）附表一：錯誤信息表??
? ? ? ? ???? ? （二）附表二：發票種類??
? ? ? ? ?? ? ? ? ? ?? ? ? ? ? ?? 文檔修改記錄： ? ? ? ? ??
該文章在 2025/4/30 16:18:40 編輯過 |
關鍵字查詢
相關文章
正在查詢... 
|
400 186 1886
