非税收入管理系统代理银行接口开发指南(Socket)

☆重要资料、严禁外传☆

非税收入管理系统代理银行接口开发指南

河南省财政厅

中华人民共和国财政部信息网络中心

北京兴财信息技术开发公司非税事业部

2011年03月

阅读指南

【阅读对象】

本手册是为非税收入代理银行业务系统的技术开发人员编写的。阅读者应该具备一定的开发基础知识，对银行内部的业务系统有一定的了解。在开发银行接口前，请仔细阅读本手册的各章节并事先阅读“非税收入管理系统代理银行业务描述.doc”。

【内容简介】

本手册包含如下内容：

第一章：接口方案,详细介绍非税收入代理银行系统与非税系统交换接口总体方案。

第二章:数据报文,详细定义了每一种业务涉及的数据交换报文格式。

目录

1接口方案 (6)

1.1总体部署 (6)

1.2技术架构 (7)

2数据报文 (8)

2.1报文种类 (8)

2.1.1请求报文 (8)

2.1.2响应报文 (9)

2.2报文格式 (9)

2.2.1请求报文 (9)

2.2.2响应报文 (10)

2.3报文体格式 (11)

2.3.1签入签出报文 (11)

2.3.2数据下载报文 (12)

2.3.3业务登记报文 (16)

2.3.4补录登记报文 (20)

2.4常数定义 (20)

2.4.1响应状态标志位 (20)

2.4.2日期和时间 (20)

2.4.3数量和金额 (20)

2.4.4结算形式 (20)

2.4.5缴库方式 (20)

2.4.6特殊标志 (20)

2.5字段说明 (21)

2.5.1单位信息 (21)

2.5.2项目信息 (21)

2.5.3网点信息 (21)

2.5.4票据信息 (22)

2.5.5票据批次信息 (22)

2.5.6专户信息 (22)

2.5.7项目标准信息 (22)

2.5.8单位项目挂接信息 (23)

2.5.9银行下载缴款书主信息 (23)

2.5.10银行下载缴款书明细信息 (24)

2.5.11银行上传缴款书主信息 (25)

2.5.12银行上传缴款书明细信息 (26)

2.5.13银行上传待查收入信息 (26)

2.5.14银行上传待查确认主信息 (27)

2.5.15银行上传待查确认明细信息 (28)

1接口方案

1.1总体部署

部署说明

●部署方式

在财政内部部署“财政厅数据传输程序”和Socket服务端。

每个省级银行部署“省行端数据传输程序”和Socket客户端。

●实现模式

“财政厅数据传输程序”负责与财政厅非税收入管理系统对接，实现业务处理。

通过Socket实现财政厅与各省行之间数据互联传输，保障传输数据的可靠和安全。

网络基础

财政厅与各省级银行间专网。

1.2技术架构

技术架构图说明

财政端的Socket服务端，用于处理从各银行传到财政的数据报文。

银行端的Socket客户端，用于从银行将数据报文发送到财政厅。

数据传输程序包括发送模块、接收模块和业务处理模块三部分。

业务处理模块用于组织数据报文、与应用系统交换等业务相关的处理功能。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请求报文

2.2.2响应报文

2.3报文体格式2.

3.1签入签出报文2.3.1.1签入登记

2.3.1.2签出登记

2.3.2数据下载报文2.3.2.1下载单位信息

2.3.2.2下载项目信息

2.3.2.3下载网点信息

2.3.2.4下载票据信息

2.3.2.5下载票据批次信息

2.3.2.6下载专户信息

2.3.2.7下载项目标准信息

2.3.2.8下载单位项目挂接信息

2.3.3业务登记报文

2.3.3.1正常收入登记（机打）

2.3.3.2正常收入登记（手工）

2.3.3.3银行开票登记

2.3.3.4校验收费是否合法

2.3.3.5待查收入登记

2.3.3.6待查确认登记（机打）

2.3.3.7待查确认登记（手工）

2.3.3.8业务冲销登记

2.3.4补录登记报文

说明：只需将请求报文头的“特殊标志”更改为1即可，报文格式与其他业务登记报文相同。

2.4常数定义

2.4.1响应状态标志位

1：成功， -1：失败

2.4.2日期和时间

1、日期都为10位的字符串，yyyy-MM-dd 。例如：2010-01-01

2、时间都为19位的字符串，yyyy-MM-dd hh:mm:ss。例如：2011-01-01 15:03:03 2.4.3数量和金额

1、数量为数字类型，最多只能有4位小数。例如：100.0001

2、金额为数字类型，最多只能有2位小数。例如：100.01

2.4.4结算形式

1:现金， 2:转账

2.4.5缴库方式

200:集中汇缴， 300:直接缴库， 400:就地缴库

2.4.6特殊标志

0:正常的代收业务处理，1:补录