日韩欧美人妻无码精品白浆,www.大香蕉久久网,狠狠的日狠狠的操,日本好好热在线观看

LOGO OA教程 ERP教程 模切知識交流 PMS教程 CRM教程 開發(fā)文檔 其他文檔  
 
網(wǎng)站管理員

SAP、百望，進項發(fā)票一體化對接
admin
2024年11月3日 7:19 本文熱度 2066

?SAP、SRM-百望接口

  • 思路

SAP、SRM相關頁面中加按鈕‘導入發(fā)票號’，實現(xiàn)單點登錄百望界面，百望開發(fā)選擇發(fā)票號界面，選擇完成后調(diào)用接口，實現(xiàn)保存發(fā)票號，對SAP中參照、分配等進行賦值或對srm相關字段進行賦值。

SAP中發(fā)票預制憑證導入功能，同時保存進百望系統(tǒng)。

  • SAM、SRM相關界面

SRM相關頁面

?

百望反饋：

根據(jù)以上說明，先整理以下：

?

1.指定單點登錄規(guī)則，校驗身份的方式，和SAP提供的接口。

a)如何獲取校驗身份的token

b)SAP提供接口，根據(jù)返回字段標明身份驗證成功或失敗

?

2.百望提供頁面：

a)百望提供頁面url

b)參數(shù)：購方名稱，發(fā)票時間范圍起和止，其他參數(shù)？

c)頁面：發(fā)票需要顯示哪些列？實際業(yè)務中，最多可能有多少張發(fā)票？默認是否是都打勾？默認根據(jù)開票日期排序？是否需要分頁？顯示合計信息：發(fā)票張數(shù)，金額之和，稅額之和？

d)點擊確定按鈕之后，通過何種方式將這些發(fā)票信息傳給SAP？通過js傳遞給父窗口，還是在后臺通過接口傳遞？

?

?效果圖：

ZBADI_FDCB_SUBBAS04_BADI ?MIR7屏幕增強增加按鈕 ?SE80ZMRM_HEADER_CHECK ?未接入百望發(fā)票保存報錯消息 ?SE19ZINVOICE_UPDATE ?預制成功更新底表 ?SE19LFDCBFM0 ?參照和分配字段返回 ?SE38LMR1MF2Y ?每次執(zhí)行事務MIR7清空ZLTB ?SE38


執(zhí)行MIR7事務同時清空當前用戶ZLTBW的數(shù)據(jù) ? ? ? ? ? ? ? ?MIR7預制發(fā)票跳轉百望發(fā)票搜索平臺 ? ? ? ? ? ? ? ?多次檢索完畢返回MIR7界面同時更新臨時自建表ZLTBW ? ? ? ? ? ? ? ?MIR7若未接入百望發(fā)票預制報消息提示 ? ? ? ? ? ? ? ?MIR7預制成功后更新到自建表ZMMBW ? ? ? ? ? ? ? ?執(zhí)行ZDMM002事務同時清空當前用戶ZLTBW數(shù)據(jù) ? ? ? ? ? ? ? ?ZDMM002上載文本后ALV顯示數(shù)據(jù) ? ? ? ? ? ? ? ?ZDMM002預制發(fā)票跳轉百望發(fā)票搜索平臺 ? ? ? ? ? ? ? ?多次檢索完畢返回ZDMM002界面同時更新臨時自建表ZLTBW ? ? ? ? ? ? ? ?ZDMM002若未接入百望發(fā)票預制報消息提示 ? ? ? ? ? ? ? ?ZDMM002預制成功后更新到自建表ZMMBW ? ? ? ? ? ? ? ?

百望進項標準版

對接服務接口文檔說明

一、進項介紹??

??百望進項管理系統(tǒng)是百望開發(fā)的為企業(yè)管理進項發(fā)票的系統(tǒng)，從發(fā)票的入庫、查驗、認證都進行數(shù)字化管控，大大增加了企業(yè)內(nèi)部發(fā)票流轉的效率，提高財稅人員的工作效率。

本接口文檔是百望進項標準版接口文檔，客戶入駐標準版本后，都可使用本接口跟百望進項標準版進行交互，系統(tǒng)根據(jù)稅號為客戶提供進項數(shù)據(jù)接口服務。

二、加密規(guī)則??

????每個接入用戶提供一個用戶名AccessKeyID、秘鑰AccessKeySecret；使用秘鑰基于HMC-SHA1算法進行請求內(nèi)容的加密和解密；

三、URL生成??

調(diào)用URL地址：

? ? ? ? ?/?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0Signature=D29569843EB9DFA0F59E921F32D24973

????????1>??? ? ? ? ?為調(diào)用服務地址，單獨給出，不寫入此文檔。

????????2>??? ? ? ? ?為接口名稱

????????3>版本號，默認為1.0（參考文檔版本的前兩位數(shù)字）?? ?

4> URL字符說明：

?對于字符 A-Z、a-z、0-9 以及字符“-”、“_”、“.”、“~”不編碼；

?對于其他字符編碼成 “%XY” 的格式

?對于擴展的 UTF-8 字符，編碼成 “%XY%ZA…” 的格式

?需要說明的是英文空格（ ）要被編碼是 %20，而不是加號（+）

?時間類型"yyyy-MM-dd'T'HH:mm:ss'Z'"

?SignatureNonce為32位隨機數(shù)UUID，時效為10分鐘。

???????

5> Signature生成規(guī)則：

?連接內(nèi)容排序：將本URL中，除Signature外其他所有參數(shù)，按照參數(shù)名稱的字典順序

?使用AccessKeySecret基于HMC-SHA1算法加密

?對加密結果用MD5加密

? ? ? ? ??

舉例參數(shù)：

?AccessKeyID=userid

?AccessKeySecret=password

?TimeStamp=2016-02-23 12:46:24

?SignatureNonce=123456

?根據(jù)參數(shù)名排序后：

AccessKeyID=userid&SignatureNonce=123456&TimeStamp=2016-02-23T12:46:24

?使用AccessKeySecret基于HMC-SHA1算法加密及MD5加密算法示范：?? ?

?輸出結果：D29569843EB9DFA0F59E921F32D24973

? ? ? ? ??

四、標準接口列表??

（一）初始化數(shù)據(jù)??

說明:?? ?

初始化發(fā)票數(shù)據(jù)，當前申報期內(nèi)可認證所有發(fā)票狀態(tài)改成“未同步”。

? ? ? ? ??

請求地址

? ? ? ? ? ? ? ? ?/init?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ??

入?yún)⒄f明

參數(shù)

類型

長度

必填

描述

TaxNo

String

20

是

購方稅號

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

???????“TaxNo”:””??????????????????//初始化發(fā)票的稅號

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????Success:"",??????????????//調(diào)用API是否成功：true/false

??????????????Code:"",?????????????????????//返回碼(見附表一)

??????????????Message:""??????????????//返回碼對應信息(見附表一)

????},?

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{?? ?

????????"success_message":?"調(diào)用[初始化]接口成功！"

????},?

"success": true

}

? ? ? ? ??

失?。?/span>

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

? ? ? ? ??

出參說明：

參數(shù)

類型

長度

描述

Success

Boolean

5

是否成功（True/false）

Code

String

4

返回碼

Message

String

200

返回信息

? ? ? ? ??

（二）取數(shù)??

說明：

????獲取任務結果，一次最多返回一千條發(fā)票；每天調(diào)用一次、初始化成功后調(diào)用?？色@取當前申報期內(nèi)可認證的所有發(fā)票。

請求地址

? ? ? ? ? ? ? ? ?/sync?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973?? ? ? ?

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ??

入?yún)⒄f明

參數(shù)

類型

長度

必填

描述

TaxNo

String

20

是

購方稅號

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

???????“TaxNo”:””??????????????????????//取數(shù)稅號

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????TaskNo:””,?????????????????????//任務編號

??????????????InvoiceQuantity:””,??????????????//發(fā)票數(shù)量

??????????????PeriodYear:””,?????????????????????//當前稅款所屬期年份

??????????????PeriodMonth:””,??????????????//當前稅款所屬期月份

??????????????OperationDateBegin:””,???????//當前可操作時間起(YYYY-MM-DD)

OperationDateEnd:””,???????//當前可操作時間止(YYYY-MM-DD)

DateFrameBegin:“”,??????????????//當前可操作時間范圍起(YYYY-MM-DD)?? ?

DateFrameEnd:“”,??????????????//當前可操作時間范圍止(YYYY-MM-DD)

FollowTask:””,?????????????????????//是否有后續(xù)任務true/false；無后續(xù)任務則不需要再次獲取

Success:””,?????????????????????//調(diào)用API是否成功：true/false

Code:“”,????????????????????????????//返回碼(見附表一)

Message:””,?????????????????????//返回碼對應信息(見附表一)

InvoiceList:[?????????????????????//發(fā)票列表

???????{

??????????????No:””,?????????????????????//序號

???????InvoiceCode:"",???????//發(fā)票代碼

InvoiceNumber:"",???????//發(fā)票號碼

InvoiceType:””,??????????????//發(fā)票種類01-增值稅專用發(fā)票 02-貨運運輸業(yè)增值稅專用發(fā)票 03-機動車銷售統(tǒng)一發(fā)票 14-通行費增值稅電子普通發(fā)票

BillingDate:" ",????????//開票日期：YYYY-MM-DD

State:"1",?????????????????????//發(fā)票狀態(tài)（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":?"調(diào)用[取數(shù)]接口成功！"

????},?

"success": true

}

? ? ? ? ??

失敗：

{

"request_id": "", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

出參說明：

ID

類型

長度

描述

TaskNo

String

32

任務編號

InvoiceQuantity?? ? ? ?

String

10

發(fā)票數(shù)量

PeriodYear

String

4

當前稅款所屬期年份YYYY

PeriodMonth

String

4

當前稅款所屬期月份MM

OperationDateBegin

String

10

當前可操作時間起：格式：YYYY-MM-DD

OperationDateEnd

String

10

當前可操作時間止：格式：YYYY-MM-DD

DateFrameBegin

String

10

當前可操作時間范圍起：格式：YYYY-MM-DD

DateFrameEnd

String

10

當前可操作時間范圍止：格式：YYYY-MM-DD

FollowTask

Boolean

~

是否有后續(xù)任務：true/false；無后續(xù)任務則不需要再次獲取

Success

Boolean

5

調(diào)用API是否成功：true/false

Code

String

4

返回碼

Message

String

200

返回碼對應信息

InvoiceList

list

~

發(fā)票列表

└ No

String

10

發(fā)票序號

└ InvoiceCode

String

10-12

發(fā)票代碼：返回多個發(fā)票信息及任務號

└ InvoiceNumber

String

8

發(fā)票號碼

└ InvoiceType

String

2

發(fā)票種類：01-增值稅專用發(fā)票02-貨運運輸業(yè)增值稅專用發(fā)票03-機動車銷售統(tǒng)一發(fā)票

└ BillingDate?? ? ? ?

String

10

開票日期：YYYY-MM-DD

└ State

String

1

發(fā)票狀態(tài)：0-正常1-失控2-作廢3-紅沖4-異常

└ PurchaserTaxNo

String

20

購方稅號

└ TotalAmount

String

17

合計金額

└ TotalTax

String

17

合計稅額

└ SalesTaxNo

String

20

銷方稅號

└ SalesTaxName

String

150

銷方名稱

└ Deductible

String

0

是否認證：0-未認證1-已認證

└ DeductibleDate

String

10

認證日期：如果已認證則為YYYY-MM-DD，未認證則為空

└ DeductiblePeriod

String

10

稅款所屬期：如果已認證則為YYYYMM，未認證則為空

└ IsAgencyRebate

String

10

是否代辦退稅：0:是，1:否

└ CertificationType

String

10

認證類型：1為抵扣，2為出口退稅，3為代理出口退稅

└CertificationWay

String

2

認證方式：0為勾選認證，1為掃描認證

? ? ? ? ??

? ? ? ? ???? ?

（三）取數(shù)任務接收成功反饋??

說明：

????當前任務號獲取成功

請求地址

? ? ? ? ? ? ? ? ?/syncResult?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ??

入?yún)⒄f明：

參數(shù)

類型

長度

必填

描述

TaxNo

String

20

是

購方稅號

TaskNo

String

32

是

任務號

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

???????“TaxNo”:””,??????????????????????//通知取數(shù)成功稅號

???????“TaskNo”:””,????????????//任務號

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{?? ?

????????Success:"",??????????????//調(diào)用API是否成功：true/false

??????????????Code:"",?????????????????????//返回碼(見附表一)

??????????????Message:""??????????????//返回碼對應信息(見附表一)

????},?

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{

????????"success_message":?"調(diào)用[取數(shù)成功反饋]接口成功！"

????},?

"success": true

}

? ? ? ? ??

失?。?/span>

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

出參說明：

參數(shù)

類型

長度

描述

Success

Boolean

5

是否成功（True/false）

Code

String

4

返回碼

Message

String

200

返回信息

? ? ? ? ???? ?

（四）認證抵扣申請??

說明：

確認當前稅款所屬期抵扣，申請?zhí)峤缓?，接口會根?jù)web端設置的一步認證標識進行判斷，如為開啟狀態(tài)，則直接提交稅局認證。如為關閉狀態(tài)，則本接口中的發(fā)票進入待認證列表，需要去web端進行確認后完成認證。

請求地址

? ? ? ? ? ? ? ? ?/deductible?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ??

入?yún)⒄f明：

參數(shù)

類型

長度

必填

描述

taxNo

String

20

是

稅號

Period

String

6

是

稅款所屬期（YYYYMM）

invoiceList

List


是


└ InvoiceCode

String

10-12

是

發(fā)票代碼

└ InvoiceNumber

String

8

是

發(fā)票號碼

└ BuyTaxNo

String

20

是

購方稅號

└?CertificationType

String

2

是

認證類型：1為抵扣，2為出口退稅，3為代理出口退稅

? ? ? ? ???? ?

JSON入?yún)⒄f明：（JSON串）

{

???????“TaxNo”:””,?????????????????????//稅號

“Period”:””,?????????????????????//稅控所屬期???????（YYYYMM）

“InvoiceList”:[

{

InvoiceCode:"",???????//發(fā)票代碼

InvoiceNumber:"",???????//發(fā)票號碼

PurchaserTaxNo:"",???????//購方稅號

CertificationType:"" //認證類型 1為抵扣，2為出口退稅，3為代理出口退稅

}

]

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????TaskList:[?????????????

?????????????????????{

?????????????????????InvoiceCode:"",???????//發(fā)票代碼

?????????????????????InvoiceNumber:"",???????//發(fā)票號碼

?????????????????????TaskNo:""?????????????????????//任務號

?????????????????????},

??????????????]

??????????????Success:””,??????????????//調(diào)用API是否成功：true/false

??????????????Code:"",?????????????????????//返回碼(見附表一)?? ?

??????????????Message:””??????????????//返回碼對應信息(見附表一)

????},?

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{

????????"success_message":?"調(diào)用[申請抵扣]接口成功！"

????},?

???????"success": true

}

? ? ? ? ??

失?。?/span>

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

出參說明：

參數(shù)

類型

長度

描述

Success

Boolean

5

調(diào)用API是否成功（ture/false）

Code

String

4


Message

String

200


TaskList

List



└?InvoiceCode

String

10-12

發(fā)票代碼

└?InvoiceNumber

String

8

發(fā)票號碼

└?TaskNo?? ? ? ?

String

32

任務編號

? ? ? ? ??

? ? ? ? ??

（五）認證抵扣結果同步??

說明：

????獲取抵扣結果

請求地址

? ? ? ? ? ? ? ? ?/result?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ??

入?yún)⒄f明

參數(shù)

類型

長度

必填

描述

taxNo

String

20

是

購方稅號

InvoiceCode

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號碼

taskNo

String

32

是

任務編號

? ? ? ? ??

JSON入?yún)⒄f明：（JSON串）

{

“TaxNo”:””,?????????????????????//稅號

“InvoiceCode”:"",???????//發(fā)票代碼?? ?

“InvoiceNumber”:"",???????//發(fā)票號碼

“TaskNo”:””??????????????//任務號

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

??????????????TaxNo:””,?????????????????????//稅號

??????????????Success: ””,??????????????//調(diào)用API是否成功：true/false

??????????????Code: ””,?????????????????????//返回碼(見附表一)

??????????????Message: ””,??????????????//返回碼對應信息(見附表一)

??????????????InvoiceCode:"",???????//發(fā)票代碼

??????????????InvoiceNumber:"",???????//發(fā)票號碼

??????????????TaskNo: ””,??????????????//任務號

??????????????ResultCode: ””,???????//處理結果 1-成功 2-無此票 3-該票異常無法認證 4-該票已經(jīng)認證 5-該票已經(jīng)逾期無法認證 6-該票已經(jīng)申請認證 7-申請認證月份已過期 8-其它異常 11-該票已作廢 12 –該發(fā)票已紅沖 13-未到申報期 14-該發(fā)票稅號不匹配 15-紅字發(fā)票不可認證?16-認證類型錯誤0-任務執(zhí)行中

??????????????DeductibleDate: ””,???????//認證日期 如果已認證則為YYYY-MM-DD，未認證則為空

??????????????DeductiblePeriod: ””,//稅款所屬期 如果已認證則為YYYYMM，未認證則為空

??????????????CertificationType:"" //認證類型?1為抵扣，2為出口退稅，3為代理出口退稅?? ?

???????},

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{

????????"success_message":?"調(diào)用[獲取抵扣結果]接口成功！"

????},?

???????"success": true

}

? ? ? ? ??

失?。?/span>

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

出參說明

參數(shù)

類型

長度

描述

TaxNo

String

20

購方稅號

Success

Boolean

5

調(diào)用API是否成功（ture/false）

Code

String

4

返回碼

Message

String

200

返回信息

InvoiceCode

String

10-12

發(fā)票代碼

InvoiceNumber

String

8

發(fā)票號碼

TaskNo

String

32

任務編號

ResultCode?? ? ? ?

String

2

處理結果：1-成功2-無此票3-該票異常無法認證4-該票已經(jīng)認證5-該票已經(jīng)逾期無法認證6-該票已經(jīng)申請認證7-申請認證月份已過期8-其它異常9-發(fā)票未到期(需切換稅期)11-該票已作廢12–該發(fā)票已紅沖13-未到申報期14-該發(fā)票稅號不匹配15-紅字發(fā)票不可認證16-認證類型錯誤0-任務執(zhí)行中

DeductibleDate

String

32

認證日期：如果已認證則為YYYYMM，未認證則為空

DeductiblePeriod

String

32

稅款所屬期：如果已認證則為YYYYMM，未認證則為空

CertificationType

String

2

認證類型：1為抵扣，2為出口退稅，3為代理出口退稅

? ? ? ? ??

? ? ? ? ??

（六）發(fā)票查驗??

請求地址

? ? ? ? ? ? ? ? ?/collect?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON屬性見入?yún)?/span>

出參

JSON屬性見出參

? ? ? ? ??

入?yún)⒄f明

參數(shù)

類型

長度

必填

描述

taxNo

String

20

是

購方稅號

InvoiceCode?? ? ? ?

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號碼

BillingDate

String

10

是

開票日期

CheckCode_6

String

6

是

校驗碼后6位（普票、電子普票、卷式普票必填）

TotalAmount

String

20

是

合計不含稅金額，必須精確到兩位小數(shù)（專票、貨運專票、機動車專票必填）

? ? ? ? ??

JSON入?yún)⒄f明：

{

“TaxNo”:””,?????????????????????//稅號

“InvoiceCode”:””,???????????//發(fā)票代碼

“InvoiceNumber”:””,???????//發(fā)票號碼

“BillingDate”:””,??????????????//開票日期：YYYY-MM-DD

“CheckCode_6”:””,???????????//校驗碼后6位（普票、電子普票、卷式普票必填）

“TotalAmount”:””???????????//合計金額，必須精確到兩位小數(shù)（專票、貨運專票、機動車專票必填）

}

? ? ? ? ??

? ? ? ? ??

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?

???????//1、增值稅專用發(fā)票?? ?

???????{

??????????????InvoiceType:"01",??????????????//增值稅專用發(fā)票?????????????

??????????????Data:???????????????????????????

??????????????{???????????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼??????

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼??????

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD??????

?????????????????????PurchaserName:"",??????????????//購方名稱??????

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號??????

?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶??????

?????????????????????PurchaserAddressPhone:"",//購方地址電話??????

?????????????????????SalesName:"",?????????????????????//銷方名稱??????

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號??????

?????????????????????SalesAddressPhone:"",???????//銷方地址電話??????

?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶??????

?????????????????????TotalAmount:"",??????????????//合計金額??????

?????????????????????TotalTax:"",?????????????????????//合計稅額??????

?????????????????????AmountTax:"",?????????????????????//價稅合計??????

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文??????

?????????????????????Remarks:"",?????????????????????//備注??????

?????????????????????MachineCode:"",??????????????//機器編碼??????

?????????????????????CheckCode:"",?????????????????????//校驗碼???????? ?

?????????????????????State:"",????????????????????????????//發(fā)票狀態(tài)（1：正常；2：作廢；)??????

?????????????????????InvoiceList:[?????????????????????//發(fā)票詳細信息列表??????

????????????????????????????{?????????????

????????????????????????????RowNo:"",????????????????????????????//行號（從1開始）

????????????????????????????CommodityCode:"",??????????????//商品編碼

????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱

????????????????????????????SpecificationModel:"",??????????????//規(guī)格型號

????????????????????????????Unit:"",???????????????????????????????????//單位

????????????????????????????Quantity:"",????????????????????????????//數(shù)量

????????????????????????????UnitPrice:"",????????????????????????????//單價

????????????????????????????Amount:"",????????????????????????????//金額

????????????????????????????TaxRate:"",????????????????????????????//稅率

????????????????????????????Tax:""???????????????????????????????????//稅額

????????????????????????????},?????????????

?????????????????????]????????????????????

??????????????},???????????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false?????????????

??????????????Code:"",??????????????//返回碼(見附表一)?????????????

??????????????Message:""??????????????//返回碼對應信息(見附表一)?????????????

???????}??????

? ? ? ? ??

???????//2、貨運運輸業(yè)增值稅專用發(fā)票??????

???????{??????????????????????????????????

??????????????InvoiceType:"02",??????????????//貨運運輸業(yè)增值稅專用發(fā)票?????????????

??????????????Data:???????????????????????????

??????????????{???????????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼?? ?

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼??????

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼??????

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD??????

?????????????????????CarrierName:"",???????????????//承運人名稱??????

?????????????????????CarrierTaxNo:"",???????????????//承運人識別號??????

?????????????????????DraweeName:"",??????????????//受票方名稱??????

?????????????????????DraweeTaxNo:"",???????????????//受票方識別號??????

?????????????????????PurchaserName:"",??????????????//收貨人名稱??????

?????????????????????PurchaserTaxNo:"",??????????????//收貨人識別號???????

?????????????????????SalesName:"",?????????????????????//發(fā)貨人名稱??????

?????????????????????SalesTaxNo:"",?????????????????????//發(fā)貨人識別號??????

?????????????????????TotalAmount:"",??????????????//合計金額??????

?????????????????????CargoInformation:"",???????//運輸貨物信息??????

?????????????????????TransportRoute:"",??????????????//起運地、經(jīng)由、到達地??????

?????????????????????TaxRate:"",?????????????????????//稅率??????

?????????????????????TotalTax:"",?????????????????????//合計稅額??????

?????????????????????MachineCode:"",??????????????//稅控盤號??????

?????????????????????AmountTax:"",?????????????????????//價稅合計??????

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文

?????????????????????AutomobileType:"",???????//車種車號??????

?????????????????????Tonnage:"",?????????????????????//車船噸位???????? ?

?????????????????????TaxAuthorityNo:"",??????????????//主管稅務機關??????

?????????????????????TaxAuthorityName:"",???????//主管稅務名稱??????

?????????????????????Remarks:"",?????????????????????//備注??????

?????????????????????State:"",????????????????????????????//發(fā)票狀態(tài)（1：正常；2：作廢；)??????

?????????????????????InvoiceList:[????????????????????

????????????????????????????{?????????????

????????????????????????????RowNo:"",?????????????????????//行號（從1開始）\

????????????????????????????CommodityCode:"",??????????????//商品編碼

????????????????????????????CommodityName:"",???????//費用項目

????????????????????????????Amount:""?????????????????????//金額

????????????????????????????},?????????????

?????????????????????]????????????????????

??????????????},???????????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false?????????????

??????????????Code:"",?????????????????????//返回碼(見附表一)?????????????

??????????????Message:""??????????????//返回碼對應信息(見附表一)?????????????

???????}??????????????????????????????????

? ? ? ? ??

???????//3、機動車銷售統(tǒng)一發(fā)票

???????{???????????????????????????

??????????????InvoiceType:"03",??????????????//機動車銷售統(tǒng)一發(fā)票??????

??????????????Data:????????????????????

??????????????{????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼?? ?

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD

?????????????????????MachineCode:"",??????????????//機器編碼

?????????????????????PurchaserName:"",??????????????//購方名稱

?????????????????????IDCardNo:"",?????????????????????//身份證號碼/組織機構代碼

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號

?????????????????????VehicleType:"",??????????????//車輛類型

?????????????????????BrandModel:"",??????????????//廠牌型號

?????????????????????OriginPlace:"",?????????????????????//產(chǎn)地

?????????????????????CertificateNo:"",??????????????//合格證號

?????????????????????Amount:"",?????????????????????//不含稅價

?????????????????????InspectionListNo:"",???????//商檢單號

?????????????????????EngineNo:"",?????????????????????//發(fā)動機號

?????????????????????VehicleNo:"",?????????????????????//車輛識別代號/車架號碼

?????????????????????ImportCertificateNo:"",???????//進口證明書號

?????????????????????SalesName:"",?????????????????????//銷方名稱

?????????????????????SalesPhone:"",?????????????????????//銷方地址電話

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號

?????????????????????SalesBankNo:"",??????????????//賬號

?????????????????????SalesAddress:"",??????????????//銷方地址

?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶

?????????????????????TaxRate:"",?????????????????????//稅率

?????????????????????Tax:""????????????????????????????//稅額?? ?

?????????????????????TaxAuthorityNo:"",??????????????//主管稅務機關

?????????????????????AmountTax:"",?????????????????????//價稅合計

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文

?????????????????????PaymentVoucherNo:"",???????//完稅憑證號碼

?????????????????????Tonnage:"",?????????????????????//噸位

?????????????????????PassengersLimited:"",???????//限乘人數(shù)

?????????????????????State:"",????????????????????????????//發(fā)票狀態(tài)（1：正常；2：作廢；)

?????????????????????TaxAuthorityName:"",???????//主管稅務名稱

??????????????},????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false??????

??????????????Code:"",?????????????????????//返回碼(見附表一)??????

??????????????Message:""??????????????//返回碼對應信息(見附表一)??????

???????}???????????????????????????

? ? ? ? ??

???????//4、增值稅普通發(fā)票

???????{??????????????????????????????????

??????????????InvoiceType:"04",??????????????//增值稅普通發(fā)票?????????????

??????????????Data:???????????????????????????

??????????????{???????????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼??????

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼??????

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD??????

?????????????????????SalesName:"",?????????????????????//銷方名稱???????? ?

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號??????

?????????????????????SalesAddressPhone:"",???????//銷方地址電話??????

?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶??????

?????????????????????PurchaserName:"",??????????????//購方名稱??????

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號??????

?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶??????

?????????????????????PurchaserAddressPhone:"",//購方地址電話??????

?????????????????????CheckCode:"",?????????????????????//校驗碼??????

?????????????????????TotalTax:"",?????????????????????//合計稅額??????

?????????????????????AmountTax:"",?????????????????????//價稅合計??????

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文

?????????????????????Remarks:"",?????????????????????//備注??????

?????????????????????MachineCode:"",??????????????//機器編碼??????

?????????????????????TotalAmount:"",??????????????//合計金額??????

?????????????????????State:"",????????????????????????????//作廢標志（1：正常；2：作廢；)??????

?????????????????????InvoiceList:[?????????????????????//發(fā)票詳細信息列表??????

????????????????????????????{?????????????

????????????????????????????RowNo:"",????????????????????????????//行號（從1開始）

????????????????????????????CommodityCode:"",??????????????//商品編碼

????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱

????????????????????????????SpecificationModel:"",??????????????//規(guī)格型號

????????????????????????????Unit:"",???????????????????????????????????//單位

????????????????????????????Quantity:"",????????????????????????????//數(shù)量?? ?

????????????????????????????UnitPrice:"",????????????????????????????//單價

????????????????????????????Amount:"",????????????????????????????//金額

????????????????????????????TaxRate:"",????????????????????????????//稅率

????????????????????????????Tax:""???????????????????????????????????//稅額

????????????????????????????},?????????????

?????????????????????]????????????????????

??????????????},???????????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false?????????????

??????????????Code:"",?????????????????????//返回碼(見附表一)?????????????

??????????????Message:""??????????????//返回碼對應信息(見附表一)

???????}?????????????????????????????????????????

? ? ? ? ??

???????//5、增值稅電子普通發(fā)票

???????{??????????????????????????????????

??????????????InvoiceType:"10",??????????????//增值稅電子普通發(fā)票?????????????

??????????????Data:???????????????????????????

??????????????{???????????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼??????

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼??????

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD??????

?????????????????????SalesName:"",?????????????????????//銷方名稱??????

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號??????

?????????????????????SalesAddressPhone:"",???????//銷方地址電話??????

?????????????????????SalesBank:"",?????????????????????//銷方開戶行賬戶???????? ?

?????????????????????PurchaserName:"",??????????????//購方名稱??????

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號??????

?????????????????????PurchaserBank:"",??????????????//購方開戶行賬戶??????

?????????????????????PurchaserAddressPhone:"",//購方地址電話??????

?????????????????????CheckCode:"",?????????????????????//校驗碼??????

?????????????????????TotalTax:"",?????????????????????//合計稅額??????

?????????????????????AmountTax:"",?????????????????????//價稅合計??????

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文

?????????????????????Remarks:"",?????????????????????//備注??????

?????????????????????MachineCode:"",??????????????//機器編碼??????

?????????????????????TotalAmount:"",??????????????//合計金額??????

?????????????????????State:"",????????????????????????????//發(fā)票狀態(tài)（1：正常；2：作廢；)??????

?????????????????????InvoiceList:[?????????????????????//發(fā)票詳細信息列表??????

????????????????????????????{?????????????

????????????????????????????RowNo:"",????????????????????????????//行號（從1開始）

????????????????????????????CommodityCode:"",??????????????//商品編碼

????????????????????????????CommodityName:"",??????????????//貨物或應稅勞務名稱

????????????????????????????SpecificationModel:"",??????????????//規(guī)格型號

????????????????????????????Unit:"",???????????????????????????????????//單位

????????????????????????????Quantity:"",????????????????????????????//數(shù)量

????????????????????????????UnitPrice:"",????????????????????????????//單價

????????????????????????????Amount:"",????????????????????????????//金額

????????????????????????????TaxRate:"",????????????????????????????//稅率?? ?

????????????????????????????Tax:""???????????????????????????????????//稅額

????????????????????????????},?????????????

?????????????????????]????????????????????

??????????????},???????????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false?????????????

??????????????Code:"",?????????????????????//返回碼(見附表一)?????????????

??????????????Message:""??????????????//返回碼對應信息(見附表一)?????????????

???????}??????????????????????????????????

? ? ? ? ??

???????//6、增值稅普通發(fā)票（卷式）

???????{??????????????????????????????????

??????????????InvoiceType:"11",??????????????//增值稅普通發(fā)票（卷式）?????????????

??????????????Data:???????????????????????????

??????????????{???????????????????????????

?????????????????????AdministrativeDivisionNo:””,//所屬行政區(qū)編碼

?????????????????????AdministrativeDivisionName:””,//所屬行政區(qū)名稱

?????????????????????InvoiceCode:"",??????????????//發(fā)票代碼??????

?????????????????????InvoiceNumber:"",??????????????//發(fā)票號碼??????

?????????????????????BillingDate:"",???????????????//開票日期：YYYY-MM-DD??????

?????????????????????SalesName:"",?????????????????????//銷方名稱??????

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號??????

?????????????????????PurchaserName:"",??????????????//購方名稱??????

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號??????

?????????????????????CheckCode:"",?????????????????????//校驗碼??????

?????????????????????TotalTax:"",?????????????????????//合計稅額??????

?????????????????????AmountTax:"",?????????????????????//價稅合計???????? ?

?????????????????????AmountTaxCN:"",??????????????//價稅合計_中文

?????????????????????Remarks:"",?????????????????????//備注??????

?????????????????????MachineCode:"",??????????????//機器編碼??????

?????????????????????TotalAmount:"",??????????????//合計金額??????

?????????????????????TotalAmountCN:"",??????????????//合計金額_中文

?????????????????????ReceivingClerk:"",??????????????//收貨員??????

?????????????????????State:"",????????????????????????????//發(fā)票狀態(tài)（1：正常；2：作廢；)??????

?????????????????????InvoiceList:[?????????????????????//發(fā)票詳細信息列表??????

????????????????????????????{?????????????

????????????????????????????RowNo:"",??????????????//行號（從1開始）

????????????????????????????CommodityCode:"",??????????????//商品編碼

????????????????????????????CommodityName:"",//項目

????????????????????????????Quantity:"",??????????????//數(shù)量

????????????????????????????UnitPrice:"",??????????????//含稅單價

????????????????????????????Amount:""??????????????//含稅金額

????????????????????????????},?????????????

?????????????????????]????????????????????

??????????????},???????????????????????????

??????????????Success:"",??????????????//調(diào)用API是否成功：true/false?????????????

??????????????Code:"",?????????????????????//返回碼(見附表一)?????????????

??????????????Message:""??????????????//返回碼對應信息(見附表一)?????????????

???????}??????

? ? ? ? ??

????},?

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{

????????"success_message":?"調(diào)用[全票面]接口成功！"?? ?

????},?

"success": true

}

失?。?/span>

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

? ? ? ? ??

? ? ? ? ??

//7、增值稅電子普通發(fā)票（通行費）

{

InvoiceType:"14",//增值稅電子普通發(fā)票（通行費）

Data:

{

AdministrativeDivisionNo:"",//所屬行政區(qū)編碼

AdministrativeDivisionName:"",//所屬行政區(qū)名稱

InvoiceCode:"",//發(fā)票代碼

InvoiceNumber:"",//發(fā)票號碼

BillingDate:"", //開票日期：YYYY-MM-DD

SalesName:"", //銷方名稱

SalesTaxNo:"", //銷方稅號

SalesAddressPhone:"", //銷方地址電話

SalesBank:"", //銷方開戶行賬戶?? ?

PurchaserName:"",//購方名稱

PurchaserTaxNo:"",//購方稅號

PurchaserBank:"",//購方開戶行賬戶

PurchaserAddressPhone:"",//購方地址電話

CheckCode:"", //校驗碼

TotalTax:"", //合計稅額

AmountTax:"", //價稅合計

AmountTaxCN:"",//價稅合計_中文

Remarks:"", //備注

MachineCode:"",//機器編碼

TotalAmount:"",//合計金額

State:"", //發(fā)票狀態(tài)（1：正常；2：作廢；)

TollSign: "06"http://通行費標志(06-可抵扣通行費，07-不可抵扣通行費)

InvoiceList:[ //發(fā)票詳細信息列表

{

RowNo:"",//行號（從1開始）

CommodityCode:"",//商品編碼

CommodityName:"",//貨物或應稅勞務名稱

Amount: 7.61, //金額

TaxRate:"",//稅率

Tax:""http://稅額

CurrentDateEnd: "20171211", //通行日起止

CurrentDateStart: "20171211", //通行日期起?? ?

LicensePlateNum: "粵ATST10", //車牌號

Type: "貨車"http://類型

},

]

},

Success:"",//調(diào)用API是否成功：true/false

Code:"", //返回碼(見附表一)

Message:""http://返回碼對應信息(見附表一)

}

出參說明：

參數(shù)

類型

長度

描述

InvoiceType

String

3

發(fā)票類型

AdministrativeDivisionNo

String

32

所屬行政區(qū)編碼

AdministrativeDivisionName

String

150

所屬行政區(qū)名稱

InvoiceCode

String

10-12

發(fā)票代碼

InvoiceNumber

String

8

發(fā)票號碼

BillingDate

String

14

開票日期：YYYY-MM-DD

PurchaserName

String?? ? ? ?

100

購方名稱

PurchaserTaxNo

String

20

購方稅號

PurchaserBank

String

150

購方開戶行賬戶

PurchaserAddressPhone

String

150

購方地址電話

SalesName

String

100

銷方名稱

SalesTaxNo

String

20

銷方稅號

SalesAddressPhone

String

150

銷方地址電話

SalesBank

String

150

銷方開戶行賬戶

TotalAmount

String

17

合計金額

TotalTax

String

17

合計稅額

AmountTax

String

17

價稅合計

AmountTaxCN

String?? ? ? ?

64

價稅合計_中文

MachineCode

String

32

機器編碼

CheckCode

String

64

校驗碼

State

String

2

發(fā)票狀態(tài)：是否作廢（1：正常；2：作廢；）

InvoiceList

String

-

發(fā)票詳細信息列表

RowNo

String

10

行號：從1開始

CommodityCode

String

40

商品編碼

CommodityName

String

150

貨物或應稅勞務名稱

SpecificationModel

String

32

規(guī)格型號

Unit

String

32

單位

Quantity

String

10

數(shù)量

UnitPrice

String?? ? ? ?

17

單價

Amount

String

17

金額

TaxRate

String

10

稅率

Tax

String

17

稅額

CarrierName

String

150

承運人名稱

CarrierTaxNo

String

32

承運人識別號

DraweeName

String

100

受票方名稱

DraweeTaxNo

String

20

受票方識別號

CargoInformation

String

150

運輸貨物信息

TransportRoute

String

100

起運地、經(jīng)由、到達地

MachineCode

String

32

稅控盤號

AutomobileType

String?? ? ? ?

64

車種車號

Tonnage

String

10

車船噸位

TaxAuthorityNo

String

32

主管稅務機關

TaxAuthorityName

String

100

主管稅務名稱

Remarks

String

184

備注

IDCardNo

String

32

身份證號碼/組織機構代碼

PurchaserTaxNo

String

20

購方稅號

VehicleType

String

32

車輛類型

BrandModel

String

32

廠牌型號

OriginPlace

String

100

產(chǎn)地

CertificateNo

String

32

合格證號

InspectionListNo

String?? ? ? ?

64

商檢單號

EngineNo

String

32

發(fā)動機號

VehicleNo

String

32

車輛識別代號/車架號碼

ImportCertificateNo

String

64

進口證明書號

SalesPhone

String

150

銷方地址電話

SalesTaxNo

String

20

銷方稅號

SalesBankNo

String

64

賬號

SalesAddress

String

150

銷方地址

PaymentVoucherNo

String

32

完稅憑證號碼

PassengersLimited

String

10

限乘人數(shù)

TollSign

String

2

通行費標志(06-可抵扣通行費，07-不可抵扣通行費)

ZeroTaxRateSign?? ? ? ?

String

2

零稅率標志(空:非零稅率， 1:稅率欄位顯示“免稅”， 2:稅率欄位顯示“不征收”， 3:零稅率)

CurrentDateEnd

String

20

通行日起止

CurrentDateStart

String

20

通行日期起

LicensePlateNum

String

20

車牌號

Type

String

10

類型

? ? ? ? ??

? ? ? ? ??

（七）發(fā)票信息查詢??

說明：

通過接口查詢發(fā)票的相關內(nèi)容。

請求地址

? ? ? ? ? ? ? ? ?/findInvoice?AccessKeyID=userid&TimeStamp=2016-02-23T12:46:24Z&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS POST

ContentType

application/json; charset=utf-8

入?yún)?/span>

JSON

出參

JSON

? ? ? ? ???? ?

入?yún)⒄f明：

參數(shù)

類型

長度

必填

描述

TaxNo

String

20

是

購方稅號

InvoiceCode

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號碼

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：（JSON串）

{

???????“TaxNo”:””,?????????????????????????//稅號

????“InvoiceCode”:"",?????????????????//發(fā)票代碼

???????“InvoiceNumber”:""??????????????//發(fā)票號碼

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????TaskNo:””,?????????????????????//任務編號

Success:””,?????????????????????//調(diào)用API是否成功：true/false

Code:“”,????????????????????????????//返回碼(見附表一)

Message:””,?????????????????????//返回碼對應信息(見附表一)

???????????InvoiceCode:"",???????//發(fā)票代碼

????????InvoiceNumber:"",???????//發(fā)票號碼

???InvoiceType:””,??????????????//發(fā)票種類01-增值稅專用發(fā)票?02-貨運運輸業(yè)增值稅專用發(fā)票 03-機動車銷售統(tǒng)一發(fā)票 14-通行費增值稅電子普通發(fā)票?? ?

?????????BillingDate:"?",????????//開票日期：YYYY-MM-DD

?????????State:"1",?????????????????????//發(fā)票狀態(tài)（0-正常1-失控?2-作廢 3-紅沖 4-異常）

?????????PurchaserTaxNo:"",???????//購方稅號

?????????TotalAmount:””,???????//合計金額

?????????TotalTax:””,??????????????//合計稅額

?????????SalesTaxNo:"",??????????????//銷方稅號

?????????SalesTaxName:"",???????//銷方名稱

?????????Deductible:””,??????????????//是否認證?0-未認證 1-已認證

?????????DeductibleDate:””,???????//認證日期?如果已認證則為YYYY-MM-DD，未認證則為空

?????????DeductiblePeriod:””,//稅款所屬期?如果已認證則為YYYYMM，未認證則為空

},

},

????"request_id":?"",

????"message":?{

????????"success_message":?"調(diào)用[發(fā)票信息查詢]接口成功！"

????},?

"success": true

}

? ? ? ? ??

失?。?/span>

{

"request_id": "", --請求ID,用于定位問題

"message": {

????????"error_code":?"",??????--失敗的CODE?? ?

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

? ? ? ? ??

出參說明：

參數(shù)

類型

長度

描述

TaskNo

String

32

任務編號

Success

Boolean

5

是否成功：True/false

Code

String

4

返回碼

Message

String

200

返回信息

InvoiceCode

String

10-12

發(fā)票代碼：返回多個發(fā)票信息及任務號

InvoiceNumber

String

8

發(fā)票號碼

InvoiceType

String

2

發(fā)票種類：01-增值稅專用發(fā)票02-貨運運輸業(yè)增值稅專用發(fā)票03-機動車銷售統(tǒng)一發(fā)票

BillingDate

String

10

開票日期：YYYY-MM-DD

State

String

1

發(fā)票狀態(tài)：0-正常1-失控2-作廢3-紅沖4-異常

PurchaserTaxNo

String

20

購方稅號

TotalAmount

String

17

合計金額

TotalTax

String

17

合計稅額

SalesTaxNo?? ? ? ?

String

20

銷方稅號

SalesTaxName

String

150

銷方名稱

Deductible

String

0

是否認證：0-未認證1-已認證

DeductibleDate

String

10

認證日期：如果已認證則為YYYY-MM-DD，未認證則為空

DeductiblePeriod

String

10

稅款所屬期：如果已認證則為YYYYMM，未認證則為空

IsAgencyRebate

String

10

是否代辦退稅：0:是，1:否

CertificationType

String

10

認證類型：1為抵扣，2為出口退稅，3為代理出口退稅

CertificationWay

String

2

認證方式：0為勾選認證，1為掃描認證

checkstatus

String

2

查驗結果 1未查驗 2查驗中 3查無此票 4已驗真

downloadUrl

String

200

發(fā)票圖像存儲地址

? ? ? ? ??

（八）獲取當前系統(tǒng)時間??

說明：

獲取當前系統(tǒng)時間，便于時間戳的校驗

請求地址

? ? ? ? ? ? ? ? ?/getTime?AccessKeyID=userid&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973

方法類型

HTTPS GET

ContentType

application/json; charset=utf-8

入?yún)?/span>?? ? ? ?

JSON

出參

JSON

? ? ? ? ??

特殊說明：此處Signature生成不包括TimeStamp的值。

? ? ? ? ??

JSON入?yún)⒄f明：（JSON串）

? ? ? ? ??

無

? ? ? ? ??

JSON出參：

? ? ? ? ??

成功：

{

"model": {

???????SystemTime:””,?????????????????????//當前系統(tǒng)時間"yyyy-MM-dd'T'HH:mm:ss'Z'"

?SystemTimeLong:””,??????????????//當前系統(tǒng)時間CurrentTimeMills

??????????????Success:””,?????????????????//調(diào)用API是否成功：true/false

??????????????Code:"",?????????????????????//返回碼(見附表一)

??????????????Message:””??????????????//返回碼對應信息(見附表一)

????},?

????"request_id":?"b560f311-4e29-48b9-9bc1-f378bca02516",

????"message":?{

????????"success_message":?"調(diào)用[獲取系統(tǒng)時間]成功！"

????},?

???????"success": true

}

? ? ? ? ??

失敗：

{

"request_id": "0bac9791-178f-4d93-871e-14757043a27e", --請求ID,用于定位問題?? ?

"message": {

????????"error_code":?"",??????--失敗的CODE

????????"error_message":?""???--失敗提示語

????},?

"success": false??--失敗標志

}

? ? ? ? ??

出參說明

參數(shù)

類型

長度

描述

SystemTime

String

32

當前系統(tǒng)時間"yyyy-MM-dd'T'HH:mm:ss'Z'"

SystemTimeLong

String

32

當前系統(tǒng)時間CurrentTimeMills

Success

Boolean

5

True/false

Code

String

4


Message

String

200


? ? ? ? ??

五、定制接口列表??

（一）單據(jù)關聯(lián)發(fā)票??

說明：

嵌入SAP流程，通過參數(shù)獲取發(fā)票列表

請求地址

? ? ? ? ? ? ? ? ?/select?AccessKeyID=userid&SignatureNonce=123456&Version=1.0&Signature=D29569843EB9DFA0F59E921F32D24973&參數(shù)列表

方法類型?? ? ? ?

HTTPS GET

出參

XML

? ? ? ? ??

特殊說明：此處Signature生成不包括TimeStamp的值。

? ? ? ? ??

入?yún)⒄f明：URL

PurchaserName:"",??????????????//購方名稱，不能為空

???????PurchaserTaxNo:"",??????????????//購方稅號，可以為空

InvoiceNumberRang:””???????//發(fā)票號碼，不能為空，只能是數(shù)字或-/，

//多個號碼段以 / 分隔，最多4個/，例如：

//12345601-09/12345620/12345631-12345640

//解析時先以/分隔，在按下面邏輯解析

//如果有”-”，則自動解析發(fā)票號碼范圍

//36230244-50，則-后面的號碼，自動填充到第一個號碼的長度

//解析為：36230244到36230250的范圍

//如果沒有-，則完全匹配發(fā)票號碼

BillingDateStart:””??????????????//格式：yyyy-MM-dd

BillingDateEnd:””??????????????//格式：yyyy-MM-dd

? ? ? ? ??

XML出參：

? ? ? ? ??

成功：

? ? ? ? ?

<request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id>

? ? ? ? ?true?? ?

? ? ? ? ?

<success_message>調(diào)用成功！success_message>

? ? ? ? ?

? ? ? ? ???????????????//調(diào)用API是否成功：true/false

?????????????????????//返回碼(見附表一)

<Success>true???????//返回碼對應信息(見附表一)

? ? ? ? ?

? ? ? ? ?????????????????????????????//發(fā)票信息，參考取數(shù)結果里的發(fā)票信息

? ? ? ? ?

.....

? ? ? ? ??

失?。?/span>? ? ? ? ?

? ? ? ? ?

<request_id>b560f311-4e29-48b9-9bc1-f378bca02516request_id>

? ? ? ? ?false? ? ? ? ?? ??

<error_code>error_code>

<error_message>error_message>

? ? ? ? ??

（二）單據(jù)反饋接口

（一）附表一：錯誤信息表??

返回碼（CODE）

返回碼對應信息Message

0

執(zhí)行成功

-1

未知錯誤

001

簽名結果錯誤

002

版本號不正確

003

時間差異超出范圍

004

SignatureNonce值已被使用過

005

請求參數(shù)不正確

006

IP不在授權范圍內(nèi)

101

身份驗證失敗

102

未開通該接口

103

授權已過期

104

不能操作該稅號

105?? ? ? ?

不能操作該發(fā)票

206

此稅號下沒有稅期信息

207

傳入的稅款所屬期與系統(tǒng)稅款所屬期不一致

231

獲取發(fā)票全票面，查驗成功，信息不完整

232

獲取發(fā)票全票面，查驗成功，信息有誤

233

獲取發(fā)票全票面，查驗成功，不屬于當前公司

234

重復插入憑證號

402

超過該張票當天查驗次數(shù)

404

超過服務器最大請求數(shù)

405

請求不合法

406

查驗成功發(fā)票不一致

409

所查發(fā)票不存在

415

查詢發(fā)票不規(guī)范

416

查驗異常

498

不支持查詢該地區(qū)的發(fā)票

499

不支持該發(fā)票種類

701

TaskNo不存在

702

TaskNo與InvoiceCode、InvoiceNumber不匹配

703

TaxNo不存在

704

請求json入?yún)榭?/span>

? ? ? ? ???? ?

（二）附表二：發(fā)票種類??

值

對應信息

01

增值稅專用發(fā)票

02

貨運運輸業(yè)增值稅專用發(fā)票

03

機動車增值稅專用發(fā)票

04

增值稅普通發(fā)票

10

增值稅電子普通發(fā)票

11

增值稅普通發(fā)票（卷式）

14

增值稅電子普通發(fā)票（通行費）

? ? ? ? ??

? ? ? ? ??

? ? ? ? ??

文檔修改記錄：

? ? ? ? ??

版本號

修改后版本號

修改時間

修改人

修改內(nèi)容

V1.0.0

V1.0.1

2018-01-19

周曉明

1、增加了查詢企業(yè)信息的接口

2、接口入?yún)⒃黾恿税姹咎?/span>

V1.0.1

V1.0.2

2018-02-26

周曉明

增加了增值稅電子普通發(fā)票（通行費）的支持

V1.0.2

V1.0.3

2018-03-19

周曉明

1、增加了發(fā)票查詢、獲取系統(tǒng)時間接口。

2、將版本號放在公共參數(shù)中。

V1.0.3?? ? ? ?

V1.0.4

2018-05-10

單長海

增加定制接口


該文章在 2025/4/30 16:18:40 編輯過
關鍵字查詢
相關文章
正在查詢...
點晴ERP是一款針對中小制造業(yè)的專業(yè)生產(chǎn)管理軟件系統(tǒng),系統(tǒng)成熟度和易用性得到了國內(nèi)大量中小企業(yè)的青睞。
點晴PMS碼頭管理系統(tǒng)主要針對港口碼頭集裝箱與散貨日常運作、調(diào)度、堆場、車隊、財務費用、相關報表等業(yè)務管理，結合碼頭的業(yè)務特點，圍繞調(diào)度、堆場作業(yè)而開發(fā)的。集技術的先進性、管理的有效性于一體，是物流碼頭及其他港口類企業(yè)的高效ERP管理信息系統(tǒng)。
點晴WMS倉儲管理系統(tǒng)提供了貨物產(chǎn)品管理,銷售管理,采購管理,倉儲管理,倉庫管理,保質期管理,貨位管理,庫位管理,生產(chǎn)管理,WMS管理系統(tǒng),標簽打印,條形碼,二維碼管理,批號管理軟件。
點晴免費OA是一款軟件和通用服務都免費，不限功能、不限時間、不限用戶的免費OA協(xié)同辦公管理系統(tǒng)。
Copyright 2010-2025 ClickSun All Rights Reserved

无码中文区| 玖玖成人天堂| 免费看欧美乱淫视频| 日韩欧美亚洲夜夜情| 亚洲欧美日韩性麻豆视频| 麻豆视频wwwaaa| 黑人的大鸡巴av| 久久夫妻视频| 新久草日B视频免费在线观看| 成人激情AVAV| 99免费热播视频| 一级黄片免费看欧美| 亚洲色一区91婷婷| kb一区二区三区网站| 国产精品 第8页| 精品啪啪啪一区二区| 夜夜躁狠狠躁日日躁飞机馆| 鄂托克旗| 日朝一区二区在线影院| 熟女玩弄小男生系列| 香蕉综合在线| 亚洲黄色精品影院| 免费日韩大尺度网站| 国产自产第1页| 中文字幕 无码在线播放| 欧美日韩18禁| 精品欧美日韩亚洲一区| 97超级在线视频| 伊人大香蕉国产一区| 射精高潮振动视频| 成人黄色免费午夜电影| 久久久精品店区2区日韩| 精品一区夜| 无码人妻久久91| 久久五草免费性爱视频| 加勒比在线1区2区3区| 美精品亚洲精品| 成人网站.comwww.| 亚洲韩国日本国产三级片| 欧美日韩伦理在线| 人人射人人插天天爽|