安徽合肥公共资源交易中心
- 格式：doc
- 大小：515.50 KB
- 文档页数：36
安徽合肥公共资源交易中心
保证金对接接口2018版
一、 引言
保证金支付大体分为四个模式，银行直连缴纳保证金、支付平台缴纳保证金、缴纳码缴纳保证金、虚拟子账户缴纳保证金，本接口文档，针对虚拟子账户缴纳模式完成对接说明。
1.1 编写目的
本接口需求文档旨在规范网上招投标业务实现保证金收费流程中涉及的接口规范。
本文档预期读者为网银接口对接设计及开发人员。
1.2 对接说明
安徽合肥公共资源交易中心网银接入平台旨在完成与各个银行系统平台进行系统对接，用以实现商户平台的有关网银对接需求。
实现技术一般为采用TCP/IP的Socket方式进行通讯，将网银操作指令发送到银行相关系统平台进行处理，安全性一般通过银行内部专网方式保障。
交易中心发给银行的报文头前统一加了12位的定长字符，10位为标识报文长度，不足10位以左补0补足，最后2位固定00；同样银行返回交易中心的报文前也需要增加12位定长字符，10位标识报文长度，不足10位以左补0，最后2位固定00。
1.3 业务参考流程图
保证金流程示意图（虚拟子账户缴纳保证金模式）中心银行投标人 合同备案 中标公示 开标后 开标前划分标段招标公告分标段生成虚拟子帐号场地预约开标时间维护默认保证金截至时间等于开标时间保证金截至时间维护保证金入账数据查询保证金入账明细查询保证金截至时间之后可查询保证金入账数目查询开标时间之后可查询保证金入账明细查询未中标退款对未中标单位进行退款支持分批次退款保证金自动退款未中标退款查询退款明细查询中标人退款中标人采用线下退款方式给银行指令做已退标记人工退款标记保证金利息试算查询保证金利息试算项目结束项目结束保证金虚拟子帐号放在公告上进行外网公示银行帐号信息配置缴纳保证金查看招标公告保证金标段一保证金标段二保证金标段三开始中心虚拟子账户已对接的银行信息及母帐号信息投标人账户根据入账流水及入账信息退款给投标人（含利息）结束中心虚拟子账户中心母账户虚拟子账户剩余金额及利息自动转入中心实体母账户并回收虚拟子账户
二、 接口说明
客户在商户网站确认网银操作后，安徽合肥公共资源交易中心网银接入平台会将参数数据组织成银行需要的格式传递给银行系统，由银行系统完成处理后，将结果返回给安徽合肥公共资源交易中心网银接入平台。
其中带（*）的表明为接口中必填字段。
具体接口参数要求如下。
2.1 生成虚拟账号
2.1.1 功能描述
银行虚拟子账户的产生可分为两种：一种为按标段唯一标识产生虚拟子账户；一种按该标段报名的投标人产生虚拟子账户。两种模式根据交易中心要求不同，可在此方案中兼容。
由中心向银行发送生成虚拟子账户电子指令，银行接收到指令之后，在指定母账户下开立保证金子账户，子账户户名同母账户户名。银行产生子帐号的同时会生成一个授权码（授权码与标段唯一标识一一对应），后续对子帐号的相关操作，银行需先比对标段唯一标识及其授权码是否同银行匹配方可进行相关交易。
注：
1、红色部分主要用于投标人生成虚拟账号时使用。即基本帐户帐号为空，则按照项目生成子账户，如果基本帐户帐号不为空则按照投标人生成子账号。
2、保证金截止日期用于银行方控制账户来账时间，以及数目查询的约束。
3、开标时间用于控制入账明细查询，开标时间之前调用查询保证金入账明细查询（3001）则需返回查询失败并给出相应提示。
4、如项目的交易地区代码和专线不一致，要求银行控制保证金子账户的产生，避免投标人保证金缴错账户。
5、BiaoDuanNo、OpenDate、OpenTime、BZJEndDate、BZJEndTime、IsRetire、BZJAheadView（除BaseAcctNo、BaseAcctName、MatuDay外字段）均为标段的属性，投标人模式下若同一标段调用多次该接口，我方会保证上述字段的一致性。
2.1.2 接口参数描述
中心向银行推送的参数
数据项 名称 长度 说明
交易代码（*） TransCode 10 3001
交易日期（*） TransDate 10 YYYYMMDD
交易时间（*） TransTime 10 HHMMSS
交易流水号 （*） SeqNo 50 不重复,具体规则见字典表
交易地区代码（*） ZoneName 50 标注各地市招投标系统，如XuanCheng、BengBu
母账户账号（*） AcctNo 50 系统保留，中心账号是明确的
标段唯一标识（*） BiaoDuanNo 50 标示项目标段信息
开标日期 OpenDate 10 YYYYMMDD
开标时间 OpenTime 10 HHMMSS
保证金截止日期 BZJEndDate 10 YYYYMMDD
保证金截止时间 BZJEndTime 10 HHMMSS
基本帐户帐号 BaseAcctNo 50 投标单位信息
基本账户名称 BaseAcctName 50
是否退息（*） IsRetire Int 0- 是,1- 否
是否提前查看保证金缴纳家数 BZJAheadView 10 0-不允许 1-允许
到期日 MatuDay datatime 保留字段，实现自动销户功能，若所在无特殊要求，传空即可。
备用字段 Bak1 50 备用字段，用于项目上特殊要求
报文格式
******
******
******
******
******
******
******
******
******
******
******
******
******
******
******
******
******
银行返回给中心的参数：
数据项 名称 长度 说明
交易代码（*） TransCode 10 3002
交易流水号（*） SeqNo 50 不重复（银行方交易流水号）
交易日期（*） TransDate 10 YYYYMMDD
交易时间（*） TransTime 10 HHMMSS
应答代码（*） Result Int 1 成功 0失败
交易结果信息 TransRltMsg 50 交易结果说明
若成功返回：交易成功
虚拟子账号（*） IAcctNo 50 虚拟子账号
虚拟子账户授权码
(用于后续交易的身份认证) （*） AuthCode 50 授权码，用于后续交易的验证，和标段一对一
备用字段 Bak1 50 备用字段，用于项目上特殊要求
报文格式：
******
*******
******
******
******
******
******
******
******
2.1.3 修改说明
2.2 开标时间维护
2.2.1 功能描述
对于招标公告发布时，未确定开标时间的，或项目开标时间有临时变动的，中心可通过该交易维修项目开标时间。在开标时间之前无法查询保证金入账明细。
由中心发起通知。
注：1、开标时间允许为空
2、投标人模式下，银行需根据标段唯一标识维护与该标段相对应的所有子账号的开标信息。
2.2.2 接口参数描述
中心向银行推送的参数
数据项 名称 长度 说明
交易代码（*） TransCode 10 3041
交易日期（*） TransDate 10 YYYYMMDD
交易时间（*） TransTime 10 HHMMSS
交易流水号 （*） SeqNo 50 不重复
交易地区代码（*） ZoneName 50 标注各地市招投标系统，如XuanCheng、BengBu
标段唯一标识（*） BiaoDuanNo 50 开标日期 OpenDate 10 YYYYMMDD
开标时间 OpenTime 10 HHMMSS
中心授权码（*） AuthCode 50 必填（生成帐号时银行返回，此处用于身份验证，银行需验证标段唯一标识和授权码均与银行匹配放能操作）
备用字段 Bak1 50 备用字段，用于项目上特殊要求
报文格式：
******
*******
******
******
******
******
******
******
******
******
银行返回给中心的参数：
数据项 名称 长度 说明
交易代码（*） TransCode 10 3042
交易日期（*） TransDate 10 YYYYMMDD
交易时间（*） TransTime 10 HHMMSS
交易流水号（*） SeqNo 50 不重复（银行方交易流水号）
应答代码（*） Result Int 1 成功 0失败
应答描述 AddWord 500 若成功则返回：交易成功
备用字段 Bak1 50 备用字段，用于项目上特殊要求
