# 电子保函申请接口文档
# 业务流与接口清单关系
![](/openplatform/elgliucheng.jpg)
# 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 | 验签失败 | 保函文件验签失败,文件有篡改。 |