DB35∕T 2055-2022 政务服务 公共资源交易电子保函数据规范(福建省).pdf

福建省地方标准 DB35/T 20552022 政务服务 公共资源交易电子保函数据规范 Government affairs serviceData specification for electronic letter of guarantee for public resource transactions ICS 35.240.40 CCS L 70 35 BDB35/T 20552022 I 目次 前言 .II 1 范围 .1 2 规范性引用文件 .1 3 术语和定义 .1 4 总体要求 .2 5 基础信息 .4 6 业务说明 .7 7 业务信息 .10 附录 A（规范性） XML 示范 .17 附录 B（规范性） 参数说明 .19 参考文献 .21 DB35/T 20552022 II 前言 本文件按照 GB/T 1.12020标准化工作导则 第 1 部分：标准化文件的结构和起草规则的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由福建省经济信息中心提出。 本文件由福建省信息化标准化技术委员会（SAFJ/TC 11）归口。 本文件起草单位：福建省经济信息中心、福建省公共资源交易公共服务平台有限公司、四创科技有限公司、福建省信创科技有限公司、福建经纬测绘信息有限公司。 本文件主要起草人：林平、李志锴、郑楚飞、陈绍林、董智华、林乐、单森华、林晓枫、蔡之栋、杨善峰、兰美玲、邓婷、姚甦靖、陈晓红、钟木娟。 DB35/T 20552022 1 政务服务 公共资源交易电子保函数据规范 1 范围 本文件规定了政务服务公共资源交易电子保函数据应用的总体要求、基础信息、业务说明和业务信息。 本文件主要适用于全省政务服务公共资源交易招投标活动中投标保证金电子保函的管理与应用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 2260 中华人民共和国行政区划代码 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 331902016 电子文件存储与交换格式版式文档 3 术语和定义 下列术语和定义适用于本文件。 3.1 担保人 guarantee 开立保函的一方。 注： 包括为自己开立保函的情况。 3.2 投保人 applicant 凡符合相关法律法规要求，参加投标的企业或供应商，即电子保函申请人。 注： 投保人使用数字证书和电子签章，进行企业身份认定 3.3 受益人 beneficiary 接受保函并享有其利益的一方。 3.4 电子保函 electronic Ietter of Guarantee 担保人使用数字证书和电子签章进行认证， 以电子数据形式向受益人开立的具有与纸质保函同等法律效力的担保凭证。 3.5 电子保函文件 electronic Ietter of guarantee file 经担保人电子签章的 OFD 格式文件，具有数据不可篡改、全溯源，可追偿等特点。 DB35/T 20552022 3.6 电子保函服务平台 E-guarantee service platform 向公共资源交易的市场主体提供电子保函业务，实现从申请、开立、查询、推送、运用到索赔或注销六个环节全流程电子化办理的全省统一平台， 具有电子保函信息的互通、 互认、 共享和实时传输功能。 4 总体要求 4.1 电子保函信息组成 电子保函信息包括基础信息、业务信息。基础信息由保函基本信息、投保人信息、受益人信息、担保人信息、招标项目和标段（包）组成。业务信息由申请保函业务、开立保函业务、查询保函业务、推送保函业务、运用保函业务、索赔或注销保函业务组成。具体组成见图 1。 电子保函信息基础信息招獅目和臟(包)信息保函基本信息投保人信息受益人信息担保人信息业务信息索赔或注销保函业务信息由呆函业务言，息开立保函业务信息查询保函业务信息麵呆函业务信息保函业务言息DB35/T 20552022 3 表1 接口规范表 输入参数 参数代码 参数名称 数据类型 参数说明 VALIDATION 身份认证，用户等信息 字符串 见附录 B DATA 数据集拼装而成字符串 Json 结构字符串 见附录 B 输出参数 参数代码 参数名称 数据类型 参数说明 STATUS 响应码 1：提交成功 -1：提交失败 MSG 响应消息 DATA 返回数据 json 返回值示例 输出参数: “STATUS”: “1”, “MSG”: “提交成功”, “DATA”:null 4.2.2 格式要求 XML 文件信息应包含如下： a) 头部格式：； b) XML 信息应只有一个根元素，根元素是。XML 示例见附录 A； c) 结构化数据信息节点采用 SM3 验证结构化数据信息节点完整性。 4.2.3 数据类型说明 数据类型对应的说明与格式见表 2。 表2 数据类型说明表 数据类型 说明 数据格式 字符型 一切可以显示打印的字符，包括汉字、字母、数字、各种符号、空格等，不具有计算能力 以大写字母“C”代表字符型： CX：表示定长为“X”的字符型数据元值； C.X：表示最长为“X”的字符型数据元值；C.ul：表示长度不确定的字符型数据元值 数值型 可以及进行数学运算的数据 以大写字母“NUM”代表数值型： NUM.（X）：表示最长为“X”的数值型数据元值； NUM.（X,y）：表示总长度为“X”位、其中小数点后为“y”位的数值型数据元值 日期时间型 用以表示日期及时间的数据 采用 GB/T 7408 的规定 DB35/T 20552022 4 5 基础信息 5.1 保函基本信息 5.1.1 组成 保函基本信息主要包括：订单编号、保函编号、保函申请日期、保函签发日期、保函生效日期、保函失效日期、保函金额、保函手续费、费率、支付方式、支付账号（银行账号）、支付人姓名（银行账户名称）、支付人联系人电话、保函申请客户端 IP 地址、保函申请源端口号、银行开户行、担保责任、索赔条款、赔付时效、银保监产品备案编号、适用法律、附件文件。 5.1.2 数据格式 保函基本信息见表 3。 表3 保函基本信息表 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C20 投保人申请电子保函的订单编号， 为本公共资源交易电子保函文件格式标准文件的唯一标识 保函编号 GUARANTEE_NO 字符型 C.20 保函编号为本电子保函文件的唯一标识， 与订单号一一对应 保函申请日期 APPLICATION_DATE 日期时间型 YYYYMMDD 保函签发日期 ISSUING_DATE 日期时间型 YYYYMMDD 保函生效日期 EFFECTIVE_DATE 日期时间型 YYYYMMDD 保函失效日期 EXPIRRY_DATE 日期时间型 YYYYMMDD 保函金额 GUARANTEE_AMOUNT 数值型 NUM(20,2) 记录每个招标项目所需的保证金要求数额，单位：元 保函手续费 COMMISSION 数值型 NUM(20,2) 根据保函金额确定的手续费，单位：元 费率 COMMISSION_RATE 数值型 NUM(1,4) 金融机构为投保人开立投标保函业务时， 向客户征收保函手续费的比例 支付方式 PAYMENT_MODE 字符型 C1 参考公共资源交易平台系统数据规范（V2.0)中7.9.8 保证金缴纳方式 支付账号（银行账号） PAYER_ACCOUNT 字符型 C.100 支付人姓名（银行账户名称） PAYER_NAME 字符型 C.50 支付人联系人电话 PAYER_PHONE 字符型 C11 DB35/T 20552022 5 表 3 保函基本信息表（续） 名称 英文名称 数据类型 数据格式 备注 保函申请客户端IP地址 IP 字符型 C.15 保函申请源端口号 REMOTE_PORT 数值型 NUM(5) 银行开户行 PAY_BANK_OPENBANK 字符型 C.20 担保责任 GUARANTEE_DUTY 字符型 C.200 索赔条款 CLAIM_CLAUSE 字符型 C.2000 赔付时效 PAY_PERIOD 数值型 NUM(5) 单位：天 银保监产品备案编号 BANK_RECORD_NO 字符型 C.100 适用法律 APPLICABLE_LAW 字符型 C.200 附件文件a ATTR 字符型 C.2000 a 附件文件内嵌在电子保函文件的“附件列表”中，附件文件包含电子保单（合同）文件、电子保单（合同）PDF文件、电子保函申请单文件、电子保函申请单PDF文件、企业资质文件、企业营业执照、其他附件等，并遵循GB/T 331902016的规定。电子保单（合同）文件、电子保函申请单文件是经投保人数字签名和电子签章的数据电文。 5.2 投保人信息 5.2.1 组成 投保人信息主要包括：投保人名称、投保人统一社会信用代码、投保人联系人姓名、投保人联系人电话、投保人联系人身份证件类型、投保人联系人身份证件号码。 5.2.2 数据格式 投保人信息见表 4。 表4 投保人信息表 名称 英文名称 数据类型 数据格式 备注 投保人名称 APPLICANT_NAME 字符型 C.50 投保人统一社会信用代码 APPLICANT_CREDIT_CODE 字符型 C18 投保人身份识别的代码 投保人联系人姓名 APPLICANT_CONTACT_NAME 字符型 C.50 用于电子保函缴纳人员的联系人姓名 投保人联系人电话 APPLICANT_CONTACT_TEL 字符型 C11 用于电子保函缴纳人员的电话 投保人联系人身份证件类型 APPLICANT_CONTACT_IDCARD_TYPE 字符型 C2 采用公共资源交易平台系统数据规范（V2.0)6.1身份证件类型代码 投保人联系人身份证件号码 APPLICANT_CONTACT_IDCARD 字符型 C18 用于电子保函缴纳人员的身份识别号码 DB35/T 20552022 6 5.3 受益人信息 5.3.1 组成 受益人信息主要包括：受益人名称、受益人统一社会信用代码、受益人银行账户名称、受益人银行账号、受益人银行开户行、受益人联系人姓名、受益人联系人电话。 5.3.2 数据格式 受益人信息见表 5。 表5 受益人信息表 名称 英文名称 数据类型 数据格式 备注 受益人名称 BENEFICIARY 字符型 C.200 受益人统一社会信用代码 BENEFICIARY_CREDIT_CODE 字符型 C18 受益人银行账户名称 BENEFICIARY_BANK_NAME 字符型 C.20 受益人银行账号 BENEFICIARY_BANK_NUMBER 字符型 C.19 受益人银行开户行 BENEFICIARY_BANK_OPENBANK 字符型 C.20 受益人联系人姓名 BENEFICIARY_CONTACT 字符型 C.50 受益人联系人电话 BENEFICIARY_CONTACT_TEL 字符型 C11 5.4 担保人信息 5.4.1 组成 担保人信息主要包括：担保人名称、担保人统一社会信用代码、担保人联系人姓名、担保人联系人电话、担保人法定代表人姓名、担保人银行行号。 5.4.2 数据格式 担保人信息见表 6。 表6 担保人信息表 名称 英文名称 数据类型 数据格式 备注 担保人名称 GUARANTOR_ NAME 字符型 C.50 担保人统一社会信用代码 GUARANTOR _CREDIT_CODE 字符型 C18 担保人联系人姓名 GUARANTOR_CONTACT_NAME 字符型 C.50 担保人的指定联系人 担保人联系人电话 GUARANTOR_CONTACT_TEL 字符型 C11 担保人的指定联系人的电话 担保人法定代表人姓名 GUARANTOR_CONTACT_LEGAL_PERSON_NAME 字符型 C.50 担保人银行行号 GUARANTOR_BANK_CODE 字符型 C.20 DB35/T 20552022 7 5.5 招标项目和标段（包）信息 5.5.1 组成 招标项目和标段（包）信息主要包括：招标项目名称、招标项目编号、标段（包）编号、标段（包）名称、合同估算价、报建编号。 5.5.2 数据格式 招标项目和标段（包）信息见表 7。 表7 招标项目和标段（包）信息表 名称 英文名称 数据类型 数据格式 备注 招标项目名称 TENDER_PROJECT_NAME 字符型 C.200 投保人保函用于投标的所在招标项目名称 招标项目编号 TENDER_PROJECT_CODE 字符型 C.20 投保人保函用于投标的所在招标项目编号 标段（包）编号 SECTION_CODE 字符型 C23 投保人保函用于投标的所在招标项目划分的标段（包）编号 标段（包）名称 SECTION_NAME 字符型 C.500 投保人保函用于投标的所在招标项目划分的标段（包）名称 合同估算价 CONTRACT_RECKON_PRICE 数值型 NUM(20,2) 单位：元 报建编号 REPROT_CODE 字符型 C16 6 业务说明 6.1 业务流程 业务流程是由申请、开立、查询、推送、运用、索赔或注销六个流程业务信息组成。电子保函服务平台与各系统间的对接业务流程见图 2。 投保人通过电子保函服务平台提交电子保函申请材料， 由担保人业务系统开立电子保函， 并回传至电子保函服务平台，对电子保函文件进行备案；投标人编制投标文件过程，通过电子交易系统向电子保函服务平台获取电子保函文件。在线监管平台监督运用电子保函服务平台的电子保函信息。 DB35/T 20552022 电子保函垠务平台担保人业务系统电子交易系统管平台申雕_攸雕_交互电子保函申请单等申请保函数据幵立保_攸網内部核保M保_麟雕查询保函信息开立状态开标前开立电子保函（数字证书+电子签章）推送保S业务S程保函接收携送縣运用保S业务淀程验证短信验证码并返回电子保函倌患_投标阶段，通过短信验证码获取保函信患投保人在平台可对电子保函进行下载和验真将电子保函以附件形式上传L批呈验真保函信息电子保函批呈验真电子保函验真显示验真结果分析违规信息开标线下处理后1操作-mm受益人填写索赔信息并提供证明材料接收索赔信息索通知担保人有索賠信息索赔流程赔阶备案索赔结果出具索赔结果段注销DB35/T 20552022 9 6.2 业务说明 6.2.1 申请业务说明 投保人登录电子保函服务平台，填写投保申请，包括项目信息、企业信息、投保人信息，提供相关材料，并应用数字证书和电子签章进行确认。 电子保函服务平台主动推送到担保人业务系统，见图 2。 6.2.2 开立业务说明 担保人在担保人业务系统上接收投保申请信息，包括项目信息、企业信息、投保人信息，对申请信息进行审核，审核通过后让投保人支付保函费用，并开立电子保函（数字证书与电子签章）生成数据电文。 担保人业务系统在内部审核完成后，主动将开立结果推送到电子保函服务平台，见图 2。 6.2.3 查询业务说明 在未收到担保人业务系统 0 推送的电子保函时，投保人可自行登录电子保函服务平台，根据“订单编号”或“保函编号”进行保函开立状态查询。投标电子保函数据电文要能够准确、及时、完整的提供投保人信息，包括但不限于投保人名称、担保金额、保函时效、担保项目名称、费用支付账户等。 电子保函服务平台主动发起请求到担保人业务系统，见图 2。 6.2.4 推送业务说明 在电子保函服务平台接收到担保人业务系统开立的电子保函后， 在投标阶段通过电子交易系统向电子保函服务平台发送电子保函文件获取请求，电子保函服务平台将文件准确、及时、完整的推送至电子交易系统。将文件一并推送至在线监管平台，为后续对招投标违规信息验真与监督做好准备。 电子保函服务平台将电子保函文件推送到电子交易系统与在线监管平台，见图 2。 6.2.5 运用业务说明 通过订单编号和保函编号查询电子保函验真信息或可通过投保人名称和招标项目编号查询电子保函验真信息，见图 2。 以投标保函为例： 电子保函的运用流程主要为支持电子保函数据要素及时、 准确传输到电子交易系统和在线监管平台，并提供验真。在开标后对电子保函文件进行验真，具体流程为： a) 由电子交易系统向电子保函服务平台发出对投标项目中涉及到的所有或部分投标人或中标人的电子保函验真申请需求； b) 电子保函服务平台对电子保函信息进行批量验真，若所验真的保函信息可在电子保函服务平台查询到，直接将验真的结果推送至电子交易系统；若电子保函服务平台无法查询到所验真的保函信息，会主动向担保人业务系统发起查询请求，由担保人业务系统提供查询地址，让电子交易系统通过接口查询验真电子保函信息； c) 在线对电子保函信息进行查验，分析投标人的违规信息，若存在违规行为，需要采取线下方式对投保人进行处理并将违规操作信息发送至电子保函服务平台，通知受益人进行索赔流程。 DB35/T 20552022 10 6.2.6 索赔或注销业务说明 受益人在电子保函服务平台填写索赔信息并提供证明材料， 由电子保函服务平台将索赔信息推送至担保人业务系统，担保人业务系统接收到索赔信息后，按照电子保函索赔流程，出具索赔结果，并向电子保函服务平台备案索赔结果，保函金额为 0 后，担保人可进行电子保函的注销。 电子保函服务平台将索赔信息推送到担保人业务系统，见图 2，若无索赔信息，可根据实际情况进行注销等操作。 7 业务信息 7.1 申请业务信息 申请业务信息参数见表 8。 表8 申请业务信息表 输入信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 项目审批文号 APPROVAL_CODE 字符型 C.20 投资项目统一代码 INVEST_PROJECT_CODE 字符型 C24 报建编号 REPORT_CODE 字符型 C100 招标项目编号 TENDER_PROJECT_CODE 字符型 C.20 招标项目名称 TENDER_PROJECT_NAME 字符型 C.200 标段（包）编号 SECTION_CODE 字符型 C23 标段（包）名称 SECTION_NAME 字符型 C.500 合同估算价 CONTRACT_RECKON_PRICE 数值型 NUM(20,2) 单位：元 受益人名称 BENEFICIARY-NAME 字符型 C.200 招标人名称 受益人统一社会信用代码 BENEFICIARY_CREDIT_CODE 字符型 C18 招标人统一社会信用代码 受益人银行账号 BENEFICIARY_ACCOUNT_NUMBER 字符型 C.20 招标人银行账号 受益人银行开户行 BENEFICIARY_BANK 字符型 C.20 招标人银行开户行 受益人银行账户名称 BENEFICIARY_ACCOUNT_NAME 字符型 C.20 招标人银行账户名称 受益人联系人姓名 BENEFICIARY_NAME 字符型 C.50 招标人联系人姓名 受益人联系人电话 BENEFICIARY_CONTACT_TEL 字符型 C11 招标人联系人电话 项目所在地 (行政区划代码) CITY_CODE 字符型 C6 采用GB/T 22602007 的规定 DB35/T 20552022 11 表 8 申请业务信息表（续） 输入信息 名称 英文名称 数据类型 数据格式 备注 招标项目类别 TENDER_PROJECT_TYPE 字符型 C3 采用公共资源交易平台系统数据规范（V2.0)中 5.3分类类目表 开标时间 BID_OPEN_TIME 日期时间型 yyyMMddHHmmss 投标有效期 VALID_PERIOD 数值型 NUM(5) 单位：天 担保额度 GUARANTEE_AMOUNT 数值型 NUM(20,2) 单位：元 担保人名称 GUARANTOR_NAME 字符型 C.200 担保人统一社会信用代码 GUARANTOR_CREDIT_CODE 字符型 C18 采用公共资源交易平台系统数据规范（V2.0)5.3 分类类目表 担保人法定代表人姓名 GUARANTOR_CONTACT_LEGAL_PERSON_NAME 字符型 C.50 担保人联系人姓名 GUARANTOR_CONTACT_NAME 字符型 C.50 担保人联系人电话 GUARANTOR_CONTACT_TEL 字符型 C11 投保人名称 APPLICANT_NAME 字符型 C.30 投保人统一社会信用代码 APPLICANT_CREDIT_CODE 字符型 C18 投保人联系人姓名 APPLICANT_CONTACT_NAME 字符型 C.50 投保人联系人电话 APPLICANT_CONTACT_TEL 字符型 C11 投保人联系人身份证件类型 APPLICANT_CONTACT_IDCARD_TYPE 字符型 C2 采用公共资源交易平台系统数据规范（V2.0)中 6.1身份证件类型代码 投保人联系人身份证件号码 APPLICANT_CONTACT_IDCARD 字符型 C18 投保人地址 APPLICANT_ADDRESS 字符型 C.200 投保人邮箱 APPLICANT_EAMIL 字符型 C.20 投保人法定代表人姓名 APPLICANT_LEGAL_PERSON_NAME 字符型 C.50 DB35/T 20552022 12 表 8 申请业务信息表（续） 输入信息 名称 英文名称 数据类型 数据格式 备注 投保人法定代表人身份证件类型 APPLICANT_LEGAL_PERSON_IDCARD_TYPE 字符型 C2 采用公共资源交易平台系统数据规范（V2.0)6.1 身份证件类型代码 投保人法定代表人身份证号 APPLICANT_LEGAL_PERSON_IDCARD 字符型 C.18 投保人法定代表人联系电话 APPLICANT_LEGAL_PERSON_TEL 字符型 C11 电子申请单文件下载地址 ORDER_URL 字符型 C.2000 电子申请单文件SM3哈希值 ORDER_SM3 字符型 C32 招标文件下载地址 TENDER_FILE_URL 字符型 C.2000 招标文件 SM3 哈希值 TENDER_FILE_SM3 字符型 C32 企业资质文件下载地址 QUALFICATION_FILE_URL 字符型 C.2000 企业资质文件 SM3 哈希值 QUALFICATION_FILE_SM3 字符型 C32 企业营业执照下载地址 BUSINESS_LICENSE_URL 字符型 C.2000 企业营业执照 SM3 哈希值 BUSINESS_LICENSE_SM3 字符型 C32 数字信封 SECRET 字符型 C.200 保函申请客户端 IP 地址 IP 字符型 C.15 保函申请源端口号 REMOTE_PORT 数值型 NUM(5) 返回信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 担保人业务系统地址 URL 字符型 C.100 担保人业务系统地址，通过此地址投保人可以进入跟踪核保进度， 进行支付等操作。 URL 的示例：业务系统返回地址：“http:/100.100.100.100/jump?id=284684” 7.2 开立业务信息 开立业务信息参数见表 9。 DB35/T 20552022 13 表9 开立业务信息表 输入信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 审核不通过可不填 文件下载地址 GUARANTEE_URL 字符型 C.2000 电子保函文件的 SM3 哈希值 GUARANTEE_SM3 字符型 C32 电子保函文件中的结构化数据XML 文件下载地址 GUARANTEE_XML_URL 字符型 C.2000 电子保函文件中的结构化数据XML 文件的 SM3 哈希值 GUARANTEE_XML_SM3 字符型 C32 数字信封 SECRET 字符型 C.200 投保人基本存款账户信息 APPLICANT_LEGAL_PERSON_BASIC_DEPOSIT_ACCOUNT 字符型 C.100 上传投保人的企业基本账户开户许可证或基本存款账户开户银行出具的基本存款账户信息 返回信息 输出参数: “STATUS”: “1”, “MSG”: “提交成功”, “DATA”:null 7.3 查询业务信息 查询业务信息参数见表 10。 表10 查询业务信息表 输入信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 返回信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 保函编号，审核不通过可不填 文件下载地址 GUARANTEE_URL 字符型 C.2000 电子保函文件下载地址 电子保函文件的 SM3 哈希值 GUARANTEE_SM3 字符型 C32 DB35/T 20552022 14 表 10 查询业务信息表（续） 返回信息 名称 英文名称 数据类型 数据格式 备注 XML 文件下载地址 GUARANTEE_XML_URL 字符型 C.2000 电子保函文件中的结构化数据XML 文件下载地址 电子保函文件中的结构化数据 XML 文件的 SM3 哈希值 GUARANTEE_XML_SM3 字符型 C32 数字信封 SECRET 字符型 C.200 7.4 推送业务信息 推送业务信息参数见表 11。 表11 推送业务信息表 输入信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 电子保函文件下载地址 GUARANTEE_URL 字符型 C.200 电子保函文件的大写 MD5 GUARANTEE_MD5 字符型 C32 结构化数据XML文件下载地址 GUARANTEE_XML_URL 字符型 C.200 结构化数据XML文件的大写MD5 GUARANTEE_XML_MD5 字符型 C32 数字信封 SECRET 字符型 C.200 返回信息 输出参数: “STATUS”: “1”, “MSG”: ”提交成功”, “DATA”:null 7.5 运用业务信息 运用业务信息参数见表 12。 DB35/T 20552022 15 表12 运用业务信息表 输入信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_IDS 字符型 C.20 支持批量查询，批量查询时使用英文半角分号隔开 保函编号 GUARANTEE_NO 字符型 C.20 应支持批量查询，批量查询时使用英文半角分号隔开 投保人名称 APPLICANT_NAME 字符型 C.200 招标项目编号 TENDER_PROJECT_CODE 字符型 C.20 返回信息 名称 英文名称 数据类型 数据格式 备注 招标项目编号 TENDER_PROJECT_CODE 字符型 C.20 招标项目名称 TENDER_PROJECT_NAME 字符型 C.200 标段（包）编号 SECTION_CODE 字符型 C23 标段（包）名称 SECTION_NAME 字符型 C.500 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 审核不通过可不填 文件下载地址 GUARANTEE_URL 字符型 C.2000 电子保函文件下载地址 文件 SM3 哈希值 GUARANTEE_SM3 字符型 C32 状态 RESULT 字符型 C2 1 暂存 2 待审核 3 待支付 4审核不通过 5 投保合同待签订 6 保函待开具 9 完成 10其他 备注 REMARK 字符型 C.2000 当状态为 10 其他时， 自定义描述保函当前状态 注：订单编号和保函编号两个参数都入参时，将对结果数据进行去重返回。 7.6 索赔或注销业务信息 索赔信息参数见表 13。 表13 运用业务信息表 输入信息 名称 英文名称 数据类型 数据格式 说明 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 文件下载地址 GUARANTEE_URL 字符型 C.2000 电子保函文件下载地址 电子保函文件 SM3 哈希值 GUARANTEE_SM3 字符型 C32 DB35/T 20552022 16 表 13 运用业务信息表（续） 输入信息 名称 英文名称 数据类型 数据格式 说明 索赔人名称 CLAIM_NAME 字符型 C.200 索赔人统一社会信用代码 CLAIM_CREDIT_CODE 字符型 C18 索赔人联系人电话 CLAIM_TEL 字符型 C11 索赔人邮箱 CLAIM_EMAIL 字符型 C.20 索赔金额 CLAIM_AMOUNT 数值型 NUM(20,2) 单位：元 索赔理由 CLAIM_REASON 字符型 C.2000 附件下载地址 CLIAM_ATTACHMENT_URL 字符型 C.2000 附件下载地址，附件类型为.ZIP 压缩包 附件文件 SM3 哈希值 CLIAM_ATTACHMENT_SM3 字符型 C32 返回信息 名称 英文名称 数据类型 数据格式 备注 订单编号 ORDER_ID 字符型 C.20 保函编号 GUARANTEE_NO 字符型 C.20 赔付状态 COMPENSATE_STATUS 字符型 C1 1待赔付2已赔付3不予赔付9 其他 不予赔付和其他需要说明理由 COMPENSATE_REMARK 字符型 C.200 赔付人名称 COMPENSATE_NAME 字符型 C.30 赔付人统一社会信用代码 COMPENSATE_CREDIT_CODE 字符型 C18 赔付人联系人姓名 COMPENSATE_CONTACT 字符型 C.50 赔付人联系人电话 COMPENSATE_MOBILE 字符型 C11 赔付人联系人固定电话 COMPENSATE_TEL 字符型 C12 赔付银行账号 COMPENSATE_BANK_CODE 字符型 C.20 赔付银行开户行 COMPENSATE_BANK_OPENBANK 字符型 C.20 受益人名称 BENEFICIARY_NAME 字符型 C.30 受益人统一社会信用代码 BENEFICIARY_CREDIT_CODE 字符型 C18 受益人联系人姓名 BENEFICIARY_CONTACT 字符型 C.50 受益人联系人电话 BENEFICIARY_TEL 字符型 C11 受益人银行账号 BENEFICIARY_BANK_CODE 字符型 C.20 受益人银行开户行 BENEFICIARY_BANK_OPENBANK 字符型 C.20 赔偿金额 COMPENSATE_AMOUNT 数值型 NUM(20,2) 单位：元 DB35/T 20552022 17 A A 附录A （规范性） XML 示范 本文件的 XML 示范，如下所示： 示例： 2494B501874781A11750CFBFB40ABEB353915629DBAC984012DB800FEB83D315 123123123123 FJ1231231231232 DB35/T 20552022 18 DB35/T 20552022 19 B B 附录B （规范性） 参数说明 B.1 Validation 参数：身份认证信息 格式如下： 示例： “TOKEN”:”123456”, “SYSTEM_NO”:”8888”, “TIME”:”20190916080000” 标签说明。 1.TOKEN：令牌，身份认证凭据。（详见 B.3 Token 生成） 2.SYSTEM_NO：系统编码。（进行电子保函服务平台注册的 ID） 3.TIME：用于验证的当前时间。 B.2 DATA 参数：详细参数或返回信息 格式如下： 示例： “SYSTEM_NO”:”8888”, “DATA_KEY”:”1234567890-123”, DATA: “数据库字段 1” ： ”123123”,”数据库字段 2” ： ”33232323”,， “数据库字段 3” ： ”123123”,”数据库字段 4” ： ”33232323” 注： SYSTEM_NO为分配的系统编号，DATA_KEY为本次数据的唯一标识，DATA为本次数据对象，以表格中的字段组成对象。 B.3 Token 生成 1.系统编码 + 当前时间(YYYYMMDDHHmmss) + 32 位大写 MD5(DATA).其中 DATA 即为对应该请求中的DATA 数据，用于验证 DATA 未被篡改。 2.对以上生成的字符串进行加密，算法为hmacsha256.使用密钥统一为电子保函服务平台进行分配。 示例1： C#： using System.Security.Crypography; private string CreateToken（string message，string secret） （ Secret=secret ？” ”; DB35/T 20552022 20 var encoding=new System.Text.ASCIIEncoding(); byte KeyBte=encoding.GetBytes(secret); byte messageBytes=encoding.GetBytes(message); Using （var hmasha256=new HMACHA256(KeyByte）) ( Bytehashmessage=hmacsha256.ComputeHash(messageBytes）; Return Convert.ToBase64String(hashmessage).Replace(+,_).Replace(/,_).Replace(=,_); ) 示例2： JAVA： import javax.crypto.Mac; import javax.crypto.spac.SecretKeySpec; import mons.codec.binary.Base64; public class ApisecurityEXample Public static viod main(String args) try String Secret=“secret ” ； String message=“Message” ； Mac sha256_HMAC=Mac.getInstance(“HmacSHA256”); secretkeySpec secret_key=new SecretKeySpace(secret.getBytes(),”HmaceSHA256”)； Sha256_HMAC.init(secret_key); Stringhash=Base64.encodeBase64String(sha256_HMAC.doFinal(message.getBytes().Replac(+,_).Replace(/,_).Replace(=,_); System.out.println(hash); catch(Exceptione) System.out.println(Error） ； DB35/T 20552022 21 参考文献 1 电子招标投标系统技术规范 第 1 部分：交易平台技术规范（国家发改委令第 20 号） 2 公共资源交易平台系统数据规范（V2.0）（发改办法规20181156 号）