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

所得税汇算清缴数据接口规范目 录1编写目的32数据接口规范的内容33数据接口格式基本规范43.1总体结构43.2报文格式说明53.3报文格式举例124业务请求接口规范154.1业务请求总体说明154.2业务请求详细定义155附录235.1所得税汇算清缴报表数据格式规范235.2算法介绍251 编写目的制定数据接口规范的目的是采集企业所得税汇算清缴数据，提升数据采集质量。同时，也为了满足大型企业数据集中管理，简化申报的需要，支持企业使用适应自身管理需要的个性化软件系统完成企业所得税汇算清缴申报工作。2 数据接口规范的内容数据接口规范是企业所得税汇算清缴数据报送到税务局端系统的报文内容规范，主要包含数据接口格式基本规范和业务请求接口规范。本规范只定义技术报文本身，不限制采用何种传输协议。税务局端（以下统一称为“服务端”）支持当前主流传输协议http、ftp、tcp协议。推荐使用http1.1协议作为报文的传输协议。本文中的数据接口规范包括三部分内容：第一部分对数据接口格式基本规范，定义客户端与服务端数据交换的报文格式，详见第3节；第二部分主要描述基于数据接口基本规范而制定的业务请求接口规范，详细定义各类请求及相应数据格式，详见第4节。业务请求接口规范可以根据业务发展的需要，对业务请求接口规范进行不断的完善和补充；第三部分作为附录，补充第二部分所用到的各类数据，对其作统一的定义，详见第5节。3 数据接口格式基本规范本节描述企业所得税汇算清缴客户端和服务端之间的数据接口格式规范。首先在3.1描述数据接口的总体结构，然后在3.2详细描述每个部分的格式要求。3.1 总体结构考虑到交易的对称性，本规范把请求和响应报文合并为一个统一的报文标准，如下图所示：技术报文总体结构图tiripPackage是整个技术报文的根节点，其下分别定义了8个子节点和，分别说明如下。节点名称说明是否必须sessionId会话ID，通过客户端连接到服务端，服务端为客户端产生一个唯一的会话ID，该会话ID将用来标识客户端的身份。在连接请求后返回。是service服务信息，包含一次请求中对所调用服务的编码描述、交易流水号、发起方表示等信息。是identity身份信息，用于在登录时，或特定业务中对应用或用户身份进行验证。是routerSession路由信息，路由信息提供了在交易过程中需要的路由关键字，routerSession采用动态列表的方式，由发起方来负责构建具体的路由属性，列表的个数可以是零到多个。否contentControl内容控制信息，用于说明在一次服务请求中对请求业务报文所做的特殊处理。否signData数字签名信息，包含数字签名的原文摘要、签名值等信息。否businessContent业务信息节点，客户端发起请求时存放的请求报文信息，服务端反馈数据是存放的反馈报文信息。是returnState反馈信息，包含从服务端反馈的业务处理结果信息和反馈回执信息等。否 3.2 报文格式说明3.2.1 报文的版本(version)考虑到规范的建立是一个逐步的过程，因此报文需要有明确的版本标识，支持以后的规范升级完善，目前的报文版本是V1.0。3.2.2 服务信息（service）服务信息的全局类型为serviceType，服务信息包含了本次请求的服务ID，交易流水号等信息，具体定义如下：serviceType结构图serviceType有5个节点，分别为：节点名称说明是否必须serviceId服务编码，每个服务有一个唯一的编码表示，系统通过此标识来判断请求的具体业务动作。例如TY02等。是clientNo客户端系统编号是tranSeq交易流水号, 由客户端产生，服务端反馈报文时会附上该交易流水号。交易流水号为32位随机数，有字母+数据组合。不能重复注意：重复请求必须使用上一次的交易流水号。是repeatFlag重复请求标志，0：非重复请求，1：重复请求。否tranReqDate交易请求日期，格式为：2012-10-15。否unique唯一性标识否clientVersion客户端版本号否3.2.3 交易标识(identity)身份认证信息的全局类型定义为identityType，身份认证信息包含了软件身份信息和客户端身份认证信息两部分，具体定义如下：identityType结构图identity节点为identityType类型，其下有两个子节点，分别为：节点名称说明是否必须application软件认证信息节点，类型定义为applicationType。是customer纳税人认证信息节点，类型定义为customerType。是 applicationType有4个节点，分别为：节点名称说明是否必须applicationId渠道ID 是supplier供应商，用于标识应用的供应商。暂不启用否version客户端系统版本号，格式为V*.*.*暂不启用否authenticateType认证类型，1:证书认证、2：用户名/密码认证。暂不启用，服务端是根据数据配置的否password厂商密码密码校验时必须传否cert厂商证书否customerType有6个节点，分别为：节点名称说明是否必须customerId软件认证信息节点，类型定义为applicationType否authenticateType认证类型,1:证书认证、2：用户名/密码认证否password用户密码否cert用户CA证书否nsrsbh纳税人识别号是djxh登记序号（非三期区域，该节点填nsrsbh）是3.2.4 路由信息 （routerSession）路由信息提供了在交易过程中需要的路由关键字，routerSession采用动态列表的方式，由发起方来负责构建具体的路由属性，列表的个数可以是零到多个。路由信息的全局类型为routerSessionType，具体的结构如下图所示：routerSessionType结构图在本规范中，该节点具体内容为：NameValue是否必须SENDER纳税人识别号否3.2.5 内容控制(contentControl)内容控制的全局类型为contentControlType，内容控制包含了对业务数据处理的方式。考虑到压缩以及加密后的结果为二进制格式，为了方便传输和处理，规定凡是加密或者压缩的数据必须进行编码。上图中的control就是内容控制信息列表，控制属性列表是可选项，内容控制信息是有顺序的。下面具体描述control的结构，control的全局类型为controlType, 如下图所示，它由三个值来表示。报文具体说明： id:控制顺序,从1开始。 type:控制类型,取值如下：type说明zip表示压缩crypt表示加密code表示编码 impl:控制类型的实现类型。对于压缩(zip)的取值如下：impl(zip)说明Zlib标准ZIP的压缩算法对于加密(crypt)的取值如下：impl (crypt)说明SBMMJM表示申报密码加密算法，具体参见5. 2章节*CA表示支持的各地CA类型，具体CA算法参见5.2章节 对于编码(code)的取值如下： impl (code)说明BASE64表示采用BASE64编码算法进行编码3.2.6 签名信息（signData）签名信息的全局类型定义为signDataType，其结构定义如下：signDataType结构signDataType结构包含3个节点，分别为：节点名称说明是否必须signType签名类型,0:对业务请求报文全文进行签名，1：对报文摘要进行签名。否signSource签名原文，如果signType为对报文摘要进行签名，则signSource内容为报文摘要。当提交报文较大时，数字签名的过程可能需要花费较长时间，这时可以考虑采用对报文摘要进行签名。否signValue签名值，对签名原文进行签名得出来的签名结果。否3.2.7 业务内容(businessContent)业务内容部分存放真正的业务数据，采用分包的结构设计，即业务内容体可以由零个或多个业务数据包构成，对于有些没有真正的返回数据的场景，例如交易失败，可以不填业务内容体。businessContent的全局类型为businessContentType,其具体结构如下图所示： businessContentType结构图subPackage的全局类型为subPackageType，由包ID、包内容以及内容的处理参数三个部分组成。处理参数主要用于业务包个性化的处理，该元素也是可选的。如下图所示：subPackageType结构图对于不需要包体的请求，比如解密失败错误时，无需生成该节点（subPackageType）内容；对于一次请求中有多个包的请求，则生成多个节点。以下描述生成一个节点的报文说明：节点名称说明是否必须id按数字顺序填。是content业务报文是paramList全局类型为paramListType，由名称和值来组成，该节点中用于存放业务体内容的一些辅助信息。否paramList的取值有以下可能内容：namevalue是否必须djxh办理具体业务时的登记序号否qqwjm请求文件名否sbzlDm具体业务的申报种类否swjgDm办理具体业务时的税务机关代码否sssqQ所属时期起否sssqZ所属时期止否zyxx摘要信息（可以存放核定文件的摘要信息）否isSign签名标识Y/N否pzzlDm凭证种类代码否3.2.8 返回状态(returnState)返回状态适用于响应报文，负责存放交易处理结果，由返回代码(returnCode)和返回消息(returnMessage)两部分构成。对于请求报文，该部分为空。返回状态的全局类型为returnStateType，如下图所示：returnType结构图returnType节点的具体说明如下：节点名称说明是否必须returnCode返回码。是returnMessage返回错误信息。是returnCode返回码部分定义:returnCodereturnMessage0000成功1000消息收妥1003报文解析失败1004身份认证失败1005当前渠道没有权限办理该类业务1006未签到9001系统出现故障，要稍后再发送9003系统出现故障，您可以更换接入地址到XXX，进行业务处理9009处理失败，失败原因:XX3.3 报文格式举例本示例中所含业务报文为“申报发送”请求的业务报文。de3bb92efd5740de8b90da12d71656e5SB020725010006000084D092CA0B62F04E250828E016A3540402015-01-1414:52:06V1.0.001ClientFsupplierV1.0.01022111111111111111111111111111111SENDER1111111111111111zipZlib2codeBASE641qqwjmtaxML_10423_20140101_20141231_650102722318341_145206_1_V1.0_ZCSBswjgDmsbzlDm10423sssqQ20140101sssqZ20141231FileNametaxML_10423_20140101_20141231_650102722318341_145206_1_V1.0_ZCSB.dat04 业务请求接口规范本节规范纳税人端与服务器端的请求服务ID，以及请求和反馈的数据格式。4.1 业务请求总体说明4.1.1 业务请求列表序号业务服务ID说明1.TY02异步反馈报送结果查询(用于结果查询)2.SB02所得税汇算清缴数据报送（以下简称为“数据报送”）说明：业务服务ID由4位字符组成，前两位表示业务类型，后面两位为业务类别下的编号。4.1.2 业务请求描述说明接下来在第4.2节将描述上面列举的各个业务请求的请求及反馈报文，为了能够更好的理解下文中所描述的业务请求，在这里对如何描述业务请求做一个说明。在第4.2节描述各个业务请求的报文时，采用的是表格方式，表格包括六行，各行的含义如下表所示：行名称含义功能描述描述该业务请求的作用Request描述该业务请求的完整请求报文（除了报文的业务内容），该报文格式符合5.1数据接口格式Schema。ReqSubpackage描述该业务请求报文中的业务内容部分。Response描述该业务请求完整的响应报文（除了返回报文的业务内容），该报文格式符合5.1数据接口格式Schema。ResSubpackage描述该业务请求响应报文中的业务内容。备注描述该业务请求发送和响应时一些需要注意的特殊说明4.2 业务请求详细定义本节详细描述客户端和服务端之间每个请求的报文格式。4.2.1 数据报送功能描述发送申报请求Request3ca3e1b0b23e4178a5cab4fd9a4238f0SB020725010006000088175D3C03C48046EE0AC140948753F002015-01-1410:56:17V1.0.001ClientFsupplierV1.0.01022SENDER 1zipZlib 2cryptxxCA3codeBASE641FileNameFKQQ.XML0ReqSubpackage报送文件，报送文件按照申报种类（企业所得税汇算清缴）进行压缩，具体报送文件格式定义参见附录5.1所得税汇算清缴报表数据格式规范。Response3ca3e1b0b23e4178a5cab4fd9a4238f0SB020725010006000088175D3C03C48046EE0AC140948753F002015-01-1410:56:17V1.0.001ClientFsupplierV1.0.01022SENDER 1zipZlib2codeBASE641FileNameFKQQ.XML0ResSubpackage无业务报文，根据技术报文的returnCode判断成功失败备注1、报送文件名的格式：taxML_申报种类_所属属期起_所属属期止_+纳税人识别号_ 时间(hhmmss) 申报次数_版本号.zip，该zip 包有多个具体的报表文件组成，报表文件名格式如下：taxML_申报种类_报表编号_所属属期起_所属属期止_+纳税人识别号_ 时间(hhmmss) 申报次数_版本号.xml2、纳税人端软件在处理电子印章数据时，先进行BASE64解码，得到BMP格式的图片，然后在回执中指定的地方显示即可。4.2.2 报送结果查询功能描述异步反馈报送结果查询(用于结果查询)Request3ca3e1b0b23e4178a5cab4fd9a4238f0TY020725010006000088175D3C03C48046EE0AC140948753F002015-01-1410:56:17V1.0.001ClientFsupplierV1.0.01022SENDER 1zipZlib2codeBASE641FileNameFKQQ.XML0ReqSubpackage纳税人识别号所属时期SB02（SB代表报送结果反馈）Response3ca3e1b0b23e4178a5cab4fd9a4238f0TY020725010006000088175D3C03C48046EE0AC140948753F002015-01-1410:56:17V1.0.001ClientFsupplierV1.0.01022SENDER 1zipZlib2codeBASE641FileNameFKQQ.XML0ResSubpackage纳税人识别号税务机关名称报送时间(格式：2015-01-15 11:30:20)交易流水号报送文件名(文件名格式不包含扩展名)申报种类编码申报税额反馈代码， 0表示申报成功；其他都是失败（对于异步，1表示解密失败 2表示解压失败 3表示不明错误。） 反馈信息(成功或失败原因等)是否存在应征（Y：存在 ，N：不存在）存放通过MD5摘要算法产生的反馈信息的摘要密文串，根据业务需求，如果报送不成功，本节点为空备注5 附录5.1 所得税汇算清缴报表数据格式规范申报种类编码报表编号报表XML文件企业所得税年度纳税申报表（A类）10423企业所得税年度纳税申报表填报表单企业所得税年度纳税申报表填报表单（002）企业基础信息表（A000000）企业基础信息表（003）中华人民共和国企业所得税年度纳税申报表（A类）（A100000）中华人民共和国企业所得税年度纳税申报表（A类）（004）一般企业收入明细表（A101010）一般企业收入明细表（005）金融企业收入明细表（A101020）金融企业收入明细表（006）一般企业成本支出明细表（A102010）一般企业成本支出明细表（007）金融企业支出明细表（A102020）金融企业支出明细表（008）事业单位、民间非营利组织收入、支出明细表（A103000）事业单位、民间非营利组织收入、支出明细表（009）期间费用明细表（A104000）期间费用明细表（010）纳税调整项目明细表（A105000）纳税调整项目明细表（011）视同销售和房地产开发企业特定业务纳税调整明细表（A105010）视同销售和房地产开发企业特定业务纳税调整明细表（012）未按权责发生制确认收入纳税调整明细表（A105020）未按权责发生制确认收入纳税调整明细表（013）投资收益纳税调整明细表（A105030）投资收益纳税调整明细表（014）专项用途财政性资金纳税调整明细表（A105040）专项用途财政性资金纳税调整明细表（015）职工薪酬纳税调整明细表（A015050）职工薪酬纳税调整明细表（016）广告费和业务宣传费跨年度纳税调整明细表（A105060）广告费和业务宣传费跨年度纳税调整明细表（017）捐赠支出纳税调整明细表（A105070）捐赠支出纳税调整明细表（018）资产折旧、摊销情况及纳税调整明细表（A105080）资产折旧、摊销情况及纳税调整明细表（019）固定资产加速折旧、扣除明细表（A105081）固定资产加速折旧、扣除明细表（020）资产损失税前扣除及纳税调整明细表（A105090）资产损失税前扣除及纳税调整明细表（021）资产损失（专项申报）税前扣除及纳税调整明细表（A105091）资产损失（专项申报）税前扣除及纳税调整明细表（022）企业重组纳税调整明细表（A105100）企业重组纳税调整明细表（023）政策性搬迁纳税调整明细表（A105110）政策性搬迁纳税调整明细表（024）特殊行业准备金纳税调整明细表（A105120）特殊行业准备金纳税调整明细表（025）企业所得税弥补亏损明细表（A106000）企业所得税弥补亏损明细表（026）免税、减计收入及加计扣除优惠明细表（A107010）免税、减计收入及加计扣除优惠明细表（027）符合条件的居民企业之间的股息、红利等权益性投资收益优惠明细表（A107011）符合条件的居民企业之间的股息、红利等权益性投资收益优惠明细表（028）综合利用资源生产产品取得的收入优惠明细表（A107012）综合利用资源生产产品取得的收入优惠明细表（029）金融、保险等机构取得的涉农利息、保费收入优惠明细表（A107013）金融、保险等机构取得的涉农利息、保费收入优惠明细表（030）研发费用加计扣除优惠明细表（A107014）研发费用加计扣除优惠明细表（031）所得减免优惠明细表（A107020）所得减免优惠明细表（031）抵扣应纳税所得额优惠明细表（A107030）抵扣应纳税所得额优惠明细表（033）减免所得税优惠明细表（A107040）减免所得税优惠明细表（034）高新技术企业优惠情况及明细表（A107041）高新技术企业优惠情况及明细表（035）软件、集成电路企业优惠情况及明细表（A107042）软件、集成电路企业优惠情况及明细表（036）税额抵免优惠明细表（A107050）税额抵免优惠明细表（037）境外所得税收抵免明细表（A108000）境外所得税收抵免明细表（038）境外所得纳税调整后所得明细表（A108010）境外所得纳税调整后所得明细表（039）境外分支机构弥补亏损明细表（A108020）境外分支机构弥补亏损明细表（040）跨年度结转抵免境外所得税明细表（A108030）跨年度结转抵免境外所得税明细表（041）跨地区经营汇总纳税企业年度分摊企业所得税情况表（A109000）跨地区经营汇总纳税企业年度分摊企业所得税情况表（042）企业所得税汇总纳税分支机构所得税分配表（A109010）企业所得税汇总纳税分支机构所得税分配表（043）企业所得税年度纳税申报表（B类）10421企业所得税年度纳税申报表（B类）2014企业所得税年度纳税申报表（B类）（001）.xml分支机构所得税年报 10422中华人民共和国企业所得税汇总纳税分支机构所得税申报表中华人民共和国企业所得税汇总纳税分支机构所得税申报表（001）中华人民共和国企业所得税汇总纳税分支机构所得税分配表中华人民共和国企业所得税汇总纳税分支机构所得税分配表（002）说明：(1) 申报种类编码长度5位。第一位表示是国税还是地税，国税1，地税2；第2位和第3位为征收项目，尽量和征管系统代码一致，表示特定的税种；最后两位扩展编码。(2) 报表编码直接按照主附表的关系从小到大排列。(3) 具体xml和XSD文件参见附件。5.2 算法介绍5.2.1 CA算法【说明】一、 对上图中的缩写做一个说明 Pva：纳税人私钥 PBb：税务局公钥 PBa：纳税人公钥 PVb：税务局私钥二、 算法中的加密过程1、 对机密信息（各种涉税的数据）进行摘要（MD5摘要算法）。2、 对1中得到的摘要用纳税人私钥进行签名，得到签名数