1、 杭州住房公积金余杭分中心业务应用系统 数据交换子系统（银行结算及对账接口） 需求规格说明书 目 录 1. 接口说明 . 3 1.1. 范围 . 3 1.2. 网络架构 . 3 1.3. 数据格式 . 4 1.4. 交换方式 . 4 1.5. 加密说明 . 4 1.6. 其他说明 . 5 2. 接口定义 . 5 2.1. 汇缴业务 . 5 2.1.1. 小 额支付代扣发起 . 6 2.1.2. 小额支付代扣返回 . 9 2.2. 支取业务 . 12 2.2.1. 收款账户检验 . 13 2.2.2. 支取支付（实时支付）本行 . 14 2.2.3. 支取支付（实时支付）跨行 . 16 2.2.
2、4. 定时批量支付 . 错误 !未定义书签。 2.3. 贷款业务 . 22 2.3.1. 贷款批量收回发起 . 22 2.3.2. 贷款批量收回返回 . 25 2.4. 商业贷款划付 . 28 2.4.1. 商业贷款划付签约、撤销签约、查询 . 28 2.4.2. 商业贷款明细发送 . 29 2.5. 对账业务 . 30 2.5.1. 银行日记账对账 . 31 2.5.2. 贷款对账信息分发 . 34 3. 信息代码表 . 35 1. 接口说明 1.1. 范围 本说明规定了住房公积金管理中心和受委托办理住房公积金金融业务的商业银行的数据交换接口格式。 本说明适用于住房公积金管理中心和商业银行间
3、传送住房公积金贷款回收、小额支付、电子对账报文（文件）时的数据交换接口。 1.2. 网络架构 在通讯服务器前部署千兆接口的防火墙系统，达到良好的边界 保护和访问控制的要求，确保只有经过系统认证和授权的合法用户才能访问中心的通讯服务器，保护网络安全。 1.3. 数据格式 报文格式为“报文长度（ 4byte） +报文内容”，例如： 4 字节 20 字节 0 0 2 0 Data 报文为全字符类型。 报文中字符串字段（如银行卡号、住房公积金个人账号、姓名等），不足位数的，右补空格。 报文中金额等字段，不足位数的，左补 0。 本接口涉及到金额部分均以元为单位，小数点后保留两位。 本接口中所有明细文件格
4、式均为文本格式，中间以半角“ ”分隔。长度不限制，金额字段前不补 0;字符串后 不补空格。 本接口中涉及到的日期格式均为年月日顺序，中间不带分隔符，如 YYYYMMDD，表示四位年两位月两位日。 1.4. 交换方式 对于采集对象是受委托办理住房公积金金融业务的商业银行，采取网络传输和介质传输相结合的方式： 实时交易（小额支付等），以网络方式 socket接口和银行交换； 批量交易（如小额支付协议委托扣收、贷款正常收回等）以文件格式数据采用 ftp和传送和存储介质进行数据交换。中心提供给各大商业银行 ftp用户和密码。 通过存储介质进行数据交换时，可以通过移动存储介质为交换介质（如磁盘、磁带、光
5、盘等）。 1.5. 加密说明 接 口定义从 2.1 到 2.4 涉及到的通讯报文都需要加密。 对于 socket 连接传输的报文一律采用加密算法，也就是说对所有接口 ,无论是请求还是应答报文全部加密。 sokect 通讯报文发送的是密文的长度（明文）和加密后的密文，密文解密后是原通讯接口报文。 本次采用的是 openssl对称加密算法中的 3des加密块链接加密方式进行加密， openssl版本暂定为 0.9.8e，具体版本另行约定。 对于文件的加密，算法和 socket 通讯加密算法一致。 动态密码另行约定。 1.6. 其他说明 为了安全起见，约定： 中心通讯 前置机需绑定前台业务机器的 i
6、p 地址。 银行通讯前置机需绑定中心通讯前置机的 ip 地址。 批次号在同一个交易下是唯一的 2. 接口定义 2.1. 汇缴业务 业务流程图 业务流程说明 （ 1）小额支付系统代扣业务： 中心定期产生单据、导出文件放置前置机 返回委托银行 银行接收请求到中心前置机取文件 银行核对文件发送扣款交易 人民银行小额支付系统 付款银行进行扣款、扣款后返回 银行把结果文件放置到中心前置机取文件 银行接收扣款结果 上传 中心接收和核对文件、导入业务系统、记账 发送 通知 发起扣款通知 中心根据单位的发薪日 5 个工作日内（节假日顺延）生成批量代扣文件，按照委托银行进行结算绑定，导出文件，存放到中心通讯前置
7、机。 文件产生和发送需要考虑各种状态（是否都生成文件，是否都发出扣款）贷款也有这种情况 中心发起“小额支付代扣发起”交易。 银行收到交易请求后 ， FTP 至中心前置机取小额支付代扣文件，并确认明细文件。 银行操作员按明细文件内容，在小额系统中启动扣款业务。 银行系统处理完成后，生成并向中心前置机上传回盘文件（扣款结果文件）。 上传回盘文件成功后，启动“小额支付代扣结果返回”交易。 中心收到交易请求，确认服务器上相应的明细文件后，处理相应回盘文件，并入账。 （ 2）补充说明： 公积金的补缴业务，也可以通过小额支付托收； 小额代扣结果尽可能短时间内返回 2.1.1. 小额支付代扣发起 业务规则
8、中心将小额支付代扣文件落地到公积金服务器，发送请求报文。 银行接收请求报文 ，取明细文件，返回信息。 备注中填写的是单据流水号，是唯一键值 注意事项：银行接收请求报文，从中心 ftp 服务器取到文件，马上返回返回应答报文，不需等到文件核对处理完后返回应答报文。 接口报文 中心请求报文： 序号 字段名称 长度 说明 数据包长 4 不含长度本身 4 位 交易码 4 2000 批次号 20 总笔数 6 总金额 12 文件名称 30 银行响应报文： 序号 字段名称 长度 说明 数据包长 4 不含长度本身 4 位 交易码 4 返回值 4 批次号 20 小额代扣发起明细文件名称格式： HS+（文件标志 1
9、 位） _YYYYMMDD（年月日 8 位） +_+批次代码（ 10 位） +.+银行代号（ 6 位） 文件标志： H 汇总 小额代扣发起明细文件内容格式： 汇总列： H总笔数 总金额 文件名称 明细列： M收款人开户银行 收款人账号 收款人名称 付款人开户银行 付款人账号 付款人名称 金额 协议编号 djhm银行机构代码摘要 例如： 2010 年 6 月 22 日， 1100090672 批次的明细文件，如下： 文件名称： HSH_20100622_1100090672.010101 文件内容： H29228.00HSH_20100622_1100090672.010101 M杭州余杭 XX
10、 银行 13452061072杭州住房公积金管理中心余杭分中心 杭州余杭 XX 银行 3237777272杭州余杭 XX 公司 4614.0086610001606单据号 银行机构码 M杭州余杭 XX 银行 13452061072杭州住房公积金管理中心余杭分中心 杭州余杭 XX 银行 3237777273杭州余杭 XX 公司 4614.0086610001607单据号 银 行机构码 说明：增加摘要字段，银行扣款时需写入单位明细账的摘要栏 2.1.2. 小额支付代扣返回 业务规则 银行将小额支付代扣结果送往公积金服务器，发送请求报文。中心接收报文，核对明细文件，返回信息。 接口报文 银行请求报文： 序号 字段名称 长度 说明 数据包长 4 不含长度本身 4 位 交易码 4 2001 批次号 20 总笔数 6 总金额 12 文件名称 30 中心响应报文： 序号 字段名称 长度 说明 数据包长 4 不含长度本身 4 位 交易码 4 返回值 4 批次号 20 小额代扣明细返回文件名称格式： HR+（文件标志 1 位） _+YYYYMMDD（年月日 8 位） +_+批次代码（ 10 位） +.+银行代号（ 6位） 文件标志： H 汇总 小额代扣明细返回文件内容格式： 汇总列： H总笔数 总金额 文件名称 （批扣文件第一行原样返回）
