Inside 模式下财务凭证电子归档模块核心服务调用清单
Inside 模式下财务凭证电子归档模块核心服务调用清单
说明
本清单为 Excel 可直接落地版，按归档模块调用原生服务、归档模块暴露服务两大核心分类整理，包含服务名称、核心方法、入参 DTO、出参 DTO、核心调用场景、优先级6 大核心字段，所有 DTO 均为 MetaERP 财务域标准化预制对象，入参 / 出参字段为开发对接核心字段，可直接用于 Inside 模式下的开发落地与联调。
通用约定
- 服务命名：遵循
FIN_<领域>_<模块>_<功能>Service，跨域通用服务为COMMON_<功能>_<模块>Service； - DTO 后缀：
QueryXXXDTO（查询入参）、XXXOperateDTO（操作入参）、XXXResultDTO（结果出参）、XXXInfoDTO（详情出参）； - 通用字段：所有入参 DTO 均包含
orgId（组织ID）、userId（操作用户ID），所有出参 DTO 均包含operateStatus（操作状态：SUCCESS/FAIL）、errorCode（错误码）、errorMsg（错误信息）； - 优先级：★★★★★（强依赖，核心场景必用）、★★★★（次核心，基础能力必用）、★★★（辅助依赖，补充场景使用）。
第一部分：归档模块调用 MetaERP 原生服务清单
| 序号 | 服务归属 | 服务名称 | 核心方法 | 入参 DTO（核心字段） | 出参 DTO（核心字段） | 核心调用场景 | 优先级 |
|---|---|---|---|---|---|---|---|
| 1 | 核算领域核心服务 | FIN_CORE_VOUCHER_CoreService | getVoucherFullInfo | VoucherQueryByIdDTO• orgId• userId・voucherId（凭证 ID） | VoucherFullInfoDTO・voucherHead（凭证头：号、类型、状态）・voucherLine（凭证行：科目、金额、维度）・voucherAttach（凭证附件：文件流、名称） | 归档发起前采集凭证原生全量数据 | ★★★★★ |
| 2 | 核算领域核心服务 | FIN_CORE_VOUCHER_CoreService | checkVoucherStatus | VoucherStatusCheckDTO• orgId• userId• voucherId・statusList（待校验状态：如已过账、已结账） | VoucherStatusCheckResultDTO・isMatch（是否符合状态）・currentStatus（当前实际状态） | 归档发起前校验凭证是否满足归档条件 | ★★★★★ |
| 3 | 核算领域核心服务 | FIN_CORE_VOUCHER_CoreService | updateVoucherArchiveTag | VoucherArchiveTagUpdateDTO• orgId• userId• voucherId・archiveStatus（归档状态） | CommonOperateResultDTO（通用操作结果，无扩展字段） | 归档完成后，在原生凭证表标记归档状态 | ★★★★★ |
| 4 | 核算领域核心服务 | FIN_CORE_ACCOUNT_CoreService | getAccountFullInfo | AccountQueryByIdDTO• orgId・accountId（科目 ID） | AccountFullInfoDTO・accountCode（科目编码）・accountName（科目名称）・accountAttr（科目属性） | 归档数据标准化，补全科目名称 / 属性信息 | ★★★★ |
| 5 | 核算领域核心服务 | FIN_CORE_DIMENSION_CoreService | getDimensionValue | DimensionQueryDTO• orgId・dimensionId（维度 ID）・dimensionCode（维度编码） | DimensionValueDTO・dimensionName（维度名称）・dimensionValue（维度值） | 归档数据标准化，补全核算维度信息 | ★★★★ |
| 6 | 财务域通用服务 | FIN_COMMON_AUTH_Service | checkOperatePermission | AuthCheckDTO• orgId• userId・permissionCode（权限编码：如 VOUCHER_ARCHIVE）・businessId（业务主键：voucherId） | AuthCheckResultDTO・hasPermission（是否有权限）・permissionType（权限类型） | 所有归档操作前的功能级权限校验 | ★★★★★ |
| 7 | 财务域通用服务 | FIN_COMMON_AUTH_Service | checkDataPermission | DataAuthCheckDTO• orgId• userId・dataOrgId（数据所属组织 ID）・businessType（业务类型：VOUCHER） | DataAuthCheckResultDTO• hasPermission・dataScope（数据权限范围） | 跨组织归档数据查询 / 下载时的数据级权限校验 | ★★★★ |
| 8 | 财务域通用服务 | FIN_COMMON_ORG_Service | getOrgFullInfo | OrgQueryByIdDTO• orgId | OrgFullInfoDTO・orgCode（组织编码）・orgFullName（组织全称）・orgLevel（组织层级） | 归档数据标准化，补全组织名称 / 编码信息 | ★★★★ |
| 9 | 财务域通用服务 | FIN_COMMON_LOG_Service | recordBizLog | BizLogRecordDTO• orgId• userId• businessType（ARCHIVE）• businessId（voucherId）・opDesc（操作描述） | CommonOperateResultDTO | 归档全流程记录财务域业务操作日志 | ★★★★ |
| 10 | 跨域通用服务 | COMMON_FILE_StorageService | uploadFile | FileUploadDTO・fileByte（文件字节流）・fileName（文件名）・storageDir（存储目录：FIN/VOUCHER/ARCHIVE）• bizType（ARCHIVE） | FileUploadResultDTO・fileId（文件 ID）・storagePath（存储路径）・fileMd5（文件 MD5 值）・fileSize（文件大小） | 凭证电子档 / 附件的归档存储 | ★★★★★ |
| 11 | 跨域通用服务 | COMMON_FILE_StorageService | getFileMd5 | FileQueryMD5DTO• fileId• storagePath | FileMD5ResultDTO• fileMd5・isTampered（是否被篡改） | 归档数据防篡改校验、定期文件完整性验证 | ★★★★ |
| 12 | 跨域通用服务 | COMMON_FILE_StorageService | downloadFile | FileDownloadDTO• fileId• storagePath• userId | FileDownloadResultDTO• fileByte• fileName• fileMd5 | 归档电子档 / 附件的在线下载 | ★★★★ |
| 13 | 跨域通用服务 | COMMON_NOTIFY_Service | pushTodo | TodoPushDTO• userId・todoTitle（待办标题）・todoContent（待办内容）• businessId（voucherId）・url（跳转链接） | CommonOperateResultDTO | 归档失败时向制单人推送待办任务 | ★★★★ |
| 14 | 跨域通用服务 | COMMON_NOTIFY_Service | pushNotify | NotifyPushDTO• userId・notifyTitle（通知标题）・notifyContent（通知内容）• businessId（voucherId） | CommonOperateResultDTO | 归档完成后向审计岗推送核查通知 | ★★★★ |
| 15 | 跨域通用服务 | COMMON_SYS_LOG_Service | recordSysLog | SysLogRecordDTO• userId・opIp（操作 IP）• module（FIN_ARCHIVE）・opType（操作类型）• opDesc | CommonOperateResultDTO | 归档模块系统级操作日志记录（如服务调用、异常） | ★★★ |
第二部分：归档模块暴露给 MetaERP 的服务清单
| 序号 | 服务分类 | 服务名称 | 服务注册别名 | 核心方法 | 入参 DTO（核心字段） | 出参 DTO（核心字段） | 授权调用方 | 核心调用场景 | 优先级 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | 归档核心操作服务 | FIN_CORE_ARCHIVE_CoreService | archiveCore | triggerArchive | ArchiveTriggerDTO• orgId• userId• voucherId・triggerType（触发类型：AUTO/MANUAL） | ArchiveOperateResultDTO・archiveStatus（归档状态）• fileMd5• storagePath・archiveTime（归档时间） | 凭证过账 / 审核模块、手动归档界面 | 过账成功自动归档、手动单张归档 | ★★★★★ |
| 2 | 归档核心操作服务 | FIN_CORE_ARCHIVE_CoreService | archiveCore | triggerBatchArchive | ArchiveBatchTriggerDTO• orgId• userId・voucherIdList（凭证 ID 列表）• triggerType | ArchiveBatchOperateResultDTO・successCount（成功数）・failCount（失败数）・failVoucherList（失败凭证列表 + 原因） | 凭证结账模块、批量归档界面 | 月末结账前批次归档漏归档凭证 | ★★★★★ |
| 3 | 归档核心操作服务 | FIN_CORE_ARCHIVE_CoreService | archiveCore | updateArchiveData | ArchiveDataUpdateDTO• orgId• userId• voucherId・updateFieldMap（更新字段键值对） | CommonOperateResultDTO | 凭证修改模块 | 原生凭证修改后同步更新归档数据 | ★★★★★ |
| 4 | 归档查询服务 | FIN_CORE_ARCHIVE_QueryService | archiveQuery | checkArchiveStatus | ArchiveStatusCheckDTO• orgId• userId・voucherId/batchId（二选一） | ArchiveStatusResultDTO・isArchived（是否已归档）• archiveStatus・archiveUser（归档人）• archiveTime | 凭证结账模块、凭证查询模块 | 结账前校验归档状态、凭证查询联查归档状态 | ★★★★★ |
| 5 | 归档查询服务 | FIN_CORE_ARCHIVE_QueryService | archiveQuery | getArchiveFullInfo | ArchiveQueryByIdDTO• orgId• userId• voucherId | ArchiveFullInfoDTO• archiveStatus• storagePath• fileMd5・voucherInfo（关联凭证基础信息） | 凭证查询模块、审计模块 | 财务 / 审计人员查询归档全量详情 | ★★★★★ |
| 6 | 归档查询服务 | FIN_CORE_ARCHIVE_QueryService | archiveQuery | queryArchiveByCondition | ArchiveConditionQueryDTO• orgId• userId・startTime/endTime（归档时间范围）• archiveStatus・voucherNo（凭证号，可选） | ArchivePageResultDTO・pageNum（当前页）・pageSize（每页条数）・totalCount（总条数）・archiveList（归档数据列表） | 审计模块、归档统计界面 | 按条件分页查询归档数据、归档统计分析 | ★★★★ |
| 7 | 归档文件下载服务 | FIN_CORE_ARCHIVE_DownloadService | archiveDownload | downloadArchiveFile | ArchiveFileDownloadDTO• orgId• userId• voucherId・fileType（文件类型：MAIN/ATTACH） | FileDownloadResultDTO• fileByte• fileName• fileMd5 | 凭证查询模块、审计模块 | 在线下载归档主档 / 附件 | ★★★★ |
| 8 | 归档日志服务 | FIN_CORE_ARCHIVE_LogService | archiveLog | getArchiveOpLog | ArchiveLogQueryDTO• orgId• userId• voucherId・opTimeStart/opTimeEnd（操作时间范围） | ArchiveLogResultDTO・opLogList（操作日志列表）・每条日志：opUser、opTime、opType、opDesc | 审计模块、运维模块 | 审计操作轨迹、排查归档失败原因 | ★★★★ |
| 9 | 归档配置服务 | FIN_CORE_ARCHIVE_SettingService | archiveSetting | getArchiveConfig | ArchiveConfigQueryDTO• orgId | ArchiveConfigDTO・isAutoArchive（是否自动归档）・isCheckBeforeClose（是否结账前置）・retryCount（自动重试次数）・retryInterval（重试间隔，分钟） | 所有归档相关模块 | 模块启动加载配置、业务执行时获取归档规则 | ★★★★ |
Excel 版使用说明
- 可直接将本清单复制到 Excel 中，按分类分 sheet 整理（如「归档调用原生服务」「归档暴露服务」），便于开发团队查阅；
- 入参 / 出参 DTO 的核心字段为开发必传 / 必返字段，可根据实际业务需求在财务域标准化 DTO 基础上做轻量扩展；
- 服务注册别名为领域内调用唯一标识，开发时需严格按清单配置，确保其他模块可正常发现和调用；
- 优先级为开发排期与联调优先级，★★★★★需优先开发、优先联调，保障核心归档场景落地。