(企业所得税汇算清缴数据接口规范.docVIP

目 录 1 编写目的 3 2 数据接口规范的内容 3 3 数据接口格式基本规范 4 3.1 总体结构 4 3.2 报文格式说明 5 3.3 报文格式举例 12 4 业务请求接口规范 15 4.1 业务请求总体说明 15 4.2 业务请求详细定义 15 5 附录 23 5.1 所得税汇算清缴报表数据格式规范 23 5.2 算法介绍 25  编写目的 制定数据接口规范的目的是采集企业所得税汇算清缴数据，提升数据采集质量。同时，也为了满足大型企业数据集中管理，简化申报的需要，支持企业使用适应自身管理需要的个性化软件系统完成企业所得税汇算清缴申报工作。 数据接口规范的内容 数据接口规范是企业所得税汇算清缴数据报送到税务局端系统的报文内容规范，主要包含数据接口格式基本规范和业务请求接口规范。 本规范只定义技术报文本身，不限制采用何种传输协议。税务局端（以下统一称为“服务端”）支持当前主流传输协议http、ftp、tcp协议。推荐使用http1.1协议作为报文的传输协议。 本文中的数据接口规范包括三部分内容： 第一部分对数据接口格式基本规范，定义客户端与服务端数据交换的报文格式，详见第3节； 第二部分主要描述基于数据接口基本规范而制定的业务请求接口规范，详细定义各类请求及相应数据格式，详见第4节。业务请求接口规范可以根据业务发展的需要，对业务请求接口规范进行不断的完善和补充； 第三部分作为附录，补充第二部分所用到的各类数据，对其作统一的定义，详见第5节。 数据接口格式基本规范 本节描述企业所得税汇算清缴客户端和服务端之间的数据接口格式规范。首先在3.1描述数据接口的总体结构，然后在3.2详细描述每个部分的格式要求。 总体结构 考虑到交易的对称性，本规范把请求和响应报文合并为一个统一的报文标准，如下图所示： 技术报文总体结构图 tiripPackage是整个技术报文的根节点，其下分别定义了8个子节点和，分别说明如下。 节点名称 说明 是否必须 sessionId 会话ID，通过客户端连接到服务端，服务端为客户端产生一个唯一的会话ID，该会话ID将用来标识客户端的身份。 在连接请求后返回。 是 service 服务信息，包含一次请求中对所调用服务的编码描述、交易流水号、发起方表示等信息。 是 identity 身份信息，用于在登录时，或特定业务中对应用或用户身份进行验证。 是 routerSession 路由信息，路由信息提供了在交易过程中需要的路由关键字，routerSession采用动态列表的方式，由发起方来负责构建具体的路由属性，列表的个数可以是零到多个。 contentControl 内容控制信息，用于说明在一次服务请求中对请求业务报文所做的特殊处理。 否 signData 数字签名信息，包含数字签名的原文摘要、签名值等信息。 否 businessContent 业务信息节点，客户端发起请求时存放的请求报文信息，服务端反馈数据是存放的反馈报文信息。 是 returnState 反馈信息，包含从服务端反馈的业务处理结果信息和反馈回执信息等。 否 报文格式说明 报文的版本(version) 考虑到规范的建立是一个逐步的过程，因此报文需要有明确的版本标识，支持以后的规范升级完善，目前的报文版本是V1.0。 服务信息（service） 服务信息的全局类型为serviceType，服务信息包含了本次请求的服务ID，交易流水号等信息，具体定义如下： serviceType结构图 serviceType有5个节点，分别为： 节点名称 说明 是否必须 serviceId 服务编码，每个服务有一个唯一的编码表示，系统通过此标识来判断请求的具体业务动作。例如TY02等。 是 clientNo 客户端系统编号 是 tranSeq 交易流水号, 由客户端产生，服务端反馈报文时会附上该交易流水号。 交易流水号为32位随机数，有字母+数据组合。不能 注意：重复请求必须使用上一次的交易流水号。 是 repeatFlag 重复请求标志，0：非重复请求，1：重复请求。 否 tranReqDate 交易请求日期，格式为：2012-10-15。 否 unique 唯一性标识 否 clientVersion 客户端版本号 否 交易标识(identity) 身份认证信息的全局类型定义为identityType，身份认证信息包含了软件身份信息和客户端身份认证信息两部分，具体定义如下： identityType结构图 identity节点为identityType类型，其下有两个子节点，分别为： 节点名称 说明 是否必须 application 软件认证信息节点，类型定义为application