內(nèi)蒙古自治區(qū)政府采購電子履約保函業(yè)務(wù)接口規(guī)范

目錄-1-應(yīng)用范圍本規(guī)范規(guī)定了內(nèi)蒙古自治區(qū)政府采購電子履約保函業(yè)務(wù)的應(yīng)用場景、系統(tǒng)框架及流程、數(shù)據(jù)規(guī)范及信息接口規(guī)范等。本規(guī)范適用于金融機(jī)構(gòu)預(yù)接入到內(nèi)蒙古自治區(qū)政府采購電子履約保函模塊的設(shè)計與研發(fā)。規(guī)范性引用文件GM/T0003SM2橢圓曲線公鑰密碼算法。GM/T0004-2012SM3密碼雜湊算法。術(shù)語和定義術(shù)語/縮略語解釋公私密鑰對非對稱密鑰中的公鑰和私鑰。公鑰非對稱密鑰對中公開的密鑰。私鑰非對稱密鑰對中非公開的密鑰。架構(gòu)及流程規(guī)范總體組成說明在政府采購供應(yīng)商電子履約保函業(yè)務(wù)的應(yīng)用場景中，參與業(yè)務(wù)交互的成員主要包括：政府采購金融服務(wù)平臺及擔(dān)保機(jī)構(gòu)。政府采購金融服務(wù)平臺政府采購金融服務(wù)平臺為供應(yīng)商及金融機(jī)構(gòu)提供電子履約保函業(yè)務(wù)場景，其主要職責(zé)如下：1)為供應(yīng)商提供電子履約保函申請及相關(guān)業(yè)務(wù)查詢功能。2)為金融機(jī)構(gòu)提供電子信息交互接口。金融機(jī)構(gòu)金融機(jī)構(gòu)為政府采購供應(yīng)商提供電子履約保函服務(wù)，其主要職責(zé)如下：1)按照政府采購金融服務(wù)平臺接口規(guī)范完成系統(tǒng)對接。2)響應(yīng)供應(yīng)商電子履約保函意向申請并按照政府采購金融服務(wù)平臺接口標(biāo)準(zhǔn)完成相關(guān)數(shù)據(jù)交互。政府采購電子履約保函業(yè)務(wù)流程政府采購電子履約保函業(yè)務(wù)流程如圖所示：圖1政府采購電子履約保函業(yè)務(wù)流程流程說明：1.供應(yīng)商完成電子履約保函申請后，金融服務(wù)平臺向?qū)?yīng)金融機(jī)構(gòu)推送供應(yīng)商電子履約保函申請信息。2.金融機(jī)構(gòu)完成電子履約保函審批后將審批結(jié)果通知到金融服務(wù)平臺。3.供應(yīng)商根據(jù)金融機(jī)構(gòu)提供的支付渠道支付對應(yīng)保函申請的保費(fèi)。4.金融機(jī)構(gòu)收到保費(fèi)后向供應(yīng)商開立電子履約保函，并將開立保函結(jié)果通知給金融服務(wù)平臺。5.金融服務(wù)平臺收到保函后向金融機(jī)構(gòu)發(fā)起保函驗(yàn)真，驗(yàn)證保函真?zhèn)巍?.供應(yīng)商/采購人可在開函成功后查看對應(yīng)項(xiàng)目的保函信息。7.采購人如需向?qū)?yīng)開函機(jī)構(gòu)索賠，可在金融服務(wù)平臺索賠管理中發(fā)起索賠申請。8.金融機(jī)構(gòu)受理索賠申請，將最終受理結(jié)果上送至金融服務(wù)平臺。數(shù)據(jù)規(guī)范傳輸規(guī)則通訊方式金融機(jī)構(gòu)通過互聯(lián)網(wǎng)接入的方式與金融服務(wù)平臺進(jìn)行連接，報文傳輸方式采用HTTP/HTTPS+POST+JSON報文格式。編碼方式報文采用Unicode字符集，UTF-8編碼方式。報文格式請求報文說明序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1transcode交易碼string20Y接口唯一標(biāo)識2msgcode流水號string32Y交易流水號，取32位UUID。adfd95a4b3634b58b0cf3b8c67b18a293appid銀行標(biāo)識string32Y分配的銀行appid4reqtime請求時間string14Y年月日，為yyyyMMddHHmmss格式202201251200005version接口版本string10Yv1.06data請求報文加密后的數(shù)據(jù)string-Y報文JSON字符串使用國密SM2算法加密后的數(shù)據(jù)。7sign請求報文的簽名數(shù)據(jù)string64Y請求報文的摘要信息，使用國密SM3算法進(jìn)行簽名。響應(yīng)報文說明序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述3data響應(yīng)報文加密后的數(shù)據(jù)string-N響應(yīng)報文JSON字符串使用國密SM2算法加密后的數(shù)據(jù)。接口安全報文加密方式為了加強(qiáng)接口傳輸?shù)臄?shù)據(jù)安全性，使用SM2非對稱算法對傳輸?shù)膱笪倪M(jìn)行加解密。金融機(jī)構(gòu)在申請接入時與金融服務(wù)平臺互相交換公鑰信息，加密后的內(nèi)容及密鑰對均使用Base64編碼的方式。報文簽名方式為了驗(yàn)證請求方的合法身份，請求方在請求接口時，都需要根據(jù)當(dāng)前請求報文通過SM3摘要算法生成簽名信息。金融機(jī)構(gòu)在申請接入時，由金融服務(wù)平臺提供平臺密鑰，包含appkey和appsecret，簽名方式如下：SM3({data}&{reqtime}&{appkey}&{appsecret})。數(shù)字信封將\t"/weixin_44669878/article/details/_blank"對稱密鑰通過\t"/weixin_44669878/article/details/_blank"非對稱加密(即：有\(zhòng)t"/weixin_44669878/article/details/_blank"公鑰和\t"/weixin_44669878/article/details/_blank"私鑰兩個)的結(jié)果分發(fā)對稱\t"/weixin_44669878/article/details/_blank"密鑰。具體實(shí)現(xiàn)方式：用對稱秘鑰對文件或字節(jié)加密,然后用非對稱秘鑰對對稱秘鑰的鑰匙進(jìn)行加密。加密：data:生成一個密鑰，對文件進(jìn)行對稱加密，sign：對生成密鑰進(jìn)行非對稱加密解密：用私鑰對sign值進(jìn)行解密，得到對稱加密密鑰，用解密的密鑰對data進(jìn)行對稱解密。信息接口規(guī)范提交保函申請信息交互流程如圖：提交電子履約保函申請接口流程示意圖接口調(diào)用地址接口地址由金融機(jī)構(gòu)提供接口交易碼ELY101接口提供者金融機(jī)構(gòu)接口消費(fèi)者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺功能描述供應(yīng)商憑借已在政府采購平臺公示的中標(biāo)公告及項(xiàng)目信息向金融機(jī)構(gòu)提交電子履約保函申請，金融服務(wù)平臺向?qū)?yīng)的金融機(jī)構(gòu)提交電子履約保函申請信息請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1applicationId申請編號string64Y電子履約保函申請訂單的唯一編號2supplier企業(yè)名稱string256Y投保企業(yè)名稱3socialCreditCode供應(yīng)商統(tǒng)一社會信用代碼string18Y4legalName法人姓名string20Y5legalIdNo法人身份證號碼string18Y6supplierAddress企業(yè)地址string256N企業(yè)地址7performanceBound

履約保證金float-Y保留2位小數(shù)點(diǎn)8contacts經(jīng)辦人string20Y9contactsWay經(jīng)辦人聯(lián)系方式string20Y10contractCerNo經(jīng)辦人身份證號碼string18Y11needPaper是否需要紙質(zhì)保函string2Y1：需要紙質(zhì)保函0:不需要紙質(zhì)保函12mailAddress郵寄地址string256N當(dāng)需要紙質(zhì)保函時，郵寄地址為必填項(xiàng)13projectCode政府采購統(tǒng)一項(xiàng)目編號string128Y政府采購統(tǒng)一項(xiàng)目編號14projectName項(xiàng)目名稱string256Y項(xiàng)目名稱15bidCode標(biāo)段編號string256Y16bidName標(biāo)段名稱string256Y17purchaseNature采購品目string10Y枚舉值：服務(wù)類、貨物類、工程類服務(wù)類18bidDate中標(biāo)日期string8Y格式：yyyyMMdd19bidAmount中標(biāo)金額float-Y單位：元保留2位小數(shù)點(diǎn)20purchaseName采購人名稱string256Y21purchaseSocCode采購人組織機(jī)構(gòu)代碼string64Y采購人組織機(jī)構(gòu)代碼/統(tǒng)一社會信用代碼22guraanteeDate擔(dān)保期限string10Y月2423contractDate合同期限string10N月2424ext1拓展字段1string256N25ext2拓展字段2string256N26ext3拓展字段3string256N響應(yīng)值描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述保函申請狀態(tài)通知交互流程如圖：金融機(jī)構(gòu)開函成功接口流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/bh/api接口交易碼ELY102接口提供者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺接口消費(fèi)者金融機(jī)構(gòu)功能描述金融機(jī)構(gòu)開函成功后向金融服務(wù)平臺推送開函結(jié)果請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1applicationId申請編號string32Y保函申請訂單的唯一編號2applycationStatus保函申請狀態(tài)string2Y01保函審批通過02保函審批拒絕03開函成功04開函失敗05已支付3failReason失敗原因string255N當(dāng)審批拒絕或開函失敗時，此值為必填項(xiàng)4 以下字段當(dāng)開函成功時有值5guaranteeId保函唯一標(biāo)識string64Y開函機(jī)構(gòu)生成保函唯一標(biāo)識6guaranteeAmt擔(dān)保金額string64Y7validTimeStart保函生效時間起string20Yyyyy-MM-ddhh:mm:ss8validTimeEnd保函生效時間止string20Yyyyy-MM-ddhh:mm:ss9letterOfTime出函時間string20Yyyyy-MM-ddhh:mm:ss10companyName企業(yè)名稱string50Y11 以下字段當(dāng)支付成功時有值12payTime支付時間string20Yyyyy-MM-ddhh:mm:ss13payAmt支付金額string64Y精確到小數(shù)點(diǎn)后兩位小數(shù)14payType支付方式string2Y01網(wǎng)銀轉(zhuǎn)賬02微信支付03支付寶支付04其他支付方式響應(yīng)參數(shù)：序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述保函文件查詢交互流程如圖：電子履約保函文件獲取流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/api接口交易碼ELY103接口提供者金融機(jī)構(gòu)接口消費(fèi)者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺功能描述開函成功后金融服務(wù)平臺根據(jù)金融機(jī)構(gòu)返回的文件ID向金融機(jī)構(gòu)獲取保函文件備注該接口采用數(shù)字信封方式進(jìn)行數(shù)據(jù)傳輸，詳見8.3.3請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1applicationId申請編號string32Y保函申請訂單的唯一編號響應(yīng)值描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述3guaranteeFileName文件名string255YguaranteeFileContext電子保函文本string-Y（BASE64必須是此方法，不可修改）方法：java.util.Base64.Decoderdecoder

=

Base64.getDecoder();保函驗(yàn)真交互流程如圖：驗(yàn)證通知接口流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/api接口交易碼ELY104接口提供者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺接口消費(fèi)者金融機(jī)構(gòu)功能描述金融服務(wù)平臺向金融機(jī)構(gòu)發(fā)起電子保函簽名服務(wù)，查驗(yàn)保函文件真?zhèn)危?yàn)證簽名有效性備注該接口采用數(shù)字信封方式進(jìn)行數(shù)據(jù)傳輸，詳見8.3.3請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1guaranteeId保函唯一標(biāo)識string64Y2guaranteeData保函文件textYBase64文件流響應(yīng)參數(shù)：序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述3guaranteeId保函唯一標(biāo)識string64Y4status驗(yàn)簽狀態(tài)string10Y01:驗(yàn)證成功02:驗(yàn)證失敗5certNum證書序列號string150Y6certOwner證書所有者string100Y7certBgginTime證書有效期開始時間string20Yyyyy-MM-dd8certEndTime證書有效期截止時間string20Yyyyy-MM-dd9certAuthor證書頒發(fā)者string100Y10signTime簽章時間string20Yyyyy-MM-ddhh:mm:ss索賠申請推送交互流程如圖：索賠申請推送接口流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/api接口交易碼ELY105接口提供者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺接口消費(fèi)者金融機(jī)構(gòu)功能描述采購人向金融機(jī)構(gòu)發(fā)起索賠申請，金融服務(wù)平臺向?qū)?yīng)的金融機(jī)構(gòu)提交索賠信息請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1guaranteeId保函唯一標(biāo)識string32Y2bidNum標(biāo)段標(biāo)號string128Y3projectName項(xiàng)目名稱string128Y4projectCode政府采購統(tǒng)一項(xiàng)目編號string50Y政府采購統(tǒng)一項(xiàng)目編號5companyName企業(yè)名稱string255Y投保企業(yè)名稱6socialCreditCode企業(yè)統(tǒng)一社會信用代碼string64Y投保企業(yè)統(tǒng)一社會信用代碼7purchaseName采購人名稱string256Y受益人8purchaseSocCode采購人組織機(jī)構(gòu)代碼string64Y受益人組織機(jī)構(gòu)代碼/統(tǒng)一社會信用代碼9claimAmount索賠金額string64Y10claimReason索賠理由string255Y索賠理由11openBank索賠機(jī)構(gòu)開戶行string255Y12bankAccount索賠機(jī)構(gòu)開戶賬戶string255Y13contract索賠發(fā)起人string255Y經(jīng)辦人14contractway發(fā)起人聯(lián)系方式string50Y經(jīng)辦人聯(lián)系方式15contractCertCode發(fā)起人身份證號碼string18Y經(jīng)辦人身份證號碼響應(yīng)值描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述理賠結(jié)果通知交互流程如圖：金融機(jī)構(gòu)理賠結(jié)果通知接口流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/bh/api接口交易碼ELY106接口提供者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺接口消費(fèi)者金融機(jī)構(gòu)功能描述金融機(jī)構(gòu)理賠成功后向金融服務(wù)平臺推送理賠結(jié)果請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1guaranteeId保函唯一標(biāo)識string64Y開函機(jī)構(gòu)生成保函唯一標(biāo)識2status理賠狀態(tài)string10Y00:理賠受理中01:理賠成功02:理賠失敗3paymentMoney理賠金額string64N理賠成功時有值4paymentBeneficiary理賠受益人string25N5paymentBeneficiarySocial理賠受益人組織機(jī)構(gòu)代碼string64N6paymentTime理賠時間string20N理賠成功時有值（yyyy-MM-ddhh:mm:ss）響應(yīng)參數(shù)：序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1code響應(yīng)狀態(tài)string3Y000表示成功，其他均為失敗參照10.12message響應(yīng)描述string200N如果響應(yīng)失敗，則為失敗的描述保函失效通知交互流程如圖：保函失效通知接口流程示意圖接口調(diào)用地址https://{www.***.com}/bankservice/api接口交易碼ELY107接口提供者內(nèi)蒙古自治區(qū)政府采購金融服務(wù)平臺接口消費(fèi)者金融機(jī)構(gòu)功能描述金融服務(wù)平臺向金融機(jī)構(gòu)發(fā)起電子履約保函失效通知備注請求參數(shù)描述序號參數(shù)參數(shù)名稱參數(shù)類型參數(shù)長度必填說明示例值1guaranteeId保函唯一標(biāo)識string64Y2invalidTime保函失效時間string20Yyyy