DB2101-T 0097-2023 公共资源交易投标电子保函平台接口数据描述规范

ICS35.240CCSL772101transactionbiddingelectronicguaranteepla沈阳市市场监督管理局IDB2101/T0097-2023前言 2规范性引用文件 3术语和定义 4总体要求 24.1流程示意图 24.2电子保函信息 24.3基础信息 24.4业务信息 34.5传输要求 34.5.1协议要求 34.5.2加密算法 34.5.3报文签名 34.5.4报文加解密 35电子保函基础信息 35.1电子保函基本信息表 35.2投保人信息表 55.3受益人信息表 65.4担保人信息表 75.5招标项目和标段（包）信息 86业务信息 86.1保函申请 96.2投保申请通知 6.3发票申请 6.4发票开具通知 6.5申请退保 6.6退保结果通知 6.7申请理赔 6.8理赔结果通知 6.9放弃申请 6.10放弃申请通知 6.11重新开具保函申请 6.12重新开具保函申请通知 6.13保函验真查询 6.14保函声明通知 7代码集 7.1支付方式 DB2101/T0097-20237.2产品类别 7.3产品类型 7.4审核状态 7.5发票类型 7.6赔付状态 7.7公共错误码 DB2101/T0097-2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。本文件由沈阳市发展和改革委员会提出并归口，同时负责标准的宣贯、监督实施等工作。本文件起草单位：辽宁省公共资源交易协会、沈阳市发展和改革委员会、大连市公共资源交易中心、朝阳市公共资源交易中心、沈阳市城乡建设事务服务中心、大连长兴岛经济技术开发区综合建设服务中心、辽宁思创网联科技有限公司、国泰新点软件股份有限公司、广联达科技股份有限公司。本文件主要起草人：刘晓亮、张汪洋、陈洪岭、佟伟、周健、李智、杨晨、王百合等。本文件发布实施后，任何单位和个人如有问题和意见建议，均可以通过来电、来函等方式进行反馈。本文件归口管理部门通讯地址：沈阳市发展和改革委员会（沈阳市浑南新区世纪路一号二十一世纪大厦B座11楼）；联系电话本文件主要起草单位通讯地址：辽宁省公共资源交易协会（辽宁省沈阳市皇姑区北陵大街34-3号（金融平台经济大厦）3楼3-20门）；联系电话1DB2101/T0097-2023公共资源交易投标电子保函平台接口数据描述规范本文件规定了沈阳市公共资源交易投标电子保函数据接口的总体要求、基础信息、业务信息、代码集等。本文件主要适用沈阳市公共资源交易投标活动中投标电子保函平台接口数据描述、管理建设及应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260-2007中华人民共和国行政区划代码GB11643－1999公民身份号码GB32100-2015法人和其他组织统一社会信用代码编码规则GM/T0009-2012SM2密码算法3术语和定义下列术语和定义适用于本文件。3.1担保人guarantor开立保函的一方。3.2投保人applicant申请开立保函的一方。3.3受益人beneficiary接受保函并享有其利益的一方。3.4电子保函electronicletterofguarantee担保人使用数字证书和电子签章进行认证，以电子数据形式向受益人开立的具有与纸质保函同等法律效力的担保凭证。2DB2101/T0097-20233.5电子保函文件electronicletterofguaranteefile金融机构作为担保人向受益人开立的投标保证文件。3.6电子保函平台electronicguaranteeplatform电子保函平台是由聚集银行、担保、保险等金融机构构成的技术运营机构作为运行主体。具有申请、开立、退保、验真、索赔等功能，实现沈阳市公共资源交易领域投标电子保函全流程办理的平台。3.7电子保函基础公共服务平台electronicguaranteebasicpublicserviceplatform电子保函基础公共服务平台是指由第三方市场主体搭建，聚集多个电子保函平台的保函管理服务信息化系统支撑平台。4总体要求4.1流程示意图电子保函基础公共服务平台流程具体组成见图1。图1流程示意图4.2电子保函信息电子保函信息包括基础信息、业务信息。4.3基础信息3DB2101/T0097-2023基础信息由保函基本信息、投保人信息、受益人信息、担保人信息、招标项目和标段（包）组4.4业务信息业务信息由保函申请、申请结果通知、发票申请、发票开具通知、申请退保、退保结果通知、申请理赔、理赔结果通知、放弃申请、放弃申请结果通知、重新开具保函申请、重新开具保函申请通知、保函验真查询、保函声明通知等业务。4.5传输要求4.5.1协议要求所有接口基于HTTPS协议进行通讯，通讯报文采用JSON格式，编码为UTF-8。双方的请求报文通过签名后再传输给对方，提交请求使用Post方式提交。4.5.2加密算法电子保函平台对外交互接口统一使用国密算法。4.5.3报文签名报文签名使用国密消息摘要算法（SM3）。4.5.4报文加解密电子保函平台对外交互接口统一使用国密非对称椭圆曲线算法SM2。保函文件加密、解密使用国密对称分组密码算法SM4。5电子保函基础信息5.1电子保函基本信息表电子保函基本信息具体参数见表1。表1电子保函基本信息表（T_GUARANTEE_INFO）是是 是 -是 是 是-是-4DB2101/T0097-2023表1电子保函基本信息表（T_GUARANTEE_INFO）（续）-是-是--是--是-是-是-是--否--否--是--是--是--是-payer_bank_account_r-是--是--是-是-是-是-是-是-是参照“支付方式”5DB2101/T0097-2023表1电子保函基本信息表（T_GUARANTEE_INFO续）-是--是-是-是-5.2投保人信息表投保人信息具体参数见表2。表2投保人信息表（T_APPLICANT_INFO）是是--是-unified_social_cred-是-是--是-是--是--是--是--是--是--是式-是式-是式6DB2101/T0097-2023表2投保人信息表（T_APPLICANT_INFO续）-是-responsible_person_p-是-responsible_person_i-是responsible_person_i-是responsible_person_i-是-是-识-是--是-是--是-5.3受益人信息表受益人信息具体参数见表3。表3受益人信息表（T_BENEFICIARY_INFO）是是-是--是--是--是--是--是--是-7DB2101/T0097-2023表3受益人信息表表3（T_BENEFICIARY_INFO）（续）-是--是-是--是-5.4担保人信息表担保人信息参数具体参见表4。表4担保人信息表（T_UNDERWRITER_INFO）是是-码-是--是--是--是--是--是详见“产品类别”-是详见“产品类型”-是--是--是--是--是--是-8DB2101/T0097-2023表4担保人信息表（T_UNDERWRITER_INFO续）钥-是--是--是--是--是-5.5招标项目和标段（包）信息招标项目和标段（包）信具体参见表5。表5招标项目和标段（包）信表（T_PROJECT_BID_INFO）是是--是--是--是--是--是--是--是--是-是-是--是--是-6业务信息9DB2101/T0097-20236.1保函申请通过调用此接口生成保函申请预支付订单。请求方式：POST。具体参数见表6、返回参数见表7。表6请求参数是是是是是_是是是是是是是是是是是是是r是DB2101/T0097-2023表6请求参数（续）是是是是书是-否否否是是否否是否议否是表7返回值是详见“公共错误码”是详见“公共错误码”否Redirecturl:“重定向地址”6.2投保申请通知DB2101/T0097-2023电子保函平台通过投保通知接口将用户支付结果返回给电子保函基础公共服务平台。请求方式：POST。请求参数见表8、返回值参数见表9。表8请求参数是是是 是-是是 是-是 是 是是是详见“审核状态”是是是详见“支付方式”是-是表9返回值是详见“公共错误码”DB2101/T0097-2023表9返回值（续）是详见“公共错误码”否 6.3发票申请电子保函基础公共服务平台未收到发票通知与电子发票的情况下，投标企业可以在电子保函基础公共服务平台申请重新下载获取电子发票。请求方式：POST。请求参数见表10、返回值参数见表11。表10请求参数是是是-是-是-码_identifier是-是是详见“发票类型”否-否-否-填否-否-否-是DB2101/T0097-2023表11返回值是详见“公共错误码”是详见“公共错误码”否-6.4发票开具通知金融机构开出发票通过电子保函平台将开票结果通知电子保函基础公共服务平台。请求方式：POST。请求参数见表12、返回值参数见表13。表12请求参数是是是-是-是是详见“审核状态”是是是否 是表13返回值是详见“公共错误码”DB2101/T0097-2023表13返回值（续）是详见“公共错误码”否 6.5申请退保由投保人在电子保函基础公共服务平台发起，并向电子保函平台主动推送退保申请信息。请求方式：POST。具体参数见表14、返回值参数见表15。表14请求参数是是是-是 是 是 表15返回值是详见“公共错误码”是详见“公共错误码”否 6.6退保结果通知电子保函平台与金融机构响应退保后，需通知至电子保函基础公共服务平台。请求方式：POST。请求参数见表16、返回值参数见表17。DB2101/T0097-2023表16请求参数是是是-是-是详见“申请状态”是表17返回值是详见“公共错误码”是详见“公共错误码”否 6.7申请理赔电子保函基础公共服务平台向金融机构主动发起申请。请求方式：POST。请求参数见表18、返回值参数见表19。表18请求参数是是是 是-_number是 是 是DB2101/T0097-2023表18请求参数（续）是-是-是-是-否--是表19返回值是详见“公共错误码”是详见“公共错误码”否-6.8理赔结果通知金融机构理赔处理完成之后，电子保函平台向电子保函基础公共服务平台主动推送理赔成功相关信息。请求方式：POST。请求参数见表20、返回值参数见表21。表20请求参数是是是-是-是详见“赔付状态”否-DB2101/T0097-2023表20请求参数（续）是-话是-是-否[]是-是-否-否-否-否-否-否-是-表21返回值是详见“公共错误码”是详见“公共错误码”否 DB2101/T0097-20236.9放弃申请由投保人在电子保函基础公共服务平台发起放弃申请（未收到投保成功通知的订单），告知电子保函平台此次申请放弃并作废。请求方式：POST。请求参数见表22、返回值参数见表23。表22请求参数是是是是表23返回值是详见“公共错误码”是详见“公共错误码”否-6.10放弃申请通知电子保函平台方主动发起放弃保函申请通知。请求方式：POST。请求参数见表24、返回值参数见表25。表24请求参数是是是是DB2101/T0097-2023表25返回值是详见“公共错误码”是详见“公共错误码”否-6.11重新开具保函申请由投保人在电子保函基础公共服务平台主动发起重开申请，电子保函平台通过此接口重新开具告知书与保函文件。请求方式：POST。请求参数见表26、返回值参数见表27。表26请求参数是是是-是-是-是-表27返回值是详见“公共错误码”是详见“公共错误码”否 6.12重新开具保函申请通知重新开具保函申请通知。请求方式：