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

《资金结算系统》银行技术接口需求文件状态：[] 草稿[V]正式发布[] 正在修改文件标识：当前版本：作 者：完成日期：文档历史修改记录版本状态起草日期备注V1.002013-12-10V1.012014-06-06对应答报文头进行详细说明V1.12014-06-17增加中心发起接口：获取联彳丁号和银行返回 联行号信息的文件格式银企互联4一银行接入方式 4二银企业务模式 41银企业务概述42银企业务种类4三接口报文格式 51 接口报文格式52 文件传送格式263 接口示例34附录421 返回码一览表（银行中心使用） 422 车艮行编码表 423 证件类型434 其他说明435 附议 43银企互联银行做公积金中心的委托结算机构， 公积金中心借助商业银行成熟的、 先进 便捷的结算手段，建立公积金业务系统与商业银行的直连平台，为资金管理服务 提供多渠道和客户化支持， 以便实现实时、分时划账的资金结算业务一银行接入方式(1) 通过TCP/IP协议使用SOCKE进行自定义接口方式进行传输，报文接 口格式使用标准的xml数据报文格式，报文中xml数据加密传输报文中的长度 指加密后的长度2) 采用文件传送模式。

对于批量传送多条信息记录时采用文本文件FTP方式进行传送，文件格式采用分隔符文件格式进行传输二银企业务模式1银企业务概述本章节主要针对住房公积金中心与委托银行开展的委托公积金结算相关业 务，主要包括归集的提取业务、贷款回收业务、联名卡查询、贷款发放、银行账 户转账等业务提取业务：指住房公积金管理中心委托银行从中心指定的提取账户支付中心 已审批通过的提取金额到个人联名卡(借记卡、折)中贷款回收：指住房公积金管理中心委托银行将借款职工的月还款额由借款职 工的还款账户划至中心指定的委托贷款回收户中贷款发放：指住房公积金管理中心委托银行将放贷账户中的金额划至符合贷 款条件约定的个人或者单位账户中2银企业务种类公积金中心与委托银行的直连业务按照时序上划分有实时、分时两种业务按照交易记录数量划分为：单笔和批量两种业务类型按照公积金营业时段划分，可分为：日常交易、日终交易按照交易账务类 型可划分为：账务类交易、非账务类交易三接口报文格式1接口报文格式(1)报文格式约定交易报文采用 XML格式，且带 XML头部()声明；XML艮文最上层节点为‘root ',样式如下：公共报文头交葛报文体对于XML报文中同层节点的顺序，参照本文档中的接口描述顺序 ,并且xml 报文中不能出现空节点。

2)字段类型约定字段类型分为以下三类：①Cn：表示任何可见字符(包括数字和中文)，n表示允许字符的最大长度， 如果有效数据长度不足n位则按实际位数②Nn：表示0-9的数字，n表示有效数据的最大长度，前后不能加空格或 其它非法字符③Nm.n：基本上与Nn类型类似，但字段内容可以允许为负号、0-9数字和 小数点，其中m表示有效数据的最大长度(不包括小数点)，门表示小数 位数，通常用来表示发生额、余额等金额类字段如 N14.2表示14位 有效数(不包括小数点)，其中带两位小数位的字段举列：4005.23应 表示为N6.2④ 负数的表示方式：对于负号用“-”表示如：-12.93)返回结果判断成功标志(ans_code)：每一个应答报文头中都包含该字段，作为每个交易 请求的即时应答结果，若ans_code为’0'表示该交易请求已成功处理或已成功 受理，以此为准返回信息(ans_info ):银行每一个应答报文头中都包含该字段，作为返回 成功或出错信息返回附加码(particular_code )：既四位的返回码，当ans_code不为‘0' 时，可以根据该字段判断具体错误情况当ans_code为0时，particular_code填写为‘0000'。

返回附加详细信息(particular_info )：返回详细出错信息具体返回码见 附录A4)安全加密通讯报文DE劭口密传输所有报文都采用加密方式(不包括心跳报文)，报 文中的长度指加密后的长度5)通讯方式采用TCP/IP的短连接形式，通讯流程示意图:通讯数据包结构格式为：9位报头+数据报，如列表所示:长度8位1位不一内容解释报文长度（字节，十进制），不包括 报头长度前8位，包含1位标志左对齐，右补空格标志位要传车^的XML报文住房公积金中心与银行接H银行通讯机标志位说明：a. “0” ：全报文为不加密b. “1” ：全报文加密9位报文头变长XML报文体（6）异常处理通讯超时约定为15秒（可以动态配置该参数，但默认为 15）,当交易过程 中发生通讯超时异常时，此时可能会有两种情况：1、中心发送指令失败，银行未收到交易请求；2、中心发送指令成功，且银行已处理（成功或失败），但中心 （由于网络故障等）未接收到银行应答会再发起转账查询交易，查询该笔交易 的状态若查询仍未返回则根据实际情况作如下处理：A.对于中心同行业务，在多次超时并且查询无返回时系统默认为失败，等 到日终对账处理B.对于中心的跨行业务，在多次超时并且查询无返回结果时，系统默认失败。

等到日终对账处理C.在日间存在不明确的应答结果时：如：公积金中心与委托银行在收发支付电子指令时，会发生通讯异常或是超时响应等状态当出现超时时，公积金系统会自动发送一个转账查询交易来 查询该笔交易状态，若转账查询交易也出现超时现象 则公积金中心系统都 默认为失败，等待日终对账处理出现异常的交易公积金系统在日终前不会Page 7 of 56再重发日终对账后，对中心有，银行无的情况，中心进行抹账处理中心 无银行有的情况，中心进行补账处理对双方都有发生，金额不符情况，按 照银行结果中心进行调整D.在日间存在明确应答结果情况下：若公积金中心向委托银行发送实时结算请求时， 委托银行返回成功应答给公 积金中心，在日终对账时中心有而银行无， 此时需要银行补账若公积金中 心向委托银行发送实时结算请求时，委托银行返回失败应答给公积金中心， 在日终对账时中心无而银行有，此时需要银行冲账所有的交易报文中体现的日期均为公积金系统的业务交易日期，对账中请使用的也为业务交易日期交易接口中的要素标签都为小写字母7）交易码与接口对照表交易码交易名称使用接口A00001同行业务中心同行业务（加密）A00002跨行业务中心跨行业务（加密）A00006转账查询转账查询（加密）A00008日终对账日终对账（加密）A00009明细对账（账户明细下载）明细对账（加密）A00011批量文件传送通知批量文件传送通知（加密）A00012密钥发送密钥发送（不加密）A00021批量业务回执批量业务回执（加密）A00023银行卡（折）校验银行账户启效性校验（加密）A00025公积金专户余额查询公积金专户余额查询（加密）A00026获取联彳T号获取联仃勺（加号）(8)对账方式结算平台对账指公积金中心通过结算平台发起的所有成功和失败的账务类交易流水与银行的核对，非结算平台发起的金额发生不在结算平台对账内容之 中。

中心与银行方结算平台对账由中心系统发起完成 对账接口中的日期使用的 是公积金系统发生日期公积金中心每天在日结之后系统自动发起结算平台对账对账发起的起始日期和终止日期都是使用交易发送的自然日期但交易报文中使用的日期均为公积金的业务日期自然日期与业务日期原则上为同一天对账的账务类交易具体为：在日终结算平台对账出现的几种异常情况，进入人工干预机制，经中心与银 行双方确认无误后，可分别做如下处理：A.银行有，中心无对于银行有该笔业务，而中心无的业务，确认为银行返回成功的，中心通过 异常处理模块将账务补齐；确认为银行返回失败的，银行负责抹账处理并书面说 明原因B.中心有，银行无对于中心有，银行无的业务，确认为银行返回成功的，由银行将账务补齐并书面说明原因；该业务确认为银行返回失败的，由中心负责抹账处理系统提供对异常账务的查询，对于异常处理之前和之后都可以查询到其状态异常处理模块为综合业务系统中异常账务处理模块，可以实现抹账、补账的 功能9)请求报文头报文名称请求报文头报文用途报文类型请求公共包头备注最后修改日期字段名（包括路径）字段中文含 义取值 范围必填说明//请求应答标 志C1Y请求-0应答-1//报文类型C2Y同行业务-01跨行业务-02转账查询-03撤销-04日终对账-05账户明细下载-06联名卡中心挂失-07批量文件传送通知-08密钥发送-09批量业务回执-20银行账户校验-21 公积金账户余额查询-22（红色表示暂时没有此报文）//交易码C6Y//机构码C13Y网点//用户号C30Y柜员//发起方序号C32Y报文标小//原发起方序 号C32报文标小//交易日期C10Y公积金的业务日期格式为 YYYY-MM-DD//时间N6Y时间戳hhmmss//渠道标志C2YA位：0-柜面1-网站2-客服中心3-查询机第二位：1-手工9-报盘0-系统//银行标识C201:XX 行02:XX 行03:……（托付，填写付款银行；托收，填写收款银行） 参考附录A//密钥C16为二级加密，加密算法采用标准 DES算法。

备用）//1/卜田J取C1024暂时不用接口说明：1）发起方序号，由交易的发起方填写，发起方序号可以标识唯一的报文，每个 交易日期内发起方序号不重复2）应答报文头中“原发起方序号”，填写请求报文中的“发起方序号”3）对于异步批量交易发送批量业务回执时，请求报文头中的“原发起方序号”： 必须填写此时填写接到“批量业务传送通知”时请求报文头中的“发起方序 号”。