1、贵州省网上税务局服务项目对外开放接口标准及接入报文规范（V1.0.0）国家税务总局贵州省税务局贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 2 页 共 60 页Foresee 2017目 录1. 概述 -71.1. 编写目的 -71.2. 背景 -71.3. 术语定义 -71.4. 适用范围 -72. 接入策略 -82.1. 系统协作逻辑 -82.2. 接口交互设计 -93. 接入管理 -103.1. 接入应用管理 -103.2. 接入纳税人管理 -104. 接
2、口设计 -104.1. 技术规范 -104.1.1. 接口协议 -104.1.2. 技术报文规范 -114.1.2.1. 技术报文总体结构 -114.1.2.2. 服务信息（service） -134.1.2.3. 身份信息（identity） -144.1.2.4. 路由信息 （routerSession） -154.1.2.5. 内容控制（contentControl） -16贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 3 页 共 60 页Foresee
3、20174.1.2.6. 签名信息（signData） -174.1.2.7. 业务内容（businessContent） -184.1.2.8. 反馈信息（returnState） -194.2. 业务规范 -204.2.1. 用户注册 -204.2.2. 代码规范 -204.2.3. 业务处理逻辑分布 -205. 安全策略 -225.1. CA 证书 -225.1.1. 用户登录（纳税人身份识别） -235.1.2. 申报提交 -235.1.3. 缴款 -236. 数据接口 -237. 应用接口 -237.1. I_NF_SFJR_001 纳税人帐号登录验证 -237.1.1. 接口描述
4、-237.1.2. 数据格式 -247.1.2.1. 请求报文 -247.1.2.2. 返回报文 -247.2. I_NF_SFJR_002 审计员帐号登录验证 -257.2.1. 接口描述 -257.2.2. 数据格式 -257.2.2.1. 请求报文 -25贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 4 页 共 60 页Foresee 20177.2.2.2. 返回报文 -257.3. I_NF_SFJR_003 获取功能权限 -267.3.1. 接口描述
5、 -267.3.2. 数据格式 -267.3.2.1. 请求报文 -267.3.2.2. 返回报文 -267.4. I_NF_SFJR_004 获取纳税人基本信息 -277.4.1. 接口描述 -277.4.2. 数据格式 -277.4.2.1. 请求报文 -277.4.2.2. 返回报文 -287.5. I_NF_SFJR_005 获取税费种认定信息 -367.5.1. 接口描述 -367.5.2. 数据格式 -367.5.2.1. 请求报文 -367.5.2.2. 返回报文 -377.6. I_NF_SFJR_006 获取申报期初数据 -397.6.1. 接口描述 -397.6.2. 数据
6、格式 -407.6.2.1. 请求报文 -407.6.2.2. 返回报文 -407.7. I_NF_SFJR_007 提交申报数据 -417.7.1. 接口描述 -417.7.2. 数据格式 -417.7.2.1. 请求报文 -41贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 5 页 共 60 页Foresee 20177.7.2.2. 返回报文 -427.7.3. 签名 -437.8. I_NF_SFJR_008 获取纳税人资格信息 -437.8.1. 接口描
7、述 -437.8.2. 数据格式 -447.8.2.1. 请求报文 -447.8.2.2. 返回报文 -447.9. I_NF_SFJR_009 纳税人未清缴(欠税)信息查询 -457.9.1. 接口描述 -457.9.2. 数据格式 -467.9.2.1. 请求报文 -46返回报文 -467.10. I_NF_SFJR_010 纳税人未清缴信息查询(社保费) -477.10.1. 接口描述 -477.10.2. 数据格式 -477.10.2.1. 请求报文 -47返回报文 -487.11. I_NF_SFJR_010 缴税信息查询 -497.11.1. 接口描述 -497.11.2. 数据格
8、式 -497.11.2.1. 请求报文 -497.11.2.2. 返回报文 -507.12. I_NF_SFJR_011 缴税信息查询（社保费） -527.12.1. 接口描述 -527.12.2. 数据格式 -52贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 6 页 共 60 页Foresee 20177.12.2.1. 请求报文 -527.12.2.2. 返回报文 -527.13. I_NF_SFJR_012 缴款 -547.13.1. 接口描述 -547.
9、13.2. 数据格式 -557.13.2.1. 请求报文 -557.13.2.2. 返回报文 -557.13.3. 签名 -567.14. I_NF_SFJR_13 缴款（社保费） -567.14.1. 接口描述 -567.14.2. 数据格式 -577.14.2.1. 请求报文 -577.14.2.2. 返回报文 -577.14.3. 签名 -587.15. I_NF_SFJR_101 反馈结果查询 -587.15.1. 接口描述 -587.15.2. 数据格式 -597.15.2.1. 请求报文 -597.15.2.2. 返回报文 -59贵州省网上税务局服务项目 版本: 架构设计-第三方接
10、入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 7 页 共 60 页Foresee 20171. 概述1.1. 编写目的本文对贵州省网上税务局第三方软件接入技术规范进行说明，用于指导第三方软件系统通过互联网接入贵州省网上税务局，包含了第三方接口的技术实现逻辑、技术报文定义及业务接口定义等。1.2. 背景贵州省网上税务局上线后，考虑到未来大量的第三方代理机构以及企业端软件等社会资源也是整个纳税服务体系的重要构成，因此必须建立一套完整的第三方系统接入的环境，从标准、技术方案以及实现模式等层面来进行设计。纳税服务平台作为
11、金税三期中的一个重要的服务承载平台，也需要对相关的接口按应用集成平台接入规范对各接口、服务等进行管理。1.3. 术语定义术语 缩略语 定义纳税服务项目 纳服 贵州省网上税务局服务项目第三方接入系统接入纳税服务项目面向互联网开放的第三方系统，包括第三方客户端软件、自助终端系统、自助办税系统等。1.4. 适用范围本文档用于规范和指导第三方网上纳税申报软件接入贵州省网上税务局，通过贵州省网上税务局向第三方网上纳税申报软件提供的申报、征收等接口进行网上涉税业务办理。贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSF
12、JRZXT-JRGF20171115 第 8 页 共 60 页Foresee 2017第三方系统包括客户端软件、自助终端系统及 WEB 形态网上报税系统等。2. 接入策略2.1. 系统协作逻辑第三方接入系统平台与纳服支撑平台、核心征管系统、个人税收管理系统之间的关系如下图所示：第三方接入系统协作图如上图所示，第三方系统主要通过接口调用方式与第三方接入平台进行交互，第三方接入平台接收三方系统请求后，将请求投递到纳服支撑平台进行业务处理。在纳服支撑平台内部，对业务处理请求的实现分两种实现方式：如果数据已经通过主数据管理系统抽取生成并推送到纳服支撑平台的，纳服支撑平贵州省网上税务局服务项目 版本:
13、架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 9 页 共 60 页Foresee 2017台直接通过访问主数据副本向第三方平台提供数据访问逻辑；如果请求是数据提交请求，则纳服支撑平台将数据报文提交核心前置，待核心前置完成业务逻辑处理后，反馈结果到第三方接入平台。2.2. 接口交互设计第三方系统访问第三方接入平台，采用异步交互方式，接口交互逻辑如下图所示：接口交互设计图交互过程说明如下： 第三方系统向第三方接入前置发起业务请求； 第三方接入前置接受业务请求，对请求进行合法性验证； 同步反馈本次请求
14、已经接收的响应状态； 接入前置系统将第三方系统的请求转换成对纳服支撑平台业务处理请求，向纳服支撑平台发起请求； 纳服支撑平台根据业务类型发起对核心前置或个税前置的异步请求； 纳服支撑平台接受到前置系统的业务反馈后，将反馈结果通过异步机制反馈到接入前置； 接入前置系统接收到异步响应结果后，在接入前置将反馈结果缓存起来； 第三方系统根据接口协议，调用结果获取查询接口，获取异步响应结果。贵州省网上税务局服务项目 版本: 架构设计-第三方接入报文规范 日期: 2018-7-15FX/GT3-NF SAD_JSJGSJ-DSFJRZXT-JRGF20171115 第 10 页 共 60 页Foresee
15、 20173. 接入管理3.1. 接入应用管理第三方厂商应用通过第三方接入平台接入纳服支撑平台，需要获得相应的应用接入认证许可。接入认证许可是一对服务器证书，第三方接入平台在接入客户端访问请求时，系统平台会对接入许可进行认证，只有通过认证的第三方厂商客户端软件的请求才会被处理。3.2. 接入纳税人管理使用第三方接入平台提供的网上办税接口进行网上涉税业务办理的纳税人，都需要在贵州省网上税务局进行网上办税系统的开户，取得网上办税系统的办税帐号。纳税人通过第三方接入平台的接口进行网上涉税业务办理时，第三方接入平台通过办税帐号对纳税人进行认证识别，并进行相应业务权限上的控制和校验，避免发生安全上的问题。4. 接口设计4.1. 技术规范4.1.1. 接口协议 WebService 协议第三方接入接口采用基于 WS Security 安全认证协议的 WebService 服务实现。第三方接入系统平台通过 WebService 头部所包含的安全认证信息对第三方厂商进行认证，一个符合 WS Security 协议标准的，基于用户名/密码认证方式的报文头部节点内容如下所示：
