DB2101-T 0097-2023 公共資源交易投標(biāo)電子保函平臺(tái)接口數(shù)據(jù)描述規(guī)范

ICS35.240CCSL772101transactionbiddingelectronicguaranteepla沈陽(yáng)市市場(chǎng)監(jiān)督管理局IDB2101/T0097-2023前言 2規(guī)范性引用文件 3術(shù)語(yǔ)和定義 4總體要求 24.1流程示意圖 24.2電子保函信息 24.3基礎(chǔ)信息 24.4業(yè)務(wù)信息 34.5傳輸要求 34.5.1協(xié)議要求 34.5.2加密算法 34.5.3報(bào)文簽名 34.5.4報(bào)文加解密 35電子保函基礎(chǔ)信息 35.1電子保函基本信息表 35.2投保人信息表 55.3受益人信息表 65.4擔(dān)保人信息表 75.5招標(biāo)項(xiàng)目和標(biāo)段（包）信息 86業(yè)務(wù)信息 86.1保函申請(qǐng) 96.2投保申請(qǐng)通知 6.3發(fā)票申請(qǐng) 6.4發(fā)票開(kāi)具通知 6.5申請(qǐng)退保 6.6退保結(jié)果通知 6.7申請(qǐng)理賠 6.8理賠結(jié)果通知 6.9放棄申請(qǐng) 6.10放棄申請(qǐng)通知 6.11重新開(kāi)具保函申請(qǐng) 6.12重新開(kāi)具保函申請(qǐng)通知 6.13保函驗(yàn)真查詢 6.14保函聲明通知 7代碼集 7.1支付方式 DB2101/T0097-20237.2產(chǎn)品類(lèi)別 7.3產(chǎn)品類(lèi)型 7.4審核狀態(tài) 7.5發(fā)票類(lèi)型 7.6賠付狀態(tài) 7.7公共錯(cuò)誤碼 DB2101/T0097-2023本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起請(qǐng)注意本文件的某些內(nèi)容可能涉及專(zhuān)利，本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專(zhuān)利的責(zé)任。本文件由沈陽(yáng)市發(fā)展和改革委員會(huì)提出并歸口，同時(shí)負(fù)責(zé)標(biāo)準(zhǔn)的宣貫、監(jiān)督實(shí)施等工作。本文件起草單位：遼寧省公共資源交易協(xié)會(huì)、沈陽(yáng)市發(fā)展和改革委員會(huì)、大連市公共資源交易中心、朝陽(yáng)市公共資源交易中心、沈陽(yáng)市城鄉(xiāng)建設(shè)事務(wù)服務(wù)中心、大連長(zhǎng)興島經(jīng)濟(jì)技術(shù)開(kāi)發(fā)區(qū)綜合建設(shè)服務(wù)中心、遼寧思創(chuàng)網(wǎng)聯(lián)科技有限公司、國(guó)泰新點(diǎn)軟件股份有限公司、廣聯(lián)達(dá)科技股份有限公司。本文件主要起草人：劉曉亮、張汪洋、陳洪嶺、佟偉、周健、李智、楊晨、王百合等。本文件發(fā)布實(shí)施后，任何單位和個(gè)人如有問(wèn)題和意見(jiàn)建議，均可以通過(guò)來(lái)電、來(lái)函等方式進(jìn)行反饋。本文件歸口管理部門(mén)通訊地址：沈陽(yáng)市發(fā)展和改革委員會(huì)（沈陽(yáng)市渾南新區(qū)世紀(jì)路一號(hào)二十一世紀(jì)大廈B座11樓）；聯(lián)系電話本文件主要起草單位通訊地址：遼寧省公共資源交易協(xié)會(huì)（遼寧省沈陽(yáng)市皇姑區(qū)北陵大街34-3號(hào)（金融平臺(tái)經(jīng)濟(jì)大廈）3樓3-20門(mén)）；聯(lián)系電話1DB2101/T0097-2023公共資源交易投標(biāo)電子保函平臺(tái)接口數(shù)據(jù)描述規(guī)范本文件規(guī)定了沈陽(yáng)市公共資源交易投標(biāo)電子保函數(shù)據(jù)接口的總體要求、基礎(chǔ)信息、業(yè)務(wù)信息、代碼集等。本文件主要適用沈陽(yáng)市公共資源交易投標(biāo)活動(dòng)中投標(biāo)電子保函平臺(tái)接口數(shù)據(jù)描述、管理建設(shè)及應(yīng)用。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260-2007中華人民共和國(guó)行政區(qū)劃代碼GB11643－1999公民身份號(hào)碼GB32100-2015法人和其他組織統(tǒng)一社會(huì)信用代碼編碼規(guī)則GM/T0009-2012SM2密碼算法3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1擔(dān)保人guarantor開(kāi)立保函的一方。3.2投保人applicant申請(qǐng)開(kāi)立保函的一方。3.3受益人beneficiary接受保函并享有其利益的一方。3.4電子保函electronicletterofguarantee擔(dān)保人使用數(shù)字證書(shū)和電子簽章進(jìn)行認(rèn)證，以電子數(shù)據(jù)形式向受益人開(kāi)立的具有與紙質(zhì)保函同等法律效力的擔(dān)保憑證。2DB2101/T0097-20233.5電子保函文件electronicletterofguaranteefile金融機(jī)構(gòu)作為擔(dān)保人向受益人開(kāi)立的投標(biāo)保證文件。3.6電子保函平臺(tái)electronicguaranteeplatform電子保函平臺(tái)是由聚集銀行、擔(dān)保、保險(xiǎn)等金融機(jī)構(gòu)構(gòu)成的技術(shù)運(yùn)營(yíng)機(jī)構(gòu)作為運(yùn)行主體。具有申請(qǐng)、開(kāi)立、退保、驗(yàn)真、索賠等功能，實(shí)現(xiàn)沈陽(yáng)市公共資源交易領(lǐng)域投標(biāo)電子保函全流程辦理的平臺(tái)。3.7電子保函基礎(chǔ)公共服務(wù)平臺(tái)electronicguaranteebasicpublicserviceplatform電子保函基礎(chǔ)公共服務(wù)平臺(tái)是指由第三方市場(chǎng)主體搭建，聚集多個(gè)電子保函平臺(tái)的保函管理服務(wù)信息化系統(tǒng)支撐平臺(tái)。4總體要求4.1流程示意圖電子保函基礎(chǔ)公共服務(wù)平臺(tái)流程具體組成見(jiàn)圖1。圖1流程示意圖4.2電子保函信息電子保函信息包括基礎(chǔ)信息、業(yè)務(wù)信息。4.3基礎(chǔ)信息3DB2101/T0097-2023基礎(chǔ)信息由保函基本信息、投保人信息、受益人信息、擔(dān)保人信息、招標(biāo)項(xiàng)目和標(biāo)段（包）組4.4業(yè)務(wù)信息業(yè)務(wù)信息由保函申請(qǐng)、申請(qǐng)結(jié)果通知、發(fā)票申請(qǐng)、發(fā)票開(kāi)具通知、申請(qǐng)退保、退保結(jié)果通知、申請(qǐng)理賠、理賠結(jié)果通知、放棄申請(qǐng)、放棄申請(qǐng)結(jié)果通知、重新開(kāi)具保函申請(qǐng)、重新開(kāi)具保函申請(qǐng)通知、保函驗(yàn)真查詢、保函聲明通知等業(yè)務(wù)。4.5傳輸要求4.5.1協(xié)議要求所有接口基于HTTPS協(xié)議進(jìn)行通訊，通訊報(bào)文采用JSON格式，編碼為UTF-8。雙方的請(qǐng)求報(bào)文通過(guò)簽名后再傳輸給對(duì)方，提交請(qǐng)求使用Post方式提交。4.5.2加密算法電子保函平臺(tái)對(duì)外交互接口統(tǒng)一使用國(guó)密算法。4.5.3報(bào)文簽名報(bào)文簽名使用國(guó)密消息摘要算法（SM3）。4.5.4報(bào)文加解密電子保函平臺(tái)對(duì)外交互接口統(tǒng)一使用國(guó)密非對(duì)稱橢圓曲線算法SM2。保函文件加密、解密使用國(guó)密對(duì)稱分組密碼算法SM4。5電子保函基礎(chǔ)信息5.1電子保函基本信息表電子保函基本信息具體參數(shù)見(jiàn)表1。表1電子保函基本信息表（T_GUARANTEE_INFO）是是 是 -是 是 是-是-4DB2101/T0097-2023表1電子保函基本信息表（T_GUARANTEE_INFO）（續(xù)）-是-是--是--是-是-是-是--否--否--是--是--是--是-payer_bank_account_r-是--是--是-是-是-是-是-是-是參照“支付方式”5DB2101/T0097-2023表1電子保函基本信息表（T_GUARANTEE_INFO續(xù)）-是--是-是-是-5.2投保人信息表投保人信息具體參數(shù)見(jiàn)表2。表2投保人信息表（T_APPLICANT_INFO）是是--是-unified_social_cred-是-是--是-是--是--是--是--是--是--是式-是式-是式6DB2101/T0097-2023表2投保人信息表（T_APPLICANT_INFO續(xù)）-是-responsible_person_p-是-responsible_person_i-是responsible_person_i-是responsible_person_i-是-是-識(shí)-是--是-是--是-5.3受益人信息表受益人信息具體參數(shù)見(jiàn)表3。表3受益人信息表（T_BENEFICIARY_INFO）是是-是--是--是--是--是--是--是-7DB2101/T0097-2023表3受益人信息表表3（T_BENEFICIARY_INFO）（續(xù)）-是--是-是--是-5.4擔(dān)保人信息表?yè)?dān)保人信息參數(shù)具體參見(jiàn)表4。表4擔(dān)保人信息表（T_UNDERWRITER_INFO）是是-碼-是--是--是--是--是--是詳見(jiàn)“產(chǎn)品類(lèi)別”-是詳見(jiàn)“產(chǎn)品類(lèi)型”-是--是--是--是--是--是-8DB2101/T0097-2023表4擔(dān)保人信息表（T_UNDERWRITER_INFO續(xù)）鑰-是--是--是--是--是-5.5招標(biāo)項(xiàng)目和標(biāo)段（包）信息招標(biāo)項(xiàng)目和標(biāo)段（包）信具體參見(jiàn)表5。表5招標(biāo)項(xiàng)目和標(biāo)段（包）信表（T_PROJECT_BID_INFO）是是--是--是--是--是--是--是--是--是-是-是--是--是-6業(yè)務(wù)信息9DB2101/T0097-20236.1保函申請(qǐng)通過(guò)調(diào)用此接口生成保函申請(qǐng)預(yù)支付訂單。請(qǐng)求方式：POST。具體參數(shù)見(jiàn)表6、返回參數(shù)見(jiàn)表7。表6請(qǐng)求參數(shù)是是是是是_是是是是是是是是是是是是是r是DB2101/T0097-2023表6請(qǐng)求參數(shù)（續(xù)）是是是是書(shū)是-否否否是是否否是否議否是表7返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否Redirecturl:“重定向地址”6.2投保申請(qǐng)通知DB2101/T0097-2023電子保函平臺(tái)通過(guò)投保通知接口將用戶支付結(jié)果返回給電子保函基礎(chǔ)公共服務(wù)平臺(tái)。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表8、返回值參數(shù)見(jiàn)表9。表8請(qǐng)求參數(shù)是是是 是-是是 是-是 是 是是是詳見(jiàn)“審核狀態(tài)”是是是詳見(jiàn)“支付方式”是-是表9返回值是詳見(jiàn)“公共錯(cuò)誤碼”DB2101/T0097-2023表9返回值（續(xù)）是詳見(jiàn)“公共錯(cuò)誤碼”否 6.3發(fā)票申請(qǐng)電子保函基礎(chǔ)公共服務(wù)平臺(tái)未收到發(fā)票通知與電子發(fā)票的情況下，投標(biāo)企業(yè)可以在電子保函基礎(chǔ)公共服務(wù)平臺(tái)申請(qǐng)重新下載獲取電子發(fā)票。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表10、返回值參數(shù)見(jiàn)表11。表10請(qǐng)求參數(shù)是是是-是-是-碼_identifier是-是是詳見(jiàn)“發(fā)票類(lèi)型”否-否-否-填否-否-否-是DB2101/T0097-2023表11返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否-6.4發(fā)票開(kāi)具通知金融機(jī)構(gòu)開(kāi)出發(fā)票通過(guò)電子保函平臺(tái)將開(kāi)票結(jié)果通知電子保函基礎(chǔ)公共服務(wù)平臺(tái)。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表12、返回值參數(shù)見(jiàn)表13。表12請(qǐng)求參數(shù)是是是-是-是是詳見(jiàn)“審核狀態(tài)”是是是否 是表13返回值是詳見(jiàn)“公共錯(cuò)誤碼”DB2101/T0097-2023表13返回值（續(xù)）是詳見(jiàn)“公共錯(cuò)誤碼”否 6.5申請(qǐng)退保由投保人在電子保函基礎(chǔ)公共服務(wù)平臺(tái)發(fā)起，并向電子保函平臺(tái)主動(dòng)推送退保申請(qǐng)信息。請(qǐng)求方式：POST。具體參數(shù)見(jiàn)表14、返回值參數(shù)見(jiàn)表15。表14請(qǐng)求參數(shù)是是是-是 是 是 表15返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否 6.6退保結(jié)果通知電子保函平臺(tái)與金融機(jī)構(gòu)響應(yīng)退保后，需通知至電子保函基礎(chǔ)公共服務(wù)平臺(tái)。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表16、返回值參數(shù)見(jiàn)表17。DB2101/T0097-2023表16請(qǐng)求參數(shù)是是是-是-是詳見(jiàn)“申請(qǐng)狀態(tài)”是表17返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否 6.7申請(qǐng)理賠電子保函基礎(chǔ)公共服務(wù)平臺(tái)向金融機(jī)構(gòu)主動(dòng)發(fā)起申請(qǐng)。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表18、返回值參數(shù)見(jiàn)表19。表18請(qǐng)求參數(shù)是是是 是-_number是 是 是DB2101/T0097-2023表18請(qǐng)求參數(shù)（續(xù)）是-是-是-是-否--是表19返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否-6.8理賠結(jié)果通知金融機(jī)構(gòu)理賠處理完成之后，電子保函平臺(tái)向電子保函基礎(chǔ)公共服務(wù)平臺(tái)主動(dòng)推送理賠成功相關(guān)信息。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表20、返回值參數(shù)見(jiàn)表21。表20請(qǐng)求參數(shù)是是是-是-是詳見(jiàn)“賠付狀態(tài)”否-DB2101/T0097-2023表20請(qǐng)求參數(shù)（續(xù)）是-話是-是-否[]是-是-否-否-否-否-否-否-是-表21返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否 DB2101/T0097-20236.9放棄申請(qǐng)由投保人在電子保函基礎(chǔ)公共服務(wù)平臺(tái)發(fā)起放棄申請(qǐng)（未收到投保成功通知的訂單），告知電子保函平臺(tái)此次申請(qǐng)放棄并作廢。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表22、返回值參數(shù)見(jiàn)表23。表22請(qǐng)求參數(shù)是是是是表23返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否-6.10放棄申請(qǐng)通知電子保函平臺(tái)方主動(dòng)發(fā)起放棄保函申請(qǐng)通知。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表24、返回值參數(shù)見(jiàn)表25。表24請(qǐng)求參數(shù)是是是是DB2101/T0097-2023表25返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否-6.11重新開(kāi)具保函申請(qǐng)由投保人在電子保函基礎(chǔ)公共服務(wù)平臺(tái)主動(dòng)發(fā)起重開(kāi)申請(qǐng)，電子保函平臺(tái)通過(guò)此接口重新開(kāi)具告知書(shū)與保函文件。請(qǐng)求方式：POST。請(qǐng)求參數(shù)見(jiàn)表26、返回值參數(shù)見(jiàn)表27。表26請(qǐng)求參數(shù)是是是-是-是-是-表27返回值是詳見(jiàn)“公共錯(cuò)誤碼”是詳見(jiàn)“公共錯(cuò)誤碼”否 6.12重新開(kāi)具保函申請(qǐng)通知重新開(kāi)具保函申請(qǐng)通知。請(qǐng)求方式：