外部数据

V5.0.023

初始版本

2023年06月30日

外部数据模型编码

当前外部数据导入时使用的外部数据模型的编码

外部数据模型名称

当前外部数据导入时使用的外部数据模型的名称

业务单元

当前外部数据所属业务单元

外部数据编码

当前外部数据的编码，可以穿透查看外部数据详情

版本号

用于记录当前外部数据导入时使用的模型版本

状态

外部数据的状态，包括三种：

• 生效：只有生效数据可以用于生成凭证或者其他系统调用

• 校验失败：当外部数据模型的【保存校验失败数据】参数为true时，导入的数据校验失败仍然会存储下来（只存储其他校验成功的字段），此时整体的外部数据状态为校验失败。只有校验失败的数据才允许删除，其余外部数据不允许删除

• 废弃：如果数据传入错误，且为未生成凭证状态，可以通过【传相同编码】的方式将前一条传入的数据作废。废弃状态的数据不允许参与生成凭证或其他系统调用

number

外部数据编码

外部数据编码作为匹配外部数据的唯一标识，有以下注意事项：

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

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

org

业务单元

外部数据所属的业务单元

注意事项：需要在星瀚内已建立好对应的业务单元，再传入业务单元的编码

sourcesys

来源系统

外部数据的来源系统

description

paging

当传入的外部数据分录过大（例如超过了URL文件大小限制），一次性没有办法将所有分录导入，则需要用到分页，支持多次导入同一个外部数据的分录：

• true：允许分页。如果传了true，再调用追加分录接口（路径：【开放平台】-【其他】-【API服务管理1.0】-【会计平台】-【追加分录】），则可以实现多次往同一个外部数据（传同编码）里传分录

注意事项：如果不是调用【追加分录】接口，即使传了true，如果传同编码的外部数据仍然会作废前一条外部数据

• false：不允许分页。如果传相同编码的外部数据，则会作废前一条外部数据

savedefault

1.传入外部数据时，如果是系统预置字段未通过校验（例如，传入的预置字段中的业务单元在星瀚系统中不存在），则直接不允许导入数据

2.如果是自定义字段未通过校验（例如，字段的精度、长度不符合要求，基础资料在系统中不存在等），则可以选择是否需要保存校验失败的数据：

• true：保存校验失败的数据。如果校验失败，数据仍然可以传入系统中，此时外部数据的状态为校验失败，不允许用于生成凭证等后续操作，只用于在前端页面查看报错。后续可以支持重新校验，重新校验通过后，则状态变为生效

• false：不保存校验失败的数据，只要有一个字段校验失败，本条外部数据无法导入系统

重新校验

【校验失败】的数据支持<重新校验>，根据重新校验后的结果变更外部数据状态。例如，导入外部数据时未先维护好基础资料导致数据校验失败，在维护好对应基础资料后再重新校验，外部数据状态则可变为生效

生成凭证

外部数据支持调用凭证模板生成总账凭证

保存外部数据（操作）

追加分录