1 简介

1.1 功能介绍

       支持从关务管理系统CMS自动下载出口报关单数据，供出口退税申报配单使用。

1.2 应用场景

       在国际贸易业务中，对中国报关出口的货物退还在国内各生产环节和流转环节按税法规定缴纳的增值税和消费税，即出口环节免税且退还以前纳税环节的已纳税款。符合条件的纳税人向主管税局机关申报对应的出口退税申报表，申报表需基于报关单、进项发票和出口发票三单的配单结果，出口报关单在配单中或不可缺。对于跨境业务量大的企业而言，搬迁关单数据、维持税务云系统数据完整/正确需花费大量的人力。

       适用场景：使用税务云出口退税应用，并使用关务管理系统CMS，支持直连CMS采集出口报关单数据至税务云。

1.3 系统路径

      【税务云】→【涉税数据管理】→【出口报关单】 →{采集报关单}

1.4 关键字段/按钮说明

1.4.1 关键字段说明（采集报关单弹窗）

2 主要操作

2.1  前置准备

2.1.1 确认权限分配

      报关单采集前，需确认管理员已给操作用户分配出口报关单的新增权限，采集报关单弹窗中税务组织只能选择用户有权限的组织，已分配权限可忽略此步骤。

      操作路径：【基础服务云】→【安全管理】→【权限管理】 → 用户授权或角色授权

图2.1 基础服务云-安全管理-用户授权界面

2.1.2 确认采集组织税号维护正确

      报关单采集前，需确认采集的税务组织中国大陆税制下已维护正确的税号，税号是采集报关单的验证条件之一，采集的税务组织只能获取本组织的出口报关单数据。

      操作路径：【税务云】→【基础设置】→【税务组织管理】 → 【税务组织信息】/【纳税主体信息】

2.1.3 连接配置（适用角色：实施顾问）

      连接CMS关务管理系统采集出口报关单，需进行身份验证，用户必须在系统先维护好连接坂云CMS关务管理系统的连接地址、ID、秘钥信息后，才可进行出口报关单的采集。

      操作路径：【开发服务云】→【开发平台】→【税务云】→【税企直连】→【税企直连-系统配置】

注：可在开发平台直接搜索 tsate_param_setting

图2.2 开发平台-税企直连应用-税企直连节点

      选择{列表}页面类型，点击【预览与调试】，进入系统配置列表，选择对应参数点击【修改】，将系统预设的以下参数根据企业信息维护正确（联系CMS获取或确认对应值），保存即可。

图2.3 开发平台-税企直连系统配置参数界面

2.1.4 计量单位映射配置（适用角色：实施顾问）

      因中国海关存储返回的出口报关单数据中，计量单位代码为海关固定代码，与系统{计量单位}基础资料代码存在差异，需配置映射关系，以确保关单采集时成交单位、法定第一单位等数据进入税务云的正确性。

注：置于开发平台原因是该内容为实施一次性配置点，供数据映射逻辑使用，无前台合适入口。系统预置计量单位与海关计量单位可匹配项过少，预设价值不高，预留用户根据系统实际使用计量单位情况自定义映射

• 步骤1：选中列表页签节点，点击【预览】，进入计量单位列表
  

      操作路径：【开发服务云】→【开发平台】→【税务云】→【涉税数据管理】→【计量单位映射】

注：可在开发平台直接搜索 tdm_setting_jldw

图2.4 开发平台顶部搜索编码结果界面

图2.5 开发平台-税务云计量单位映射-单据开发列表节点界面

• 步骤2：在计量单位映射列表，点击【引入数据】功能按钮，在引入弹窗界面，点击【立即下载】获取数据引入模板

图2.6 开发平台-税务云计量单位映射-列表预览界面

• 步骤3：引出星瀚系统中相关的计量单位数据，在计量单位资料列表页面，选择数据，点击引出功能（此步骤非必须，目的为完成步骤4的计量单位映射）

  操作路径：【基础服务云】→【基础资料】→【公共数据】→【计量单位】

图2.7 基础服务云-基础资料-计量单位列表界面

• 步骤4：维护星瀚计量单位与海关计量单位代码的映射关系（可根据计量单位名称匹配），其中通道字段请维护“cms”（小写）。以下附件{11.计量单位代码表}包含海关通关参数计量单位代码与映射维护样例，供维护参考。

11.计量单位代码表.xlsx

2.1.5 网络权限确认

      因采集系统为第三方关务管理系统，从星瀚税务云访问CMS系统，需用户服务端环境拥有访问CMS系统的网络权限，请联系企业系统运维确认。（目标IP：218.17.33.165    端口号：6680/8890 ）

注：开通网络权限前，请联系CMS确认目标系统的最新IP

2.1.6 开启关单任务调度作业和调度计划

      ①因采集系统对任务请求做了频率控制（较长时间才能返回结果，且多任务需要逐个排队处理）；

      ②系统支持下载至多一个月的关单，且支持手工或调度任务多次发起下载，采集任务量不可控；

      为了避免任务量大时环境卡死的风险，系统对关单采集任务采用调度作业执行方式处理，因此无论用户使用手工采集或定时调度发起采集的方式，均需要将关单任务本身的调度作业与调度计划开启，才能够成功下载。

      步骤1：调度作业列表设置采集任务调度作业为启用状态

      操作路径：【系统服务云】→【调度中心】→【调度作业】 →税务云-税企直连节点

      调度作业编码：tsate_sync_exportdeclaration_SKDJ_S

      调度作业名称：定时同步出口报关单数据作业

注：调度作业支持设置每个调度计划（批次）时间内采集的关单数量（pageSize），预设默认每批次采集5张报关单，根据接口限制，最多可设置为10张每批次

图2.8 系统服务云-定时同步出口报关单数据计划详细界面

      步骤2：调度计划列表设置采集任务调度计划为启用状态

      操作路径：【系统服务云】→【调度中心】→【调度计划】 →税务云-税企直连节点

      调度作业编码：tsate_sync_exportdeclaration_plan_SKDP_S

      调度作业名称：定时同步出口报关单数据计划

注：调度计划支持设置每个调度计划（批次）的频次，预设默认每2分钟完成一个批次（5张关单）的下载。用户可根据坂云系统稳定后的支持速度对批次时间与每批次关单数进行调整。例如确认1分钟可采集6单，则将调度计划时间改为每1分钟执行，关单数量（pageSize）改为6张

图2.9 系统服务云-定时同步出口报关单数据作业详细界面

2.1.7 确认集成方案与相关配置已部署并启用

      当关单数据从坂云系统请求至苍穹/星瀚系统后，使用集成服务云将数据映射入库至税务云出口报关单中，因此需保证用户系统已部署出口报关单集成相关方案。

注：使用集成服务云，首先需完成连接配置等基本操作，如第一次使用集成管理，请确认连接配置已设置成功，详见以下操作指引 集成管理-连接配置（当前账套）

      步骤1：导入关单集成方案并启动方案

      操作路径：【集成服务云】→【集成管理】→【数据集成】 →【数据集成设计】 →【数据集成方案】

      集成方案编码：KD_ExportDeclarationUpdate(IERP-IERP)

      集成方案名称：预置_出口报关单新增修改(苍穹-苍穹)

      在数据集成方案列表页面确认是否已部署该方案，如系统未自动部署，请点击{导出方案下拉-导入方案}，在方案导入详细页面上传文件（汇总在本文档2.1.7步骤3集成方案附件），导入完成方案导入后，点击{启动方案}按钮完成启动。

图2.10 集成服务云-数据集成方案列表界面

      步骤2：导入关单集成启动方案并启用

      操作路径：【集成服务云】→【集成管理】→【数据集成】 →【数据集成设计】 →【启动方案】

      集成方案编码：KD_ExportDeclarationUpdate(IERP-IERP)

      集成方案名称：预置_出口报关单新增修改(苍穹-苍穹)

      在启动方案列表页面确认是否已部署该方案，如系统未自动部署，请点击{导出方案下拉-导入方案}，在方案导入详细页面上传文件（汇总在本文档2.1.7步骤3集成方案附件），导入完成方案导入后，点击{启用}按钮完成方案启用。

     步骤3：导入关单启动方案转API并启用

      操作路径：【集成服务云】→【集成管理】→【API集成】 →【API开发】 →【启动方案转API】

      集成方案编码：KD_ExportDeclarationUpdate_Push

      集成方案名称：预置_出口报关单新增修改_推送

      在启动方案转API列表页面确认是否已部署该内容，如系统未自动部署，请点击{导出API下拉-导入API}，在导入详细页面上传文件（如下附件），导入后，点击{启用}按钮完成启用。

出口报关单-坂云CMS直连采集集成方案.rar

2.2 采集报关单

2.2.1 前提条件

       文档2.1前置准备均已完成

2.2.2 操作步骤-发起采集

• 步骤1： 出口报关单列表点击【采集报关单】，维护税务组织、更新日期、结关状态，点击【采集】发起下载

  操作路径： 【税务云】→【涉税数据管理】→【出口报关单】 →{采集报关单}

• 步骤2： 采集任务发起后，可点击采集报关单功能下拉-【采集任务监控】按钮跳转至任务监控列表，查看当前任务执行情况，组织需要注意过滤为采集关单的税务组织

  操作路径：【税务云】→【涉税数据管理】→【出口报关单】 →{采集任务监控}

• 步骤3： 采集任务成功后，可在出口报关单列表查看采集的数据，数据来源类型为“直连下载”。如采集任务失败，可通过日志详情查看失败原因，日志中将记录以下信息：

       ① 可采集关单数：将用户设置采集的更新日期/出口报关单作为请求条件，坂云CMS系统返回的关单记录总数；

      ②有效关单数：在①的基础上过滤掉无出口报关单号码（税务云出口报关单的唯一编码，无关单号的数据无法入库）、在税务云出口报关单列表已为审核或已提交状态的数据（此类状态不支持更新覆盖，避免该类数据重复采集，占用采集时间）

       ③当前下载到第x条：基于有效关单数，记录执行中的任务进度，已完成的任务该数据应等于有效关单数

       ④采集成功关单数：已成功新增/更新入库至税务云出口报关单的数量

       ⑤失败原因：用户可在日志详情字段中查看每批次未成功采集的原因（可能原因：接口请求无数据返回；数据存在问题未通过校验保存失败），仅展示当前批次的失败原因，全量任务失败原因需通过monitor查看

注：（1）因CMS接口限制，一次下载期间限制为31天，若所选期间数据量较多，建议缩小时间段下载，比如1天、3天、7天等；（2）更新日期与出口报关单号必须维护一个，如更新日期与出口报关单号同时维护，以出口报关单号为准（此时更新日期条件不生效）

图2.13 出口报关单-采集报关单界面

图2.14 出口报关单-采集报关单任务日志监控界面

2.3 调度作业配置-发起采集报关单

       用户可自定义需自动采集报关单数据的组织，自动发起出口报关单数据采集任务

2.3.1 前提条件

      文档2.1前置准备均已完成

2.3.2 设置调度作业参数，并启用调度作业

      操作路径： 【系统服务云】→【调度中心】→【调度作业】 →税务云-涉税数据管理节点

      调度作业编码：tdm_ExportDeclarationGatherTask_SKDJ_S

      调度作业名称：报关单采集调度作业

图2.15 系统服务云-报关单采集调度作业详情运行参数界面

2.3.3 设置调度计划，启用调度计划

      操作路径： 【系统服务云】→【调度中心】→【调度作业】 →税务云-涉税数据管理节点

      调度计划编码：taxc_tdm_ExportDeclarationGatherTask

      调度计划名称：报关单采集调度计划

      预设调度计划中默认每日重复执行，定时任务默认执行一次，时间为00:00（用户可根据实际情况更改频率与时间）

注：CMS建议定时采集执行时间设置为3:00-8:00之间，避免因CMS系统繁忙导致采集失败，建议通过每天小批次采集方式，以提升成功率；

图2.16 系统服务云-报关单采集调度计划详情界面

变更记录