税务国库横向联网系统接口规范.docx

税务国库横向联网系统接口规范.docx

《税务国库横向联网系统接口规范.docx》由会员分享，可在线阅读，更多相关《税务国库横向联网系统接口规范.docx（45页珍藏版）》请在冰点文库上搜索。

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

附件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前言

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

止付应答

←

9

下载入库流水凭证请求

→

10

下载入库流水凭证响应

←

11

下载报表请求

→

12

下载报表响应

←

注①：

“→”代表模式当中的第1步；“←”代表模式当中的第2步。

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

图9SKY发送信息处理模式

说明：

1.SKY系统通过MQ发送业务信息到TIPS

此种模式适用于：

序号

业务名称

业务处理含义

写异步队列

说明

1

自由格式报文

→

2

通用结果处理通知

→

注①

3

申请重发核对包请求

→

注①：

收到TIPS的异步通知（如各核对通知、公共数据更新）时，出现异常，发送该通知。

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

图10税务机关接收同步处理模式

说明：

1.国库信息处理系统通过MQ发送业务信息给税务机关业务系统；

2.税务机关业务系统在接收到国库信息处理系统发送过来的业务信息后，立即处理，处理结束后同步通过MQ发送回执给TIPS。

此种模式适用于TIPS发起的连接测试请求，银行端缴款，银行端查询缴款等业务。

序号

业务名称

业务处理含义

收妥

处理

1

连接测试请求

★

★

2

三方协议认证（TIPS发起）

★

3

银行端缴款业务

★

★

4

银行端查询缴款

★

★

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

图11SKY接收信息处理模式

说明：

1.税务机关业务系统通过MQ接收TIPS的业务信息

此种模式适用于：

序号

业务名称

业务处理含义

写异步队列

通知/处理回执

1

税票信息核对消息通知

★

←

2

退库业务核对消息通知

★

←

3

更正业务核对消息通知

★

←

4

免抵调业务核对消息通知

★

←

5

公共数据更新通知

★

←

6

自由格式报文

★

←

7

停运通知

★

←

8

故障通知

★