公共资源交易电子保函数据规范.docx

ICS?CCS?DB4419东莞市地方标准DB4419/XXXXX-XXXX公共资源交易电子保函数据规范2024-XX-XX实施2024-XX-XX发布东莞市市场监督管理局发布目次而言InI范围42规范性引用文件43术语和定义43.1公共资源交易中心43.2佥融机构A3.3招标人43.4投标人43.5电子保函3.6电子保函服务接口44总体要求51. 1电子保函信息组成54. 2传输要求55业务说明85. 1业务流程85.2业务步骤116基础信息I1.6.1保函范本信息126.2金融机构信息126.3投标人信息126. 4招标人伯息136.5J目标段信足137业务信息137. 1保函开立信息137.2 保函续期信史IJ7.3 保函关联信息M7.4 保南关联信息推送157.5 保函担保结束信息167.6 索赂业务信息177.7 投标人实名认证信息18附录A（燃能性）国密加密算法示例代码19附录B（烷范性指令类型20网录C（规莅性状态码21附录D（规范性）团体证件类型22参考文献23I1.本文件按照GB/T1.1-20204标准化工作导则第1部分：标准化文件的结构和起草规则3的规定起草。请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的贪任.本文件由东莞市公共资源交场中心提出.木文件由东莞市政务服务和数据管理局归口。本文件起草单位：东莞市政务服务和数据管理局、东莞市公共资源交易中心、东莞银行股份有限公司、东莞市清软斯维尔信息技术有限公M本文件主要起草人：李俊华、熊瑶、洪松远、用钱安、孔相、黄汉文、姚会奇、潘海泉.I1.1.公共资源交易电子保函数据规范1葩国木文件规定了公共资源交易电子保函数据应用的总体要求、基础信息、业务说明和业务信息，本文件适用于公共资源交易招标投标活动中电子保函数据的管理与应用。2规葩性引用文件下列文件中的内容通过文中的规范性引R1.而构成本文件必不可少的条款。其中.注日期的引用文件.仅该H期对应的版本适用于本文件：不注H期的引用文件,其最新版本（包括所有的修改监）适用于本文件.GB/T12406表示货币的代码3术语和定义下列术语和定义适用于本文件.3.1 公共资源交易中心公共资源交易中心是负费公共资源交易和提供咨询、服务的机构，以下简称交易中心.3.2 金融机构本燃范中所提及的金融机构包括提供电子保函开函服务的惕行、保险公司、担保公M等机构.即电子保函担保人.3.3 招标人提出招标项目并进行招标的法人或其他组织,接受保函并享有其利益的一方.3.4 投标人响应招标并参加投标竞争的法人或其他组织，电子保曲中谙人。3.5 电子保函金融机构应投标人的请求，以数据电文为软体，利用电子通信手段，向招标人开立的具有法律效力的担保凭证.3.6 电子保函服务接口电子保函服务接口是指由交易中心与金融机构共同构建的、实现让电子保函相关数据信息在交易中心系统与金融机构业务系统之间进行数据交互和传输的标准或协议4.1电子保函信息组成电子保调信息包拈堪础信息、业务信息.携础信息图保函花本信息、金融机构信息、招标人信息、投标人信息和招标项目信刖如成.业务信息由保函开立信息、保函续期信息、保函关联信息,保函担4.2传输要求4.2.1协议要求东莞公共货源交易中心系统与金融机内系统间的接口对接采用HTTPS协议，发送和返回的数据均为JS(W格式。请求使用IJoST请求，全部接口使用UTF-8编码。4.2.2数据加密要求数据传怆中请求参数、响应参数中规定data数掘内容,全部栗用国雷SN2W法进行加密，加淤流程为；原文uft8编码一SM2加密。4.2.3数据格式要求4.2.3.1Header设置对接交易中心接口时，除获取IOken的接口以外,Header都要按以卜设置:Headers:(*Authorization*:*access.token*,*Content-Type*:*app1.icaiionjson*42.3.2接口通用格式接1.1.通用格式见表1.入数参数代种参政名称数据类空参皎说明banksn金融机构垢叫字符型businesscode指令类X1.字符型详见附录Bdata业务致榭字符型行3种类型数空字符申：未加密的单个字符中:对JS3格式的数据使用SM2柒法加变后的密文.ti(MstanpITtff1.IH字符型时间St放字（1.0NG的字符申类如signature签名值字符型待器名的字符串(SignStr)格式如下：*1.itnc?xt;mp,biinksn.busincsscdr.accrxs;token,dzU".总共5郃分.祗慕分如果无内容妫埴入空字符¢.不含其中的理9”J1.中，；KxC3与tckm为已获取的6效tok<n9使用SM3靛法对字符小SisnStr进行计算生成signature假设有以下ibtin'tim-*timextanp*fbnksn-*banksn*.accesstoken=*accesstoken*data=*(iaia*.示例hksinosscode=*bsinesscode"8ignStr=*,ti11estMp1.>anksnbusinesscodeaccessIokendata*:示例2：bsinesscode=*signStr=*tinestatrp1.mnksnaccesstokendata*iff求依示例("bankM':“金融机构输号”.*busincxxcod<*:"999”,*data*ti11estamp*:"1M183D3","汶igmi:计算得到的签名字符卡Ihi誓acrrcod状态码字符型rr为成功,其他为失败，见附录c.GrESg状态描逑字符型data业务致IK字符型对JSON格式致薪使用SU2茸法加密后的密文.Iim<tanp时间跋字符型时何做,数字(Ios的字符小类里.signature签名值字符型将宠名的字符那(SignStr)格式I*timesta11p.banksn,businesscode,data*.总共5部分.用SJ分如果无内容则填入空字符*.不含其中的“过号其中banksn为传入的金饿机构i码.Ixisinesscodc为佞入的Ifi令类型.accesstoken固定为空字符申.使用SM3籁法对字符中SisnStr进行计算生成signature。示例请参子粕入参数相应部分.&H值示例I*crrcnde*z*1.(IO*,rr昭成功二41*access.token":"XXX",'expiresi11*:ISOO1.*ti11estamp*:"】MI83D34",“sigrwur;计虢得到的绥名字符；1；"4.2.3.3其他格式要求(1)所有接口多数(JSON)的名称统一使用小写字母，时MJefe(Iimestaw)为数字(1.ONG)的字符串类型,如：*1641183034*.(3)JSO格式业务数据中数(ft字段内容需转换为字符串.(4)JSoN格式业务数据中11期时间字段，统一格式为：年用4位数字、月用2位数字、H用2位数字、时用24小时制、分用2位数字、秒用2位数字组合而成,不足位数的前面用0补上，形式如：yyyy-na-ddhh24:i:ss"，中间没有空格及横线.如“20220107090205”，表示2022年1月7日早上9点2分5杪.4.2.4数据类型说明数据类里时应的说明与格式见下表2表2数据类型说明我数据提51说明皎据格式字符星切可以&1小打印的字符.包括汉字、字母.数字'各种符与、空格等不具有计算健力.以大写字母"C”代表字符型Iex：装示定长为“X”的字符型敷咽C.X:表示Jtt代为“X”的字符型数据元值；C.U1：表示K度不陶定的字符型i据元值。数侑?H可以进行牧学运算的数据.以大写字母"N”代表代位型I义4:表示我长为"X-的数俶型数据元依：V.X,y:表示总长度为“X”位、其中小数点后为-y"位的救也型数据元值，时间H期里用以表示H期及时间的数据.应好令4.2.3.3耳他格式耍求.5业务说明5.1 业务流程业务流程由项目招标信息发布、匿名保函开立、项目签到关联保函、保函续期、担保结束和保函索赔业务环节组成.电子保函业务流程详见图2、图3.电广保函业务施程（交易中心1.j金融机构交”.部分）1S-S3-5投打人申卑保京饺用wa0½三MHS*iMMf1.滨由EE木：IgM灶理5.2 业务步骤5.3 .1项目发布招标人登录交易中心系统,填写并完成JS程项目发布流程后，项目的招标公告信息在网上公示.投标人可通过互岷网或登录交易中心系统杳看招标公告信息，5.4 2.2匿名保函开立投标人在金融机构业务系统中谛开立匿名保函,录入保函基本信息、投标人基本信息，其中投标淹水号是H1.金融机构通过电子保函极务接口向交易中心获取的,完成信息填写后向金融机构申请电子保函开立，金融机构检查投标人缴纳手续交的转账账户必须为投标企业基本账户，金融机构业务系统确认投标人保函手续把徼纳情况后，对投标人开函申请i行审核，审核通过后开立匿名电子保函，金融机构业务系统在开函成功后将匿名保函信息通过电子保函留务接I推送至交易中心系统.5.5 .3保函续期根据工程项目的招标信息调整或其他情形导致电子保函需诳行续期时，投标人可在金融机构业务系统中清保函续期，金融机构业务系统审核投标人电子保函续期审核，审核通过后进行电子保函续期，金融机构业务系统在电子保函续期后将保函续期信息通过电子保函服务接口推送至交易中心系统.5.6 .4项目签到保函关联投标人签到，选择符合项目保证金金额要求和保函有效期要求的有效匿名电子保函进行关联，经过交易中心与金融机构间的二次确认明确/电子保函与项目的关联关系.5.2.4.1保函关联信息推送投标人签到完毕后，交易中心系统将保函唯一识别怕息、招标项目相关佰恩通过电子保函服务接口推送至金融机构业务系统。金融机构根据保南信息，牛.成电子保函保单，供招标人、投标人查询和核实.5.2.4.2保函关联成功信息推送金融机构业务系统收到交易中心系统保函项目为岷指令后，将已开出的电子保函与招标项目完成关联，电子保函信息要素补充完整后，正式生成电子保函文件，金融机构业务系统处理项目关联完毕后.回词交易中心系统传给完整的电子保函信息.5.2.5保函索赔当投标人违反招标文件约定或其他情形，招标人可依法申请保函索赔。招标人在金融机构业务系统发起索赔申请,按要求填”索赔信息并提供证明材料，金融机构接收到索赔申请后,按照索贴流程，进行索赔处理.5.2.6担保结束电子保函所担保的特定W项已经完成或终止，交易中心系统将保函担保站束信息通过电子保函服务接口推送至金融机构业务系统，根据实际的业务场景可以分为招标人发起担保站束和投标人发起担保结束两种情况。5. 2.6.1招标人发起担保结束1.i招标结束，招标人把已完成IF1.签到的电子保函通过交易中心系统向佥融机构业务系统发出担保结束信息.金融机构接收后，按照业务流程和实际业务情况办理担保结束业务.6. 2.6.2投标人发起担保结束未关联项目的电子保函，投标人可发起担保结束事项.投标人通过交易中心系统向金融机构业务系统发出担保结束信息.金融机构接收后，按照业务流程和实际业务情况办理担保结束业务。7. 1保函本信息保函基本信息见表3。表3保函基础信息信名称I英文名称数据类型I数据格式I必加限备注投保流水号INSURE_SNJX1.DE字符型C.50是电子保函/保证保险编号GuarantEE-CODE字符里C.50是投保生效时间Va1.ii1.startjime字符型C.20是投保有效期至VA1.ID_ENDJnME字符型C.20是投保金新INSURE_AH0UNTN.20,6是投保金额大写INSURi1.AMOUNTGM,ITA1.字符型C.100是投保金额币种INSURECuRRENCY_CODE字符型C3是采用GB/T12406£表示货币的代码的数字码,例如：人民币是156款项说明INSIJRE.DESCRIPTION字符型C.500否6.2金融机构信息金融机构信息见我4.去I金融机的信息表名馀I英文名称I数据类型I数抿格式I必地项备注投保流水号INSURE_SN_CoDE字符型C.50是金融机构编码F1.CODE字符型C.50是金融机构名称FI_NAiE字符型C.500是金融机构联系人F1.CONTACTOR字符型C.50是金融机构联系电话F1._C()NTACT_N1.'M1.iER字符型C.50是6.3投标人信息投标人信息见去5。表5投标人信刖表名称I英文名称数据类型数据格式必填项法注投标人统社会信用代码Bn)DERJ)RG/01比字符型C.30是投保流水号INSURE_SN_CODE字符型C.50是电子保函/保证保险编号GUARANTEE_C0DE字符型C.50是投标人户名Biddei1.acoountJJAME字符型G.300是投标人账号BIDDERjurOCN1.NO字符型C.50是企业基本账户账号BAS1(1.ACCOIJNTNO字符型C.50是企业基本账户开户行basijbnk字符型C.100是投标人联系人姓名BIDDERCOWACTOR字符型C.50是投标人联系人身份证号码BI(X)ER_CONTACTOR_ID-CARD字符型C.100是6.4招标人信息招标人信息见表6。我6招标人信息表名称英文名称I数据类型I数据裕式I必填项备注投保流水号INS1.JRE_SN-CODE字符型C.50是电子保函/俣证保除编号GUARANTEEeOODE字符型C.50是招标人名称TENDRREE.NAME字符型C.300是招标人证件类型TENDEREE_C0DE_TYPE字符型C.20否见附录D招标人证件号码TENDEREE_C0DE字符型C.100否招标人联系人名称侬DEREEmTRCTOR字符型C.200否招标人地址TENDEREEeADDRESS字符型C.100O否6.5项目标段信息项目标段信息见去7。表7项目标段信息表名称I英文名称必填项备注投保流水号INSURE一Sf1.CODE字符型C.50是电子保函/保证保险编号GUARNTEE,CODE字符型C.50是标段唯一码BID_SECTION_ID字符型C.50是招标编号侬DER工ODE字符型C.50是标段名称Bn1.SECTKwNAME字符型G.600是投标文件递交截止时间BIDDOjSUmn1.ENDjIME字符型C.20是担保保证金金额MRG【N_AY()UNT数值型N.20.6是标段合同估算价CONTRK1.RECKoXPR1.CE数值型.20.6否标段合同估算价币种代码CURRENCY工ODE字符型C3否采用GBZT124061表示货币的代码的数字码,例如：人民币是156标段合同估算价单位PR1.CEJJNIT字符型C.20否项目类型PROJEC1.TYPE字符型C.10是是否接受电子保函ACCEPT_1.EnER字符型C.10是是否接受保证保险accept_iNsurance字符型G.10是招标代理名称TENDERjGENCY_NAME字符型C.300否7业务信息8. 1保函开立信息保困开立信息见去8.表8保函开立信息表名称英文名称数据类型数据格式必填项备注投保流水号INSURE_SNvoDE字符型C.50是投标流水号福保持唯一性。由交易中心生成.电子保函/保证保隆编号GuARRNTEE40DE字符型C.50是投标人户名BIDDER_ACeOUN1.NAME字符型C.300是投标人账号BIDDER_AecOUNT_NO字符型C.50是企业基本账户账号BAS1.C_ACCOUNT_NO字符型C.50是企业然本账户开户行BASK1.BANK字符型C.100是投保生效时间VA1.ID_STARTJnME字符型C.20是投保有效期至VA1.ID_ENDjnME字符型C.20是投保金额INSURE.AMOUNT数假型N.20.6是投保金额大写INSCRE-AMoUNTCAPITA1.字符型C.100是投保金额币种INS1.RE_CVRRENC¥_CODE字符型C3是采用GB/T124064表示货币的代码的数字码，例如：人民币是156投标人联系人姓名BIDDER.CONTACTOR字符型C.50是投标人联系人身份证号码B1.DDER_C0NTAcTORmCARD字符型C.100是款项说明INs1.JRE.DESCRIPTION字符型C.500否7.2保函续期信息保函续期信息见表9,表9保函续期信息表名称英文名称数据类型数据格式必填项备注投保流水号NSURE_SN_CODE字符型C.50是唯一性。电子保函/保证保险编号Guaranteecode字符型C.50是投保有效期调整至VA1.ID_END_TIME字符型C.20是7.3保函关联信息保函关联信息见表10.表10保函关联伯恩发央又？""小*那海¾T*涯区南¾1.投保流水号IYSuRE_SN_CODE字符型C.50是唯一性。电子保函/保证保险编号GUARANTEE工ODE字符型C.50是标段唯一码BID_SECTI0N_ID字符型C.50是招标编号TENDER_C0DE字符型G.50是标段名称BID_SECTIONNAME字符型C.600是招标人名称IENDEREE小AME字符型C.300是投标文件递交裁止时间BID1.)OC.S1.BMITENI),TIME字符型C.20是损保保证金金额MARGIN.AMWNT数值型N.20,6是单位：元标段合同估算价CONTRACT_RECKON_PRICE数值型N.20.6否标段合同估算价币种代码CURRENCXCODE字符型C3否采用GB/T12106表示货币的代码的数字玛，例如：人民币是156标段合同估停价单位PRICE-UNIT字符型G.20否单位：元、万元招标人证件类型TENDEREE工ODE_TYPE字符型C.20否招标人证件号码TENDERER.CODE字符型C.100否招标人联系人名称Tenderei1.contactor字符型G.200否招标人地址TENDEREE_ADDRESS字符型C.100O否项目类型PROJEeTjrYPE字符型C.10是是否接受电子保函ACCEPT,ETER字符型C.10是Y-接受：N-不接受；是否接受保证保险ACCEPT_INSURANCE字符型C.10是Y-接受;N-不接受；招标代理名称TENDER_AGEXCJNAYE字符型C.300否7.4保函关联信息推送保区关联成功伯息我见及11衣H保函关联成功信息表名称英文名称数据类型数据格式备注投保流水号INSIRE_SN_COOE字符型C.50是唯一性.电子保函/保证保险编号GaRANTEEyODE字符型C.50是标段瞰一码BID_SECTIONJD字符型C.50是招标编号IENDER_CODE字符型C.50是标段名称BID_SECT10N_NAME字符型C.60()是招标人名称TENDEREENAME字符型C.300是投标人户名B1.M)ER-ACCOUNTJAYE字符型C.300是投标人账号B1.DDfiIUCCoIjN1.No字符型C.50是企业基本账户账号BAS1(1.ACCOUff1.NO字符型C.50是企业基本账户开户行BRS1.qBRNK字符型C.100是投保生效时间VA1.1.D_STARTJIME字符型C.20是投保疗效期至V1.ID.END.TIME字符型C.20是投保金额INSUREju1.oUNT数值型N.20.6是投保金额大写INSURE-AMOUN.CAPITA1.字符型C.100是投保金额币种NSURE_CURRENCY工ODE字符型C3是采用GB/T124064求示货币的代码S的数字码,例如：人民币是156投标人般系人姓名1BIDDER.CONTACTOR字符型C.50是投标人联系人身份证号码BIDDERCONTACTOR.IDCARD字符型C.100是保函文件下教地址GUARANTEEJJR1.字符型C.500是7.5保函担保结束信息保函担保结束信息见表12.12保函担央结束伯恩友名称英文名称数据类型数据格式必地项备注投保流水号INSURE_SN-O)DE字符型C.50是流水号需保持唯一性.标段唯一码BID_SECTION_ID字符型C.50否当“是否已关联项目”取值为V.该攻必填.招标编号TENDER_CODE字符型C.50否当“是否已关联项目”取值为Y.该项必域.标段名称B1.D-Sechonjwme字符型C.600否当“是否已关联项目”取值为Y.该夜必填.电子保函/保证保险编号GUARANTEE工ODE字符型G.50是投保金额INSURE_AMOVNT数值型N.20,6是投保金颔大写INSUREAMo1.y1.CAP1.TA1.了符型!C.100是投保金颔币种INS1.RE_CURRENCY_CODE字符型C3是采用GB/T12406表示货币的代码的数字码，例如：人民币是156»是否已关联项目ASSOCIATED_PROJECT字符型C1.是Y-是：N-否；项目状态PKOJECTeSTATUS字符型C1.是卜正常：I-异常;当“是否已关联项目”取值为Y,该项必填.7.6索期业务信息索赔业务信息见表13、表14.表13索赔一Ik务信息表名称英文名称数据类型数据恪式必填顶备注申请流水号C1.AIM_APP1.Y_SN_CO()E字符里C.32是理赔申请日期(Wk1.APP1.Y_DATE字符型C.20是可以参照4.2.3.3其他格式要求.投保流水号INSURE_SN_C0DE字符型C.50是唯-性。电子保函/保证保险娟号GHARANTEE_CODE字符型C.50是理赔原因CbUM_REAS0X字符型C.256是理幽方式C1.A1.M-METHOn字符型C1.是O-全颤1»付:I-部分分付:理黠金额c1.r1.amount数值型N.20.6是收款账号C1IM.ACC(XJNT.NO字符型C.50是收款账号户名C1.AIM_ACCOIM_NAME字符型C.300是收款账号开户银行C1.AIj1.BANK字符型C.100是联系人姓名ci.aIMcontacior字符型C.256是岷系人电话q,aimcontactnumber字符型C.30是发M索RS业务影像文件表名称英文名方E澧至睾5*tW黑*1.t¾1.病备注申请流水号C1.AIM.APP1.Y_SN_CODE字符型C.32是文件类型FI1.E-TYPE字符型C.10否文件名F1.1.E_NAME字符型C.255是影像文件流水IMGFI1.E_SN字符型C.100是影像文件日期IMG_PI1.E_DATE字符型C.20是可以参照4.2.3.3其他格式要求.7.7投标人实名认证信息投标人实名认证信息见在15.表15投标人实名认证信息表名称英文名称数据类蛰数据格式必填项备注投保流水号IXs(JRE_SN-O)DE字符型C.50是唯一性.电子保函/保证保除编号Guarantei1.code字符型C.50否投标人经办人姓名BIDDEROPERATOR小站IE字符型C.50是投标人经办人身份证号码BIM)ERJ)PERATORID,CRD字符型C.100是投标人羟办人生物特征信息BIDDEROPERATORFEATURE_DATA字符型C.1024000是人股信息base64认证时间A111.TIME字符型C.20是可以参照4.2.3.3其他格式要求.认证给果Aim1.R图1.1.T字符型C2是OO-IS过：01不通过附录A(规范性)国密加密算法示例代码iBportcn.hutoo1.crypto.ECKeyUti1.;i三portcn.hutoo1.crypto,asy11metric.KeyType;i三portcn.hutoo1.crypto,asymmetric.SM2;pub1.icc1.assSMTooIs* 数据加密* t>arakey密钥* par<ac1.ient1.dc1.ientId* Paranti三estap时间myyyyMMdd1.1.1.1.nmss* eturnpub1.icStringpubkey.encrypt(Stringkey,StringC1.icntSecret,Stri11Iimesiap)SM2sm2=ne>SM2(nu1.1.,ECKeyUti1.toSm2Pu1.>1.icParaasfkey);StringOncryptStr=s2.OncryptBcd(timesta÷C1.ien1.Sccre1.>KcyType.Pub1.icKey);returnencrytStr:/* 计算Authorization* paraanppSecret中请密线* tparasc1.ientId申请的客户端Id8<heturn*/pub1.icStringgetAuthHeader(StringappSecret,Stringc1.ientIdvStringC1.ientSecret,StringIiBeStaP)Stringbearer-pubkey_encr>-pt(appSecret,C1.ientSecret,timestap);return“Basic*+c1ientId+*:*+bearer;附录B（规范性）指令类型指令编眄指令对应类型511电子保函开立指令，金融机构主动推送512电子保函担保期结束或退款指令.中心主动推送515电子保函担保期续期指令.金融机构主动推送611保证保险开立指令，金融机构主动推送612保证保险担保期结束或退款指令中心主动推送615保证保险担保期续期指令，金融机构主动推送999获取金融机构访问token,中心主动推送附录C（规范性）状态码状态码状态描述100成功101承复发送102指令原文与签名值不符103accept,token已过期104金融机构未存准入范围内或业务类型未开通105数据检查存在必填项为空问题106指令中汇总和明细数据量不符109流水号重复112检测接收的电子保函/保证保险为异常.对应的担保项目或金款或基本户不符。210访问的IP未经过授权219其他错误,表示未定义返回码的透辑错误299系统错误附录D（规范性）团体证件类型代码类型O1.组织机构代码证02税务登记证03统一社会信用代码04工商营业执照号51其他-政府机关52其他-事业单位53其他-社会团体54其他-工程项目组55其他-军事机构56其他-外国注册企业57其他-其他类型99其他参考文献IGB2312-1980佶息交换用汉字编码字符集基本第2JGBT183911-2002信息技术数据元的现莅与标准化第1部分：数据元的规范与标准化框架3GB18030-2005信息技术中文编码字符集4GB/TI9487-2001电子政务业务流程设计方法通用规范5DB35T2055-2022政务服务公共资源交易电子保函数据规范6)B3401T308-2023公共资源交易投标保证金电子保函平价数据规范7电子招标投标系统技术规范第1部分：交易平台技术规范国家发改委第20号)8公共资源交易平台系统数据规范(Y2.0)(发改办法现(2018)H56号)