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