Oracle Fusion Cloud 集成指南：使用 SkyPlanner APS 进行生产排程

Oracle Fusion Cloud 为外部排程系统提供三种数据接入方式：

1. Oracle Fusion Cloud SCM 的 REST API。基础路径为 /fscmRestApi/resources/11.13.18.05/。排程系统使用的资源包括 workOrders（及其子资源 WorkOrderOperation、WorkOrderOperationResource 和 WorkOrderOperationMaterial）、processWorkOrders、workDefinitions、workCenters、productionResources、calendars、itemsV2、itemStructures 和 inventoryOnhandBalances。生产进度提交至 operationTransactions、resourceTransactions 和 materialTransactions。采购订单则来自 Procurement REST API 中的 purchaseOrders。（REST 端点）
2. File-Based Data Import（FBDI）。Import Work Orders 流程根据模板创建或更新工单及其工序和工序资源，Import Work Order Resource Transactions 则加载资源事务记录。Oracle 对时效性有明确说明：”This option isn’t suitable for importing manufacturing data on a real-time basis.”（此选项不适合实时导入制造数据。）（来源）
3. Oracle Integration (OIC)。Oracle 的集成平台负责承载 Fusion 与其他系统之间的数据流。Oracle Integration 的一个集成配方会监听 Oracle Fusion Cloud Manufacturing 中的 Work Order Status Change 事件（来源）。如果公司已在使用 OIC，就采用这种方式。

实时排程主要通过 REST 对接。FBDI 适合首次加载主数据。

Oracle 端采用轮询方式。通过带筛选条件的 REST 查询，获取新增和变更的工单、工单下达状态变更、现有库存及采购订单。轮询频率按工厂设置：工单每隔几分钟读取一次，库存则每小时读取一次。如果使用 Oracle Integration，Work Order Status Change 事件可以触发即时读取。

状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写端采用事件驱动方式。

1. 首次加载主数据。通过 REST 读取物料、物料结构、工作定义、工作中心、生产资源和日历，或从 FBDI 导出文件中一次性加载。工作中心的映射需要仔细规划：如果一个工作中心内有四台属于同一资源的机器，可以映射为一个工作中心组，也可以映射为四个工作中心。每个制造组织映射为一个工作中心组，使所有工厂都纳入同一份计划。

2. 工单同步。读取已下达和未下达的工单及其工序、物料，同时读取未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。

排程对象是工单，而不是 Supply Planning 的计划订单。计划订单必须先在 Oracle 中转为工单。

3. 排程回写。当引擎安排或移动生产任务时，SkyPlanner webhook 会触发对 workOrders/{WorkOrderId}/child/WorkOrderOperation/{WorkOrderOperationId} 的 PATCH 请求，写入 PlannedStartDate 和 PlannedCompletionDate。此处适用 Oracle 的规则：”The planned start date must not occur before the start date of the work order or after the finish date of the work order.”（计划开始日期不得早于工单开始日期，也不得晚于工单结束日期。）（来源）因此，当新排程超出工单日期范围时，集成会先通过 PATCH 更新工单头的日期，再更新工序日期。

4. 车间报工。操作人员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业情况，工时记录让排程保持最新。完工数量提交至 operationTransactions，人工和机器工时提交至 resourceTransactions。如果工厂已在 Oracle 中报工，SkyPlanner 则读取其中的进度。

5. 数据归属与冲突处理规则。上线前应将这些规则明确记录下来：

只指定一个系统写入工序日期。SkyPlanner 不需要 Oracle 的排程工作区，因此会取代 Production Scheduling，负责写入计划日期。如果 Production Scheduling 仍在发布排程，其负责的组织必须与 SkyPlanner 排程的组织分开。

• 默认排程引擎的行为。Oracle 的无约束排程引擎会在创建时以及执行 “certain update actions”（某些更新操作）时运行。请在您的环境中测试哪些更新会重新计算日期，并确保 SkyPlanner 是最后写入工序日期的系统。
• 工单时间范围。工序日期必须处于工单开始日期与完成日期之间。先通过 PATCH 更新工单头。
• Basis Type。只有在 Basis Type 为 Variable 时，资源用量才按单位产品计算。Fixed 表示每道工序使用固定时间。导入时必须进行换算，否则所有时长都会出错。
• 离散制造与流程制造。离散制造工厂使用 workOrders，流程制造工厂使用 processWorkOrders。如果两种模式都在使用，就需要同时映射。
• 分页。Oracle 对每次 REST 调用返回的记录数设有上限。所有查询都应分页，并按组织和状态筛选。
• 季度更新。Oracle 每季度更新 Fusion。请在路径中固定 REST 版本，并在每次更新后重新测试。
• 状态规则。处于 Pending Approval 或已关闭状态的工单不应写入新日期。读取时应将其排除。