电子保函申请接口文档

业务流与接口清单关系

LG101-开函申请推送

接口地址:/LG101

请求方式:POST

交易码:LG101

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

查询指定开函申请项目

请求示例:

{
    "data":[
        {
            "purchaseInfo":"",
            "handleContactWay":"13012300000",
            "projectLimiTime":"",
            "termEndDate":"",
            "companyName":"北京时代信息化公司",
            "legalContactIdCard":"110101199003071030",
            "projectType":"竞争性谈判",
            "agentContacts":"",
            "productOne":"",
            "lcIdCardImageReverseId":"/zcdservice/upload/imgs/supplier/1339046161507946528/202012211132_1608521550409_3674.png",
            "socialCreditCode":"91110108740053589U",
            "guaranteeId":"",
            "producType":"",
            "premium":"",
            "legalContactName":"测试供应商B",
            "guarantorId":"",
            "projectBudget":"7654345",
            "registererCapital":"1111111",
            "guaranteeAmt":"500.00",
            "bidName":"内蒙保函测试标段1",
            "postponed":"",
            "lcIdCardImageFrontId":"/zcdservice/upload/imgs/supplier/1339046161507946528/202012211132_1608521546104_4829.png",
            "companyType":"事业单位",
            "bidDocUrl":"",
            "handleContactName":"张世豪",
            "projectNumber":"1234567",
            "agentName":"测试成功代理机构2019",
            "projectExpireDate":"20201223101620",
            "legalContactWay":"13851648879",
            "termStartDate":"",
            "companyAddress":"香港特别行政区油尖旺區nullaaaaJ",
            "bidNum":"123456123456",
            "agentContactWay":"",
            "applicationId":"",
            "projectName":"内蒙1221保函流程测试1",
            "tenderDocEndDate":"20201223101530",
            "insurancePolicyHtml":"",
            "licencesImageId":"/zcdservice/upload/imgs/supplier/1339046161507946528/202012211132_1608521541971_8368.png"
        },
      
    ],
}

请求参数:

参数名称	参数说明	类型	模式
data
applicationId	申请ID	string
guarantorId	担保机构ID	string
postponed	是否延期开标 0 否 1 是	string
guaranteeId	关联保函ID（当延期开标时有此值）	string
productOne	产品唯一标识	string
companyName	企业名称	string
socialCreditCode	统一社会信用代码号	string
companyType	企业性质/类型 供应商自己填写	string
companyAddress	企业地址	string
registererCapital	企业注册资金（万元）	string
legalContactName	法人代表姓名	string
legalContactIdCard	法人证件号码(身份证)	string
legalContactWay	法人联系方式	string
handleContactName	经办人姓名	string
handleContactWay	经办人联系方式	string
licencesImageId	营业执照附件id	string
lcIdCardImageFrontId	法人身份证正面附件id	string
lcIdCardImageReverseId	法人身份证反面附件id	string
bidNum	标段编号	string
bidName	标段名称	string
projectType	项目类型	string
purchaseInfo	采购人信息	string
agentName	代理机构名称	string
agentContacts	代理机构联系人	string
agentContactWay	代理机构联系方式 手机号	string
projectExpireDate	项目有效期(yyyy-MM-dd hh:mm:ss)	string
projectLimiTime	工期	string
tenderDocEndDate	投标文件递交截止日期	string
termStartDate	申请保函有效时间起(yyyy-MM-dd hh:mm:ss) 申请时间	string
termEndDate	申请保函有效时间止(yyyy-MM-dd hh:mm:ss) 开标时间点后延90天，担保机构参考	string
projectBudget	标段项目预估金额	string
guaranteeAmt	担保金额（元）	string
premium	保函费用	string
insurancePolicyUrl	担保协议pdf下载链接	string
insurancePolicy	担保协议附件ID	string
bidDocUrl	招标文件下载地址(访问地址,访问地址)	string
producType	保函类型 1 分离式保函 2 直开式保函	string
projectName	项目名称	string
message		string
status		string

LG102-保函申请附件获取

接口地址:/LG102

请求方式:POST

交易码:LG102

发起方:担保机构

请求数据类型:application/json

响应数据类型:*/*

接口描述:

担保机构查询，获取担保机构业务系统申请保函附件信息

请求示例:

{
	"applicationId": "",
	"fileId": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
applicationId	申请ID		true	string
fileId	文件ID		true	string

响应状态:

状态码	说明	模式
200	OK

响应参数:

参数名称	参数说明	类型	模式
data
INFO_DATA		array
Filename	文件名称	string
FileContext	文件	string
message		string
status		string

响应示例:

{
     "data":{
         "FileContext":"",
         "Filename":"202010121705_1602493543294_9592.pdf"
     },
 }

LG103-尽调结果获取

接口地址:/LG103

请求方式:POST

交易码:LG103

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台异步查询，获取担保机构业务系统尽调审核结果，即是否有意向承担担保责任

请求示例:

{
	"applicationId": "",
	"startDate": "",
	"endDate": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
applicationId	申请ID		true	string
startDate	保函创建时间起(yyyy-MM-dd )		true	string
endDate	保函创建时间至(yyyy-MM-dd )		true	string

响应状态:

状态码	说明	模式
200	OK

响应参数:

参数名称	参数说明	类型	模式
data
applicationId	申请ID	string
status	状态(参考文档7.1保函状态码定义)	string
reason	理由	string
changeDate	审批时间	string
message		string
status		string

响应示例:

{
     "data":{
         "applicationId":"",
         "status":"",
         "reason":"",
        "changeDate":""
     },
 }

LG103的状态：:

010 待审核 投标人在电子保函平台提交开函申请后，进入待审核状态

011 未通过 担保机构审核开函申请未通过的,进入未通过状态

020 待支付 担保机构审核开函申请通过后，进入待支付状态

存在开具保函后，担保放发现保函被修改，无效，回传的状态：

090 验签通过 保函文件验签成功，文件无篡改

091 验签失败 保函文件验签失败，文件有篡改

LG104-支付结果获取

接口地址:/LG104

请求方式:POST

交易码:LG104

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台异步查询，获取担保机构业务系统尽调审核结果，即是否有意向承担担保责任

请求示例:

{
	"applicationId": "",
	"startDate": "",
	"endDate": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
applicationId	申请ID		true	string
startDate	保函创建时间起(yyyy-MM-dd )		true	string
endDate	保函创建时间至(yyyy-MM-dd )		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
applicationId	申请ID	string
guarantorName	担保机构名称	string
payNumber	支付流水号	string
payMoney	支付金额	string
payName	支付账户名称	string
payAccountNumber	支付账号	Number
payDate	支付时间	string
payee	收款人	string
payeeType	收款方式(01:支付宝 02:微信，03 现金，04 银行转账，05汇票 06支票 07 其他)	integer
message		string
status		string

响应示例:

     "data":{
         "applicationId":"",
         "guarantorName":"",
         "payNumber":"",
         "payMoney":"",
         "payName":"",
         "payAccountNumber":"",
         "payDate":"",
         "payee":"",
         "payeeType":""
        
   
 }

LG105-电子保函信息获取

接口地址:/LG105

请求方式:POST

交易码:LG105

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台按照支付成功的开函申请ID或时间区间定时向担保机构业务系统获取已开具的保函信息

请求示例:

{
	"applicationId": "",
	"startDate": "",
	"endDate": ""
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
applicationId	申请ID		true	string
startDate	保函创建时间起(yyyy-MM-dd )		true	string
endDate	保函创建时间至(yyyy-MM-dd )		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
applicationId	申请ID	string
guaranteeId	保函唯一标识	string
guarantorName	担保机构名称	string
guaranteeAmt	担保金额	string
guaranteeUrl	PDF电子保函文件下载地址	string
guaranteeHtml	保函文件标识ID	string
validTimeStart	保函生效时间起(yyyy-MM-dd hh:mm:ss	integer
validTimeEnd	保函生效时间至(yyyy-MM-dd hh:mm:ss	integer
letterOfTime	出函时间	string
companyName	供应商名称	string
message		string
status		string

响应示例:

{
     "data":{
         "applicationId":"",
         "guaranteeId":"",
         "guarantorName":"",
         "guaranteeAmt":"",
         "guaranteeUrl":"",
         "guaranteeHtml":"",
         "validTimeStart":"",
         "validTimeEnd":"",
          "letterOfTime":"",
         "companyName":""
        
    
 }

LG106-电子保函文件获取

接口地址:/LG106

请求方式:POST

交易码:LG106

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台按照支付成功的开函申请ID和文件标识向担保机构业务系统获取已开具的保函文件信息

请求示例:

{
	"applicationId": "",
	"guaranteeHtml": ""
	
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
applicationId	申请ID		true	string
guaranteeHtml	保函文件标识ID		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
guaranteeFileName	文件名	string
guaranteeFileContext	电子保函文本（BASE64必须是此方法，不可修改）方法：java.util.Base64.Decoder decoder = Base64.getDecoder();	Base
message		string
status		string

响应示例:

     "data":{
         "guaranteeFileName":"",
         "guaranteeFileContext":""
       
  
 }

LG107-中标信息推送

接口地址:/LG107

请求方式:POST

交易码:LG107

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台发起，定时向担保机构推送有开函记录的项目中标信息、签约信息，便于担保机构注销保函

请求示例:

{
    
    "infoData":[
        {
            "purchaseInfo":"测试采购单位@001",
            "LAST_EDIT_DATE":1600582145000,
            "projectNumber":"BHCS2020091051",
            "bidCompanyName":"供应商A",
            "agentName":"测试代理机构",
            "socialCreditCode":"110101199001012213",
            "CREATE_DATE":1600582145000,
            "bidTime":"2020-09-02",
            "bankId":"1286120104660439040",
            "bidAfficheUrl":"",
            "bidNum":"1",
            "bidAmt":"999990",
            "ID":"1307562403307327488",
            "bidName":"保函测试"
        }
       
    ]
  
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
data
INFO_DATA				array
bidName	标段名称		true	string
bidNum	标段编号		true	string
projectNumber	项目编号		true	string
bidCompanyName	中标企业名称		true	string
socialCreditCode	中标企业名称统一社会信用代码号		true	string
bidAfficheUrl	中标公告地		false	string
bidTime	中标时间		false	string
bidAmt	中标金额		false	string
agentName	代理机构名称		false	string
purchaseInfo	采购人信息（联合采购格式：采购单位名称@组织机构代码，采购单位名称@统组织机构代码）		false	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
message		string
status		string

响应示例:

{
	"message": "",
	"status": ""
}

LG108-6注销状态查询

接口地址:依据担保机构提供

请求方式:POST

交易码:LG108

发起方:电子保函平台发起，根据保函标识或时间区间定时查询保函状态

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台发起，根据保函标识或时间区间定时查询保函状态

请求示例:

{
	"guaranteeId": "",
	"startDate": "",
	"endDate": ""
	
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
guaranteeId	申请ID		false	string
startDate	保函创建时间起(yyyy-MM-dd )		true	string
endDate	保函创建时间至(yyyy-MM-dd )		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
guaranteeId	保函唯一标识	string
guarantorName	担保机构名称	string
cancelDate	注销时间	string
cancellationNotice	注销通知文本	string
status	状态(060:已注销)	string
guaranteeUrl	已注销PDF电子保函文件下载地址	string
guaranteeHtml	已注销电子保函文本json串	string
message		string
status		string

响应示例:

     "data":{
         "guaranteeId":"",
         "guarantorName":"",
         "cancelDate":"",
         "cancellationNotice":"",
         "status ":"",
         "guaranteeUrl":"",
         "guaranteeHtml":""
 }

注销状态:

060 已注销 担保机构根据中标签约情况，注销相应保函后，进入已注销状态

LG109-索赔申请推送

接口地址:依据担保机构提供

请求方式:POST

交易码:LG109

发起方:电子保函平台将招标人索赔申请推送给担保机构。

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台将招标人索赔申请推送给担保机构

请求示例:

{
    
    "infoData":[
        {
            "guaranteeId":"",
            "bidNum":,
            "projectCode":"",
            "companyName":"",
            "socialCreditCode":"",
            "purchaseInfo":"",
            "claimAmount":,
            "claimReason":"",
            "guarantorName":"",
            "openingBank":"",
            "bankAccount":"",
            "initiatorName":"",
            "initiatorWay":"",
            "orgType":"",
            "orgName":"",
            "orgCode":""
        }
       
    ]
  
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
data
guaranteeId	保函唯一标识		true	string
bidNum	bidNum		标段编号	string
projectCode	项目编号		true	string
companyName	供应商名称		true	string
socialCreditCode	中标企业名称统一社会信用代码号		true	string
purchaseInfo	采购人信息（联合采购格式：名称@组织机构代码，名称@组织机构代码）		true	string
claimAmount	索赔金额		true	string
claimReason	索赔理由		true	string
guarantorName	担保机构名称		true	string
openingBank	索赔机构开户行		true	string
bankAccount	索赔机构开户账号		true	string
initiatorName	发起人名称		true	string
initiatorWay	发起人联系方式		true	string
orgType	索赔机构发起类型 1 采购人 2 代理机构		true	string
orgName	索赔机构名称		true	string
orgCode	索赔组织机构代码		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
message		string
status		string

响应示例:

{
	"message": "",
	"status": ""
}

LG110-理赔状态查询

接口地址:依据担保机构提供

请求方式:POST

交易码:LG110

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台异步查询担保机构业务系统，获得某索赔申请的理赔状态

请求示例:

{
	"guaranteeId": "",
	"startDate": "",
	"endDate": ""
	
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
guaranteeId	申请ID		false	string
startDate	保函创建时间起(yyyy-MM-dd )		true	string
endDate	保函创建时间至(yyyy-MM-dd )		true	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
guaranteeId	保函唯一标识	string
status	状态(参考文档7.1保函状态码定义)	string
paymentMoney	理赔金额	string
paymentBeneficiary	理赔受益人	string
paymentBeneficiarySocial	理赔受益人组织机构代码	string
paymentTime	理赔时间	string
message		string
status		string

响应示例:

     "data":{
         "guaranteeId":"",
         "status":"",
         "paymentMoney":"",
         "paymentBeneficiary":"",
         "paymentBeneficiarySocial ":"",
         "paymentTime":""
   
 

LG111-保函签章文件验签

接口地址:电子签名服务(https://114.115.172.176:8087/gdpurchase/purchase.json)

请求方式:POST

交易码:LG111

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台发起，异步调用电子签名服务，查验保函文件真伪，验证签名有效性

请求示例:

{
	"guaranteeId": "",
	"guaranteeUrl": "",
	"guaranteeData": "",
	"verifyType": ""
	
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
guaranteeId	保函唯一标识		true	string
guaranteeUrl	保函文件下载地址，与guaranteeData二选一，先读取该值		false	string
guaranteeData	保函文件内容，与guaranteeUrl二选一，guaranteeUrl为空后再读取该值		false	string
verifyType	验签方式：1-广东CA；2-CFCA，不传时默认为1		false	string

响应状态:

状态码	说明	模式
200	OK	RespMsgVO

响应参数:

参数名称	参数说明	类型	模式
data
applicationId	保函唯一标识	string
status	状态(参考文档7.1保函状态码定义)	string
certNum	证书序列号	string
certOwner	证书所有者	string
certBeginTime	证书有效期开始时间	string
certEndTime	证书有效期截止时间	string
certAuthor	证书颁发者	string
signTime	签章时间	string
message		string
status		string

响应示例:

     "data":{
         "guaranteeId":"",
         "status":"",
         "paymentMoney":"",
         "paymentBeneficiary":"",
         "paymentBeneficiarySocial ":"",
         "paymentTime":""
 

LG112-保函文件验签结果

接口地址:依据担保机构提供

请求方式:POST

交易码:LG112

发起方:电子保函平台

请求数据类型:application/json

响应数据类型:*/*

接口描述:

电子保函平台发起，调用电子担保机构系统，推送保函验签结果

请求示例:

{
	"guaranteeId": "",
	"status": ""
	
}

请求参数:

参数名称	参数说明	请求类型	是否必须	数据类型	模式
guaranteeId	保函唯一标识		true	string
guaranteeUrl	状态(参考文档7.1保函状态码定义)		false	string

7.1 保函状态码定义

状态码	名称	描述
010	待审核	投标人在电子保函平台提交开函申请后，进入待审核状态
010	未通过	担保机构审核开函申请未通过的,进入未通过状态
010	待支付	担保机构审核开函申请通过后，进入待支付状态
010	已支付	投标人支付保函费用成功后，进入已支付状态
010	已出函	担保机构出具电子保函后，进入已出函状态
010	已注销	担保机构根据中标签约情况，注销相应保函后，进入已注销状态
010	理赔待核	担保机构对索赔申请进行审核阶段的,进入理赔待核状态
010	已理赔	担保机构完成相应索赔申请的理赔后，进入已理赔状态
010	未理赔	担保机构对索赔申请未进行理赔的，进入未理赔状态
010	验签通过	保函文件验签成功，文件无篡改
010	验签失败	保函文件验签失败，文件有篡改。