结算接口需求-遵义市住房公积金管理中心.docVIP

Page PAGE 22 of 56 《资金结算系统》 银行技术接口需求 文件状态： [ ] 草稿 [√] 正式发布 [ ] 正在修改 文件标识： 当前版本： 作 者： 完成日期： 文档历史修改记录 版本状态 起草日期 备注 V1.00 2013-12-10 V1.01 2014-06-06 对应答报文头进行详细说明 V1.1 2014-06-17 增加中心发起接口：获取联行号和银行返回联行号信息的文件格式  目 录 TOC \o 1-3 \h \z \u 银企互联 4 一 银行接入方式 4 二 银企业务模式 4 1 银企业务概述 4 2 银企业务种类 5 三 接口报文格式 5 1 接口报文格式 5 2 文件传送格式 26 3 接口示例 30 附录 38 1 返回码一览表（银行中心使用） 38 2 银行编码表 39 3 证件类型 39 4 其他说明 39 5 附议 39 银企互联 银行做公积金中心的委托结算机构，公积金中心借助商业银行成熟的、先进便捷的结算手段，建立公积金业务系统与商业银行的直连平台，为资金管理服务提供多渠道和客户化支持， 以便实现实时、分时划账的资金结算业务。 一 银行接入方式 (1) 通过TCP/IP协议使用SOCKET进行自定义接口方式进行传输，报文接口格式使用标准的xml数据报文格式，报文中xml数据加密传输。报文中的长度指加密后的长度。 (2) 采用文件传送模式。对于批量传送多条信息记录时采用文本文件FTP方式进行传送，文件格式采用分隔符文件格式进行传输。 二 银企业务模式 1 银企业务概述 本章节主要针对住房公积金中心与委托银行开展的委托公积金结算相关业务，主要包括归集的提取业务、贷款回收业务、联名卡查询、贷款发放、银行账户转账等业务。 提取业务：指住房公积金管理中心委托银行从中心指定的提取账户支付中心已审批通过的提取金额到个人联名卡（借记卡、折）中。 贷款回收：指住房公积金管理中心委托银行将借款职工的月还款额由借款职工的还款账户划至中心指定的委托贷款回收户中。 贷款发放：指住房公积金管理中心委托银行将放贷账户中的金额划至符合贷款条件约定的个人或者单位账户中。 2 银企业务种类 公积金中心与委托银行的直连业务按照时序上划分有实时、分时两种业务。按照交易记录数量划分为：单笔和批量两种业务类型。 按照公积金营业时段划分,可分为：日常交易、日终交易。按照交易账务类型可划分为：账务类交易、非账务类交易。 三 接口报文格式 接口报文格式 （1）报文格式约定 交易报文采用XML格式，且带XML头部（?xml version=1.0 encoding=GBK?）声明；XML报文最上层节点为‘root’,样式如下： 对于XML报文中同层节点的顺序，参照本文档中的接口描述顺序,并且xml报文中不能出现空节点。 （2）字段类型约定 字段类型分为以下三类： Cn：表示任何可见字符（包括数字和中文），n表示允许字符的最大长度，如果有效数据长度不足n位则按实际位数。 Nn：表示0-9的数字， n表示有效数据的最大长度，前后不能加空格或其它非法字符。 Nm.n：基本上与Nn类型类似，但字段内容可以允许为负号、0-9数字和小数点，其中m表示有效数据的最大长度（不包括小数点），n表示小数位数，通常用来表示发生额、余额等金额类字段。如N14.2表示14位有效数（不包括小数点），其中带两位小数位的字段。举列：4005.23应表示为 N6.2。 负数的表示方式：对于负号用“-”表示如：-12.9。 （3）返回结果判断 成功标志（ans_code）：每一个应答报文头中都包含该字段，作为每个交易请求的即时应答结果，若ans_code为‘0’表示该交易请求已成功处理或已成功受理，以此为准。 返回信息（ans_info）：银行每一个应答报文头中都包含该字段，作为返回成功或出错信息。 返回附加码（particular_code）： 既四位的返回码，当ans_code不为‘0’时，可以根据该字段判断具体错误情况。当ans_code为0时，particular_code填写为‘0000’。 返回附加详细信息（particular_info）：返回详细出错信息。具体返回码见附录A。 （4）安全加密 通讯报文DES加密传输。所有报文都采用加密方式（不包括心跳报文），报文中的长度指加密后的长度。 （5）通讯方式 采用TCP/IP的短连接形式，通讯流程示意图： 通讯数据包结构格式为：9位报头+数据报，如列表所示： 长度 8位 1位 不定长 内容解释 报文长度(字节，十进制)，