内蒙古自治区政府采购电子履约保函业务接口规范.docx

《内蒙古自治区政府采购电子履约保函业务接口规范.docx》由会员分享，可在线阅读，更多相关《内蒙古自治区政府采购电子履约保函业务接口规范.docx（25页珍藏版）》请在第壹文秘上搜索。

1、内蒙古自治区政府采购电子履约保函业务接口规范V1.0.2目录1应用范围-1-2规范性引用文件-1-3术语和定义-1-4架构及流程规范-1-4.1 总体组成说明-1-4.2 履约保函业务流程-3-5数据规范-4-5. 1传输规则-4-5.1.1 通讯方式-4-5.1.2 编码方式-5-5.2 报文格式-5-5.2.1 请求报文说明-5-5.2.2 响应报文说明-5-5.3 接口安全-6-5.3.1 报文加密方式-6-5.3.2 报文签名方式-6-5.3.3 数字信封-6-6信息接口规范-7-6.1 提交保函申请信息-7-6.2 保函申请状态通知-10-6.3 保函文件查询-12-6.4 保函验真

2、-13-6.5 索赔申请推送-15-6.6 理赔结果通知-17-6.7 保函失效通知-19-6.8 保函注销结果推送-20-7代码字典-22-7.1错误码描述-22-1应用范围本规范规定了内蒙古自治区政府采购电子履约保函业务的应用场景、系统框架及流程、数据规范及信息接口规范等。本规范适用于金融机构预接入到内蒙古自治区政府采购电子履约保函模块的设计与研发。2规范性引用文件GM/T0003SM2椭圆曲线公钥密码算法。GM/T0004-2012SM3密码杂凑算法。3术语和定义术语/缩略语解释公私密钥对非对称密钥中的公钥和私钥。公钥非对称密钥对中公开的密钥。私钥非对称密钥对中非公开的密钥。4架构及流程

3、规范4.1 总体组成说明在政府采购供应商电子履约保函业务的应用场景中，参与业务交互的成员主要包括：政府采购金融服务平台及担保机构。政府采购金融服务平台政府采购金融服务平台为供应商及金融机构提供电子履约保函业务场景，其主要职责如下：1）为供应商提供电子履约保函申请及相关业务查询功能。2）为金融机构提供电子信息交互接口。金融机构金融机构为政府采购供应商提供电子履约保函服务，其主要职责如下：1）按照政府采购金融服务平台接口规范完成系统对接。2）响应供应商电子履约保函意向申请并按照政府采购金融服务平台接口标准完成相关数据交互。4.2 政府采购电子履约保函业务流程政府采购电子履约保函业务流程如图所示:供

4、fis申请供应期金电的弱平台金机构机W 开的 流 程索曙申请果R人素R程图1政府采购电子履约保函业务流程流程说明:L供应商完成电子履约保函申请后，金融服务平台向对应金融机构推送供应商电子履约保函申请信息。2 .金融机构完成电子履约保函审批后将审批结果通知到金融服务平台。3 .供应商根据金融机构提供的支付渠道支付对应保函申请的保费。4 .金融机构收到保费后向供应商开立电子履约保函，并将开立保函结果通知给金融服务平台。5 .金融服务平台收到保函后向金融机构发起保函验真，验证保函真伪。6 .供应商/采购人可在开函成功后查看对应项目的保函信息。7 .采购人如需向对应开函机构索赔，可在金融服务平台索赔管

5、理中发起索赔申请。8 .金融机构受理索赔申请，将最终受理结果上送至金融服务平台。5数据规范5.1 传输规则5.1.1 通讯方式金融机构通过互联网接入的方式与金融服务平台进行连接，报文传输方式采用HTTP/HTTPS+POST+JSON报文格式。5.1.2 编码方式报文采用Unicode字符集，UTF-8编码方式。5.2 报文格式5.2.1 请求报文说明序号参数参数名称参数类型参数长度必填说明示例值1transcode交易码string20Y接口唯一标识2msgcode流水号string32Y交易流水号，取32位UUlD。adfd95a4b3634b58b0cf3b8c67bl8a293appi

6、d银行标识string32Y分配的银行appid4reqtime请求时间string14Y年月日，为yYyyMMddHHmmss格式202201251200005version接口版本string10Yvl.06data请求报文加密后的数据string-Y报文JSON字符串使用国密SM2算法加密后的数据。7sign请求报文的签名数据string64Y请求报文的摘要信息，使用国密SM3算法进行签名。5.2.2 响应报文说明序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3YOoO表示成功，其他均为失败参照10.1序号参数参数名称参数类型参数长度必填说明示例值2mess

7、age响应描述string200N如果响应失败，则为失败的描述3data响应报文加密后的数据string-N响应报文JSON字符串使用国密SM2算法加密后的数据。5.3 接口安全5.3.1 报文加密方式为了加强接口传输的数据安全性，使用SM2非对称算法对传输的报文进行加解密。金融机构在申请接入时与金融服务平台互相交换公钥信息，加密后的内容及密钥对均使用Base64编码的方式。5.3.2 报文签名方式为了验证请求方的合法身份，请求方在请求接口时，都需要根据当前请求报文通过SM3摘要算法生成签名信息。金融机构在申请接入时，由金融服务平台提供平台密钥，包含叩Pkey和appsecret,签名方式如下

8、：SM3(data&reqtime&appkey&appsecret)o5.3.3 数字信封将对称密钥通过非对称加密(即：有公钥和私钥两个)的结果分发对称密钥。具体实现方式：用对称秘钥对文件或字节加密,然后用非对称秘钥对对称秘钥的钥匙进行加密。加密：data:生成一个密钥，对文件进行对称加密，sign：对生成密钥进行非对称加密解密：用私钥对sign值进行解密，得到对称加密密钥，用解密的密钥对data进行对称解密。6信息接口规范6.1 提交保函申请信息交互流程如图：金他服务平台金融机构发起请求响应请求结果提交电子履约保函申请接口流程示意图接口调用地址接口地址由金融机构提供接口交易码ELYlOl接

9、口提供者金融机构接口消费者内蒙古自治区政府采购金融服务平台功能描述供应商凭借已在政府采购平台公示的中标公告及项目信息向金融机构提交电子履约保函申请，金融服务平台向对应的金融机构提交电子履约保函申请信息请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1applicationld申请编号string64Y电子履约保函申请订单的唯一编,弓2supplier企业名称string256Y投保企业名称3SocialCreditCode供应商统一社会信用代码string18Y4IegaIName法人姓名string20Y5IegaIIdNO法人身份证号码string18Y6SuppIierAddr

10、ess企业地址string256N企业地址7performaceBound履约保证金float-Y保留2位小数点8contacts经办人string20Y9contactsWay经办人联系方式string20Y10contractCerNo经办人身份证号码string18Y11eedPaper是否需要纸质保函string2Y1：需要纸质保函0:不需要纸质保函12mailAddress邮寄地址string256N当需要纸质保函时，邮寄地址为必填项13projectCode政府采购统一项目编号string128Y政府采购统一项目编号14projectName项目名称string256Y项目名称序号

11、参数参数名称参数类型参数长度必填说明示例值15bidCode标段编号string256Y16bidName标段名称string256Y17purchaseNature采购品目string10Y枚举值：服务类、货物类、工程类服务类18bidDate中标日期string8Y格式：yyyyMMdd19bidAmount中标金额float-Y单位：元保留2位小数点20purchaseName采购人名称string256Y21purchaseSocCode采购人组织机构代码string64Y采购人组织机构代码/统一社会信用代码22guraanteeDate担保期限string10Y月2423contra

12、ctDate合同期限string10N2424extl拓展字段1string256N25ext2拓展字段2string256N26ext3拓展字段3string256N响应值描述序号参数参数名称参数类型参数长度必填说明示例值序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3YOOo表示成功，其他均为失败参照10.12message响应描述string200N如果响应失败，则为失败的描述6.2 保函申请状态通知交互流程如图：金融机构开函成功接口流程示意图接口调用地址https:/www.*.com/bankservice/bh/api接口交易码ELY102接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述金融机构开函成功后向金融服务平台推送开函结果请求参数描述序号参数参数名称参数类型参数长度必填说明示例值序号参数参数名称参数类型参数长度必填说明示例值1applicationld申请编号string32Y保函申请订单的唯一编号2applycationStatuS保函申请状态string2