财政票据电子化暨非税收入收缴管理系统银行端接口报文规范.doc

财政票据电子化暨非税收入收缴管理系统
银行端接口报文规范
一、接口格式概述
财政系统为外部系统（如：银行）提供了接口标准。财政系统和其他的软件系统通过接口报文进行联机交互。本文档中所有数据项的结构示意图，如某项注为（0,N）,表示该项值可能为空，并且可能有N字节长度；某项注为（1,N）,表示该项不能为空，至少出现一到N字节长度。
报文和文本文件中的数据类型有String表示为字符型，NString表示只为数字内容的字符；金额型为小数后两位含小数点最长18位（，）；数字型为整数或小数，小数点后最多6位，长度最长18位；Date型为日期8位，如；版本号参数值：；报文中的“强制/可选”域有三个选项M、O、*M，M表示该域必填，O表示该域可以为空，*M表示在特定的情况下必填。
二、接口格式结构
（一）报文结构说明
交易报文包含两个部分组成，依次是报文头、报文域；报文域包含报文内容和数字签名两部分。其结果如图：
1、报文头
报文头是报文第一个数据元素，主要记录了报文长度、应用程序、版本、报文类型、报文域数据类型等基本信息，报文头各个元素长度都是定长。不足位数后面补空格。
2、报文域
报文域构成了报文的主体，内容主要是封装标准的字符串，各个字段表示为：各个字段之间以一个“^|”分隔。
对于报文都有数字签名，数字签名部分用于存放对报文内容的数字签名信息，用于交易参与方的身份认证。只有报文域中报文内容项才进行数字签名。
3、报文种类
（1）编号说明
第一位表示谁发起（1商业银行发起、2财政发起、9：通用），二、三、四位表示序号。
（2）报文种类及文件名称列表
报文种类
报文名称
备注
柜台缴款
1001
银行查询缴款书报文
1002
银行向财政发送银行手动输入的缴款书明细信息报文
2001
财政正确发回银行的缴款书明细报文
1003
银行向财政发送缴款书确认信息报文
1004
银行查询已经缴款的缴款书报文
日终对账
1011
银行向财政发送银行日切信息报文
2011
财政发送银行对账情况报文
1015
银行向财政发送POS日切信息报文
2015
财政发送银行POS对账情况报文
辅助报文
2110
财政给银行应补传相应日期文件的报文
2111
财政给银行要求下载更新财政基础数据文件通知
1111
银行给财政已上传银行数据文件通知
9001
通用应答报文
9005
联网测试报文
文本文件
银行向财政发送银行日缴款书明细文件
银行向财政发送POS日缴款书明细文件
财政给银行财政账户信息文件
银行给财政账户余额文件
银行给财政账户收支明细文件
4、报文头数据项
域
域名称
类型
长度
数据项描述
HeadLength
报文头长度
NString
2
MsgLength
整个报文长度
NString
6
APP
应用程序名称
String
8
填写为DQ_NOTAX
VER
版本号
String
3
报文的版本号，区分接口报文不同的版本
MsgNo
报文编号
NString
4
所发报文的编号
MsgID
报文唯一标志符
NString
18
用于发起方唯一标识一笔报文，由发起方自定义
MsgRef
报文参考号
NString
18
由交易发起者产生，回应报文自动带回，具体内容由发起者填写，用于标识回应报文对应的原报文，从而便于发起者完成原报文与回执报文的匹配处理，发起请求报文时报文参考号同报文标识号
BankCode
银行编码
NString
2
财政指定代表银行唯一的编码
Resvered
保留使用
String
10
共占71个字节。所有域都为定长的必填域。不足位数后面补空格。
（二）文本文件结构说明
文本文件中存放标准字符串格式的各个字段值，各个字段之间以一个“^|”分隔，一行结束需加回车换行符。
（三）报文格式及文本文件说明
1、柜台缴款接口
（1）银行查询缴款书报文(1001)
数据项名称
类型
长度
数据项描述
强制/可选
缴款书号
String
[1,70]
手工录入存放缴款书上的印刷号（非税收入一般缴款书、交警的处罚决定书），二维码扫描的存放扫描内容
M
票面信息校验码
String
[1,10]
手工录入存放缴款书上的票面信息校验码，二维码扫描的固定填写
M
“000”，交警处罚决定书的固定填写“00