广东省电子税务局接入接口规范目录1概述5.docxVIP

广东省电子税务局接入 接口规范  目 录 TOC \o 1-4 \h \z \u 1 概述 5 1.1 编写目的 5 1.2 术语定义 5 1.3 适用范围 5 2 接入管理 6 2.1 接入应用管理 6 3 接口设计 6 3.1 技术规范 6 3.1.1 接口协议 6 3.1.2 技术报文规范 6 技术报文总体结构 6 服务信息（service） 7 身份信息（identity） 8 路由信息 （routerSession） 10 内容控制（contentControl） 11 签名信息（signData） 11 业务内容（businessContent） 12 反馈信息（returnState） 14 4 业务请求 15 4.1 增值税一般人纳税人申报 15 4.1.1 获取期初数数据(ZZSYBNSR.HQQCSJ) 15 接口描述 15 业务报文数据格式 15 样例报文 16 4.1.2 申报业务提交（GD.YCSBD） 16 接口描述 16 数据格式 17 4.2 申报结果查询（TB.SBJGCX） 17 接口描述 17 数据格式 17  概述 编写目的 本文对涉企软件接入技术标准规范进行说明，用于指导第三方涉企软件系统接入，包含了第三方接口的技术实现逻辑、技术报文定义及业务接口定义等。 术语定义 术语 缩略语 定义 适用范围 本文档用于规范和指导涉企软件接入，通过电子税务局向第三方涉企软件提供的涉税业务接口进行业务办理。 第三方涉企软件包括通过总局网上纳税申报评测的各类纳税服务软件等，包括纳税人桌面端软件以及通过互联网接入的自助终端等。 接入管理 接入应用管理 第三方厂商应用通过统一受理平台接入时，需要获得相应的应用接入认证许可。接入认证许可使用纳税证书，第三方接入平台在接入客户端访问请求时，系统平台会对接入许可进行认证，只有通过认证的涉企软件的请求才会被处理。 接口设计 技术规范 接口协议 第三方接入接口采用http协议由统一受理平台实现接入。 技术报文规范 技术报文总体结构 考虑到交易的对称性，在第三方接入规范中，将请求和响应的技术报文定义为统一的格式标准，如下图所示： 技术报文总体结构图 tiripPackage是整个技术报文的根节点，其下分别定义了8个子节点和，分别说明如下。 节点名称 说明 是否必须 sessionId 会话ID，纳税人通过客户端系统登录到第三方接入平台后，第三方接入平台会为纳税人产生一个唯一的会话ID，该会话ID将用来标识纳税人的身份。 在登录请求后返回。 是 service 服务信息，包含一次请求中对所调用服务的编码描述、交易流水号、发起方表示等信息。 是 identity 身份信息，用于在登录时，或特定业务中对应用或用户身份进行验证。 是 routerSession 路由信息，路由信息提供了在交易过程中需要的路由关键字，routerSession采用动态列表的方式，由发起方来负责构建具体的路由属性，列表的个数可以是零到多个。 否 contentControl 内容控制信息，用于说明在一次服务请求中对请求业务报文所做的特殊处理。 否 signData 数字签名信息，包含数字签名的原文摘要、签名值等信息。 否 businessContent 业务信息节点，客户端发起请求时存放的请求报文信息，服务端反馈数据是存放的反馈报文信息。 是 returnState 反馈信息，包含从服务端反馈的业务处理结果信息和反馈回执信息等。 否 服务信息（service） 服务信息的全局类型为serviceType，服务信息包含了本次请求的服务ID，交易流水号等信息，具体定义如下： serviceType结构图 serviceType有5个节点，分别为： 节点名称 说明 是否必须 serviceId 服务编码，每个服务有一个唯一的编码表示，系统通过此标识来判断请求的具体业务动作。例如SB01,TY02等等。 是 clientNo 客户端产品编号 (应用接入暂时没有取) 是 tranSeq 交易流水号, 由客户端产生，服务端反馈报文时会附上该交易流水号。 交易流水号为32位随机数，有字母+数据组合。不能重复 注意：重复请求必须使用上一次的交易流水号。 是 repeatFlag 重复请求标志，0：非重复请求，1：重复请求。 （暂时没有取） 否 tranReqDate 交易请求日期，格式为：2012-10-15。 （暂时没有取） 否 unique 唯一性标识 否 clientVersion 客