☆重要资料、严禁外传☆
非税收入管理系统代理银行接口开发指南
河南省财政厅
中华人民共和国财政部信息网络中心
北京兴财信息技术开发公司非税事业部
2011年03月
阅读指南
【阅读对象】
本手册是为非税收入代理银行业务系统的技术开发人员编写的。阅读者应该具备一定的开发基础知识，对银行内部的业务系统有一定的了解。在开发银行接口前，请仔细阅读本手册的各章节并事先阅读“非税收入管理系统代理银行业务描述.doc”。
【内容简介】
本手册包含如下内容：
第一章：接口方案,详细介绍非税收入代理银行系统与非税系统交换接口总体方案。
第二章:数据报文,详细定义了每一种业务涉及的数据交换报文格式。
目录
1接口方案 (6)
1.1总体部署 (6)
1.2技术架构 (7)
1.3队列规划 (8)
1.4实现逻辑 (8)
2数据报文 (10)
2.1报文种类 (10)
2.1.1请求报文 (10)
2.1.2响应报文 (11)
2.2报文格式 (11)
2.2.1请求报文 (11)
2.2.2响应报文 (12)
2.3报文体格式 (13)
2.3.1签入签出报文 (13)
2.3.2数据下载报文 (14)
2.3.4补录登记报文 (22)
2.4常数定义 (22)
2.4.1响应状态标志位 (22)
2.4.2日期和时间 (22)
2.4.3数量和金额 (22)
2.4.4结算形式 (22)
2.4.5缴库方式 (22)
2.4.6特殊标志 (22)
2.5字段说明 (23)
2.5.1单位信息 (23)
2.5.2项目信息 (23)
2.5.3网点信息 (23)
2.5.4票据信息 (24)
2.5.5票据批次信息 (24)
2.5.6专户信息 (24)
2.5.7项目标准信息 (24)
2.5.9银行下载缴款书主信息 (25)
2.5.10银行下载缴款书明细信息 (26)
2.5.11银行上传缴款书主信息 (27)
2.5.12银行上传缴款书明细信息 (27)
2.5.13银行上传待查收入信息 (28)
2.5.14银行上传待查确认主信息 (28)
2.5.15银行上传待查确认明细信息 (29)
1接口方案
1.1总体部署
部署说明
●部署方式
在财政内部部署“财政厅数据传输程序”和TongLINK/Q传输节点。
每个省级银行部署“省行端数据传输程序”和TongLINK/Q传输节点。
●实现模式
“财政厅数据传输程序”负责与财政厅非税收入管理系统对接，实现业务处理。
TongLINK/Q传输节点构建成星型传输网络，实现财政厅与各省行之间数据互联传输，保障传输数据的可靠和安全。
“省行端数据传输程序”负责与各省行业务系统对接，由各省行基于TongLINK/Q API 遵照接口标准和报文格式自行开发。
网络基础
财政厅与各省级银行间专网。
1.2技术架构
技术架构图说明
财政端的TongLINK/Q传输节点设置1个接收队列，用于处理从各银行传到财政的数据报文；为每个银行设置1个发送队列，用于从财政发送数据到银行。
银行端的TongLINK/Q传输节点设置1个指向财政厅的发送队列，用户从银行将数据报文发送到财政厅；设置1个接收队列，用于接收从财政厅发送到银行的数据报文。
数据传输程序包括发送模块、接收模块和业务处理模块三部分。
业务处理模块用于组织数据报文、与应用系统交换等业务相关的处理功能。
发送/接收模块调用TongLINK/Q API接口实现数据信息的发送与接口。
1.3队列规划
队列命名规范
1、所有发送队列的命名均以“_snd”为结尾；所有接收队列的命名均以“_rcv”结尾。
2、发送队列的命名以“To”+“目的银行代码”+“_snd”的形式命名。目的银行代码可以银行英文缩写或者自定义英文代码来标示，具体命名可在实施阶段统一规划。
3、接收队列的命名以“目的银行代码”+“_rcv”的形式命名。
1.4实现逻辑
关键逻辑说明
1、银行端与财政厅端的消息发送与回复是通过TongLINK/Q的消息ID进行关联和匹配的。
2、如果银行端发送消息后没有接收到回复消息，超出等待时间后，应重新发送原报文。财政厅端接收到重发的数据报文后，根据报文头信息进行判断，并重新发送回复消息。
3、TongLINK/Q的所有消息属性配置均为持久化消息，且生命周期为永不过期。
2数据报文
2.1报文种类
2.1.1请求报文
请求报文是指代理银行进行各类业务登记时向非税系统发起的数据报文。
2.1.2响应报文
响应报文是指非税系统针对代理银行的请求报文返回的处理结果。
2.2报文格式
请求报文和响应报文均由三部分组成：报文头、报文体、报文尾。
报文中使用的分隔符定义如下：
（1）数据类型分隔符号：char(30)
（2）数据字段分隔符号：char(31)
（3）记录分隔符号：char(12)
（4）主从信息分隔符：char(13)
（5）报文结束符号：char(4)
2.2.1请求报文
