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

1 40 附件 2 税税务务国国库库横横向向联联网网系系统统 接接口口规规范范 版版 本本 号号 V V 2 2 0 0 0 0 0 0 国国 家家 税税 务务 总总 局局 2 40 修改记录修改记录 序号 修改时间修改时间 修改人审核人备注 1 2006 7 21臧忠超修改 4 10 中关于 MQ 消息用户 标识设置的部分 2 2007 7 2段晓燕修改了 2 2 节中表 1 税务国库 横向联网处理报文清单 3 2011 8 22孙亚松增加了退更免回执 4 5 6 7 3 40 目目 录录 1 1前言前言 6 1 1目的 6 1 2横联系统概述 6 1 3参考文献 6 2 2接口分析接口分析 7 2 1总体业务处理流程 7 2 2接口业务处理范围 7 3 3物理连接说明物理连接说明 12 4 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 5接口双方需要完成的工作接口双方需要完成的工作 31 5 1税务总局需要完成的工作 31 5 2人民银行需要完成的工作 31 6 6接口报文说明接口报文说明 32 7 7接口安全管理接口安全管理 33 7 1税务机关内部权限管理 33 7 2应用连接安全 33 7 3报文权限控制 33 7 4审计追踪 33 7 5病毒防范 34 7 6网络安全 34 4 40 8 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 9接口扩展规则接口扩展规则 40 5 40 1 1前言前言 1 11 1 目的目的 本文档的目标是描述连接综合征管系统的税务国库横向联网 以下简称税库银或 SKY 系统与国库信息处理系统 以下简称 TIPS 之间的接口实现方法 1 21 2 横联系统概述横联系统概述 建设税务国库横向联网电子缴税系统的主要目标 运用现代信息网络技术 建立税务 国库间的联网系统 实现税款征缴 入库 退库 更正 对账等全流程的网络化 电子化 加快税款入库速度 提高财政资金运转效率 简化税款征缴程序 为纳税人提供快捷 准 确的税款缴纳方式 实现数据传送无纸化 操作程序标准化 账务核对电子化 监控管理 实时化 对外服务人性化业务处理模式 1 31 3 参考文献参考文献 税务国库横向联网系统提供一组基于 XML 格式的报文 实现税务征管业务系统与国库 信息处理系统的对接 主要完成税务征管业务系统和国库信息处理系统之间的实时单笔扣 税 定时批量扣税 冲正 自缴核销 退库 更正 免抵调等业务的联机处理 税务国库横向联网系统采用 MQ 通讯方式 联网系统按照本规范定义的报文格式 接 收和发送相应的报文 进行信息交换 横联系统的业务流程和报文格式 参考如下文件 文件名称简介 税务国库横向联网业务需求书 正式下发稿 业务需求的依据 数据采集交换接口 金税工程 三期 数据采集 交换标准 税库银系统的接口技术规范 即本文档 附录一 税库银接口业务处理流程 附录二 税库银业务报文描述 描述业务报文详细信息 和税库银项目 中技术报文的扩展内容 附录三 税库银业务报文说明 定义业务服务 ID 帮助对业务进行索引 6 40 2 2接口分析接口分析 2 12 1 总体业务处理流程总体业务处理流程 图 1 总体业务处理流程 如图 1 中 存在三类处理流程 1 综合征管系统发起的实时业务 A1 A4 综合征管系统向国库信息处理系统发起实时请求 国库信息系统实时返 回应答 2 综合征管系统发起的异步业务 B1 B4 综合征管系统向国库信息处理系统发起异步请求 国库信息系统异步返 回应答 3 国库信息系统发起的异步业务 C1 C2 国库信息系统发起异步的处理或核对通知 税库银系统接收后 向综合 征管系统异步返回 国库信息系统与银行间接口的规范不在本文档论述范围内 2 22 2 接口业务处理范围接口业务处理范围 SKY 系统与国库信息处理系统的接口业务处理范围主要包括实时类报文 批量类报 文 对账类报文 辅助交易类报文等四类报文 报文结构分为单笔和批量两种结构 单笔 7 40 报文指报文所含内容为单笔交易信息 批量报文指报文可包含单笔或多笔明细信息 具体 报文清单如表 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 注 单笔 SKKKA4taxMLjhSkyTyResponse xsd 批量 7 自缴 核销 TIPS 结果通知 SKTYJGtaxMLjhSkyResultResponse xsd 单笔 8 SKY 请求 SKCXZHtaxMLjhSkyCxQqRequest xsd 单笔 9 撤消 自缴 TIPS 结果应答 SKCXZH 注 单笔 10 SKY 退库请求 SKTKA1taxMLjhSkyPlTkRequest xsd 批量单笔数据 11 TIPS 收妥应答 SKTKA2 注 单笔单笔数据 SKTKA2taxMLjhSkyTyResponse xsd12 TIPS 结果通知 SKTYJGtaxMLjhSkyResultResponse xsd 批量 单笔 13 退库 交易 TIPS 退库回执 SKTYHZtaxMLjhSkyTgmHzResponse xsd 单笔 单笔数据 14 SKY 请求 SKCXTKtaxMLjhSkyCxQqRequest xsd 单笔 15 撤消 退库 TIPS 结果应答 SKCXTK 注 单笔 16 SKY 请求 SKGZA1taxMLjhSkyPlGzRequest xsd 批量单笔数据 17 TIPS 收妥应答 SKGZA2 注 批量单笔数据 18 TIPS 结果通知 SKGZA2 SKTYJG taxMLjhSkyTyResponse xsd taxMLjhSkyResultResponse xsd 批量 单笔 19 更正 交易 TIPS 更正回执 SKTYHZtaxMLjhSkyTgmHzResponse xsd 单笔 单笔数据 20 撤消 SKY 请求 SKCXGZtaxMLjhSkyCxQqRequest xsd 单笔 8 40 编 号 业务 名 发起 方 服务类型服务 ID业务报文定义 报文 结构 报文内容 21 更正 TIPS 结果应答 SKCXGZ 注 单笔 22 SKY 请求 SKMDA1taxMLjhSkyPlMdtRequest xsd 批量单笔数据 23 TIPS 收妥应答 SKMDA2 注 批量单笔数据 SKMDA2taxMLjhSkyTyResponse xsd24 TIPS 结果通知 SKTYJGtaxMLjhSkyResultResponse xsd 批量 单笔 25 免抵 调 TIPS 免抵调回 执 SKTYHZtaxMLjhSkyTgmHzResponse 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 止付 TIPS 结果通知 SKTYJG taxMLjhSkyResultResponse xsd taxMLjhSkyZfResponse xsd 单笔 批量 34 明细 核对 TIPS 核对通知 SKSPHDtaxMLjhSkyKkmxdzRequest xsd 批量批量数据 35 退库 核对 TIPS 核对通知 SKTKHDtaxMLjhSkyTkdzRequest xsd 批量批量数据 36 更正 核对 TIPS 核对通知 SKGZHDtaxMLjhSkyGzdzRequest xsd 批量批量数据 37 MDT 核 对 TIPS 核对通知 SKMDHDtaxMLjhSkyMdtdzRequest xsd 批量批量数据 38 三方 协议 SKY TIPS 请求 SKSFA1 SKSFA2 taxMLjhSkySfxyyzRequest xsd 单笔 9 40 编 号 业务 名 发起 方 服务类型服务 ID业务报文定义 报文 结构 报文内容 39 验证处理应答 SKSFA1 SKSFA2 taxMLjhSkySfxyyzResponse xsd 单笔 40 SKY 请求 SKTZCXtaxMLjhSkyZtcxRequest xsd 单笔 41 状态 查询 TIPS 处理应答 SKTZCXtaxMLjhSkyZtcxResponse xsd 单笔 SKY 发送 SKZYA1taxMLjhSkyZygs xsd 单笔 42 TIPS 异步响应 SKZYA3 注 TIPS 发送 SKZYA2taxMLjhSkyZygs xsd 单笔 43 自由 格式 SKY 异步响应 SKZYA4 注 44 SKY 请求 SKDLGKtaxMLjhSkySignInTipsRequest xsd 45 登录 TIPS 处理应答 SKDLGKtaxMLjhSkySignInTipsResponse xsd 46 SKY 请求 SKQTGKtaxMLjhSkySignOutTipsRequest xsd 47 签退 TIPS 处理应答 SKQTGKtaxMLjhSkySignOutTipsResponse xsd SKY 请求 SKLJA1 注 48 TIPS 处理应答 SKLJA1 注 TIPS 请求 SKLJA2 注 49 连接 测试 SKY 处理应答 SKLJA2 注 50 公共 数据 更新 TIPS 发送 SKGGSJtaxMLjhSkyGgsjgxRequest xsd 51 申请 重发 核对 包信 息 SKY 请求 SKBCF1taxMLjhSkyBcfRequest xsd 52 下载 入库 流水 SKY 请求 SKLSA1taxMLjhSkyXzrklspzRequest xsd 10 40 编 号 业务 名 发起 方 服务类型服务 ID业务报文定义 报文 结构 报文内容 凭证 信息 TIPS 发送 SKLSA2taxMLjhSkyXzrklspzResponse xsd SKY 请求 SKBBA1taxMLjhSkyXzbbxxRequest xsd53 下载 报表 信息 TIPS 发送 SKBBA2taxMLjhSkyXzbbxxResponse xsd 银行端缴款请求 SKYHA1taxMLjhSkyYhdjkRequest xsd 银行端缴款回执 SKYHA2taxMLjhSkyYhdjkResponse xsd 54 银行 端缴 款 注 银行端缴款扣款 响应 SKYHA3taxMLjhSkyYhdjkkkResponse xsd 银行端查询缴款 请求 SKYHQ1taxMLjhSkyYhdCxjkRequest xsd 55 银行 端查 询缴 款 注 银行端查询缴款 响应 SKYHQ2taxMLjhSkyYhdCxjkResponse xsd 56 停运 通知 TIPS 通知SKTYTZ taxMLjhSkyTytzRequest xsd 57 故障 通知 TIPS 通知 SKGZTZtaxMLjhSkyGztzRequest xsd 58 运行 参数 通知 TIPS 通知 SKCSTZtaxMLjhSkyYxcsRequest xsd 注 无业务报文 通过技术报文的 ReturnCode 判断 注 无业务报文 通过技术报文的 Content 传递信息 注 银行端缴款业务的流程和定义 仅供参考 11 40 3 3物理连接说明物理连接说明 如下图所示 省级综合征管系统税库银省级前置系统 办税大厅柜台 国库信息处理系统省级节点 税库银应用服务器 综合征管系统数据中心 税库银MQ服务器 税库银数据库 征管系统数据服务器 可选 银行系统 网上申报等系统 图 3 物理连接结构图 说明 1 综合征管系统的 SKY 前置系统和省级或地级人民银行网间互联平台进行连接 2 省级或地级人民银行网间互联平台和国库信息处理系统连接 3 综合征管系统和国库信息处理系统的信息通讯通过人民银行网间互联平台中转 12 40 4 4应用连接说明应用连接说明 税务国库横向联网系统使用 IBM MQSeries 作为消息中间件服务器 进行应用的连接 通信 对于消息中间件服务器的版本要求 请参考 MQ 配置部署指引 的版本要求章节 4 14 1 应用连接结构图应用连接结构图 TIPS 税 务 业 务 系 统 接入通 道 企 业 信 息 总 线 服 务 器 网 间 互 联 平 台 金融网 间 网 税务系统 交 易 应 用 服 务 器 SKY前置系统 基于MQ 基于MQ 商业银 行系统 商 业 银 行 系 统 图 4 应用连接结构图 SKY 与 TIPS 之间的应用连接结构如图 4 所示 税务总局与人民银行共同定义一组 XML 报文 以实现 TIPS 与税务机关业务系统的对接 SKY 与 TIPS 的通信连接采用 MQ 中间件实现 SKY 的前置系统可选择部署 MQ Server 或 MQ Client 如果选择部署 MQ Server 则选择对等模式进行通信连接 本模式可以保 障性能需求 如果选择部署 MQ Client 则选择中心节点模式进行通信连接 本模式可以 节约成本 但在高性能需求方面存在局限性 采用上述何种通信连接模式 建议遵循 以 满足性能需求为前提 这一准则 在接口队列设计方面 为保障实时类交易的高可靠性和高实时响应性 做到实时类交 易和非实时类交易相互影响降至最低 我们对实时类交易和非实时类交易分别提供一组或 多组通信接口队列 接口队列从业务角度上看 分别处理不同类别的交易 但在通信流程 上 没有本质差别 业务处理与队列通道的对应可由配置进行调整 因此 现以实时类交易为例 对中心节点模式和对等模式两种通信连接模式的通信流 13 40 程分别加以说明 中心节点模式 C S 模式 国国库库信信息息处处理理系系统统 MQ Server Queues Manager Region 接收Queue Local 发送Queue Remote 征征收收机机关关 MQI MQI 实时类交易接口队列 接收Queue Local 发送Queue Remote MQI MQI 非实时类交易接口队列 Q1Q2Q1 Q2 MQ Client Region 发发送送 程程序序 接接收收 程程序序 发发送送 程程序序 接接收收 程程序序 图 5 中心节点模式中间件数据传输图 说明 如图 5 所示 TIPS 和税务机关前置系统间的通信连接采用中间件 MQ Client TO MQ Server 的方式 即中心节点模式 1 联网中心配置 MQ Server 通过 MQ manager 为 SKY 系统创建接收队列 Q1 和 发送队列 Q2 接收队列 Q1 用于接收税务机关业务系统向 TIPS 输入的数据 发送队 列用于发送 TIPS 向税务机关业务系统输出的数据 2 SKY 系统与 TIPS 建立通信连接后 SKY 系统调用 MQ Client API 即 MQI 将请 求消息写入远程的 TIPS 分配的接收队列 Q1 中 3 TIPS 接收请求消息并处理完成后 将返回结果写到对应 SKY 的发送队列 Q2 中 联网机构调用 MQ Client API 即 MQI 从对应的发送队列 Q2 中轮询接收处理结 果 对等模式 S To S 模式 14 40 发送Queue Remote TIPS MQ Server Queues Manager Region 接收Queue Local 发送Queue Remote SKY MQ Server Queues Manager Region 接收Queue Local Channel Channel 实时类交易接口队列 发送Queue Remote 接收Queue Local 发送Queue Remote 接收Queue Local Channel Channel 非实时类交易接口队列 Q1Q2 Q3Q4 Q1 Q3 Q2 Q4 图 6 对等模式中间件数据传输图 说明 如图 6 所示 SKY 和 TIPS 系统间的通信连接采用中间件 MQ Server TO MQ Server 的方式 即对等模式 1 SKY 通过自身的 MQ manager 为接入的 TIPS 系统分别创建发送队列 Q1 和接 收队列 Q2 发送队列用于发送税务机关业务系统向 TIPS 输出的数据 接收队列用于接 收 TIPS 向税务机关业务系统输入的数据 2 TIPS 系统通过自身的 MQ manager 创建自己的接收队列 Q3 和发送队列 Q4 发送队列用于发送 TIPS 向税务机关业务系统输出的数据 接收队列用于接收税务机关业 务系统向 TIPS 输出的数据 当税务机关业务系统与 TIPS 建立连接以后 会创建从税务机 关业务系统到 TIPS 之间的通道 channel 通道两端队列的对应关系见上图 3 税务机关业务系统通过调用 MQ API 将请求消息写入本地 MQ Server 的发送队列 Q1 中 消息经通道传输至 TIPS 为该业务系统分配的接收队列 Q3 中 TIPS 处理完 成后 将返回结果写到对应为该业务系统分配的发送队列 Q4 中 消息经通道传输至税 务机关业务系统 15 40 4 24 2 应用连接配置应用连接配置 SKY 与 TIPS 系统的通信链路 通过配置 MQ Server 的 Channel 实现 在配置 MQ Channel 及其它 MQ 对象时 需要接口双方向对方提供队列管理器名称 服务器连接通道 名称 主机名或 IP 地址 侦听端口 发送通道名称 接收通道名称 发送队列名称 接 收队列名称 字符集等配置项 税务机关连接可参考人民银行公布的 MQ 配置部署指引 考虑到系统中处理的业务主要有两种 即实时通信业务和异步业务 两类业务的处理 特点差异较大 实时通信业务通常报文较小 要求及时传输和处理 异步业务通常报文较 大 不需要实时进行传输和处理 为了保证实时业务的处理效率 SKY 系统将异步业务和 实时通信业务放在不同的消息队列中处理 系统设置实时队列和异步 非实时 队列 其 中实时队列 包括一个实时发送队列和一个实时接收队列 将设置消息缺省属性为非持久 异步 非实时 队列 包括一个批量发送队列和一个批量接收队列 将设置消息缺省属性 为持久 具体哪些交易和报文通过何种队列传输见 4 7 中交易列表所述 说明 缺省情况下 放入非持久队列中的消息具有非持久属性 不记录消息日志 优 点是消息传输的效率高 缺点是一旦出现队列管理器异常 服务器掉电 关机等情况 队 列中的消息将丢失 放入持久队列中的消息具有持久属性 会记录消息日志 优点是在队 列管理器异常 服务器掉电 关机等情况下 消息不会丢失 缺点是效率较低 但是 非 持久队列中也可以传输持久消息 持久队列中也可以传输非持久消息 不过需要应用程序 发送每条消息前对消息的属性进行明确的设置 4 34 3 应用连接信息包压缩应用连接信息包压缩 为了提高报文在网络上的传输效率 各联网机构发送的报文须进行压缩处理 接收的 报文要进行解压缩处理 对消息的压缩处理和解压缩处理可通过 MQ 的出口函数实现 具 体实现方法和算法应参考 MQ 配置部署指引 4 44 4 应用连接批量报文的限制应用连接批量报文的限制 为了保证网络传输的快速 及时 高效 系统限定联网单位发起的批量包封装的业务 在 1 千笔以内 小于一千笔 TIPS 发起的与综合征管系统信息核对 入库明细 报表明细笔数如果超过了一千笔 进行分包发送 并在信息包的汇总信息中列出总笔数以及当前包在总包里的序号 对于批 16 40 量扣税业务 SKY 系统负责进行包的组装 对于批量扣税回执和核对通知业务 TIPS 负责 进行包的组装 4 54 5 应用连接接口处理模式应用连接接口处理模式 SKY 系统与 TIPS 之间的联机交易模式包括五种 具体如下 4 5 14 5 1模式一模式一 SKYSKY 发送同步请求处理模式发送同步请求处理模式 SKYTIPS 2 1 图 7 税务机关发起同步处理模式 说明 1 SKY 系统通过 MQ 发送信息给 TIPS 2 TIPS 系统接收后 及时处理 在处理结束后立即给 SKY 系统同步的应答 此种模式适用于综合征管系统发起的 业务应答含义 序号业务请求名称 收妥业务处理 1 1 实时扣税 2 2 冲正 即撤消倒扣 3 3 自缴核销 正划 4 4 撤消自缴核销 撤消正划 5 5 退库请求 6 6 撤消退库 7 7 更正请求 8 8 撤消更正 9 9 免抵调请求 1010 撤消免抵调 1111 三方协议认证 税发起 1212 连接测试 1313 包和交易状态查询 1414 登录 1515 签退 征管发送业务信息给国库信息处理系统 国库信息处理系统接收后 立即进行处理 17 40 并在处理结束后同步返回处理结果回执报文给税务机关 不同的业务 应答含义有所不同 如使用异步通信队列实现模式一中的同步业务 必须满足实时性要求 4 5 24 5 2模式二模式二 SKYSKY 异步业务处理模式异步业务处理模式 SKYTIPS 2 1 图 8 税务机关发起异步处理模式 说明 1 SKY 系统通过 MQ 发送业务请求信息给 TIPS 2 国库信息处理系统处理结束后 通过 MQ 发送异步处理回执给税务机关业务系统 此种模式主要适用于 业务处理含义 序业务名称写发送异步队列异步队列接收通知 处 理回执 1 1 发送批量扣税 注 2 2 批量扣税回执 3 3 自缴核销业务应答 4 4 退库业务回执 5 5 更正业务回执 6 6 免抵调业务回执 7 7 止付 8 8 止付应答 9 9 下载入库流水凭证请求 1010 下载入库流水凭证响应 1111 下载报表请求 1212 下载报表响应 注 代表模式当中的第 1 步 代表模式当中的第 2 步 18 40 4 5 34 5 3模式三模式三 SKYSKY 发送信息处理模式发送信息处理模式 SKYTIPS1 图 9 SKY 发送信息处理模式 说明 1 SKY 系统通过 MQ 发送业务信息到 TIPS 此种模式适用于 业务处理含义 序号业务名称 写异步队列说明 1 1 自由格式报文 2 2 通用结果处理通知 注 3 3 申请重发核对包请求 注 收到 TIPS 的异步通知 如各核对通知 公共数据更新 时 出现异常 发送 该通知 4 5 44 5 4模式四模式四 TIPSTIPS 发送同步请求处理模式发送同步请求处理模式 SKYTIPS 1 2 图 10 税务机关接收同步处理模式 说明 1 国库信息处理系统通过 MQ 发送业务信息给税务机关业务系统 2 税务机关业务系统在接收到国库信息处理系统发送过来的业务信息后 立即 19 40 处理 处理结束后同步通过 MQ 发送回执给 TIPS 此种模式适用于 TIPS 发起的连接测试请求 银行端缴款 银行端查询缴款等业务 业务处理含义 序号业务名称 收妥处理 1 1 连接测试请求 2 2 三方协议认证 TIPS 发起 3 3 银行端缴款业务 4 4 银行端查询缴款 4 5 54 5 5模式五模式五 TIPSTIPS 发送信息处理模式发送信息处理模式 SKYTIPS1 图 11 SKY 接收信息处理模式 说明 1 税务机关业务系统通过 MQ 接收 TIPS 的业务信息 此种模式适用于 业务处理含义 序号业务名称 写异步队列通知 处理回执 1 1 税票信息核对消息通知 2 2 退库业务核对消息通知 3 3 更正业务核对消息通知 4 4 免抵调业务核对消息通知 5 5 公共数据更新通知 6 6 自由格式报文 7 7 停运通知 8 8 故障通知 9 9 运行参数通知 原则上是单向的通信交易 接收方不必再发送收妥通知 但如果发生 报文解析不 全 等错误 则接收方需要根据报文参考号按照模式三发送 申请重发核对包请求 4 64 6 应用连接中报文的匹配应用连接中报文的匹配 为了方便发起方的业务处理 系统提供三个层次 三种方式 的报文和交易的匹配机 20 40 制 4 6 14 6 1基于基于 MQMQ 消息消息 IDID 的消息匹配机制的消息匹配机制 无论 SKY 还是 TIPS 系统 都同时具备双重身份 既可能是交易的发起请求方 又可 能是交易的服务响应方 如 在实时扣款交易中 税务机关作为交易的发起请求方 而 TIPS 对综合征管系统而言 作为交易的服务响应方 在三方协议认证交易中 TIPS 商业银行 作为交易的发起请求方 而 SKY 作为交易 的服务响应方 在图 12 中 交易的发起请求方 设计交易请求服务 作为交易的服务响 应方 则设计交易响应服务 下面结合图 12 说明接口双方应用开发中需要遵循的技术 规范 接收Queue 发送Queue 交易响应服务 交易请求服务 1 发起请求报文 2 按CorrelId匹配接收 回执报文 1 实时接收请求报文 2 设置CorrelId MsgId 后 实时发送回执报文 Msg 123 REQ MsgId 123 CorrelId REQ XML Msg 请 求信息 征征收收机机关关业业务务系系统统 Msg 123 RES MsgId 123 CorrelId 123 XML Msg 回 执信息 Msg 678 REQ MsgId 678 CorrelId REQ XML Msg 请 求信息 Msg 678 RES MsgId 678 CorrelId 678 XML Msg 回执信息 TIPS国国库库信信息息处处理理系 系统统 Msg 123 REQ MsgId 123 CorrelId REQ XML Msg 请 求信息 交易响应服务 Msg 123 RES MsgId 123 CorrelId 123 XML Msg 回执信息 交易请求服务 Msg 678 REQ MsgId 678 CorrelId REQ XML Msg 请 求信息 Msg 678 RES MsgId 678 CorrelId 678 XML Msg 回执信息 图 12 消息流向转换图 技术分析 21 40 1 上图中 税务机关业务系统的交易请求服务主动发起 MQPUT 请求报文 Msg 123 并同步实时等候 MQGET 对应的回执报文 所以需要建立消息匹配机制 2 上图中 税务机关业务系统的交易响应服务被动接收 MQGET TIPS 发起的请求 报文 Msg 678 但如果 Msg 123 对应的回执报文和 Msg 678 请求报文共用一个 Queue 的话 需要建立消息过滤机制 使交易响应服务与交易请求服务从同一个 Queue 中各取所需 即交易响应服务只能取出 Msg 678 请求报文而不能取出 Msg 123 对应的回执报文 交易请求服务只能取出 Msg 123 对应的回执报文而不能取 出 Msg 678 请求报文 从上述分析可以看出 为了便于交易双方的处理 接口双方的应用接口应按照以 下约定 建立消息匹配和过滤机制 1 发起方 如 SKY 的交易请求服务在发起请求报文前 必须设置请求报文 CorrelId 的值为规范中规定的值 如上图所示 本规范约定为前 3 个字节为 REQ 后 21 个字节为 ASCII 为 0 的字符 本文为便于表述 以下简称为 REQ 在请求报文发送成功后 保留 MQ Server 返回的 MsgId 如上图中的 MsgId 123 并将 MsgId 拷贝到 CorrelId 中 通过 CorrelId 匹配同步接收对应 的业务回执或应答报文 2 接收方 如 TIPS 或 SKY 的交易响应服务通过本规范中约定的 CorrelId 值 REQ 接收请求报文 在收妥并完成业务处理之后 将回执报文中的 CorrelId 设为对应请求报文中的 MsgId 的值 如上图中的 MsgId 123 或设定为固定值 ANS000000000000000000000 小结 1 对于 SKY 发起所有同步交易 即表 2 中模式一业务 TIPS 返回的对应业务回执 或异常时应答报文中均应支持该匹配机制 SKY 接口应用开发时交易请求服务可以利用该 匹配机制进行同步发送业务 模式一 的处理 但交易响应服务需按照上述消息过滤机制 进行设计 2 同样 为了保持一致性 税务机关在对 TIPS 发送报文进行响应时也应将请求报 文的 MQ MsgId 设置为回执报文的 CorrelId 具体要求为模式四业务 见表 3 需要再次重申的是 在本规范中 发起方的交易请求服务在发起请求报文前 必须设 置请求报文 CorrelId 的值 接收方的交易响应服务通过本规范中约定的 CorrelId 值接收 请求报文 这里 明确约定该特定的 CorrelId 值 22 40 在 MQ 的消息头属性中 CorrelId 的长度为 24 个字节 前 3 个字节设置成 REQ 后 21 个字节设置成 ASCII 为 0 的字符 该 24 个字节如果采用 16 进制的 ASCII 码表示为 524551000000000000000000000000000000000000000000 如使用异步通信队列实现模式一中的同步业务 也可参考上述实现方式 4 6 24 6 2基于全局基于全局 IDID 的报文匹配机制的报文匹配机制 请求报文发起方负责填写请求报文中的全局 ID 即技术报文中的 globalBusinessId 响应方带回请求报文中的全局 ID 如何填写带回 ID 请参见 附录二 税库银业务报文 描述 从而支持请求报文发起方的报文匹配处理 必须支持基于全局 ID 匹配机制的业务有模式二和模式五的业务 批量扣税 批量扣税回执 税票信息核对消息通知 退库业务核对消息通知 更正业务核对消息通知 免抵调业务核对消息通知 公共数据更新通知 自由格式报文 其他 图 和 描述了全局 ID 报文匹配机制的实现方式 全局 ID 填写于 globalBusinessId 当中 23 40 图 1 报文全局 ID 图示 而响应方带回请求报文中的全局 ID 则位于 图 1 原报文全局 ID 图示 4 6 34 6 3基于业务要素的交易匹配机制基于业务要素的交易匹配机制 对于模式二中消息的匹配 SKY 是通过 包 委托日期和 包 交易流水号两要素来 24 40 保证的 对于 TIPS 系统 由于其可能是全国集中 而言 则需要用 包 委托日期 包 交易流水号及税务机关代码来进行匹配 具体参考 应用连接消息处理模式及匹配 列表 综上 SKY 系统提供三种报文或交易匹配机制 TIPS 应按照业务流程优先的原则进行 使用 即优先使用基于消息 ID 的交易匹配机制 对于报文和消息的匹配机制 SKY 系统提供基于 MQ 消息 ID 的消息匹配 基于业务要 素的匹配和基于全局 ID 的报文匹配三种机制 TIPS 根据接口应用开发的情况选择使用 对于同步业务 表 2 中模式一 的应答和业务回执 SKY 使用基于 MQ 消息 ID 的消息匹配 机制 基于报文参考号的匹配机制和基于业务要素的匹配机制 对于非同步业务 表 2 中 模式二 的应答 SKY 支持基于报文参考号的匹配机制和业务要素的交易匹配机制 4 74 7 应用连接消息处理模式及匹配列表应用连接消息处理模式及匹配列表 表一 处理模式列表 表中绿色部分为初步规划 需经过联调测试阶段 来确认该种 配置是否为正式规范 匹配方式编号业务名 称 发起方服务类型处理模式 所属队 列 持 久 过 期 MQ 消息 ID 报文参 考号 业务 要素 1 SKY 请求模式一实时否是是是是 2 实时扣 税 TIPS 结果应答模式一实时否是是是是 3 SKY 请求模式一实时否是是是是 4 实时冲 正 TIPS 结果应答模式一实时否是是是是 5 SKY 请求模式一异步是否是是是 6 TIPS 收妥应答模式一异步是否是是否 7 自缴核 销 TIPS 结果通知模式二异步是否否是是 8 SKY 请求模式一实时否是是是是 9 撤消自 缴 TIPS 结果应答模式一实时否是是是否 10 退库交 SKY 退库请求模式一异步是否是是是 25 40 编号业务名 称 发起方服务类型处理模式 所属队 列 持 久 过 期 匹配方式 MQ 消息 ID 报文参 考号 业务 要素 11 TIPS 收妥应答模式一异步是否是是否 12 TIPS 结果通知模式二异步是否否是是 13 易 TIPS 退库回执模式二异步是否否是是 14 SKY 请求模式一实时否是是是是 15 撤消退 库 TIPS 结果应答模式一实时否是是是否 16 SKY 请求模式一异步是否是是是 17 TIPS 收妥应答模式一异步是否是是否 18 TIPS 结果通知模式二异步是否否是是 19 更正交 易 TIPS 更正回执模式二异步是否否是是 20 SKY 请求模式一实时否是是是是 21 撤消更 正 TIPS 结果应答模式一实时否是是是否 22 SKY 请求模式一异步是否是是是 23 TIPS 收妥应答模式一异步是否是是否 24 TIPS 结果通知模式二异步是否否是是 25 免抵调 TIPS 免抵调回 执 模式二异步是否否是是 26 SKY 请求模式一实时否是是是是 27 撤销免 抵调 TIPS 结果应答模式一实时否是是是否 28 SKY 请求模式二异步是否是 是是 29 TIPS 结果通知模式二异步是否否 是否 30 批量扣 税 TIPS 处理应答模式五异步是否否是是 31 SKY 请求模式二异步是否是 是是 32 TIPS 收妥应答模式二异步是否否 是否 33 止付 TIPS 结果通知模式五异步是否否是是 26 40 编号业务名 称 发起方服务类型处理模式 所属队 列 持 久 过 期 匹配方式 MQ 消息 ID 报文参 考号 业务 要素 34 明细核 对 TIPS 核对通知 模式五异步是否否 是 35 退库核 对 TIPS 核对通知 模式五 异步是否否 是 36 更正核 对 TIPS 核对通知 模式五异步是否 业务 要素 是 37 免抵调 核对 TIPS 核对通知 模式五异步是否 业务 要素 是 38 状态查 询 SKY 请求模式一实时否 是是是否 39 登录请 求 SKY 请求模式一实时否 是是是否 40 退出请 求 SKY 请求模式一实时否 是是是否 41 SKY 请求模式三异步是否否是否 42 自由格 式 报文 TIPS 请求模式五异步是否 否是否 43 SKY 请求模式一实时否是是是否 44 三方协 议 验证 注 TIPS 结果应答模式一实时否 是是是否 45 SKY 请求模式一实时否是是是否 46 连接测 试 TIPS 请求模式四实时否是是是否 27 40 编号业务名 称 发起方服务类型处理模式 所属队 列 持 久 过 期 匹配方式 MQ 消息 ID 报文参 考号 业务 要素 47 公共数 据更新 TIPS 请求模式五异步是否 否是否 48 停运通 知 TIPS 请求模式五异步是否 否是否 49 通用结 果处理 通知 SKY 应答 模式三 五 异步 实时 否是是 50 SKY 请求模式二异步是否否 是否 51 下载入 库流水 TIPS 请求模式五异步是否否是否 52 SKY 请求模式二异步是否否 是否 53 下载报 表 TIPS 请求模式五异步是否否是否 注 此处协议验证是指税务端发起 银行端响应验证处理要求 4 84 8 MQMQ 消息过期时间设置消息过期时间设置 由于横联系统发起实时交易采用同步方式处理 一旦超时其处理回执对于交易发起者 来说已经失去意义 考虑到通信连接异常等因素可能引起 MQ 队列消息堆积 若消息堆积 过多 会严重影响到实时交易的系统响应时间 因此 本接口规范中 将采用 MQ 的消息 过期技术来解决上述问题 接口应用开发时须共同遵循以下要求 接口应用开发时须共同遵循以下要求 现以 单笔实时扣税交易 为例 说明消息过期时间设置方法及与超时时间设置的关 系 其它交易的设置规则与 单笔实时扣税交易 相同 消息过期时间设置方法 SKY 在发送实时扣税报文给 TIPS 时 税务机关业务系统需要设置 MQ 消息头的过期时 间属性 MQMD Expiry 假设过期时间设为 T0 TIPS 收到实时扣税报文后 转发报文给商业银行时 TIPS 需要设置 MQ 消息头的过期 时间属性 MQMD Expiry 假设过期时间设为 T1 28 40 商业银行收到 TIPS 转发报文后 发送回执报文给 TIPS 商业银行业务系统需要设置 MQ 消息头的过期时间属性 MQMD Expiry 假设过期时间设为 T2 TIPS 收到商业银行回执报文后 转发扣税回执报文给 SKY 时 TIPS 需要设置 MQ 消息 头的过期时间属性 MQMD Expiry 假设过期时间设为 T3 消息过期时间与超时的关系 单笔实时扣税交易 操作的效率 将直接影响到办税大厅的纳税服务 所以 各连 网机构的处理效率必须以满足税务综合征管系统为第一目标 假定商业银行业务系统业务 处理时间为 T4 TIPS 业务处理时间为 T5 则各处理系统处理时间的总和 应小于综合征 管系统定义的超时时间 T T0 T1 T2 T3 T4 T5 T 消息过期时间设置具体要求 上述 T T0 T1 T2 T3 T4 T5 各时间依据系统的实际运行情况进行设定 并可能 根据业务变化进行调整 具体值将模式测试中确定 因此税务机关业务系统 TIPS 商业 银行业务系统 必须保证上述各时间具备可维护性 从上边的例子可以看出 交易发起方发送模式一业务时需要设置对应请求报文的消息 过期时间 T0 交易响应方接收模式四业务时需要设置对应业务回执报文的消息过期时间 T2 交易中转方 TIPS 转发上述业务有关报文时需要设置消息过期时间 T1 和 T3 综上 SKY 系统在发起模式一业务报文时需设置消息过期时间 T0 在收到模式四业务 并进行处理后发出业务回执报文时需要设置消息过期时间 T2 4 94 9 接口应用系统配置约定接口应用系统配置约定 为保证系统具备良好的扩展性 高可移植性 及可调优性 在系统设计时 应该将通 信连接 安全认证 数据压缩及对性能可能造成影响的其它因素 在功能上尽量做到组件 化 在系统参数设置上 尽量做到系统参数可维护性 无论采用 MQ Server 还是采用 MQ Client 互联系统必须遵守下述约定 并且如下 参数均应做成可配置 可维护和可调整的 通信连接系统参数配置 主机名称或 IP 地址 29 40 侦听端口 队列管理器名称 字符集 服务器连接通道名称 发送方通道名称 接收方通道名称 实时发送队列名称 实时接收队列名称 批量发送队列名称 批量接收队列名称 应用层系统参数配置 模式一业务超时时间 消息过期时间 报文重发次数限制 批量报文最大笔数限 制 如果采用 MQ Server 与 TIPS 进行通信 则在安全认证和压缩方面可以通过 MQ Server 间的配置实现 若采用 MQ Client 与 TIPS 进行通信 则在系统设计时 请注意 与安全认证和压缩相关的系统参数保证可配置 4 104 10接口应用系统开发约定接口应用系统开发约定 为了 MQ 的连通性在各种操作平台上得到可靠保证 MQ 字符集 CCSID 的定义参见 MQ 配置部署指引 在该字符集上基于 MQ 的应用系统开发应注意如下事项 请各联网 单位务必遵守 无论各联网单位采用何种语言开发应用系统 在发送报文时 报文必须以字节流的形 式放入消息队列 在接收报文时 报文必须以字节流的形式从消息队列中取出 如果出现 中文无法正常显示问题 则报文由字节流转换为字符串时 指定中文字符集 实现中文字 符的编码转换 MQ 消息用户标识设置 为区分应用系统 SKY 系统发往 TIPS 系统的报文 必须设置 MQMD 的 UserIdentifier 属性为 CHINATAX 用于标识报文来源 TIPS 系统发给 SKY 系 统的报文 取系统默认标识 30 40 5 5接口双方需要完成的工作接口双方需要完成的工作 5 15 1 税务总局需要完成的工作税务总局需要完成的工作 制订税务国库横向联网的接口方案和接口报文规范 设计 开发税库银系统 按照与人民银行商定的统一计划 进行系统和网络集成 实施税库银系统的联调和集成测试 模拟运行 实施 SKY 上线运行 编写 SKY 系统用户手册 5 25 2 人民银行需要完成的工作人民银行需要完成的工作 制订税务国库横向联网的接口方案和接口报文规范 负责税务与国库标准规范的转换工作 开发 TIPS 系统 和 SKY 等其它系统进行联网 支持联网业务的接受和发送 按照与国税总局商定的统一计划 进行系统和网络集成 参加 协调 辅助 SKY 系统的联调和集成测试 模