变更记录

1 简介

1.1 功能介绍

用于将异构系统数据接入到星瀚。使用外部数据模型定义异构系统业务的数据结构，根据模型接入的数据结构化存储到外部数据（原【会计事件】菜单）中

注意事项：外部数据定位是一个接口表，主要作用是将异构系统数据接进星瀚生成凭证，无法实现过多的查询和计算以及业务处理的的功能（例如走工作流审批、进入共享中心等），如果有比较复杂的业务处理需求，建议集成到对应的业务系统

1.2 应用场景

公司发展的不同阶段的不同板块可能会使用不同的ERP系统，即业务系统和财务系统可能会使用不同厂商所提供的软件，例如前端使用SAP/用友等系统的费用模块，想要生成星瀚的总账凭证，需要将两个系统之间进行转换和对接，外部数据就是用于将不同厂商的业务系统数据接入星瀚，对接到星瀚总账中。

1.3 系统路径

【财务云】→【会计事件库】→【外部数据接入】→【外部数据】

1.4 关键字段/按钮说明

外部数据字段说明

系统预置字段说明

关键按钮说明

1.5 外部数据状态流转说明

注意事项：

1.只有"生效"状态的外部数据才能用于生成凭证等后续操作

2.只有"校验失败"状态的外部数据才允许删除，其他状态的数据不允许删除

3.外部数据作废后，数据状态不可以重新变为生效

1.6 涉及的接口

接口路径：【openAPI】-【其他】-【API1.0】-【API服务管理1.0】-【财务云】-【会计平台】

2 主要操作

2.1 导入外部数据

前提条件

定义好外部数据模型

操作步骤

步骤1：创建第三方应用，路径：【openAPI】-【安全策略】-【第三方应用】

第三方应用，即是需要与星瀚平台对接的三方系统。创建第三方应用是为了获取与星瀚平台通讯的连接信息，即access token 值

• 系统编码：第三方应用唯一标识

• AccessToken认证密钥：获取AccessToken时需要

• API授权、IP白名单：需要打开，否则访问不通过

步骤2： 根据外部数据模型导入外部数据

调用星瀚开放平台中的“保存外部数据（操作）”接口，将数据传输到会计事件库中，一次完整的传输产生一个外部数据

（1）接口路径：【openAPI】-【其他】-【API1.0】-【API服务管理1.0】-【财务云】-【会计平台】-【保存外部数据（操作）】

（2）模型的数据导入示例可以通过<json示例>获取

详细的外部数据接口调用指南见：外部数据接口调用使用指南 (kdcloud.com)

示例：

• eventclass：传入【外部数据模型】编码，通过哪个模型导入数据，就传哪个模型编码

• number：传入【外部数据】编码，传入什么值，对应的外部数据编码就是什么

• org：传入业务单元编码，需要星瀚系统内建立好业务单元

• paging：是否分页，如果为"true"，则可以追加分录

• savedefault：保存校验失败数据，如果为"true"，则允许传入校验不通过的外部数据（系统预置字段除外）

• 第一个红色方框：标识了外部数据的单据头字段

• 第二个红色方框：标识了外部数据的一级分录体

• 第三个红色方框：标识了外部数据的二级分录体

注意事项：

1.外部数据编码不允许重复，如果重复传入，则前面传入的数据会自动失效（前提是没有生成凭证）

2.如果外部数据已经生成凭证，传入重复外部数据编码编码会报错

后续操作

如果未生成凭证，可支持将外部数据作废

2.2 查看接入报错

适用场景

外部数据接入时，选择了保存校验失败的数据（即模型中savedefault字段传true），则允许保存校验失败数据，并且在外部数据页面查看详细报错信息

操作步骤

步骤1：报错按模型定义的分组划分，每个分组对应一块报错信息。只要分组里有一个字段校验失败，则对应分组旁边的状态就为失败

步骤2：查看具体第几行错误信息

例如，一级分录【费用明细】下的二级分录【发票信息】中，【发票类型】字段校验失败，则可以查看具体在哪行【费用明细】下的哪行【发票信息】的【发票类型】值未校验通过

注意事项：前提条件为选择了保存校验失败的数据（即模型中savedefault字段传true），否则不保存校验失败数据

2.3 作废数据

适用场景

如果数据导入有误，且没有生成凭证，则可以将当前有误的外部数据作废。作废后的外部数据将不能用于生成凭证、对账等用途

操作步骤

步骤1：查看作废外部数据接口要求

路径：【openAPI】-【其他】-【API1.0】-【API服务管理1.0】-【财务云】-【会计平台】-【作废外部数据】

步骤2：根据要求，通过openAPI可以作废已导入的外部数据

注意事项：已生成凭证的外部数据不允许作废

2.4 生成凭证

前提条件

定义好外部数据模型，并且已发布

操作步骤

步骤1：在【单据列表】-【会计事件库】，选择需要生成凭证的外部数据模型节点，点击<新增>定义凭证模板

步骤2：点击<生成凭证>，将外部数据生成对应的总账凭证

注意事项：

1.如果外部数据模型的【是否新模型】标识为：是，则凭证模板在【单据列表】-【会计事件库】下定义

2.如果外部数据模型的【是否新模型】标识为：否，则凭证模板在【外部数据（老模型）】下定义

步骤3：生成凭证成功后，会显示凭证字号，且是否生成凭证字段为是，可以联查凭证详情

2.5 支持对账

前提条件

外部数据模型列表中【是否新模型】为：是

操作步骤

步骤1：新建对账方案

详细对账方案设置见：对账方案 (kdcloud.com)

注意事项：

1.业务系统选择【会计事件库】

2.【取数规则】中，业务对象选择【会计事件库】

• 选择会计事件库下需要对账的模型，可根据外部数据模型编码过滤（注意，所有编码都在外部数据模型编码的前面加了fah_e_前缀）

• 【类型】选择【单据】

3 版本升级说明

【V5.0.022】版本到【V5.0.023】版本外部数据做了重大调整，主要差异点如下：

1.菜单名由【会计事件】变更为【外部数据】

2.新老模型分别走两套逻辑，通过新老模型导入的数据也分别为两套逻辑，以下为新模型导入的【外部数据】特性：

（1）做了结构化存储改造，从原来会计事件解析报文转变为可允许直接从表取数

（2）支持智能对账

（3）支持凭证模板中使用函数

（4）【状态】字段新增【校验失败】值，支持保存字段校验失败的数据（模型中savedefault字段传true）

（5）新增【版本号】字段，支持追溯外部数据导入的模型版本

（6）新增【重新校验】功能，支持校验失败的数据进行重新校验

（7）新增查看外部数据接入报错信息功能