數(shù)據(jù)標(biāo)準(zhǔn)對接接口規(guī)范說明文檔

版本時間狀態(tài)操作人詳細(xì)描述

VI.0.02018/12/01新建創(chuàng)建文檔，定義

1.增加申請退款接口

VI.0.12019/12/19修改2.增加退款結(jié)果接收接口

1.增加申請索賠接口

VI.0.22019/12/26修改2.增加索蟾結(jié)果接收接口

1.增加查詢退款接口

VI.0.32020/1/10修改2.增加查詢索賠接口

1.增加認(rèn)證及加密方式中MD5結(jié)果的說明；

2.保函申請接口enterpriseTel長度修改為2()

3.項目信息回傳接口增加加密方式的說明(多訂單同時

開標(biāo)推送)

4.項目信息回傳接口tendererContaclPhone長度

VI.0.32020/7/15修改修改為20

VI.0.32020/12/21修改1.退款狀態(tài)增加“4退款失敗”；

VI.0.3_07272021/7/27修改1.保函申請接口增加基本賬戶信息；

V1.0.3_04242022/4/24修改1.申請索賠接口輸入內(nèi)容增加保函驗證碼，為非必傳；

使用范圍3

二、流程圖...............................3

三、接口訪問協(xié)議….......................5

四、認(rèn)證及加密方式......................5

五、業(yè)務(wù)接口說明接口輸入:...............5

1、保函申請接口（外部系統(tǒng)提供）..................................................5

2、保函結(jié)果查詢接口（外部系統(tǒng)提供）..............................................7

3、保函結(jié)果接收接口（可接受重復(fù)調(diào)用）...............................................8

4、項目信息回傳接口（外部系統(tǒng)提供）.................................................9

5、申請退款接口（外部系統(tǒng)提供）..................................................10

6、查詢退款結(jié)果（外部系統(tǒng)提供）..................................................II

7、退款結(jié)果接收接口...............................................................11

8、申請索賠（外部系統(tǒng)提供）.........................................................12

9、查詢索賠結(jié)果（外部系統(tǒng)提供）..................................................13

10、索賠結(jié)果接收...................................................................13

六、附錄................................................................14

1、錯誤碼匯總.....................................................................14

2、訂單狀態(tài)匯總...................................................................14

3、退款狀態(tài)匯總...................................................................15

4、索賠狀態(tài)匯總...................................................................15

使用范圍

本文檔定義了北京筑龍金融服務(wù)平臺發(fā)布的對接接口規(guī)范。

外部系統(tǒng)可以根據(jù)本文檔定義的接口來完成和筑龍金融服務(wù)平臺的對接

二、流程圖

I）保函申請

I

投標(biāo)人交易中心筑龍平臺出函機構(gòu)

2）保函退款

投標(biāo)人交易中心筑龍平臺出函機構(gòu)

3）保函索賠

招標(biāo)人交易中心筑龍平臺出函機構(gòu)

三、接口訪問協(xié)議

>通訊協(xié)議：HTTP/HTTPS

>請求方式：POST

>數(shù)據(jù)格式：JSON

四、認(rèn)證及加密方式

傳入?yún)?shù)按key值進(jìn)行升序排列后，將不為空的參數(shù)按照kcy=valuc的形式進(jìn)行連接

例：

cntcrpnseName=lcgalIdCard=l11ltimcStamp=jinrongLoginstr

再結(jié)尾拼接接固定秘鑰串，最后進(jìn)行md5加密（32位小寫）后，當(dāng)成參數(shù)傳入，參數(shù)名為：signStr。

固定加密吊由北京筑龍?zhí)峁?/p>

五、業(yè)務(wù)接口說明接口輸入：

1、保函申請接口（外部系統(tǒng)提供）

接口說明：

本接口用于外部機構(gòu)電子保函的申請，有可能會轉(zhuǎn)人工審核，轉(zhuǎn)人工審核時，可使用保函結(jié)果查詢

接口獲取申請狀態(tài)。另，當(dāng)申請結(jié)果確定時，外部系統(tǒng)會主動推送結(jié)果。

外部機構(gòu)提供保函的申請接口，筑龍公司請求接II入?yún)?，返回結(jié)果，請求發(fā)生錯誤時應(yīng)按照異常碼

異常信息。

請求地址：

URL：

接口輸入:

名稱說明類型是否必填

orderId訂單號由北京筑龍生成String是

產(chǎn)品大類默認(rèn)P03投標(biāo)保函是

prnduetTypnString

P03投標(biāo)保函，P02履約保函

bidderName投標(biāo)人名稱String是

bidderCodc投標(biāo)人統(tǒng)一社會信用代碼String是

basicAccount企業(yè)基本戶名稱String是

basicAccountNumber企業(yè)基本戶賬號String是

bidderContact投標(biāo)人聯(lián)系人名稱String是

bidderContactAddress投標(biāo)人聯(lián)系人地址String是

bidderContactPhoneNumbe投標(biāo)人聯(lián)系人電話是

String

r

bidderContactEmai1投標(biāo)人聯(lián)系人電子郵箱String是

legalPersonName法人姓名String是

1ega1PersonIdCard法人身份證號String是

needEInvoice是否需要電子發(fā)票String是，1需要，0不需要

長度1位

enterpriseAddr企業(yè)地址（開票用）String需要電子發(fā)票時必填

最大長度200

enterpriseTel企業(yè)聯(lián)系電話（開票用）String需要電子發(fā)票時必填

最大長度20

entcrpriseBankno銀行賬號（開票用）String需要電子發(fā)票時必填

最大長度50

enterpriseBankName開戶行（開票用）String需要電子發(fā)票時必填

最大長度50

tenderBond投標(biāo)保證金（元）保留兩位小數(shù)Decimal是

投標(biāo)生效日期日期型字符串是

tenderStartTimeString

口期格式為yyyyMMddHHmmss

tenderExpire投標(biāo)有效期（天）Integer是

項目類型（1：工程建設(shè)；2：政府采是

projectTypeInteger

購）

timcStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串Siring是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

orderld訂單號String是

orderStalus訂單狀態(tài)Siring是，詳見附錄訂單

狀態(tài)

insuranccCoinpany承保單位String是

baoFei保費Number足

jumpUrl跳轉(zhuǎn)鏈接，訂單狀態(tài)為3時返回String否

errorCode錯誤碼String是

0為正常，其他錯誤

碼參見附錄

errorMsg錯誤信息String否

2、保函結(jié)果查詢接口（外部系統(tǒng)提供）

接口說明：

本接口用于查詢電子保函的申請結(jié)果。

請求地址：

URL：

接口輸入：

名稱說明類型是否必填

orderld訂單號IDString是

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

orderld訂單號String是

guarantccld保函編號String否

當(dāng)訂單狀態(tài)為5時，由外部系統(tǒng)

生成并返回

validateCode保函驗真碼String否

當(dāng)訂單狀態(tài)為5時，由外部系統(tǒng)

生成并返回

orderStatus訂單狀態(tài)是，詳見附錄訂單

狀態(tài)

insuranccCompany承保單位String是

payStatus繳費狀態(tài)Number是0：未繳費1：已

繳費

baoFei保費Number是

guaranteeUrl電子保函下載地址String否

errorCode錯誤碼String是

0為正常，其他錯誤

碼參見附錄

errorMsg錯誤信息String否

3、保函結(jié)果接收接口（可接受重復(fù)調(diào)用）

接口說明：

接口由北京筑龍?zhí)峁?dāng)保函申請結(jié)果確定后，外部機構(gòu)會調(diào)用該接口進(jìn)行申請結(jié)果的推送。

請求地址：

URL：http://****/****/pushElgApplyResult

接口輸入:

名稱說明類型是否必填

orderld訂單號IDString是

orderStatus保函訂單結(jié)果String是，詳見附錄訂單狀

態(tài)

guaranteeld保函編號String否

當(dāng)訂單狀態(tài)為5時，由外部系

統(tǒng)生成并返回

validateCode保函驗真碼String否

當(dāng)訂單狀態(tài)為5時，由外部系

統(tǒng)生成并返回

insuranceCompany承保單位String是

payStatus繳費狀態(tài)Number是0:未繳費1:已繳

費

baoFei保費Number是

jumpUrl跳轉(zhuǎn)鏈接，訂單狀態(tài)為3時返String否

回

guaranteeUrl電子保函下載地址，訂單狀態(tài)String否

為5時返回

timeStamp時間戳字符串（亳秒級）String是

platformCode第三方平臺編號（由北京筑龍?zhí)酳tring是

供）

signStr驗簽加密用String是

>接口輸出

名稱說明數(shù)據(jù)類型是否必填

errorCode錯誤碼String是

0為正常，其他錯誤碼

參見附錄

errorMsg錯誤信息String否

4、項目信息回傳接口（外部系統(tǒng)提供）

接口說明：

本接口用于通知外部機構(gòu)，其已開具的保函的項目信息，接口輸入和輸出均為Json數(shù)組格式。單

次推送包含單個或多個訂單。

請求地址：

URL：

接口輸入:

名稱說明類型是否必填

projectName項目名稱String是

projectCode項目編號String是

tenderer招標(biāo)（采購）人String是

tendererCode招標(biāo)人統(tǒng)一信用社會代碼String是

tendererContactPhone招標(biāo)人聯(lián)系人電話String否

agency代理機構(gòu)否

招標(biāo)（采購）人地址區(qū)域碼是

tenderei'AddressString

國家標(biāo)準(zhǔn)6位行政區(qū)劃

項目地區(qū)區(qū)域碼是

projectAi'caString

國家標(biāo)準(zhǔn)6位行政區(qū)劃

招標(biāo)類型（1：服務(wù)；2：貨物；否

tenderTypeInteger

3：工程）

項目類型（1：工程建設(shè)；2：政是

projectTypeInteger

府采購）

sectionName標(biāo)段（包件）名稱String是

sectionCode標(biāo)段（包件）編號String是

orderld訂單號由北京筑龍生成：String是

guaranteeld保函編號String是

□fferUrl要約函下載地址String否

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

orderld訂單號String是

orderStatus訂單狀態(tài)String是

guaranteeUrl保函下載地址String否，狀態(tài)為5時返

回

errorCode錯誤碼String是

0為正常，其他錯誤

碼參見附錄

errorMsg錯誤信息String否

5、申請退款接口（外部系統(tǒng)提供）

接口說明：

請求地址：URL：

接口輸入：

名稱說明類型是否必填

guaranteeId保函編號String是

bidderName投標(biāo)人名稱String是

bidderCode投標(biāo)人統(tǒng)一社會信用代碼String是

refundReason退款原因String是

contactsPhone聯(lián)系人電話String是

bankName銀行開戶行String是

bankNo銀行賬號，用于退款String是

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

errorCode錯誤碼String是

（）為正常，其他錯誤碼

參見附錄

errorMsg錯誤信息String否

acceptanceld退費受理編號String是

status狀態(tài)String是，詳見附錄訂單狀

態(tài)

6、查詢退款結(jié)果（外部系統(tǒng)提供）

接口說明：用于查詢退款申請法度

接口地址：

接II輸入：

名稱說明類型是否必填

acccptanceld退費受理編號String是

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

acccptanccid退費受理編號String是

status狀態(tài)String是，詳見附錄退

費狀態(tài)

errorCode錯誤碼String是

0為正常，其他錯

誤碼參見附錄

ciiuiMsg錯誤信息Suing否

7、退款結(jié)果接收接口

接口說明：退款申請?zhí)幚斫Y(jié)束之后調(diào)用，通知退款結(jié)果

接口地址：URL：hup:〃****/****/accessRefundResuli

接口輸入：

名稱說明類型是否必填

acccptanceld退費受理編號String是

status狀態(tài)，詳見附錄String是

auditOpinion審核意見，退款失敗時必填String否

platformCode平臺編號String是

limeSlamp時間戳字符申（亳秒級）Siring是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

errorCode錯誤碼String是

。為正常，其他錯誤碼

參見附錄

errorMsg錯誤信息String否

8、申請索賠（外部系統(tǒng)提供）

接口說明：用于申請索賠

接口地址：

接口輸入：

名稱說明類型是否必填

guaranteeId保函編號String是

validatcCode保函驗真碼String否，當(dāng)保函回傳結(jié)果

當(dāng)訂單狀態(tài)為5時，由外部系有這個時申請索賠必

統(tǒng)生成并返回傳。

claimAmount索賠金額（元）Number是

claimCompany索賠企業(yè)名稱String是

claimCompanyCode索賠企業(yè)統(tǒng)一社會信用代碼String否

claimReason索賠原因String是

claimFile索賠相關(guān)文件下載地址String否

contactsPhone聯(lián)系人電話String是

bankName銀行開戶行String是

bankNo銀行賬號，用于接收賠款String是

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密串String是

接口輸出:

名稱說明數(shù)據(jù)類型是否必填

errorCode錯誤碼String是

（）為正常，其他錯誤碼

參見附錄

errorMsg錯誤信息String否

claimld索賠受理編號String是

status索賠狀態(tài)String是，詳見附錄索賠狀

態(tài)

9、查詢索賠結(jié)果（外部系統(tǒng)提供）

接I」說明：用于查詢索賠申請結(jié)果

接口地址：

接口輸入：

名稱說明類型是否必填

claimld索賠受理編號String是

timeStamp時間戳字符串（亳秒級）String是

signStr驗簽加密庫String是

接口輸出:

名稱說明類型是否必填

claimld索賠受理編號String是

status索賠狀態(tài)，詳見附錄String是

errorCode錯誤碼String是

0為正常，其他

錯誤碼參見附錄

errorMsg錯誤信息String否

10、索賠結(jié)果接收

接口說明：用于接收索賠結(jié)果

接II地址：http:〃****/****/rcccivcClaimRcsult

接口輸入：

名稱說明