企业所得税汇算清缴数据接口规范.docx
《企业所得税汇算清缴数据接口规范.docx》由会员分享,可在线阅读,更多相关《企业所得税汇算清缴数据接口规范.docx(37页珍藏版)》请在冰豆网上搜索。
企业所得税汇算清缴数据接口规范
所得税汇算清缴
数据接口规范
1编写目的
制定数据接口规范的目的是采集企业所得税汇算清缴数据,提升数据采集质量。
同时,也为了满足大型企业数据集中管理,简化申报的需要,支持企业使用适应自身管理需要的个性化软件系统完成企业所得税汇算清缴申报工作。
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结构图
在本规范中,该节点具体内容为:
Name
Value
是否必须
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的取值有以下可能内容:
name
value
是否必须
djxh
办理具体业务时的登记序号
否
qqwjm
请求文件名
否
sbzlDm
具体业务的申报种类
否
swjgDm
办理具体业务时的税务机关代码
否
sssqQ
所属时期起
否
sssqZ
所属时期止
否
zyxx
摘要信息(可以存放核定文件的摘要信息)
否
isSign
签名标识Y/N
否
pzzlDm
凭证种类代码
否
3.2.8返回状态(returnState)
返回状态适用于响应报文,负责存放交易处理结果,由返回代码(returnCode)和返回消息(returnMessage)两部分构成。
对于请求报文,该部分为空。
返回状态的全局类型为returnStateType,如下图所示:
returnType结构图
returnType节点的具体说明如下:
节点名称
说明
是否必须
returnCode
返回码。
是
returnMessage
返回错误信息。
是
returnCode返回码部分定义:
returnCode
returnMessage
0000
成功
1000
消息收妥
1003
报文解析失败
1004
身份认证失败
1005
当前渠道没有权限办理该类业务
1006
未签到
9001
系统出现故障,要稍后再发送
9003
系统出现故障,您可以更换接入地址到XXX,进行业务处理
9009
处理失败,失败原因:
XX
3.3报文格式举例
本示例中所含业务报文为“申报发送”请求的业务报文。
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
de3bb92efd5740de8b90da12d71656e5
SB02
07250100060000
84D092CA0B62F04E250828E016A35404
0
2015-01-14
14:
52:
06
V1.0.001
Client
Fsupplier
V1.0.010
2
2
111111*********
111111*********
SENDER
111111*********
1
zip
Zlib
2
code
BASE64
1
[CDATA[UEsDBBQAAAAIAIR2LkaK]>
qqwjm
taxML_10423_20140101_20141231_650102722318341_145206_1_V1.0_ZCSB
swjgDm
sbzlDm
10423
sssqQ
20140101
sssqZ
20141231
FileName
taxML_10423_20140101_20141231_650102722318341_145206_1_V1.0_ZCSB.dat
0
4业务请求接口规范
本节规范纳税人端与服务器端的请求服务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数据报送
功能描述
发送申报请求
Request
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
3ca3e1b0b23e4178a5cab4fd9a4238f0
SB02
07250100060000
88175D3C03C48046EE0AC140948753F0
0
2015-01-14
10:
56:
17
V1.0.001
Client
Fsupplier
V1.0.010
2
2
SENDER
1
zip
Zlib
2
crypt
xxCA
3
code
BASE64
1
FileName
FKQQ.XML
0
ReqSubpackage
报送文件,报送文件按照申报种类(企业所得税汇算清缴)进行压缩,具体报送文件格式定义参见附录5.1所得税汇算清缴报表数据格式规范。
Response
xmlversion="1.0"encoding="UTF-8"standalone="yes"?
>
3ca3e1b0b23e4178a5cab4fd9a4238f0
SB02
07250100060000
88175D3C03C48046EE0AC140948753F0
0
2015-01-14
10:
56:
17
V1.0.001
Client
Fsupplier