《内蒙古自治区政府采购电子履约保函业务接口规范.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接口提供者内
13、蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述金融机构开函成功后向金融服务平台推送开函结果请求参数描述序号参数参数名称参数类型参数长度必填说明示例值序号参数参数名称参数类型参数长度必填说明示例值1applicationld申请编号string32Y保函申请订单的唯一编号2applycationStatuS保函申请状态string2YOl保函审批通过02保函审批拒绝03开函成功04开函失败05已支付3faiIReason失败原因string255N当审批拒绝或开函失败时，此值为必填项4以下字段当开函成功时有值5guaranteeld保函唯一标识string64Y开函机构生成保函唯一标识
14、6guaranteeAmt担保金额string64Y7VaIidTimeStart保函生效时间起string20Yyyyy-MM-ddhh:mm:ss8VaIidTimeEnd保函生效时间止string20Yyyyy-MM-ddhh:mm:ss9IetterOfTime出函时间string20Yyyyy-MM-ddhh:mm:ss10companyName企业名称string50Y11以下字段当支付成功时有值12payTime支付时间string20Yyyyy-MM-ddhh:mm:ss13paymt支付金额string64Y精确到小数点后两位小数14payType支付方式string2Y01
15、网银转账02微信支付03支付宝支付04其他支付方式响应参数:序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3Y000表示成功，其他均为失败参照10.12message响应描述string200N如果响应失败，则为失败的描述6.3 保函文件查询交互流程如图：金融服务平台金融机构发起请求响应请求结果电子履约保函文件获取流程示意图接口调用地址httpswww.*.com)/bankservice/api接口交易码ELY103接口提供者金融机构接口消费者内蒙古自治区政府采购金融服务平台功能描述备注开函成功后金融服务平台根据金融机构返回的文件ID向金融机构获取保函文件该接口
16、采用数字信封方式进行数据传输，详见833请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1applicationld申请编号string32Y保函申请订单的唯一编号响应值描述序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3Y000表示成功，其他均为失败参照10.12message响应描述string200N如果响应失败，则为失败的描述3guaranteeFi1eName文件名string255YguaranteeFi1eContext电子保函文本string-Y（BASE64必须是此方法，不可修改）方法：java.util.Base64.Decoderd
17、ecoder=Base64.getDecoder();6.4 保函验真交互流程如图:金地服务平台金融机构发起请求响应请求结果一一验证通知接口流程示意图接口调用地址https:/WWW.*.com/bankservice/api接口交易码ELY104接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述备注金融服务平台向金融机构发起电子保函签名服务，查验保函文件真伪，验证签名有效性该接口采用数字信封方式进行数据传输，详见8.3.3请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1guaranteeld保函唯一标识string64Y2guaranteeData保函文件tex
18、tYBase64文件流响应参数:序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3YOOo表示成功，其他均为失败参照10.1序号参数参数名称参数类型参数长度必填说明示例值2message响应描述string200N如果响应失败，则为失败的描述3guaranteeld保函唯一标识string64Y4status验签状态string10Y01:验证成功02:验证失败5certNum证书序列号string150Y6certwner证书所有者string100Y7certBgginTime证书有效期开始时间string20Yyyyy-MM-dd8CertEndTime证书有
19、效期截止时间string20Yyyyy-MM-dd9certAuthor证书颁发者string100Y10signTime签章时间string20Yyyyy-MM-ddhh:mm:ss6.5 索赔申请推送交互流程如图:金闻服务平台金融机构发起请求响应请求结果索赔申请推送接口流程示意图接口调用地址httpsWWW.*.comZbankserviceZapi接口交易码ELY105接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述采购人向金融机构发起索赔申请，金融服务平台向对应的金融机构提交索赔信息请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1guaranteeld保
20、函唯一标识string32Y2bidNum标段标号string128Y3ProjectName项目名称string128Y4projectCode政府采购统一项目编号string50Y政府采购统一项目编号5companyName企业名称string255Y投保企业名称6SocialCreditCode企业统一社会信用代码string64Y投保企业统一社会信用代码7purchaseName采购人名称string256Y受益人8purchaseSocCode采购人组织机构代码string64Y受益人组织机构代码/统一社会信用代码9ClaimAmount索赔金额string64Y10ClaimRea
21、son索赔理由string255Y索赔理由序号参数参数名称参数类型参数长度必填说明示例值11OpenBank索赔机构开户行string255Y12bankccount索赔机构开户账户string255Y13contract索赔发起人string255Y经办人14contractway发起人联系方式string50Y经办人联系方式15contractCertCode发起人身份证号码string18Y经办人身份证号码响应值描述序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3YOOO表示成功，其他均为失败参照10.12message响应描述string200N如果响应失
22、败，则为失败的描述6.6 理赔结果通知交互流程如图:金翩服务平台金融机构一发起请求一响应请求结果金融机构理赔结果通知接口流程示意图接口调用地址https:/www.*.com/bankservice/bh/api接口交易码ELY106接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述金融机构理赔成功后向金融服务平台推送理赔结果请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1guaranteeld保函唯一标识string64Y开函机构生成保函唯一标识2status理赔状态string10Y00：理赔受理中01:理赔成功02:理赔失败3paymentMoney理赔金额
23、string64N理赔成功时有值4paymentBeneficiary理赔受益人string25N5paymentBeneficiarySocial理赔受益人组织机构代码string64N6payment!ime理赔时间string20N理赔成功时有值(yyyy-MM-ddhh:mm:ss)响应参数:序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3Y000表示成功，其他均为失败序号参数参数名称参数类型参数长度必填说明示例值参照10.12message响应描述string200N如果响应失败，则为失败的描述6.7 保函失效通知交互流程如图:金融服务平台金越机构发起请
24、求响应请求结果保函失效通知接口流程示意图接口调用地址https:www.*.com)/bankservice/api接口交易码ELY107接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述备注金融服务平台向金融机构发起电子履约保函失效通知请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1guaranteeld保函唯一标识string64Y2invalid?保函失效时间string20Yyyyy-MM-ddhh:mm:ss序号参数参数名称参数类型参数长度必填说明示例值ime2remark预留字段text1024N响应参数:序号参数参数名称参数类型参数长度必填说明示例值
25、1code响应状态string3YOOO表示成功，其他均为失败参照10.12message响应描述string200N如果响应失败，则为失败的描述6.8 保函注销结果推送交互流程如图：金翩服务平台金融机构一发起请求一响应请求结果电子履约保函注销结果通知接口流程示意图接口调用地址https:/www.*.com/bankservice/bh/api接口交易码ELY108接口提供者内蒙古自治区政府采购金融服务平台接口消费者金融机构功能描述金融机构将已注销的保函结果推送至金融服务平台请求参数描述序号参数参数名称参数类型参数长度必填说明示例值1guaranteeld保函唯一标识string64Y开函机
26、构生成保函唯一标识响应参数:序号参数参数名称参数类型参数长度必填说明示例值1code响应状态string3YOOO表示成功，其他均为失败参照10.12message响应描述string200N如果响应失败，则为失败的描述3guaranteeld保函唯一标识string64Y开函机构生成保函唯一标识4cancelDate注销时间string20Yyyyy-MM-ddhh:mm:ss4cancelNotice注销通知文本string200N保函注销通知文本7代码字典7.1错误码描述序号错误码错误信息1000成功（其他代码都为失败）2101数据接收失败，数据验签未通过3102数据接收失败，数据解密失败4103数据接收失败，请求参数校验未通过5201业务处理失败，项目编号不存在6202业务处理失败，合同编号不存在7203业务处理失败，保函唯一标识/保函申请编号不存在8204业务处理失败，供应商信息不存在9301系统服务暂停，请稍侯10302服务器异常
