住房公积金银行结算数据应用系统公积金中心接口标准V1112Word下载.docx
- 文档编号:19539391
- 上传时间:2023-01-07
- 格式:DOCX
- 页数:83
- 大小:241.88KB
住房公积金银行结算数据应用系统公积金中心接口标准V1112Word下载.docx
《住房公积金银行结算数据应用系统公积金中心接口标准V1112Word下载.docx》由会员分享,可在线阅读,更多相关《住房公积金银行结算数据应用系统公积金中心接口标准V1112Word下载.docx(83页珍藏版)》请在冰豆网上搜索。
1.1.8
2012/8/2
BDC110响应报文添加“利息银行主机流水号”
2012/8/8
BDC108文件明细记录中“付方户名”、“付方余额”、“收方户名”、“收方余额”取消必输属性
1.1.9
2012/8/21
所有“资金交易类型”字段长度从2位变更为6位
资金交易类型代码表初始数据变更
2012/8/22
BDC101单笔付款“本金发生额”取消必输属性,添加“销户支取时必输”说明
BDC103批量付款交易报文字段“付款本金金额”添加“销户支取时必输”说明;
文件字段“本金发生额”、“利息发生额”添加“销户支取时必输”说明
2012/8/28
BDC101单笔付款、BDC103批量付款中增加DeIntCrAcct
1.1.10
2012/9/10
新增理财类交易接口,BDC114-BDC121;
新增定期账户余额查询接口
2012/9/19
BDC108批量业务结果下载“类别”字段取消必输属性,“序号”长度从19改为20
BDC110交易结果查询响应报文新增罚息流水号、违约金流水号
2012/9/21
BDC118、BDC119、BDC120新增“存期”字段
2012/9/25
BDC115、BDC118“活期账户”“活期户名”“活期账户开户机构名”修改为非必输
BDC121“通知设定日期”修改为非必输
2012/10/11
BDC115“原存入金额”修改为“实际金额”,取值从BDC122查询结果报文中的“实际金额”获取
1.1.11
2012/11/9
BDC118、BDC120、BDC121“通知设定序号”长度修改为20位
2012/11/14
BDC109新增“业务明细账号”、“业务明细流水号”字段;
BDC101、BDC102、BDC109“备注”字段修改为必输
2012/11/27
报文头“返回信息”长度从char(80)修改为char(160)
BDC106贷款本息分解响应报文添加说明
新增SBDC100账户变动通知
2012/12/3
BDC113响应文件内容变更,添加定期相关信息
2012/12/12
BDC101响应报文“银行主机处理状态”,新增说明,修改“本金银行主机流水号”和“利息银行主机流水号”的说明
BDC113明细文件“序号”字段改为20位
2012/12/20
BDC106请求报文“银行扣款贷款罚息发生额”,“贷款违约金收方账号”,“贷款违约金收方户名”,“贷款违约金收方账户类别”,“贷款违约金收方账户行名”和“银行扣款贷款违约金发生额”字段由必输改为非必输
2012/01/18
BDC106请求明细文件中“非扣款还贷金额”和“非扣款贷款本金发生额”去除说明,修改该交易明细文件中的平衡关系说明,。
1.1.12
2014/7/2
新增“活期账户实施余额查询”,交易码BDC123
2014/7/15
修改BDC109“单笔转账”返回报文,HostStatus字段增加2:
银行已付款
删除BDC105“贷款扣款交易”输入文件明细最后两个字段
2014/7/17
BDC105请求报文body标签下增加域163,名称BankAcctNo
2014/7/21
1.1.1.贷款本息分解(BDC106)中BtachNo改为BatchNo
目录
1.引言1
1.1.编写目的1
1.2.项目背景1
1.3.参考资料1
2.网络结构2
2.1.连接方式2
3.通信标准4
3.1.基本通信协议4
3.1.1.TCP接入方式4
3.1.2.HTTP接入方式4
3.2.通讯安全4
3.2.1.Openssl简介4
3.2.2.证书的产生5
3.2.3.证书的更新5
3.2.4.同步会话密钥5
3.3.报文接口规范6
3.3.1.交易报文格式6
3.3.2.交易文件传输7
4.外接系统开发支持9
4.1.通信程序库9
4.2.交易核对匹配机制9
5.接口接口规范11
5.1.交易报文头11
5.1.1.名词解释11
5.1.2.公积金中心系统发起11
5.1.3.应用系统发起13
5.2.公积金中心发起的服务接口14
5.2.1.接口探测(SYS600)14
5.2.2.系统签到(BDC001)15
5.2.3.系统签退(BDC002)16
5.2.4.单笔付款(BDC101)17
5.2.5.单笔收款(BDC102)19
5.2.6.批量付款交易(BDC103)21
5.2.7.批量收款交易(BDC104)24
5.2.8.贷款扣款交易(BDC105)26
5.2.9.贷款本息分解(BDC106)28
5.2.10.批量业务结果查询(BDC107)33
5.2.11.批量业务结果下载(BDC108)35
5.2.12.单笔转账(BDC109)37
5.2.13.交易结果查询(BDC110)39
5.2.14.联行号查询(BDC112)41
5.2.15.账户交易明细查询(BDC113)42
5.2.16.活期转定期(BDC114)43
5.2.17.定期支取(BDC115)45
5.2.18.定期转存方式设定(BDC116)47
5.2.19.活期转通知存款(BDC117)48
5.2.20.通知存款支取(BDC118)49
5.2.21.通知存款支取设定(BDC119)51
5.2.22.通知存款支取通知取消(BDC120)52
5.2.23.通知存款支取通知查询(BDC121)54
5.2.24.定期账户余额查询(BDC122)55
5.2.25.活期账户实时余额查询(BDC123)56
5.3.应用系统发起的服务接口58
5.3.1.接口探测(SYS600)58
5.3.2.账户变动通知(SBDC100)59
5.4.响应码定义60
5.5.字段说明60
5.5.1.资金交易类型代码表60
5.5.2.银行编码表61
5.5.3.公积金中心代码表62
1.引言
编写目的
为规范住房公积金银行结算数据应用系统(以下简称“应用系统”)与各住房公积金管理中心IT系统之间直联交易接口和通讯,特制定本公共接口标准,使之作为相关方开发工作的前提和基础。
本文档预期读者为项目主管部门和项目实施部门有关人员、住房公积金管理中心有关人员以及应用系统系统操作用户。
项目背景
为满足住房公积金管理中心电子支付结算需求,统一资金支付结算通道,加强住房公积金监管,国家住房和城乡建设部决定建设全国统一的住房公积金银行结算数据应用系统。
参考资料
《住房公积金银行结算数据应用系统技术方案》
2.网络结构
连接方式
应用系统前置和外接系统可以采用HTTP或TCP的连接方式(其中,主要考虑到外接系统的开发平台,对应于JAVA开发平台,建议采用HTTP,对C平台,采用TCP的连接方式)。
通信安全采用openssl的解决方案。
交易接口报文采用XML报文格式。
上图中,前置与住房公积金银行结算数据应用系统间不采用加密通道,其他连接线路均采用openssl加密。
3.通信标准
基本通信协议
TCP接入方式
TCP接入方式采用短连接。
数据模式采用header+leng+data的模式定义,
Header共16字节,前6位字节为系统节点号,第7个字节为交易类型标识(0-业务类交易,1-签到交易),后9位字节保留备用(全部为‘\0’),leng是32bit的网路字节序的整数,标识整个报文的长度,data是报文数据。
报文数据的格式统一采用后面报文接口规范章节中描述的格式。
HTTP接入方式
HTTP接入方式按照HTTP协议规范交换数据,报文数据直接采用HTTP的body部分作为交易报文数据。
通讯安全
总的原则:
应用系统和外部网络系统之间的交互,采用openssl安全加密;
位于局域网环境内系统之间的交易,则不走加密通道。
应用系统前置和公积金中心系统之间需要走安全通道。
Openssl简介
SSL是SecureSocketLayer(安全套接层协议)的缩写,可以在Internet上提供秘密性传输。
SSL采用公开密钥技术。
其目标是保证两个应用间通信的保密性和可靠性,可在服务器端和用户端同时实现支持。
目前,利用公开密钥技术的SSL协议,已成为Internet上保密通讯的工业标准。
OpenSSL是套开放源代码的SSL套件,其函式库是以C语言所写成,实作了基本的传输层资料加密功能。
证书的产生
✓通过openssl,应用系统前置为每个外接系统产生一对非对称密钥,privatekey保留在前置机(其目录见下面的描述),publickey颁发(通过文件)给外接系统。
✓privatekey的保护:
privatekey被3DES加密后,以文件的形式,保存在前置机上。
该privatekey是所有安全的根,因此,要注意该文件的保护,比如设置适当的访问权限,保护好3DES的密码等。
应用系统前置机上的证书的目录存储结构:
-/key
-/key/CENTER//公积金中心
-/key/CENTER/CENTER-NO//各公积金中心编号
-/key/BANK//银行
-/key/BANK/BANK-NO//各商业银行编号
证书的更新
间隔一定的时间,可以为各个外接系统,重新产生证书,按上面的步骤,颁发给对接系统,以更新各个系统的证书。
同步会话密钥
sessionkey会话密钥的同步,采用外接系统到应用系统前置签到的方式(签到交易)。
其步骤如下所示:
1.外接系统向前置发起签到交易
2.应用系统前置产生一个随机数(会话密钥明文),用对应于该外接系统的privatekey加密(会话密钥密文)
3.将会话密钥密文保存在对应的证书目录中
4.将会话密钥密文返回给外接系统
5.外接系统用publickey解密后,得到会话密钥明文。
6.完成。
该交易必须是外接系统启动后的第一个交易,之后的交易都必须采用该sessionkey加密。
报文接口规范
交易报文格式
交易报文采用XML格式,遵循XML规范。
<
?
xmlversion="
1.0"
encoding="
UTF-8"
>
message>
<
head>
!
--交易报文头信息,具体说明请参考公共报文头说明章节,交易数据内容仅作参考-->
--请求交易码-->
fieldname="
trcode"
010101<
/field>
--...-->
/head>
body>
--交易报文体信息,交易数据内容仅作参考-->
ACCT_NO"
6269000000010002980<
PSWD"
pin="
true"
21BC09DA<
--多条记录内容-->
field-listname="
SUMMARY"
0"
FIELD_1"
00<
FIELD_2"
02<
/field-list>
1"
01<
03<
/body>
/message>
交易报文由两部分组成,交易报文头和交易报文体。
其中交易报文头信息在报文头(head)节点内,交易报文体信息在报文体(body)节点内。
对于密码等敏感信息字段,需要作加密处理,在报文中通过field节点的pin属性来标识,如pin=”true”表示为加过密的数据,缺省为未加密数据。
对于多条记录的情况,第一个field-list节点的名字为数组名,其包含的单条记录节点的命名依次为0、1、2、3……。
交易报文头信息
交易报文头信息的填写标准请参考公共报文头说明章节。
交易报文体信息
根据交易报文接口章节中每个交易的请求/响应接口定义组装报文。
交易报文DTD
--报文格式-->
ELEMENTmessage(head,body)>
--报文头-->
ELEMENThead(field*)>
--报文体-->
ELEMENTbody(field*,field-list*)>
ELEMENTfield(#PCDATA)>
ATTLISTfield
nameCDATA#REQUIRED
pin(true|false)"
false"
ELEMENTfield-list(field-list+|field+)>
ATTLISTfield-list
交易文件传输
交易文件经过编码处理后,嵌入到交易报文中,和交易报文一起发送或接收。
文件格式使用GBK字符集编码,按换行符’\n’划分记录,按分割符’|’划分字段,数据项中不能有半个汉字、分割符’|’、换行符’\n’。
相同文件名不能多次提交。
文件内容压缩编码
发送方传输联机文件时:
将文件内容读出进行ZIP压缩,再进行BCD编码,得到文件内容报文域。
接收方接收联机文件时:
将文件内容报文域取出BCD码字符串,再进行ZIP解压缩,得到原始文件内容。
长度限制
根据实际的交易情况,以及通信方式来定最大长度限制。
现系统最大定义为10M.
文件传输报文规范
文件传输报文遵循上面描述的交易报文规范。
在下面的例子中,文件传输的例子参见红色标记部分。
<
FILE_LIST"
NAME"
filename1<
DATA"
……<
filename2<
其中,红色的部分是用户定义的,NAME和DATA是必须的。
4.外接系统开发支持
通信程序库
通讯程序库包含如下内容:
1.客户端通信函数:
报文的加解密函数、发送报文和接收报文函数,以及签到和签退函数。
2.服务端辅助函数:
通信报文的加解密函数。
以上函数库中,HTTP接入方式的是JAVA版本,TCP接入方式的是C版本
交易核对匹配机制
交易发送和接收数据的核对匹配通过相关各方的流水号对照来关联。
1、从公积金中心方发起的收付款交易:
公积金中心方为发送方,应用系统和银行方为接收方。
发送方流水号、应用系统流水号发给银行方,银行方返回的流水号由应用系统转给公积金中心。
2、从公积金中心方发起的查询下载交易:
公积金中心方为发送方,应用系统为接收方。
公积金中心通过应用系统查询下载。
5.接口接口规范
本文是基于应用系统给出的报文接口,因此文中的输入格式指外系统发送给应用系统的报文格式,输入文件指外系统发送给应用系统的文件,输出格式指应用系统发送给外系统的报文格式,输出文件指应用系统发送给外系统的文件。
交易报文头
在每个交易中都包含的公用控制信息说明。
名词解释
交易机构号:
住房公积金中心、分中心、管理部在应用系统中登记的机构号。
发送方节点号和接收方节点号:
为应用系统给发送交易的公积金中心系统分配的节点编号和应用系统给发送交易的银行系统分配的节点编号。
客户编号:
银行系统给公积金中心分配的客户编号。
公积金中心系统发起
5.1.1.1.输入控制信息
节点
节点属性
中文描述
数据类型
必输
说明
HEAD
SendDate
发送方日期
Char(8)
M
yyyymmdd
SendTime
发送方时间
Char(6)
Hhmmss
SendSeqNo
发送方流水号
Char(26)
全局唯一
TxUnitNo
交易机构号
Char(15)
机构编号
SendNode
发送方节点号
发送方在系统中注册的编号
公积金中心节点号
TxCode
交易代码
参见服务列表
ReceiveNode
接收方节点号
接收方在系统中注册的编号
银行节点号
CustNo
客户编号
Char(32)
银行给公积金中心的客户编号
由银行决定是否需要
OperNo
操作员编号
Char(21)
5.1.1.2.输出控制信息
TxStatus
交易状态
Char
(1)
0成功;
1失败
RtnCode
返回码
Char(20)
00000-为成功
RtnMessage
返回信息
Char(160)
ReceiveDate
接收方日期
ReceiveTime
接收方时间
ReceiveSeqNo
接收方流水号
BDCDate
应用系统日期
BDCTime
应用系统时间
BDCSeqNo
应用系统流水号
应用系统发起
5.1.1.3.输出格式报文头
YYYYMMDD
HHMMSS
由应用系统WEB方式提交的,这里同发送方日期
BD
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 住房公积金 银行 结算 数据 应用 系统 公积金 中心 接口标准 V1112