2023年税务国库横向联网系统接口规范

附件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.

国家税务总局第2页共43页

目录

1前言....................................................................................5

1.1目的.................................................................................5

1.2横联系统概述........................................................................5

1.3参考文献............................................................................5

2接口分析................................................................................7

2.1总体业务处理流程....................................................................7

2.2接口业务处理范围....................................................................7

3物理连接说明...........................................................................13

4应用连接说明............................................................................14

4.1应用连接结构图......................................................................14

4.2应用连接配置.......................................................................17

4.3应用连接信息包压缩.................................................................17

4.4应用连接批量报文的限制..............................................................17

4.5应用连接接口处理模式................................................................18

4.5.1模式一SKY发送同步请求处理模式.......................................................................................................18

4.5.2模式二SKY异步业务处理模式................................................................................................................19

4.5.3模式三SKY发送信息处理模式...............................................................................................................20

4.5.4模式四TIPS发送同步请求处理模式.....................................................................................................20

4.5.5模式五TIPS发送信息处理模式.............................................................................................................27

4.6应用连接中报文的匹配................................................................22

4.6.1基于MQ消息1D的消息匹配机制............................................................................................................22

4.6.2基于全局ID的报文匹配机制...................................................................................................................24

4.6.3基于业务要素的交易匹配机制................................................................................................................26

4.7应用连接消息处理模式及匹配列表......................................................26

4.8MQ消息过期时间设置.................................................................29

4.9接口应用系统配置约定................................................................31

4.10接口应用系统开发约定.............................................................31

5接口双方需要完成的工作.................................................................33

5.1税务总局需要完成的工作.............................................................33

5.2人民银行需要完成的工作.............................................................33

6接口报文说明...........................................................................34

7接口安全管理...........................................................................35

7.1税务机关内部权限管理................................................................35

7.2应用连接安全.......................................................................35

7.3报文权限控制.......................................................................35

7.4审计追踪...........................................................................35

7.5病毒防范...........................................................................36

7.6网络安全...........................................................................36

国家税务总局第3页共43页

8异常及差错处理.........................................................................37

8.1异常处理..........................................................................37

8.1.1业务处理异常......................................................................37

8.1.2通信异常处理.....................................................................37

8.2差错处理..........................................................................37

8.2.1报文检查错........................................................................37

8.2.2验证电子签名不符.................................................................38

8.2.3重账检查机制......................................................................38

8.2.4核对不平..........................................................................38

8.3故障处理..........................................................................40

8.3.1TIPS处理中心故障.................................................................40

8.3.2税务机关业务系统故障.............................................................41

8.3.3税务机关业务系统与TIPS之间网络故障...........................................41

8.3.4灾备通信连接切换.................................................................41

9接口扩展规则...........................................................................42

国家税务总局第4页共43页

编号：

时间：2021年X月X日书山有路勤为径，学海无涯苦作舟页码：第5页共43页

1前言

1.1目的

本文档的目标是描述连接综合征管系统的税务国库横向联网（以下简称税库银或SKY）

系统与国库信息处理系统（以下简称TIPS）之间的接口实现方法。

1.2横联系统概述

建设税务国库横向联网电子缴税系统的主要目标：运用现代信息网络技术，建立税务、

国库间的联网系统，实现税款征缴、入库、退库、更正、对账等全流程的网络化、电子化，

加快税款入库速度，提高财政资金运转效率，简化税款征缴程序，为纳税人提供快捷、准

确的税款缴纳方式，实现数据传送无纸化、操作程序标准化、账务核对电子化、监控管理

实时化、对外服务人性化业务处理模式。

1.3参考文献

税务国库横向联网系统提供一组基于XML格式的报文，实现税务征管业务系统与国库

信息处理系统的对接；主要完成税务征管业务系统和国库信息处理系统之间的实时单笔扣

税、定时批量扣税、冲正、自缴核销、退库，更正，免抵调等业务的联机处理。

税务国库横向联网系统采用MQ通讯方式，联网系统按照本规范定义的报文格式，接收

和发送相应的报文，进行信息交换。横联系统的业务流程和报文格式，参考如下文件：

文件名称简介

《税务国库横向联网业务需求书（正式下发稿）》业务需求的依据

《数据采集交换接口》金税工程（三期）数据采集/交换标准

《税库银系统的接口技术规范》即本文档

《附录一：税库银接口业务处理流程》

《附录二：税库银业务报文描述:》描述业务报文详细信息，和税库银项目

中技术报文的扩展内容

《附录三：税库银业务报文说明》定义业务服务ID,帮助对业务进行索引

笫5页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第6页共43页

第6页共43页

编号：

时间：2021年X月X日书山有路勤为径，学海无涯苦作舟页码：第7页共43页

2接口分析

2.1总体业务处理流程

一A1,实时请求一►-A2.实时请求一►

+A4.实时响应——•-A3.实忖响应—

库

国

商

业

务

税

息

信

银

SKY行

管

征—BI.异步请求一►一B2.异步请求一*<■

理

处

处

前置7理

统

系+B4.异步响应——一B3.异步响应——

统

系

系

系统统

，2处理和捎号一ci.处理回执1核时通知

图1总体业务处理流程

如图1中，存在三类处理流程：

1.综合征管系统发起的实时业务

(A1-A4)综合征管系统向国库信息处理系统发起实时请求，国库信息系统实时返回

应答；

2.综合征管系统发起的异步业务

(B1-B4)综合征管系统向国库信息处理系统发起异步请求，国库信息系统异步返回

应答；

3.国库信息系统发起的异步业务

(C1-C2)国库信息系统发起异步的处理或核对通知，税库银系统接收后，向综合征

管系统异步返回。

国库信息系统与银行间接口的规范不在本文档论述范围内。

2.2接口业务处理范围

SKY系统与国库信息处理系统的接口业务处理范围主要包括实时类报文、批量类报文、

第7页共43页

编号：

时间：2021年X月X日书山有路勤为径，学海无涯苦作舟页码：第8页共43页

对账类报文、辅助交易类报文等四类报文。报文结构分为单笔和批量两种结构，单笔报文

指报文所含内容为单笔交易信息，批量报文指报文可包含单笔或多笔明细信息。具体报文

清单如表1所示（各报文格式及填写要求参见《税库银-数据采集交换标准一附录E_业务报

文描述》）：

表1：税务国库横向联网处理报文清单

编业务发起报文

服务类型服务ID业务报文定义报文内容

号名方结构

1.实时SKY请求SKKKA1taxMLjhSkySsKkRequest.xsd单笔

2.扣税TIPS结果应答SKKKA1taxMLjhSkySsKkResponse.xsd单笔

3.实时SKY请求SKKKA2taxMLjhSkySsKkCzRequest.xsd单笔

4.冲正TIPS结果应答SKKKA2注①单笔

5.SKY请求SKKKA3taxMLjhSkyZjhxRequest.xsd批量

6.自缴TIPS收妥应答SKKKA4注①单笔

7.核销SKKKA4taxMLjhSkyTyResponse.xsd批量

TIPS结果通知

SKTYJGtaxMLjhSkyResultResponse.xsd单笔

8.撤消SKY请求SKCXZHtaxMLjhSkyCxQqRequest.xsd单笔

9.自缴TIPS结果应答SKCXZH注①单笔

10.SKY退库请求SKTKA1taxMLjhSkyPITkRequest.xsd批量单笔数据

11.TIPS收妥应答SKTKA2注①单笔单笔数据

退库

12.SKTKA2taxMLjhSkyTyResponse.xsd批量

交易TIPS结果通知

SKTYJGtaxMLjhSkyResultResponse.xsd单笔单笔数据

13.TIPS退库回执SKTYHZtaxMLjhSkyTgmHzResponse.xsd单笔

14.撤消SKY请求SKCXTKtaxMLjhSkyCxQqRequest.xsd单笔

15.退库TIPS结果应答SKCXTK注①单笔

16.SKY请求SKGZA1taxMLjhSkyPIGzRequest.xsd批量单笔数据

17.更正TIPS收妥应答SKGZA2注①批量单笔数据

18.交易SKGZA2taxMLjhSkyTyResponse.xsd批量

TIPS结果通知单笔数据

SKTYJGtaxMLjhSkyResultResponse.xsd单笔

第8页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第9页共43页

编业务发起报文

服务类型服务ID业务报文定义报文内容

号名方结构

19.TIPS更正回执SKTYHZtaxMLjhSkyTgmHzResponse.xsd单笔

20.撤消SKY请求SKCXGZtaxMLjhSkyCxQqRequest.xsd单笔

21.更正TIPS结果应答SKCXGZ注①单笔

22.SKY请求SKMDA1taxMLjhSkyPIMdtRequest.xsd批量单笔数据

23.TIPS收妥应答SKMDA2注①批量单笔数据

24.免抵SKMDA2taxMLjhSkyTyResponse.xsd批量

TIPS结果通知

调SKTYJGtaxMLjhSkyResultResponse.xsd单笔

单笔数据

25.免抵调回

TIPSSKTYHZtaxMLjhSkyTgmHzResponse.xsd单笔

执

26.撤销SKY请求SKCXMDtaxMLjhSkyCxQqRequest.xsd单笔

27.免抵

TIPS结果应答SKCXMD注①单笔

调

28.SKY请求SKKKAAtaxMLjhSkyChuxvkkRequest.xsd批量批量数据

批量

29.TIPS结果通知SKTYJGtaxMLjhSkyResultResponse.xsd单笔

扣税

30.TIPS处理应答SKKKABtaxMLjhSkyChuxvkkResponse.xsd批量批量数据

31.SKY请求SKZFA1taxMLjhSkyZfRequest.xsd单笔

32.TIPS收妥应答SKZFA2注①单笔

止付

33.TIPStaxMLjhSkyResultResponse.xsd单笔

结果通知SKTYJG

taxMLjhSkyZfResponse,xsd批量

34.明细

TIPS核对通知SKSPHDtaxMLjhSkyKkmxdzRequest.xsd批量批量数据

核对

35.退库

TIPS核对通知SKTKHDtaxMLjhSkyTkdzRequest.xsd批量批量数据

核对

36.更正

TIPS核对通知SKGZHDtaxMLjhSkyGzdzRequest.xsd批量批量数据

核对

笫9页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第10页共43页

编业务发起报文

服务类型服务ID业务报文定义报文内容

号名方结构

37.MDT核

TIPS核对通知SKMDHDtaxMLjhSkyMdtdzRequest.xsd批量批量数据

对

38.SKSFA1

三方请求taxMLjhSkySfxyyzRequest.xsd单笔

SKY/SKSFA2

协议

39.TIPSSKSFA1

验证处理应答taxMLjhSkySfxyyzResponse.xsd单笔

SKSFA2

40.状态SKY请求SKTZCXtaxMLjhSkyZtcxRequest.xsd单笔

41.查询TIPS处理应答SKTZCXtaxMLjhSkyZtcxResponse.xsd单笔

42.SKY发送SKZYA1taxMLjhSkyZygs.xsd单笔

自由TIPS异步响应SKZYA3注①

43.格式TIPS发送SKZYA2taxMLjhSkyZygs.xsd单笔

SKY异步响应SKZYA4注①

44.SKY请求SKDLGKtaxMLjhSkySignlnTipsRequest.xsd

登录

45.TIPS处理应答SKDLGKtaxMLjhSkySignlnTipsResponse.xsd

46.SKY请求SKQTGKtaxMLjhSkySignOutTipsRequest.xsd

签退

47.TIPS处理应答SKQTGKtaxMLjhSkySignOutTipsResponse.xsd

48.连接SKY请求SKLJA1注②

测试TIPS处理应答SKLJA1注②

49.TIPS请求SKLJA2打遮）

SKY处理应答SKLJA2注②

50.公共

数据TIPS发送SKGGSJtaxMLjhSkyGgsjgxRequest.xsd

更新

第10页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第11页共43页

编业务发起报文

服务类型服务ID业务报文定义报文内容

号名方结构

51.申清

重发

核对SKY请求SKBCF1taxMLjhSkyBcfRequest.xsd

包信

息

52.下载SKY请求SKLSA1taxMLjhSkyXzrklspzRequest.xsd

入库

流水

TIPS发送SKLSA2taxMLjhSkyXzrklspzResponse.xsd

凭证

信息

53.下载SKY请求SKBBA1taxMLjhSkyXzbbxxRequest.xsd

报表

TIPS发送SKBBA2taxMLjhSkyXzbbxxResponse.xsd

信息

54.银行银行端缴款请求SKYHA1taxMLjhSkyYhdjkRequest.xsd

端缴银行端缴款回执SKYHA2taxMLjhSkyYhdjkResponse.xsd

款银行端缴款扣款

SKYHA3taxMLjhSkyYhdjkkkResponse.xsd

注③响应

55.银行银行端查询缴款

SKYHQ1taxMLjhSkyYhdCxjkRequest.xsd

端查请求

询缴

银行端查询缴款

款SKYHQ2taxMLjhSkyYhdCxjkResponse.xsd

响应

注③

56.停运

TIPS通知SKTYTZtaxMLjhSkyTytzRequest.xsd

通知

57.故障

TIPS通知SKGZTZtaxMLjhSkyGztzRequest.xsd

通知

第11页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第12页共43页

编业务发起报文

服务类型服务ID业务报文定义报文内容

号名方结构

58.运行

参数TIPS通知SKCSTZtaxMLjhSkyYxcsRequest.xsd

通知

注①

无业务报文，通过技术报文的ReturnCode判断。

注②

无业务报文，通过技术报文的Content传递信息。

注③

银行端缴款业务的流程和定义，仅供参考。

第12页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第13页共43页

3物理连接说明

如下图所示

银行系统

国库信息处理系统省级节京

海级综合征管系统

5器税库银MO服务器

综合征管系统数据中心

‘办税央厅柜台

征目系统数据服务器（可选）税库银数据库

，网上申报等系名Ft

图3物理连接结构图

说明：

1、综合征管系统的SKY前置系统和省级或地级人民银行网间互联平台进行连接

2、省级或地级人民银行网间互联平台和国库信息处理系统连接。

3、综合征管系统和国库信息处理系统的信息通讯通过人民银行网间互联平台中转。

第13页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第14页共43页

4应用连接说明

税务国库横向联网系统使用IBMMQSeries作为消息中间件服务器，进行应用的连接

通信。对于消息中间件服务器的版本要求，请参考《MQ配置部署指引》的版本要求章节。

4.1应用连接结构图

我人烟同业银

税务系统TIPS

道行系统

企

交

业

税

商

S网

易

信

务K

间

业

基于MQ应

Y息

业

前

互

I-------------►银

用

总

务

置

联

行

服

线

系

系

平

系

务

统

服

统

台

统

器

务

器

图4应用连接结构图

SKY与TIPS之间的应用连接结构如图4所示，税务总局与人民银行共同定义一组XML

报文，以实现TIPS与税务机关业务系统的对接。

SKY与TIPS的通信连接采用MQ中间件实现，SKY的前置系统可选择部署MQServer或

MQClient,如果选择部署MQServer,则选择对等模式进行通信连接，本模式可以保障性

能需求；如果选择部署顺Client,则选择中心节点模式进行通信连接，本模式可以节约成

本，但在高性能需求方面存在局限性。采用上述何种通信连接模式，建议遵循“以满足性

能需求为前提”这一准则。

在接口队列设计方面,为保障实时类交易的高可靠性和高实时响应性，做到实时类交易

和非实时类交易相互影响降至最低，我们对实时类交易和非实时类交易分别提供一组或多

组通信接口队列。接口队列从业务角度上看，分别处理不同类别的交易；但在通信流程上，

没有本质差别。业务处理与队列通道的对应可由配置进行调整。

第14页共43页

编号：

时间：2021年X月X日书山有路勤为径，学海无涯苦作舟页码：第15页共43页

因此，现以实时类交易为例，对中心节点模式和对等模式两种通信连接模式的通信流

程分别加以说明:

■中心节点模式（C-S模式）

图5中心节点模式中间件数据传输图

说明：如图5所示，TIPS和税务机关前置系统间的通信连接采用中间件MQClientT0

MQServer的方式（即中心节点模式）。

（1）联网中心配置MQServero通过MQmanager为SKY系统创建接收队列（Q1）和

发送队列（Q2）。接收队列（Q1）用于接收税务机关业务系统向TIPS输入的数据，发送队

列用于发送TIPS向税务机关业务系统输出的数据。

（2）SKY系统与TIPS建立通信连接后，SKY系统调用MQClientAPI（即MQI）将请

求消息写入远程的TIPS分配的接收队列（Q1）中。

（3）TIPS接收请求消息并处理完成后，将返回结果写到对应SKY的发送队列（Q2）

中，联网机构调用MQClientAPI（即MQI）从对应的发送队列（Q2）中轮询接收处理结果。

第15页共43页

编号：

时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第16页共43页

■对等模式(SToS模式)

MQ-server

Queues

ManagerRegion

DD00D000D00D00DD0DU

D0QueueDDQueue00Queue00Queue

(Remote)(Local)(Remote)(Local)

■yQ*12,

CCCC

hhhh

aaaa

nnnn

nnnn

eeee

5廿""^03'"|=JQ4'

00QueueD0QueueDDQueueDDQueue

(Local)(Remote)(Local)(Remote)

MQ-Server

QueuesTIPS

、ManagerRegionJ

图6对等模式中间件数据传输图

说明：如图6所示，SKY和TIPS系统间的通信连接采用中间件MQServerTOMQ

Server的方式（即对等模式）。

（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处理完

第16页共43页

编号：

时间：2021年X月X日书山有路勤为径，学海无涯苦作舟页码：第17页共43页

成后，将返回结果写到对应为该业务系统分配的发送队列（Q4）中，消息经通道传输至税

务机关业务系统。

4.2应用连接配置

SKY与TIPS系统的通信链路，通过配置MQServer的Channel实现。在配置MQChannel

及其它MQ对象时，需要接口双方向对方提供队列管理器名称、服务器连接通道名称、主

机名或IP地址、侦听端口、发送通道名称、接收通道名称、发送队列名称、接收队列名称、

字符集等配置项，税务机关连接可参考人民银行公布的《MQ配置部署指引》。

考虑到系统中处理的业务主要有两种，即实时通信业务和异步业务。两类业务的处理

特点差异较大。实时通信业务通常报文较小，要求及时传输和处理；异步业务通常报文较

大，不需要实时进行传输和处理。为了保证实时业务的处理效率，SKY系统将异步业务和

实时通信业务放在不同的消息队列中处理，系统设置实时队列和异步（非实时）队列，其

中实时队列（包括一个实时发送队列和一个实时接收队列）将设置消息缺省属性为非持久，

异步（非实时）队列（包括一个批量发送队列和一个批量接收队列）将设置消息缺省属性

为持久。具体哪些交易和报文通过何种队列传输见4.7中交易列表所述。

说明：缺省情况下，放入非持久队列中的消息具有非持久属性，不记录消息日志，优

点是消息传输的效率高，缺点是一旦出现队列管理器异常、服务器掉电、关机等情况，队

列中的消息将丢失；放入持久队列中的消息具有持久属性，会记录消息日志，优点是在队

列管理器异常、服务器掉电、关机等情况下，消息不会丢失，缺点是效率较低。但