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

SAP、百望，進(jìn)項(xiàng)發(fā)票一體化對(duì)接
admin
2024年11月3日 7:19 本文熱度 1611

?SAP、SRM-百望接口

  • 思路

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

SAP中發(fā)票預(yù)制憑證導(dǎo)入功能，同時(shí)保存進(jìn)百望系統(tǒng)。

  • SAM、SRM相關(guān)界面

SRM相關(guān)頁面

?

百望反饋：

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

?

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

a)如何獲取校驗(yàn)身份的token

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

?

2.百望提供頁面：

a)百望提供頁面url

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

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

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

?

?效果圖：

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


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

百望進(jìn)項(xiàng)標(biāo)準(zhǔn)版

對(duì)接服務(wù)接口文檔說明

一、進(jìn)項(xiàng)介紹??

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

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

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

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

三、URL生成??

調(diào)用URL地址：

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

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

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

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

4> URL字符說明：

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

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

?對(duì)于擴(kuò)展的 UTF-8 字符，編碼成 “%XY%ZA…” 的格式

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

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

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

???????

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

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

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

?對(duì)加密結(jié)果用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加密算法示范：?? ?

?輸出結(jié)果：D29569843EB9DFA0F59E921F32D24973

? ? ? ? ??

四、標(biāo)準(zhǔn)接口列表??

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

說明:?? ?

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

? ? ? ? ??

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

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

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)

????},?

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

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

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

????},?

"success": true

}

? ? ? ? ??

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

? ? ? ? ??

出參說明：

參數(shù)

類型

長度

描述

Success

Boolean

5

是否成功（True/false）

Code

String

4

返回碼

Message

String

200

返回信息

? ? ? ? ??

（二）取數(shù)??

說明：

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

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

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

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????TaskNo:””,?????????????????????//任務(wù)編號(hào)

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

??????????????PeriodYear:””,?????????????????????//當(dāng)前稅款所屬期年份

??????????????PeriodMonth:””,??????????????//當(dāng)前稅款所屬期月份

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

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

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

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

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

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

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

Message:””,?????????????????????//返回碼對(duì)應(yīng)信息(見附表一)

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

???????{

??????????????No:””,?????????????????????//序號(hào)

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

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

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

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

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

PurchaserTaxNo:"",???????//購方稅號(hào)

TotalAmount:””,???????//合計(jì)金額

TotalTax:””,??????????????//合計(jì)稅額

SalesTaxNo:"",??????????????//銷方稅號(hào)

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

Deductible:””,??????????????//是否認(rèn)證 0-未認(rèn)證 1-已認(rèn)證

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

DeductiblePeriod:””,//稅款所屬期 如果已認(rèn)證則為YYYYMM，未認(rèn)證則為空

"IsAgencyRebate": "0", // 是否代辦退稅（1為是，0為否）

"CertificationType":"1"http://認(rèn)證類型 1為抵扣，2為出口退稅，3為代理出口退稅

},

]

? ? ? ? ??

},

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

????"message":?{

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

????},?

"success": true

}

? ? ? ? ??

失敗：

{

"request_id": "", --請(qǐng)求ID,用于定位問題

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

出參說明：

ID

類型

長度

描述

TaskNo

String

32

任務(wù)編號(hào)

InvoiceQuantity?? ? ? ?

String

10

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

PeriodYear

String

4

當(dāng)前稅款所屬期年份YYYY

PeriodMonth

String

4

當(dāng)前稅款所屬期月份MM

OperationDateBegin

String

10

當(dāng)前可操作時(shí)間起：格式：YYYY-MM-DD

OperationDateEnd

String

10

當(dāng)前可操作時(shí)間止：格式：YYYY-MM-DD

DateFrameBegin

String

10

當(dāng)前可操作時(shí)間范圍起：格式：YYYY-MM-DD

DateFrameEnd

String

10

當(dāng)前可操作時(shí)間范圍止：格式：YYYY-MM-DD

FollowTask

Boolean

~

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

Success

Boolean

5

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

Code

String

4

返回碼

Message

String

200

返回碼對(duì)應(yīng)信息

InvoiceList

list

~

發(fā)票列表

└ No

String

10

發(fā)票序號(hào)

└ InvoiceCode

String

10-12

發(fā)票代碼：返回多個(gè)發(fā)票信息及任務(wù)號(hào)

└ InvoiceNumber

String

8

發(fā)票號(hào)碼

└ InvoiceType

String

2

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

└ BillingDate?? ? ? ?

String

10

開票日期：YYYY-MM-DD

└ State

String

1

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

└ PurchaserTaxNo

String

20

購方稅號(hào)

└ TotalAmount

String

17

合計(jì)金額

└ TotalTax

String

17

合計(jì)稅額

└ SalesTaxNo

String

20

銷方稅號(hào)

└ SalesTaxName

String

150

銷方名稱

└ Deductible

String

0

是否認(rèn)證：0-未認(rèn)證1-已認(rèn)證

└ DeductibleDate

String

10

認(rèn)證日期：如果已認(rèn)證則為YYYY-MM-DD，未認(rèn)證則為空

└ DeductiblePeriod

String

10

稅款所屬期：如果已認(rèn)證則為YYYYMM，未認(rèn)證則為空

└ IsAgencyRebate

String

10

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

└ CertificationType

String

10

認(rèn)證類型：1為抵扣，2為出口退稅，3為代理出口退稅

└CertificationWay

String

2

認(rèn)證方式：0為勾選認(rèn)證，1為掃描認(rèn)證

? ? ? ? ??

? ? ? ? ???? ?

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

說明：

????當(dāng)前任務(wù)號(hào)獲取成功

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

TaskNo

String

32

是

任務(wù)號(hào)

? ? ? ? ??

? ? ? ? ??

JSON入?yún)⒄f明：

{

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

???????“TaskNo”:””,????????????//任務(wù)號(hào)

}

? ? ? ? ??

JSON出參說明：

成功：

{

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)

????},?

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

????"message":?{

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

????},?

"success": true

}

? ? ? ? ??

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

出參說明：

參數(shù)

類型

長度

描述

Success

Boolean

5

是否成功（True/false）

Code

String

4

返回碼

Message

String

200

返回信息

? ? ? ? ???? ?

（四）認(rèn)證抵扣申請(qǐng)??

說明：

確認(rèn)當(dāng)前稅款所屬期抵扣，申請(qǐng)?zhí)峤缓螅涌跁?huì)根據(jù)web端設(shè)置的一步認(rèn)證標(biāo)識(shí)進(jìn)行判斷，如為開啟狀態(tài)，則直接提交稅局認(rèn)證。如為關(guān)閉狀態(tài)，則本接口中的發(fā)票進(jìn)入待認(rèn)證列表，需要去web端進(jìn)行確認(rèn)后完成認(rèn)證。

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

稅號(hào)

Period

String

6

是

稅款所屬期（YYYYMM）

invoiceList

List


是


└ InvoiceCode

String

10-12

是

發(fā)票代碼

└ InvoiceNumber

String

8

是

發(fā)票號(hào)碼

└ BuyTaxNo

String

20

是

購方稅號(hào)

└?CertificationType

String

2

是

認(rèn)證類型：1為抵扣，2為出口退稅，3為代理出口退稅

? ? ? ? ???? ?

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

{

???????“TaxNo”:””,?????????????????????//稅號(hào)

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

“InvoiceList”:[

{

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

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

PurchaserTaxNo:"",???????//購方稅號(hào)

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

}

]

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

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

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

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

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

?????????????????????TaskNo:""?????????????????????//任務(wù)號(hào)

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

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

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

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

??????????????Message:””??????????????//返回碼對(duì)應(yīng)信息(見附表一)

????},?

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

????"message":?{

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

????},?

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

}

? ? ? ? ??

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

出參說明：

參數(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ā)票號(hào)碼

└?TaskNo?? ? ? ?

String

32

任務(wù)編號(hào)

? ? ? ? ??

? ? ? ? ??

（五）認(rèn)證抵扣結(jié)果同步??

說明：

????獲取抵扣結(jié)果

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

InvoiceCode

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號(hào)碼

taskNo

String

32

是

任務(wù)編號(hào)

? ? ? ? ??

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

{

“TaxNo”:””,?????????????????????//稅號(hào)

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

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

“TaskNo”:””??????????????//任務(wù)號(hào)

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

??????????????TaxNo:””,?????????????????????//稅號(hào)

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

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

??????????????Message: ””,??????????????//返回碼對(duì)應(yīng)信息(見附表一)

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

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

??????????????TaskNo: ””,??????????????//任務(wù)號(hào)

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

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

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

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

???????},

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

????"message":?{

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

????},?

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

}

? ? ? ? ??

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

出參說明

參數(shù)

類型

長度

描述

TaxNo

String

20

購方稅號(hào)

Success

Boolean

5

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

Code

String

4

返回碼

Message

String

200

返回信息

InvoiceCode

String

10-12

發(fā)票代碼

InvoiceNumber

String

8

發(fā)票號(hào)碼

TaskNo

String

32

任務(wù)編號(hào)

ResultCode?? ? ? ?

String

2

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

DeductibleDate

String

32

認(rèn)證日期：如果已認(rèn)證則為YYYYMM，未認(rèn)證則為空

DeductiblePeriod

String

32

稅款所屬期：如果已認(rèn)證則為YYYYMM，未認(rèn)證則為空

CertificationType

String

2

認(rèn)證類型：1為抵扣，2為出口退稅，3為代理出口退稅

? ? ? ? ??

? ? ? ? ??

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

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

InvoiceCode?? ? ? ?

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號(hào)碼

BillingDate

String

10

是

開票日期

CheckCode_6

String

6

是

校驗(yàn)碼后6位（普票、電子普票、卷式普票必填）

TotalAmount

String

20

是

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

? ? ? ? ??

JSON入?yún)⒄f明：

{

“TaxNo”:””,?????????????????????//稅號(hào)

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

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

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

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

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

}

? ? ? ? ??

? ? ? ? ??

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?

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

???????{

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

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

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

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

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

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

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

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

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

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號(hào)??????

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

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

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

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號(hào)??????

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

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

?????????????????????TotalAmount:"",??????????????//合計(jì)金額??????

?????????????????????TotalTax:"",?????????????????????//合計(jì)稅額??????

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)??????

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文??????

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

?????????????????????MachineCode:"",??????????????//機(jī)器編碼??????

?????????????????????CheckCode:"",?????????????????????//校驗(yàn)碼???????? ?

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

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

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

????????????????????????????RowNo:"",????????????????????????????//行號(hào)（從1開始）

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

????????????????????????????CommodityName:"",??????????????//貨物或應(yīng)稅勞務(wù)名稱

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

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

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

????????????????????????????UnitPrice:"",????????????????????????????//單價(jià)

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

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

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

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

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

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)?????????????

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

? ? ? ? ??

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

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

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

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

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

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

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

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

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

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

?????????????????????CarrierName:"",???????????????//承運(yùn)人名稱??????

?????????????????????CarrierTaxNo:"",???????????????//承運(yùn)人識(shí)別號(hào)??????

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

?????????????????????DraweeTaxNo:"",???????????????//受票方識(shí)別號(hào)??????

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

?????????????????????PurchaserTaxNo:"",??????????????//收貨人識(shí)別號(hào)???????

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

?????????????????????SalesTaxNo:"",?????????????????????//發(fā)貨人識(shí)別號(hào)??????

?????????????????????TotalAmount:"",??????????????//合計(jì)金額??????

?????????????????????CargoInformation:"",???????//運(yùn)輸貨物信息??????

?????????????????????TransportRoute:"",??????????????//起運(yùn)地、經(jīng)由、到達(dá)地??????

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

?????????????????????TotalTax:"",?????????????????????//合計(jì)稅額??????

?????????????????????MachineCode:"",??????????????//稅控盤號(hào)??????

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)??????

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文

?????????????????????AutomobileType:"",???????//車種車號(hào)??????

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

?????????????????????TaxAuthorityNo:"",??????????????//主管稅務(wù)機(jī)關(guān)??????

?????????????????????TaxAuthorityName:"",???????//主管稅務(wù)名稱??????

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

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

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

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

????????????????????????????RowNo:"",?????????????????????//行號(hào)（從1開始）\

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

????????????????????????????CommodityName:"",???????//費(fèi)用項(xiàng)目

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

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

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

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)?????????????

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

? ? ? ? ??

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

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

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

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

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

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

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

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

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

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

?????????????????????MachineCode:"",??????????????//機(jī)器編碼

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

?????????????????????IDCardNo:"",?????????????????????//身份證號(hào)碼/組織機(jī)構(gòu)代碼

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號(hào)

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

?????????????????????BrandModel:"",??????????????//廠牌型號(hào)

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

?????????????????????CertificateNo:"",??????????????//合格證號(hào)

?????????????????????Amount:"",?????????????????????//不含稅價(jià)

?????????????????????InspectionListNo:"",???????//商檢單號(hào)

?????????????????????EngineNo:"",?????????????????????//發(fā)動(dòng)機(jī)號(hào)

?????????????????????VehicleNo:"",?????????????????????//車輛識(shí)別代號(hào)/車架號(hào)碼

?????????????????????ImportCertificateNo:"",???????//進(jìn)口證明書號(hào)

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

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

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號(hào)

?????????????????????SalesBankNo:"",??????????????//賬號(hào)

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

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

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

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

?????????????????????TaxAuthorityNo:"",??????????????//主管稅務(wù)機(jī)關(guān)

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文

?????????????????????PaymentVoucherNo:"",???????//完稅憑證號(hào)碼

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

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

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

?????????????????????TaxAuthorityName:"",???????//主管稅務(wù)名稱

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)??????

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

? ? ? ? ??

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

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

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

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

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

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

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

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

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

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

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

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號(hào)??????

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

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

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

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號(hào)??????

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

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

?????????????????????CheckCode:"",?????????????????????//校驗(yàn)碼??????

?????????????????????TotalTax:"",?????????????????????//合計(jì)稅額??????

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)??????

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文

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

?????????????????????MachineCode:"",??????????????//機(jī)器編碼??????

?????????????????????TotalAmount:"",??????????????//合計(jì)金額??????

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

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

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

????????????????????????????RowNo:"",????????????????????????????//行號(hào)（從1開始）

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

????????????????????????????CommodityName:"",??????????????//貨物或應(yīng)稅勞務(wù)名稱

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

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

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

????????????????????????????UnitPrice:"",????????????????????????????//單價(jià)

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

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

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

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

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

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)

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

? ? ? ? ??

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

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

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

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

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

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

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

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

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

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

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

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號(hào)??????

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

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

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

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號(hào)??????

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

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

?????????????????????CheckCode:"",?????????????????????//校驗(yàn)碼??????

?????????????????????TotalTax:"",?????????????????????//合計(jì)稅額??????

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)??????

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文

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

?????????????????????MachineCode:"",??????????????//機(jī)器編碼??????

?????????????????????TotalAmount:"",??????????????//合計(jì)金額??????

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

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

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

????????????????????????????RowNo:"",????????????????????????????//行號(hào)（從1開始）

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

????????????????????????????CommodityName:"",??????????????//貨物或應(yīng)稅勞務(wù)名稱

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

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

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

????????????????????????????UnitPrice:"",????????????????????????????//單價(jià)

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

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

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

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

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

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)?????????????

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

? ? ? ? ??

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

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

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

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

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

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

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

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

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

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

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

?????????????????????SalesTaxNo:"",?????????????????????//銷方稅號(hào)??????

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

?????????????????????PurchaserTaxNo:"",??????????????//購方稅號(hào)??????

?????????????????????CheckCode:"",?????????????????????//校驗(yàn)碼??????

?????????????????????TotalTax:"",?????????????????????//合計(jì)稅額??????

?????????????????????AmountTax:"",?????????????????????//價(jià)稅合計(jì)???????? ?

?????????????????????AmountTaxCN:"",??????????????//價(jià)稅合計(jì)_中文

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

?????????????????????MachineCode:"",??????????????//機(jī)器編碼??????

?????????????????????TotalAmount:"",??????????????//合計(jì)金額??????

?????????????????????TotalAmountCN:"",??????????????//合計(jì)金額_中文

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

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

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

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

????????????????????????????RowNo:"",??????????????//行號(hào)（從1開始）

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

????????????????????????????CommodityName:"",//項(xiàng)目

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

????????????????????????????UnitPrice:"",??????????????//含稅單價(jià)

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

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

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

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

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

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

??????????????Message:""??????????????//返回碼對(duì)應(yīng)信息(見附表一)?????????????

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

? ? ? ? ??

????},?

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

????"message":?{

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

????},?

"success": true

}

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

? ? ? ? ??

? ? ? ? ??

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

{

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

Data:

{

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

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

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

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

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

SalesName:"", //銷方名稱

SalesTaxNo:"", //銷方稅號(hào)

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

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

PurchaserName:"",//購方名稱

PurchaserTaxNo:"",//購方稅號(hào)

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

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

CheckCode:"", //校驗(yàn)碼

TotalTax:"", //合計(jì)稅額

AmountTax:"", //價(jià)稅合計(jì)

AmountTaxCN:"",//價(jià)稅合計(jì)_中文

Remarks:"", //備注

MachineCode:"",//機(jī)器編碼

TotalAmount:"",//合計(jì)金額

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

TollSign: "06"http://通行費(fèi)標(biāo)志(06-可抵扣通行費(fèi)，07-不可抵扣通行費(fèi))

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

{

RowNo:"",//行號(hào)（從1開始）

CommodityCode:"",//商品編碼

CommodityName:"",//貨物或應(yīng)稅勞務(wù)名稱

Amount: 7.61, //金額

TaxRate:"",//稅率

Tax:""http://稅額

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

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

LicensePlateNum: "粵ATST10", //車牌號(hào)

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

},

]

},

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

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

Message:""http://返回碼對(duì)應(yīng)信息(見附表一)

}

出參說明：

參數(shù)

類型

長度

描述

InvoiceType

String

3

發(fā)票類型

AdministrativeDivisionNo

String

32

所屬行政區(qū)編碼

AdministrativeDivisionName

String

150

所屬行政區(qū)名稱

InvoiceCode

String

10-12

發(fā)票代碼

InvoiceNumber

String

8

發(fā)票號(hào)碼

BillingDate

String

14

開票日期：YYYY-MM-DD

PurchaserName

String?? ? ? ?

100

購方名稱

PurchaserTaxNo

String

20

購方稅號(hào)

PurchaserBank

String

150

購方開戶行賬戶

PurchaserAddressPhone

String

150

購方地址電話

SalesName

String

100

銷方名稱

SalesTaxNo

String

20

銷方稅號(hào)

SalesAddressPhone

String

150

銷方地址電話

SalesBank

String

150

銷方開戶行賬戶

TotalAmount

String

17

合計(jì)金額

TotalTax

String

17

合計(jì)稅額

AmountTax

String

17

價(jià)稅合計(jì)

AmountTaxCN

String?? ? ? ?

64

價(jià)稅合計(jì)_中文

MachineCode

String

32

機(jī)器編碼

CheckCode

String

64

校驗(yàn)碼

State

String

2

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

InvoiceList

String

-

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

RowNo

String

10

行號(hào)：從1開始

CommodityCode

String

40

商品編碼

CommodityName

String

150

貨物或應(yīng)稅勞務(wù)名稱

SpecificationModel

String

32

規(guī)格型號(hào)

Unit

String

32

單位

Quantity

String

10

數(shù)量

UnitPrice

String?? ? ? ?

17

單價(jià)

Amount

String

17

金額

TaxRate

String

10

稅率

Tax

String

17

稅額

CarrierName

String

150

承運(yùn)人名稱

CarrierTaxNo

String

32

承運(yùn)人識(shí)別號(hào)

DraweeName

String

100

受票方名稱

DraweeTaxNo

String

20

受票方識(shí)別號(hào)

CargoInformation

String

150

運(yùn)輸貨物信息

TransportRoute

String

100

起運(yùn)地、經(jīng)由、到達(dá)地

MachineCode

String

32

稅控盤號(hào)

AutomobileType

String?? ? ? ?

64

車種車號(hào)

Tonnage

String

10

車船噸位

TaxAuthorityNo

String

32

主管稅務(wù)機(jī)關(guān)

TaxAuthorityName

String

100

主管稅務(wù)名稱

Remarks

String

184

備注

IDCardNo

String

32

身份證號(hào)碼/組織機(jī)構(gòu)代碼

PurchaserTaxNo

String

20

購方稅號(hào)

VehicleType

String

32

車輛類型

BrandModel

String

32

廠牌型號(hào)

OriginPlace

String

100

產(chǎn)地

CertificateNo

String

32

合格證號(hào)

InspectionListNo

String?? ? ? ?

64

商檢單號(hào)

EngineNo

String

32

發(fā)動(dòng)機(jī)號(hào)

VehicleNo

String

32

車輛識(shí)別代號(hào)/車架號(hào)碼

ImportCertificateNo

String

64

進(jìn)口證明書號(hào)

SalesPhone

String

150

銷方地址電話

SalesTaxNo

String

20

銷方稅號(hào)

SalesBankNo

String

64

賬號(hào)

SalesAddress

String

150

銷方地址

PaymentVoucherNo

String

32

完稅憑證號(hào)碼

PassengersLimited

String

10

限乘人數(shù)

TollSign

String

2

通行費(fèi)標(biāo)志(06-可抵扣通行費(fèi)，07-不可抵扣通行費(fèi))

ZeroTaxRateSign?? ? ? ?

String

2

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

CurrentDateEnd

String

20

通行日起止

CurrentDateStart

String

20

通行日期起

LicensePlateNum

String

20

車牌號(hào)

Type

String

10

類型

? ? ? ? ??

? ? ? ? ??

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

說明：

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

請(qǐng)求地址

? ? ? ? ? ? ? ? ?/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

是

購方稅號(hào)

InvoiceCode

String

10-12

是

發(fā)票代碼

InvoiceNumber

String

8

是

發(fā)票號(hào)碼

? ? ? ? ??

? ? ? ? ??

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

{

???????“TaxNo”:””,?????????????????????????//稅號(hào)

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

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

}

? ? ? ? ??

JSON出參說明：

成功：

{

????"model":?{

????????TaskNo:””,?????????????????????//任務(wù)編號(hào)

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

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

Message:””,?????????????????????//返回碼對(duì)應(yīng)信息(見附表一)

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

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

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

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

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

?????????PurchaserTaxNo:"",???????//購方稅號(hào)

?????????TotalAmount:””,???????//合計(jì)金額

?????????TotalTax:””,??????????????//合計(jì)稅額

?????????SalesTaxNo:"",??????????????//銷方稅號(hào)

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

?????????Deductible:””,??????????????//是否認(rèn)證?0-未認(rèn)證 1-已認(rèn)證

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

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

},

},

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

????"message":?{

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

????},?

"success": true

}

? ? ? ? ??

失敗：

{

"request_id": "", --請(qǐng)求ID,用于定位問題

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

? ? ? ? ??

出參說明：

參數(shù)

類型

長度

描述

TaskNo

String

32

任務(wù)編號(hào)

Success

Boolean

5

是否成功：True/false

Code

String

4

返回碼

Message

String

200

返回信息

InvoiceCode

String

10-12

發(fā)票代碼：返回多個(gè)發(fā)票信息及任務(wù)號(hào)

InvoiceNumber

String

8

發(fā)票號(hào)碼

InvoiceType

String

2

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

BillingDate

String

10

開票日期：YYYY-MM-DD

State

String

1

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

PurchaserTaxNo

String

20

購方稅號(hào)

TotalAmount

String

17

合計(jì)金額

TotalTax

String

17

合計(jì)稅額

SalesTaxNo?? ? ? ?

String

20

銷方稅號(hào)

SalesTaxName

String

150

銷方名稱

Deductible

String

0

是否認(rèn)證：0-未認(rèn)證1-已認(rèn)證

DeductibleDate

String

10

認(rèn)證日期：如果已認(rèn)證則為YYYY-MM-DD，未認(rèn)證則為空

DeductiblePeriod

String

10

稅款所屬期：如果已認(rèn)證則為YYYYMM，未認(rèn)證則為空

IsAgencyRebate

String

10

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

CertificationType

String

10

認(rèn)證類型：1為抵扣，2為出口退稅，3為代理出口退稅

CertificationWay

String

2

認(rèn)證方式：0為勾選認(rèn)證，1為掃描認(rèn)證

checkstatus

String

2

查驗(yàn)結(jié)果 1未查驗(yàn) 2查驗(yàn)中 3查無此票 4已驗(yàn)真

downloadUrl

String

200

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

? ? ? ? ??

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

說明：

獲取當(dāng)前系統(tǒng)時(shí)間，便于時(shí)間戳的校驗(yàn)

請(qǐ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:””,?????????????????????//當(dāng)前系統(tǒng)時(shí)間"yyyy-MM-dd'T'HH:mm:ss'Z'"

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

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

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

??????????????Message:””??????????????//返回碼對(duì)應(yīng)信息(見附表一)

????},?

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

????"message":?{

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

????},?

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

}

? ? ? ? ??

失敗：

{

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

"message": {

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

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

????},?

"success": false??--失敗標(biāo)志

}

? ? ? ? ??

出參說明

參數(shù)

類型

長度

描述

SystemTime

String

32

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

SystemTimeLong

String

32

當(dāng)前系統(tǒng)時(shí)間CurrentTimeMills

Success

Boolean

5

True/false

Code

String

4


Message

String

200


? ? ? ? ??

五、定制接口列表??

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

說明：

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

請(qǐng)求地址

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

方法類型?? ? ? ?

HTTPS GET

出參

XML

? ? ? ? ??

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

? ? ? ? ??

入?yún)⒄f明：URL

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

???????PurchaserTaxNo:"",??????????????//購方稅號(hào)，可以為空

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

//多個(gè)號(hào)碼段以 / 分隔，最多4個(gè)/，例如：

//12345601-09/12345620/12345631-12345640

//解析時(shí)先以/分隔，在按下面邏輯解析

//如果有”-”，則自動(dòng)解析發(fā)票號(hào)碼范圍

//36230244-50，則-后面的號(hào)碼，自動(dòng)填充到第一個(gè)號(hào)碼的長度

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

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

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???????//返回碼對(duì)應(yīng)信息(見附表一)

? ? ? ? ?

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

? ? ? ? ?

.....

? ? ? ? ??

失敗：? ? ? ? ?

? ? ? ? ?

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

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

<error_code>error_code>

<error_message>error_message>

? ? ? ? ??

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

（一）附表一：錯(cuò)誤信息表??

返回碼（CODE）

返回碼對(duì)應(yīng)信息Message

0

執(zhí)行成功

-1

未知錯(cuò)誤

001

簽名結(jié)果錯(cuò)誤

002

版本號(hào)不正確

003

時(shí)間差異超出范圍

004

SignatureNonce值已被使用過

005

請(qǐng)求參數(shù)不正確

006

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

101

身份驗(yàn)證失敗

102

未開通該接口

103

授權(quán)已過期

104

不能操作該稅號(hào)

105?? ? ? ?

不能操作該發(fā)票

206

此稅號(hào)下沒有稅期信息

207

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

231

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

232

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

233

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

234

重復(fù)插入憑證號(hào)

402

超過該張票當(dāng)天查驗(yàn)次數(shù)

404

超過服務(wù)器最大請(qǐng)求數(shù)

405

請(qǐng)求不合法

406

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

409

所查發(fā)票不存在

415

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

416

查驗(yàn)異常

498

不支持查詢?cè)摰貐^(qū)的發(fā)票

499

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

701

TaskNo不存在

702

TaskNo與InvoiceCode、InvoiceNumber不匹配

703

TaxNo不存在

704

請(qǐng)求json入?yún)榭?/span>

? ? ? ? ???? ?

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

值

對(duì)應(yīng)信息

01

增值稅專用發(fā)票

02

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

03

機(jī)動(dòng)車增值稅專用發(fā)票

04

增值稅普通發(fā)票

10

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

11

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

14

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

? ? ? ? ??

? ? ? ? ??

? ? ? ? ??

文檔修改記錄：

? ? ? ? ??

版本號(hào)

修改后版本號(hào)

修改時(shí)間

修改人

修改內(nèi)容

V1.0.0

V1.0.1

2018-01-19

周曉明

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

2、接口入?yún)⒃黾恿税姹咎?hào)

V1.0.1

V1.0.2

2018-02-26

周曉明

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

V1.0.2

V1.0.3

2018-03-19

周曉明

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

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

V1.0.3?? ? ? ?

V1.0.4

2018-05-10

單長海

增加定制接口


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

黄频国产免费高清视频,久久不卡精品中文字幕一区,激情五月天AV电影在线观看,欧美国产韩国日本一区二区
夜色欧美一区二区三区 | 一级a爱片国产亚洲精品 | 亚洲国产91一区二区三区 | 亚洲中文字幕乱码影视 | 中文字幕乱码一区二区三区免费 | 香港三级日本三级韩级人妇 |