DB3502T 064.3-2021 建设工程电子投标保函平台 第3部分：接入规范　

3502E-biddingguaranteeplatformofconstructionengineeringPart3:Interfacespeci2021-09-28发布I 本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定本文件为DB3502/T064《建设工程电子投标保函平台》的第3部分。DB3502/T064已发布了以下部实现电子投标保函的互联网+监管。DB3502/T064拟由三——第2部分：运行管理，目的在于规范平台管理和应用，作——第3部分：接入规范，目的在于规范平台的设计、软件1建设工程电子投标保函平台第3部分：接入规范本文件适用于建设工程电子投标保函平台与外部系统和内部系统之间的接GB/T38540信息安全技术安全电子签章密码DB3502/T064.1建设工程电子投标保函平台第1部分：总体DB3502/T064.2建设工程电子投标保函平台第2部分：运行DB3502/T064.1-2021和DB3502/T064.2-2021界定的术语和定义适用于本文4符号和缩略语AES：密码学中的高级加密标准（AdvancedEncryCA：电子认证服务（CertificateAuthGUID：全局唯一标识符（GloballHASH：散列函数（HashFunctioMD5：MD5信息摘要算法（MD5Message-DigestAlgorithm）PDF：便携式文档格式（PortablXML：扩展性标识语言（eXtensibleMarkupLa5.1工程担保保证人业务系统或第三方网络平台对接要求——具备电子投标保函申请、修改、退保、理赔等功能；2——受益人信息；——投标人信息；5.1.3银行业金融机构、工程担保公司和保险公司开具的电子投标保函格式应符合各类工程建设项目5.2电子投标保函文件格式标准及实现要求5.2.1电子投标保函文件电子投标保函文件元数电子投标保函文件元数据属性Cus<ofd:CustomDataName="电子投标保函编号">...</ofd:<ofd:CustomDataName="担保额度">...</of<ofd:CustomDataName="保费">...</ofd:<ofd:CustomDataName="招标项目编号">...</ofd:<ofd:CustomDataName="招标项目名称">...</ofd:<ofd:CustomDataName="标段编号">...</ofd<ofd:CustomDataName="标段名称">...</ofd<ofd:CustomDataName="投标人名称">...</ofd<ofd:CustomDataName="投标人统一社会信用代码">...</ofd:<ofd:CustomDataName="招标人名称">...</ofd<ofd:CustomDataName="招标人统一社会信用代码">...</ofd:<ofd:CustomDataName="工程担保保证人名称">...</ofd:<ofd:CustomDataName="工程担保保证人统一社会信用代码">...</ofd:3电子投标保函文件电子签章电子投标保函附件文件——应包括电子投标保函基本信息、受益人信息、投标人信息、招标项目和标段信息、工程担保——有且只能有一个根元素，为<DZBH>；5.3数据元素5.3.1结构化数据信息节点的MD5值（DZBHMDDZBHMD5为对DZBHINFO整个节点的字符串进行去除空格，转大写后获取的MD5哈希值，用于验证5.3.4电子投标保函编号（GUARANTEE4否否否否NUM(20)否AMOUNTNUM(20,6)否NUM(20,6)否否否否否是否否否NUM(20)否否是5.3.6受益人信息(BENEFICIARY_INF否BENEFICIARY_CREDIT_否BENEFICIARY_BANK_ACC否否BENEFICIARY_BANK_OPEN否否BENEFICIARY_CONTACT否5.3.7投标人信息(BIDDER)5否否否否否BIDDER_CONTACT_IDCARD_否否否否否否否是是否否否否NUM(20,6)否否否否否否否否否），否否否否否否6NUM(5)否NUM(20)）（否否否招标文件大写MD5码否5.3.9工程担保保证人信息(GUARANTO否否否GUARANTOR_LEGAL_IDCAR否否否否否否是否否GUARANTOR_TECHNOLOG否否否否否否否否7是否否AMOUNTNUM(20,6)否否否否否否否是否否是5.3.11附件信息(GUARANTEE_ATTACHME否WARRANTY_MD5否WARRANTY_PDF_FILE_NA否否否否否否否否BUSINESS_LICENSE_FILE_否否是是8平台图1电子投标保函平台接口架构图该接口地址由工程担保保证人业务系统或第三方Content-Type:application/x-www-form-urlencoded;charse工程担保保证人业务系统或第三方网络平台申请接入时需提供接口地址，并确保接口工作正参数说明参数说明(含义、枚举值、格式、示例)1字符串是账户标识2字符串是3字符串是4字符串是5字符串是6字符串是时间戳，格式(yyyyMMddHHmmss)7字符串是1字符串是操作成功返回true,失败返回false2字符串否3字符串否4字符串否96.2.2工程担保保证人业务系统或第三方网络平台接收申表9工程担保保证人业务系统或第三方网络平台该接口地址由工程担保保证人业务系统或第三方Content-Type:multipart/form-data;charset=utf1APPID是2APPLY_ID是3是4APPLY_INFO是5是","TENDER_PROJECT_","TENDER_PROJECT_","TENDERER_CREDIT_COD信用代码","TENDERER_BANK_CODE":"行账号","TENDERER_BANK_OPENBANK":人银行账户名称","TENDERER_CONTACT":人联系人","TENDERER_CONTACT_TEL":5是（YYYYMMDDHHMMSS）","BID_B担保额度大写","TENDER_NOTI告地址","TENDER_NOTICE_ISSUE_TIME":"招标公告发布时间","TENDER_FIL6是","BIDDER_CREDIT_CO人姓名","BIDDER_CONTACT_TEL":电话","BIDDER_CONTACT_IDCARD_TYPE投标人证件号码","BIDDER_ADDRESS"","LEGAL_PERSON_IDCARD_TYP代表人身份证件类型","LEGAL_PERSON_7是7是","RECEIVE_ADDRESS":"增值税电子普通发票不提供"BANK_CODE8是9是是是1是2否3否4否 6.2.3电子投标保函平台接收电子投标保https://*****/authorize/api/rContent-Type:multipart/form-data;charset=utf1APPID是2APPLY_ID是3是4是5是6是1是2否3否4否 6.2.4工程担保保证人业务系统或第三方网络平台接收电子投标保函申请单盖章工程担保保证人业务系统或第三方网络平台接收电子投标保函申请单盖章文件表11工程担保保证人业务系统或第三方网络平台接收电子投标保函申请该接口地址由工程担保保证人业务系统或第三方Content-Type:multipart/form-data;charset=utf投标人在电子投标保函平台填写所有申请信息并完成相1APPID是2APPLY_ID是3E是4是5是MD5":"...","FILETYPE":|ORDER_PDF（盖章PDF文件）"}]6FILEKEY对应的值是7是8是1是2否3否4否-https://*****/authorize/api/reContent-Type:application/x-www-form-urlencoded;charset=utf-8工程担保保证人业务系统或第三方网络平台中的核保状1APPID是2APPLY_ID是3AUDIT_STATUS是4AUDIT_TIME是核保时间，格式（yyyy-MM-dd5否6否7否8是9是1是2否3否4否-https://*****/authorize/api/rContent-Type:application/x-www-form-urlencoded;charset=utf-8工程担保保证人业务系统或第三方网络平台中的支付结1APPID是2APPLY_ID是3是4是支付时间，格式（yyyy-MM-ddHH5否6是7是1是2否3否4否-6.2.7电子投标保函平台接收发票、到账https://*****/authorize/api/rContent-Type:application/x-www-form-urlencoded;charset=utf-81APPID是2APPLY_ID是3是4是5否6是7是1是2否3否4否 6.2.8电子投标保函平台接收加密的电子投标保函文件及信表15电子投标保函平台接收加密的电子投标保函文件https://*****/authorize/api/rContent-Type:multipart/form-data;charset=utf工程担保保证人业务系统或第三方网络平台生成电子投1APPID是2APPLY_ID是3是4是5是6是7是8是9是1是2否3否4否-6.2.9工程担保保证人业务系统或第三方网络平台接收电子投标保函退保工程担保保证人业务系统或第三方网络平台接收电子投标保函表16工程担保保证人业务系统或第三方网络平台接收电子投标保该接口地址由工程担保保证人业务系统或第三方Content-Type:multipart/form-data;charset=utf投标人在电子投标保函平台填写退保申请信息并完成相1APPID是2APPLY_ID是3是4是MD5":"..."}]5FILEKEY对应的值是6是7是1是2否3否4否-6.2.10电子投标保函平台接收保函https://*****/authorize/api/rContent-Type:application/x-www-form-urlencoded;charset=utf-8工程担保保证人业务系统或第三方网络平台中出现投标1APPID是2APPLY_ID是3AUDIT_STATUS是4AUDIT_TIME是退保时间，格式（yyyy-MM-ddHH5否6否7是8是1是2否3否4否-6.2.11工程担保保证人业务系统或第三方网络平台接收受益人索赔工程担保保证人业务系统或第三方网络平台接收受益人索赔申请表18工程担保保证人业务系统或第三方网络平台接收受益人该接口地址由工程担保保证人业务系统或第三方Content-Type:multipart/form-data;charset=utf受益人需要申请索赔时，在电子投标保函平台中填函平台通过该接口将相关信息推送到工程担保保证人业1APPID是2是3是"CLAIM_NO":"理赔申请编号","AM4是","TENDER_PROJECT_","SECTION_NAME":"标段名称""招标人","TENDERER_CREDIT_CODE":地址","INVITE_TYPE":察、设计等）","TENDER_PROJECT_TYPE"标项目类别","BID_OPEN_TIME":"）（5是6是7是8是9是1是2否3否4否-6.2.12电子投标保函平台接收理https://*****/authorize/api/rContent-Type:application/x-www-form-urlencoded;charset=utf-8工程担保保证人业务系统或第三方网络平台在理赔流程1APPID是2是息3是4AMOUNT否5否6否7否8否9否是是1是2否3否4否 6.2.13工程担保保证人业务系统或第三方网络平台退工程担保保证人业务系统或第三方网络平台退保表20工程担保保证人业务系统或第三方网络该接口地址由工程担保保证人业务系统或第三方Content-Type:multipart/form-data;charset=utf投标人申请退保时需下载对应的退保模版，并按模版填无6.2.14电子投标保函平台接收工程担保保证人客户须表21电子投标保函平台接收工程担保保证人https://*****/authorize/api/reContent-Type:application/x-www-form-urlencoded;charset=utf-81APPID是2NOTICE_ID是3NOTICE_TITLE是4是5NOTICE_TIME是6NOTICE_URL否7是8是1是2否3否4否 Content-Type:application/x-www-form-urlencoded;charset=utf-81否2否3是4是1是2msg否3否4否5否"V_TENDER_FILE_URL":"investProjectCode":"tenderBankname":"5否6否7否8否9否https://*****/authorize/api/rContent-Type:application/x-www-form-urlencoded;charset=utf-81APPID是2是3是4是5是1是2否3否4否-A-A01-A02-A03-A04 A05-A06A07-A08 A09 A10 A11-A12-A13A14A97-A98-A99-B --C- -D-- -E---F G--H-- I -Z- -- --- --1-2-3-4-9 --- ---- --- ---- --- ---- -签名规则A.1签名通用步骤说明小到大排序（字典序使用URL键值对的格式（即key1=value1&ke•参数名ASCII码从小到大排序（字典序•接口可能增加字段，验证签名时必须支持增加的扩展字段。stringSignTemp进行MD5运算，再将得到的字符串所有字符转换为大写，得到sign值A.2签名生成示例"APPID":"f810a9e4984a11e9a3490"BIDDER":"fd269701984a11e9a34stringA="appID=f810a9e49fd269701984a11e9a349000c29188e1f&timeStamp=2019stringSignTemp=stringA+"&key=5faf2b73984b11e9a349000c29188e1f"//注：ksign=DigestUtils.md5Hex(stringSignTemp).toUpperCase()="518976F30A0660834D3358B0{"appID":"f810a9e4984a11e9a3490"orderIDs":"fd269701984a11e9a34"certID":"01828138984b11e9a3490"sign":"518976F30A0660834D}<?xmlversion="1.0"encoding=<!--对DZBHINFO整个节点的字符串去空格，转大写，获取对应<TENDER_INFOAPPROVAL_CODE=""TENDER_PROJECT_CODE=""...<GUARANTORGUARANTOR_NAME=""GUARANTOR_CREDIT_CODE=""..<BIDDERBIDDER_NAME=""BIDDER_CREDIT_CODE=""<GUARANTEE_INFOSERVICE_BEGIN_TIME=""SERVICE_END_TIME=""...><<BENEFICIARY_INFOBENEFICIARY=""BENEFICIARY_CREDIT_CODE=""...></B<GUARANTEE_ATTACHMENTGUARANTEE_URL=""GUARANTEE_FILE_NAME=""...></GUARANT<INVOICE_INFOINVOICE_TITLE=""INVOICE_NO=""...><接口示例C.1工程担保保证人业务系统或第三方网络平台投标人购买资格核验*publicstaticvoidmain(String[]a{//工程担保保证人业务系统或第三方网络平台投Map<String,String>params=newHashMap<String,String>params.put("APPID","d6783f915a3111ebb946000c291params.put("BIDDER_NAME","XXX有限公params.put("BIDDER_ORG_CODE","XXXXXXXXXXXXXparams.put("GUARANTOR_CREDIT_CODE","XXXXXXXXXXXXXXXparams.put("GUARANTOR_NAME","XXX保险公司"params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sStringresult=HttpClientUtils.doPost(url}C.2工程担保保证人业务系统或第三方网络平台接收申请信息*publicstaticvoidmain(String[]a{//工程担保保证人业务系统或第三方网络Map<String,String>params=newHashMap<String,String>params.put("APPID","d6783f915a3111ebb946000c291//由电子投标保函功能模块生成的申请标识32位UUID码（电子投标保函修改时发送APPLY_ID与申请时一params.put("APPLY_ID","467e4b065a2811ebb946000c2918//密钥串，用于加密电子投标保函文件OFD（使用保证人公钥加密的密文，保证人params.put("SECRET_KEY","XXXXXXXXXXXXXXXparams.put("APPLY_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}");//Json格式的招标申请信息（使用工程担保保证人公钥加密params.put("TENDER_INFO","XXXXXXXXXXXparams.put("BIDDER","{\"XX\":\"XXX\",\"XX\":\"XXX\"}"params.put("INVOICE","{\"XX\":\"XXX\",\"XX\":\"XXX\"}");StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sStringresult=HttpClientUtils.doPost(url}C.3电子投标保函平台接收电子投标保函申请*publicstaticvoidmain(String[]a{Map<String,Object>params=newHashMap<String,Object>params.put("APPID","eab408905a2511ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("FILEMD5","XXXXXXXXXXXXXXparams.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStr(Stringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sFilefile=newFileStringurl="https//****/authorize/api/reqStringresult=HttpClientUtils.doFileUpload(url,nul}C.4工程担保保证人业务系统或第三方网络平台接收电子投标保函申请单盖章文件*publicstaticvoidmain(String[]a{//工程担保保证人业务系统或第三方网络平台接收电子投标保Map<String,Object>params=newHashMap<String,Objeparams.put("APPID","d6783f915a3111ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("GUARANTOR_CREDIT_CODE","XXXXXXXXXXXXXXXparams.put("GUARANTOR_NAME","XXX保险公司"params.put("FILES_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}"params.put("TIMESTAMP","20200101010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUppparams.put("SIGNATURE",sFilefile=newFileparams.put("FILEKEY对应的值",iStringresult=HttpClientUtils.doFileUpload(url,nul}*publicstaticvoidmain(String[]a{Map<String,String>params=newHashMap<String,String>params.put("APPID","eab408905a2511ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("AUDIT_STATUS",//核保时间，格式（yyyy-MM-ddHH:mparams.put("AUDIT_TIME","2020-01-0101:01:01params.put("APPLICATION_NO","XXXXXXparams.put("REASON"params.put("PAY_URL","http://**params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpperCparams.put("SIGNATURE",sStringurl="https//****/authorize/api/reStringresult=HttpClientUtils.doPost(urlSystem.out.println(re}*publicstaticvoidmain(String[]a{Map<String,String>params=newHashMap<String,String>();params.put("APPID","eab408905a2511ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("PAY_STATUS",//支付时间，格式（yyyy-MM-ddHH:mparams.put("PAY_TIME","2020-01-0101:01:01params.put("POLICY_NO","XXXXX//时间戳，格式（yyyyMMddHHparams.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStr(Stringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",siStringurl="https//****/authorize/apiStringresult=HttpClientUtils.doPost(url}C.7电子投标保函平台接收发票、到账凭证*publicstaticvoidmain(String[]a{Map<String,String>params=newHashMap<String,String>params.put("APPID","eab408905a2511ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("INVOICE_STATUS",params.put("INVOICE_URL","http://***params.put("VOUCHER_URL","http://*params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sStringurl="https//****/authorize/api/reStringresult=HttpClientUtils.doPost(url}C.8电子投标保函平台接收加密的电子投标保函文件及信息*publicstaticvoidmain(String[]a{Map<String,Object>params=newHashMap<String,Object>params.put("APPID","eab408905a2511ebb946000c29188eparams.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("GUARANTEE_NO","XXXXXparams.put("OFDMD5","XXXXparams.put("SOFDMD5","XXXXXXparams.put("STATUS",params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sFilefile=newFileInputStreamis=neparams.put("SOFDFILE"Stringurl="https//****/authorize/api/rStringresult=HttpClientUtils.doFileUpload(url,nul}C.9工程担保保证人业务系统或第三方网络平台接收电子投标保函退保申请*publicstaticvoidmain(String[]arg{//工程担保保证人业务系统或第三方网络平台接收电子Map<String,Object>params=newHashMap<String,Object>params.put("APPID","d6783f915a3111ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c29188params.put("SURRENDER_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}"params.put("FILES_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}"params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUppparams.put("SIGNATURE",sFilefile=newFileparams.put("FILEKEY对应的值",iStringresult=HttpClientUtils.doFileUpload(url,nul}C.10电子投标保函平台接收保函退*publicstaticvoidmain(String[]a{Map<String,String>params=newHashMap<String,String>params.put("APPID","eab408905a2511ebb946000c291params.put("APPLY_ID","467e4b065a2811ebb946000c2918params.put("AUDIT_STATUS",//退保时间，格式（yyyy-MM-ddHH:mmparams.put("AUDIT_TIME","2020-01-0101:01:01params.put("SURRENDER_FILE_URL","http://**params.put("REASON"params.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sStringurl="https//****/authorize/api/rStringresult=HttpClientUtils.doPost(url}C.11工程担保保证人业务系统或第三方网络平台接收受益人索赔申请*publicstaticvoidmain(String[]a{//工程担保保证人业务系统或第三方网络平台接Map<String,Object>params=newHashMap<String,Object>params.put("APPID","d6783f915a3111ebb946000c291params.put("CLAIM_ID","ddb84afe5a2e11ebb946000c29188e1f");params.put("CLAIM_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}"params.put("TENDER_INFO","{\"XX\":\"XXX\",\"XX\":\"XXX\"}");params.put("FILE_MD5","XXXXparams.put("FILE_NAME","XXXXXparams.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=DigestUtils.md5Hex(stringSignTemp).toUpparams.put("SIGNATURE",sFilefile=newFileInputStreamis=newFilStringresult=HttpClientUtils.doFileUpload(url,nul}*publicstaticvoidmain(String[]a{Map<String,Object>params=newHashMap<String,Object>params.put("APPID","eab408905a2511ebb946000c291params.put("CLAIM_ID","ddb84afe5a2e11ebb946000c2918params.put("STATUS",//赔付款支付时间，格式（yyyy-MM-ddHparams.put("PAY_TIME","2020-01-0101:01:01params.put("REASON"params.put("FILE_MD5","XXXXparams.put("FILE_NAME","XXXXXX.XXXparams.put("TIMESTAMP","2020010101StringstringA=UtilSign.splicingStStringsign=