税务国库横向联网系统接口规范V20.docx
《税务国库横向联网系统接口规范V20.docx》由会员分享,可在线阅读,更多相关《税务国库横向联网系统接口规范V20.docx(48页珍藏版)》请在冰豆网上搜索。
税务国库横向联网系统接口规范V20
附件2
税务国库横向联网系统
接口规范
版本号:
V2.0.0.0
国家税务总局
修改记录
序号
修改时间
修改人
审核人
备注
1.
2006-7-21
臧忠超
修改4.10中关于MQ消息用户标识设置的部分
2.
2007-7-2
段晓燕
修改了2.2节中表1:
税务国库横向联网处理报文清单
3.
2011-8-22
孙亚松
增加了退更免回执
4.
5.
6.
7.
目录
1前言6
1.1目的6
1.2横联系统概述6
1.3参考文献6
2接口分析7
2.1总体业务处理流程7
2.2接口业务处理范围7
3物理连接说明12
4应用连接说明13
4.1应用连接结构图13
4.2应用连接配置16
4.3应用连接信息包压缩16
4.4应用连接批量报文的限制16
4.5应用连接接口处理模式17
4.5.1模式一SKY发送同步请求处理模式17
4.5.2模式二SKY异步业务处理模式18
4.5.3模式三SKY发送信息处理模式19
4.5.4模式四TIPS发送同步请求处理模式19
4.5.5模式五TIPS发送信息处理模式20
4.6应用连接中报文的匹配20
4.6.1基于MQ消息ID的消息匹配机制21
4.6.2基于全局ID的报文匹配机制23
4.6.3基于业务要素的交易匹配机制24
4.7应用连接消息处理模式及匹配列表25
4.8MQ消息过期时间设置28
4.9接口应用系统配置约定29
4.10接口应用系统开发约定30
5接口双方需要完成的工作31
5.1税务总局需要完成的工作31
5.2人民银行需要完成的工作31
6接口报文说明32
7接口安全管理33
7.1税务机关内部权限管理33
7.2应用连接安全33
7.3报文权限控制33
7.4审计追踪33
7.5病毒防范34
7.6网络安全34
8异常及差错处理35
8.1异常处理35
8.1.1业务处理异常35
8.1.2通信异常处理35
8.2差错处理35
8.2.1报文检查错35
8.2.2验证电子签名不符35
8.2.3重账检查机制36
8.2.4核对不平36
8.3故障处理38
8.3.1TIPS处理中心故障38
8.3.2税务机关业务系统故障38
8.3.3税务机关业务系统与TIPS之间网络故障39
8.3.4灾备通信连接切换39
9接口扩展规则40
1前言
1.1目的
本文档的目标是描述连接综合征管系统的税务国库横向联网(以下简称税库银或SKY)系统与国库信息处理系统(以下简称TIPS)之间的接口实现方法。
1.2横联系统概述
建设税务国库横向联网电子缴税系统的主要目标:
运用现代信息网络技术,建立税务、国库间的联网系统,实现税款征缴、入库、退库、更正、对账等全流程的网络化、电子化,加快税款入库速度,提高财政资金运转效率,简化税款征缴程序,为纳税人提供快捷、准确的税款缴纳方式,实现数据传送无纸化、操作程序标准化、账务核对电子化、监控管理实时化、对外服务人性化业务处理模式。
1.3参考文献
税务国库横向联网系统提供一组基于XML格式的报文,实现税务征管业务系统与国库信息处理系统的对接;主要完成税务征管业务系统和国库信息处理系统之间的实时单笔扣税、定时批量扣税、冲正、自缴核销、退库,更正,免抵调等业务的联机处理。
税务国库横向联网系统采用MQ通讯方式,联网系统按照本规范定义的报文格式,接收和发送相应的报文,进行信息交换。
横联系统的业务流程和报文格式,参考如下文件:
文件名称
简介
《税务国库横向联网业务需求书(正式下发稿)》
业务需求的依据
《数据采集交换接口》
金税工程(三期)数据采集/交换标准
《税库银系统的接口技术规范》
即本文档
《附录一:
税库银接口业务处理流程》
《附录二:
税库银业务报文描述:
》
描述业务报文详细信息,和税库银项目中技术报文的扩展内容
《附录三:
税库银业务报文说明》
定义业务服务ID,帮助对业务进行索引
2接口分析
2.1总体业务处理流程
图1总体业务处理流程
如图1中,存在三类处理流程:
1.综合征管系统发起的实时业务
(A1-A4)综合征管系统向国库信息处理系统发起实时请求,国库信息系统实时返回应答;
2.综合征管系统发起的异步业务
(B1-B4)综合征管系统向国库信息处理系统发起异步请求,国库信息系统异步返回应答;
3.国库信息系统发起的异步业务
(C1-C2)国库信息系统发起异步的处理或核对通知,税库银系统接收后,向综合征管系统异步返回。
国库信息系统与银行间接口的规范不在本文档论述范围内。
2.2接口业务处理范围
SKY系统与国库信息处理系统的接口业务处理范围主要包括实时类报文、批量类报文、对账类报文、辅助交易类报文等四类报文。
报文结构分为单笔和批量两种结构,单笔报文指报文所含内容为单笔交易信息,批量报文指报文可包含单笔或多笔明细信息。
具体报文清单如表1所示(各报文格式及填写要求参见《税库银-数据采集交换标准_附录E_业务报文描述》):
表1:
税务国库横向联网处理报文清单
编号
业务名
发起方
服务类型
服务ID
业务报文定义
报文结构
报文内容
1.
实时
扣税
SKY
请求
SKKKA1
taxMLjhSkySsKkRequest.xsd
单笔
2.
TIPS
结果应答
SKKKA1
taxMLjhSkySsKkResponse.xsd
单笔
3.
实时
冲正
SKY
请求
SKKKA2
taxMLjhSkySsKkCzRequest.xsd
单笔
4.
TIPS
结果应答
SKKKA2
注①
单笔
5.
自缴
核销
SKY
请求
SKKKA3
taxMLjhSkyZjhxRequest.xsd
批量
6.
TIPS
收妥应答
SKKKA4
注①
单笔
7.
TIPS
结果通知
SKKKA4
taxMLjhSkyTyResponse.xsd
批量
SKTYJG
taxMLjhSkyResultResponse.xsd
单笔
8.
撤消
自缴
SKY
请求
SKCXZH
taxMLjhSkyCxQqRequest.xsd
单笔
9.
TIPS
结果应答
SKCXZH
注①
单笔
10.
退库
交易
SKY
退库请求
SKTKA1
taxMLjhSkyPlTkRequest.xsd
批量
单笔数据
11.
TIPS
收妥应答
SKTKA2
注①
单笔
单笔数据
12.
TIPS
结果通知
SKTKA2
taxMLjhSkyTyResponse.xsd
批量
单笔
单笔数据
SKTYJG
taxMLjhSkyResultResponse.xsd
13.
TIPS
退库回执
SKTYHZ
taxMLjhSkyTgmHzResponse.xsd
单笔
14.
撤消
退库
SKY
请求
SKCXTK
taxMLjhSkyCxQqRequest.xsd
单笔
15.
TIPS
结果应答
SKCXTK
注①
单笔
16.
更正
交易
SKY
请求
SKGZA1
taxMLjhSkyPlGzRequest.xsd
批量
单笔数据
17.
TIPS
收妥应答
SKGZA2
注①
批量
单笔数据
18.
TIPS
结果通知
SKGZA2
SKTYJG
taxMLjhSkyTyResponse.xsd
taxMLjhSkyResultResponse.xsd
批量
单笔
单笔数据
19.
TIPS
更正回执
SKTYHZ
taxMLjhSkyTgmHzResponse.xsd
单笔
20.
撤消
更正
SKY
请求
SKCXGZ
taxMLjhSkyCxQqRequest.xsd
单笔
21.
TIPS
结果应答
SKCXGZ
注①
单笔
22.
免抵调
SKY
请求
SKMDA1
taxMLjhSkyPlMdtRequest.xsd
批量
单笔数据
23.
TIPS
收妥应答
SKMDA2
注①
批量
单笔数据
24.
TIPS
结果通知
SKMDA2
taxMLjhSkyTyResponse.xsd
批量
单笔
单笔数据
SKTYJG
taxMLjhSkyResultResponse.xsd
25.
TIPS
免抵调回执
SKTYHZ
taxMLjhSkyTgmHzResponse.xsd
单笔
26.
撤销
免抵调
SKY
请求
SKCXMD
taxMLjhSkyCxQqRequest.xsd
单笔
27.
TIPS
结果应答
SKCXMD
注①
单笔
28.
批量
扣税
SKY
请求
SKKKAA
taxMLjhSkyChuxvkkRequest.xsd
批量
批量数据
29.
TIPS
结果通知
SKTYJG
taxMLjhSkyResultResponse.xsd
单笔
30.
TIPS
处理应答
SKKKAB
taxMLjhSkyChuxvkkResponse.xsd
批量
批量数据
31.
止付
SKY
请求
SKZFA1
taxMLjhSkyZfRequest.xsd
单笔
32.
TIPS
收妥应答
SKZFA2
注①
单笔
33.
TIPS
结果通知
SKTYJG
taxMLjhSkyResultResponse.xsd
taxMLjhSkyZfResponse.xsd
单笔
批量
34.
明细核对
TIPS
核对通知
SKSPHD
taxMLjhSkyKkmxdzRequest.xsd
批量
批量数据
35.
退库核对
TIPS
核对通知
SKTKHD
taxMLjhSkyTkdzRequest.xsd
批量
批量数据
36.
更正核对
TIPS
核对通知
SKGZHD
taxMLjhSkyGzdzRequest.xsd
批量
批量数据
37.
MDT核对
TIPS
核对通知
SKMDHD
taxMLjhSkyMdtdzRequest.xsd
批量
批量数据
38.
三方协议验证
SKY/
TIPS
请求
SKSFA1SKSFA2
taxMLjhSkySfxyyzRequest.xsd
单笔
39.
处理应答
SKSFA1
SKSFA2
taxMLjhSkySfxyyzResponse.xsd
单笔
40.
状态
查询
SKY
请求
SKTZCX
taxMLjhSkyZtcxRequest.xsd
单笔
41.
TIPS
处理应答
SKTZCX
taxMLjhSkyZtcxResponse.xsd
单笔
42.
自由
格式
SKY
发送
SKZYA1
taxMLjhSkyZygs.xsd
单笔
TIPS
异步响应
SKZYA3
注①
44.
TIPS
发送
SKZYA2
taxMLjhSkyZygs.xsd
单笔
SKY
异步响应
SKZYA4
注①
45.
登录
SKY
请求
SKDLGK
taxMLjhSkySignInTipsRequest.xsd
46.
TIPS
处理应答
SKDLGK
taxMLjhSkySignInTipsResponse.xsd
47.
签退
SKY
请求
SKQTGK
taxMLjhSkySignOutTipsRequest.xsd
48.
TIPS
处理应答
SKQTGK
taxMLjhSkySignOutTipsResponse.xsd
49.
连接测试
SKY
请求
SKLJA1
注②
TIPS
处理应答
SKLJA1
注②
51.
TIPS
请求
SKLJA2
注②
SKY
处理应答
SKLJA2
注②
53.
公共数据更新
TIPS
发送
SKGGSJ
taxMLjhSkyGgsjgxRequest.xsd
54.
申请重发核对包信息
SKY
请求
SKBCF1
taxMLjhSkyBcfRequest.xsd
55.
下载入库流水凭证信息
SKY
请求
SKLSA1
taxMLjhSkyXzrklspzRequest.xsd
TIPS
发送
SKLSA2
taxMLjhSkyXzrklspzResponse.xsd
56.
下载报表信息
SKY
请求
SKBBA1
taxMLjhSkyXzbbxxRequest.xsd
TIPS
发送
SKBBA2
taxMLjhSkyXzbbxxResponse.xsd
57.
银行端缴款
注③
银行端缴款请求
SKYHA1
taxMLjhSkyYhdjkRequest.xsd
银行端缴款回执
SKYHA2
taxMLjhSkyYhdjkResponse.xsd
银行端缴款扣款响应
SKYHA3
taxMLjhSkyYhdjkkkResponse.xsd
58.
银行端查询缴款
注③
银行端查询缴款
请求
SKYHQ1
taxMLjhSkyYhdCxjkRequest.xsd
银行端查询缴款
响应
SKYHQ2
taxMLjhSkyYhdCxjkResponse.xsd
59.
停运通知
TIPS
通知
SKTYTZ
taxMLjhSkyTytzRequest.xsd
60.
故障通知
TIPS
通知
SKGZTZ
taxMLjhSkyGztzRequest.xsd
61.
运行参数通知
TIPS
通知
SKCSTZ
taxMLjhSkyYxcsRequest.xsd
注①:
无业务报文,通过技术报文的ReturnCode判断。
注②:
无业务报文,通过技术报文的Content传递信息。
注③:
银行端缴款业务的流程和定义,仅供参考。
3物理连接说明
如下图所示
图3物理连接结构图
说明:
1、综合征管系统的SKY前置系统和省级或地级人民银行网间互联平台进行连接
2、省级或地级人民银行网间互联平台和国库信息处理系统连接。
3、综合征管系统和国库信息处理系统的信息通讯通过人民银行网间互联平台中转。
4应用连接说明
税务国库横向联网系统使用IBM MQSeries作为消息中间件服务器,进行应用的连接 通信。
对于消息中间件服务器的版本要求,请参考《MQ配置部署指引》的版本要求章节。
4.1应用连接结构图
图4应用连接结构图
SKY与TIPS之间的应用连接结构如图4所示,税务总局与人民银行共同定义一组XML报文,以实现TIPS与税务机关业务系统的对接。
SKY与TIPS的通信连接采用MQ中间件实现,SKY的前置系统可选择部署MQServer或MQClient,如果选择部署MQServer,则选择对等模式进行通信连接,本模式可以保障性能需求;如果选择部署MQClient,则选择中心节点模式进行通信连接,本模式可以节约成本,但在高性能需求方面存在局限性。
采用上述何种通信连接模式,建议遵循“以满足性能需求为前提”这一准则。
在接口队列设计方面,为保障实时类交易的高可靠性和高实时响应性,做到实时类交易和非实时类交易相互影响降至最低,我们对实时类交易和非实时类交易分别提供一组或多组通信接口队列。
接口队列从业务角度上看,分别处理不同类别的交易;但在通信流程上,没有本质差别。
业务处理与队列通道的对应可由配置进行调整。
因此,现以实时类交易为例,对中心节点模式和对等模式两种通信连接模式的通信流程分别加以说明:
⏹中心节点模式(C-S模式)
图5中心节点模式中间件数据传输图
说明:
如图5所示,TIPS和税务机关前置系统间的通信连接采用中间件MQClientTOMQServer的方式(即中心节点模式)。
(1)联网中心配置MQServer。
通过MQmanager为SKY系统创建接收队列(Q1)和发送队列(Q2)。
接收队列(Q1)用于接收税务机关业务系统向TIPS输入的数据,发送队列用于发送TIPS向税务机关业务系统输出的数据。
(2)SKY系统与TIPS建立通信连接后,SKY系统调用MQClientAPI(即MQI)将请求消息写入远程的TIPS分配的接收队列(Q1)中。
(3)TIPS接收请求消息并处理完成后,将返回结果写到对应SKY的发送队列(Q2)中,联网机构调用MQClientAPI(即MQI)从对应的发送队列(Q2)中轮询接收处理结果。
⏹对等模式(SToS模式)
图6对等模式中间件数据传输图
说明:
如图6所示,SKY和TIPS系统间的通信连接采用中间件MQServerTOMQServer的方式(即对等模式)。
(1)SKY通过自身的MQmanager为接入的TIPS系统分别创建发送队列(Q1)和接收队列(Q2),发送队列用于发送税务机关业务系统向TIPS输出的数据,接收队列用于接收TIPS向税务机关业务系统输入的数据。
(2)TIPS系统通过自身的MQmanager创建自己的接收队列(Q3)和发送队列(Q4)。
发送队列用于发送TIPS向税务机关业务系统输出的数据,接收队列用于接收税务机关业务系统向TIPS输出的数据。
当税务机关业务系统与TIPS建立连接以后,会创建从税务机关业务系统到TIPS之间的通道(channel),通道两端队列的对应关系见上图。
(3)税务机关业务系统通过调用MQAPI将请求消息写入本地MQServer的发送队列(Q1)中,消息经通道传输至TIPS为该业务系统分配的接收队列(Q3)中,TIPS处理完成后,将返回结果写到对应为该业务系统分配的发送队列(Q4)中,消息经通道传输至税务机关业务系统。
4.2应用连接配置
SKY与TIPS系统的通信链路,通过配置MQServer的Channel实现。
在配置MQChannel及其它MQ对象时,需要接口双方向对方提供队列管理器名称、服务器连接通道名称、主机名或IP地址、侦听端口、发送通道名称、接收通道名称、发送队列名称、接收队列名称、字符集等配置项,税务机关连接可参考人民银行公布的《MQ配置部署指引》。
考虑到系统中处理的业务主要有两种,即实时通信业务和异步业务。
两类业务的处理特点差异较大。
实时通信业务通常报文较小,要求及时传输和处理;异步业务通常报文较大,不需要实时进行传输和处理。
为了保证实时业务的处理效率,SKY系统将异步业务和实时通信业务放在不同的消息队列中处理,系统设置实时队列和异步(非实时)队列,其中实时队列(包括一个实时发送队列和一个实时接收队列)将设置消息缺省属性为非持久,异步(非实时)队列(包括一个批量发送队列和一个批量接收队列)将设置消息缺省属性为持久。
具体哪些交易和报文通过何种队列传输见4.7中交易列表所述。
说明:
缺省情况下,放入非持久队列中的消息具有非持久属性,不记录消息日志,优点是消息传输的效率高,缺点是一旦出现队列管理器异常、服务器掉电、关机等情况,队列中的消息将丢失;放入持久队列中的消息具有持久属性,会记录消息日志,优点是在队列管理器异常、服务器掉电、关机等情况下,消息不会丢失,缺点是效率较低。
但是,非持久队列中也可以传输持久消息,持久队列中也可以传输非持久消息,不过需要应用程序发送每条消息前对消息的属性进行明确的设置。
4.3应用连接信息包压缩
为了提高报文在网络上的传输效率,各联网机构发送的报文须进行压缩处理,接收的报文要进行解压缩处理。
对消息的压缩处理和解压缩处理可通过MQ的出口函数实现,具体实现方法和算法应参考《MQ配置部署指引》。
4.4应用连接批量报文的限制
为了保证网络传输的快速、及时、高效,系统限定联网单位发起的批量包封装的业务在1千笔以内(小于一千笔)。
TIPS发起的与综合征管系统信息核对、入库明细、报表明细笔数如果超过了一千笔,进行分包发送,并在信息包的汇总信息中列出总笔数以及当前包在总包里的序号。
对于批量扣税业务,SKY系统负责进行包的组装;对于批量扣税回执和核对通知业务,TIPS负责进行包的组装。
4.5应用连接接口处理模式
SKY系统与TIPS之间的联机交易模式包括五种,具体如下:
4.5.1模式一SKY发送同步请求处理模式
图7税务机关发起同步处理模式
说明:
1.SKY系统通过MQ发送信息给TIPS;
2.TIPS系统接收后,及时处理,在处理结束后立即给SKY系统同步的应答。
此种模式适用于综合征管系统发起的:
序号
业务请求名称
业务应答含义
收妥
业务处理
1
实时扣税
★
★
2
冲正(即撤消倒扣)
★
★
3
自缴核销(正划)
★
4
撤消自缴核销(撤消正划)
★
★
5
退库请求
★
6
撤消退库
★
★
7
更正请求
★
8
撤消更正
★
★
9
免抵调请求
★
10
撤消免抵调
★
★
11
三方协议认证(税发起)
★
★
12
连接测试
★
★
13
包和交易状态查询
★
★
14
登录
★
★
15
签退
★
★
征管发送业务信息给国库信息处理系统,国库信息处理系统接收后,立即进行处理,并在处理结束后同步返回处理结果回执报文给税务机关,不同的业务,应答含义有所不同。
如使用异步通信队列实现模式一中的同步业务,必须满足实时性要求。
4.5.2模式二SKY异步业务处理模式
图8税务机关发起异步处理模式
说明:
1.SKY系统通过MQ发送业务请求信息给TIPS;
2.国库信息处理系统处理结束后,通过MQ发送异步处理回执给税务机关业务系统。
此种模式主要适用于:
序
业务名称
业务处理含义
写发送异步队列
异步队列接收通知/处理回执
1
发送批量扣税
→(注①)
2
批量扣税回执
←
3
自缴核销业务应答
←
4
退库业务回执
←
5
更正业务回执
←
6
免抵调业务回执
←
7
止付
→
8
止付应