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

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

1、附件2税务国库横向联网系统接口规范版本号：V2.0.0.O国家税务总局修改记录序号修改时间修改人审核人备注1.2006-7-21臧忠超修改4.10中关于MQ消息用户标识设置的部分2.2007-7-2段晓燕修改了2.2节中表1：税务国库横向联网处理报文清单3.2011-8-22孙亚松增加了退更免问执4.5.6.7.1 前言51.1 1目的51.2 横联系统概述51.3 参考文献52 接口分析72.1 总体业务处理流程72.2 接口业务处理范围73 物理连接说明134 应用连接说明144.1 应用连接结构图144.2 应用连接配置174.3 应用连接信息包压缩174.4 应用连接批量报文的限制17

2、4.5 应用连接接口处理模式184.5.1模式一SKY发送同步请求处理模式184.5.2模式二SKY异步业务处理模式194.5.3模式三SKY发送信息处理模式204.5.4模式四TIPS发送同步请求处理模式204.5.5模式五T1PS发送信息处理模式214.6应用连接中报文的匹配224.6.1基于即消息ID的消息匹配机制224.6.2基于全局ID的报文匹配机制244.6.3基于业务要素的交易匹配机制264. 7应用连接消息处理模式及匹配列表265. 8MQ消息过期时间设置296. 9接口应用系统配置约定317. 10接口应用系统开发约定315接口双方需要完成的工作335.1 税务总局需要完成的

3、工作338. 2人民银行需要完成的工作336 接口报文说明347 接口安全管理357.1 税务机关内部权限管理357.2 应用连接安全351.1 3报文权限控制357.4 审计追踪357.5 病毒防范367.6 网络安全368异常及差错处理378.1 异常处理371 .1.1业务处理异常378 .1.2通信异常处理378.2差错处理378.2.1报文检查错378.2.2验证电子签名不符388.2.3重账检查机制.388.2.4核对不平388.3故障处理408.3.1TIPS处理中心故障408.3.2税务机关业务系统故障418.3.3税务机关业务系统与T1PS之间网络故障418.3.4灾备通信连

4、接切换419接口扩展规则421前言11目的本文档的目标是描述连接综合征管系统的税务国库横向联网（以下简称税库银或SKY）系统与国库信息处理系统（以下简称T1PS）之间的接口实现方法。1.2横联系统概述建设税务国库横向联网电子缴税系统的主要目标：运用现代信息网络技术，建立税务、国库间的联网系统，实现税款征缴、入库、退库、更正、对账等全流程的网络化、电子化，加快税款入库速度，提高财政资金运转效率，简化税款征缴程序，为纳税人提供快捷、准确的税款缴纳方式，实现数据传送无纸化、操作程序标准化、账务核对电子化、监控管理实时化、对外服务人性化业务处理模式。1.3参考文献税务国库横向联网系统提供一组基于XM1

5、格式的报文，实现税务征管业务系统与国库信息处理系统的对接；主要完成税务征管业务系统和国库信息处理系统之间的实时单笔扣税、定时批量扣税、冲正、自缴核销、退库，更正，免抵调等业务的联机处理。税务国库横向联网系统采用MQ通讯方式，联网系统按照本规范定义的报文格式，接收和发送相应的报文，进行信息交换。横联系统的业务流程和报文格式，参考如下文件：文件名称简介税务国库横向联网业务需求书（正式下发稿）业务需求的依据数据采集交换接口金税工程（三期）数据采集/交换标准税库银系统的接口技术规范即本文档附录一：税库银接口业务处理流程附录二：税库银业务报文描述:描述业务报文详细信息，和税库银项目中技术报文的扩展内容附

6、录三：税库银业务报文说明定义业务服务ID,帮助对业务进行索引2接口分析2.1总体业务处理流程-AI.实时请求一一A4.实时响应一一B1.异步请求一-B4.异步响应一A2.实时请求一A3.实时响应一务管统税征系SKY前置系统,B2.异步请求一库息理统国信处系商银处系业行理统C2.处理和销号一图1总体业务处理流程如图1中，存在三类处理流程：1. 综合征管系统发起的实时业务(A1-A4)综合征管系统向国库信息处理系统发起实时请求，国库信息系统实时返回应答；2. 综合征管系统发起的异步业务(B1-B4)综合征管系统向国库信息处理系统发起异步请求，国库信息系统异步返回应答；3. 国库信息系统发起的异步业

7、务(C1-C2)国库信息系统发起异步的处理或核对通知，税库银系统接收后，向综合征管系统异步返回。国库信息系统与银行间接口的规范不在本文档论述范围内。2.2接口业务处理范围SKY系统与国库信息处理系统的接口业务处理范围主要包括实时类报文、批量类报文、对账类报文、辅助交易类报文等四类报文。报文结构分为单笔和批量两种结构，单笔报文指报文所含内容为单笔交易信息，批量报文指报文可包含单笔或多笔明细信息。具体报文清单如表1所示（各报文格式及填写要求参见税库银-数据采集交换标准.附录E_业务报文描述）：表1：税务国库横向联网处理报文清单编号业务名发起方服务类型服务ID业务报文定义报文结构报文内容1.实时扣税

8、SKY请求SKKKA1taxM1jhSkySsKkRequest.xsd单笔2.TIPS结果应答SKKKA1taxM1jhSkySsKkResponse.XSd单笔3.实时冲正SKY请求SKKKA2taxM1jhSkySsKkCzRequest.xsd单笔4.TIPS结果应答SKKKA2注单笔5.自缴核销SKY请求SKKKA3taxM1JhSkyZjhxRequest.xsd批量6.TIPS收妥应答SKKKA4注单笔7.TIPS结果通知SKKKA4taxM1jhSkyTyResponse.xsd批量SKTYJGtaxM1jhSkyResu1tResponse.xsd单笔8.撤消自缴SKY请求S

9、KCXZHtaxM1JhSkyCxQqRequest.xsd单笔9.TIPS结果应答SKCXZH注单笔10.退库交易SKY退库请求SKTKA1IaxM1jhSkyP1TkRequest.xsd批量单笔数据11.TIPS收妥应答SKTK2注单笔单笔数据12.TIPS结果通知SKTK2taxM1jhSkyTyResponse.xsd批量单笔单笔数据SKTYJGtaxM1jhSkyResu1tResponse.xsd13.TIPS退库回执SKTYHZtaxM1jhSkyTgmHzResponse.xsd单笔14.撤消退库SKY请求SKCXTKtaxM1jhSkyCxQqRequest.xsd单笔15

10、.TIPS结果应答SKCXTK注单笔16.更正交易SKY请求SKGZA1taxM1JhSkyP1GzRequest.xsd批量单笔数据17.TIPS收妥应答SKGZ2注批量单笔数据18.TIPS结果通知SKGZA2SKTYJGtaxM1jhSkyTyResponse.xsdtaxM1jhSkyResu1tResponse.xsd批量单笔单笔数据编号业务名发起方服务类型服务ID业务报文定义报文结构报文内容19.TIPS更正回执SKTYHZtaxM1jhSkyTgmHzResponse.xsd单笔20.撤消更正SKY请求SKCXGZtaxM1JhSkyCxQqRequest.xsd单笔21.TIP

11、S结果应答SKCXGZ注单笔22.免抵调SKY请求SKMDA1taxM1jhSkyPIMdtRequest.xsd批量单笔数据23.TIPS收妥应答SKMDA2注批量单笔数据24.TIPS结果通知SKMD2taxM1JhSkyTyResponse.xsd批量单笔单笔数据SKTYJGtaxM1jhSkyResu1tResponse.xsd25.TIPS免抵调回执SKTYHZtaxM1jhSkyTgmHzResponse.xsd单笔26.撤销免抵调SKY请求SKCXMDtaxM1jhSkyCxQqRequest.xsd单笔27.TIPS结果应答SKCXMD注单笔28.批量扣税SKY请求SKKKAA

12、taxM1jhSkyChuxvkkRequest.xsd批量批量数据29.TIPS结果通知SKTYJGtaxM1JhSkyResu1tResponse.XSd单笔30.TIPS处理应答SKKKABtaxM1jhSkyChuxvkkResponse.xsd批量批量数据31.止付SKY请求SKZFA1taxM1JhSkyZfRequest.xsd单笔32.TIPS收妥应答SKZFA2注单笔33.TIPS结果通知SKTYJGtaxM1jhSkyResu1tResponse.xsdtaxM1JhSkyZfResponse.xsd单笔批量34.明细核对TIPS核对通知SKSPHDtaxM1jhSkyKkmxdzRequest.xsd批量批量数据35.退库核对TIPS核对通知SKTKHDtaxM1JhSkyTkdzRequest.xsd批量批量数据36.更正核对TIPS核对通知SKGZHDtaxM1jhSkyGzdzRequest.xsd批量批量数据编号业务名发起方服务类型服务ID业务报文定义报文结构报文内容37.MDT核对TIPS核对通知SKMDHDtaxM1jhSkyMdtdzRequest.xsd批量批量数据38.三方协议验证SKY/TIPS请求SKSFA1SKSFA2taxM1JhSkySfxyyzRequest.xsd单笔39.处理应答SKSFA1SK