Infor M3 集成指南：使用 SkyPlanner APS 进行生产排程

Infor M3 提供四个集成层，在本集成中各有用途。

1. ION API Gateway 上的 M3 API（MI 程序）。每个 MI 程序都通过 REST 调用：https://{ionapi-host}/{tenant}/M3/m3api-rest/v2/execute/{program}/{transaction}。请使用 v2。该版本新增了公司、分部和日期格式参数，返回的数据结构也与 v1 不同。PMS100MI 用于制造订单，PMS070MI 用于工序报工。（Infor 文档）
2. Infor Data Fabric 中的 Compass 查询 API。通过 SQL 读取 MITMAS、MWOHED 和 MWOOPE 等 M3 表的副本。Compass 采用异步方式：提交查询任务，轮询任务状态，再分页获取结果，每页最多 100,000 行或 10 MB。它适合首次加载主数据，不适合实时同步。（Infor 文档）
3. ION BODs。M3 BOD Processor 按会计实体发布已启用的 BODs。入站 BODs 包括 Process ProductionOrder、Sync BillOfMaterials、Process BillOfMaterials、Process ItemMaster 以及 Sync InventoryCount。（Infor 文档）
4. M3 Event Hub。这是一个发布—订阅框架，用于处理表级事件，例如制造订单表头和工序的变更。（Infor 文档）

MI API 规范位于各租户 ION API 目录的 Available APIs 下，每个程序都有对应的 Swagger 文档。如果标准目录中缺少所需事务，可通过 XtendM3 添加自定义 MI 程序，通过 Metadata Publisher 构建自定义列表 API。

M3 可以推送变更，但需要先在 Infor 端完成配置：

• Event Hub 只发布有活跃订阅者的事件。ION Enterprise Connector（IEC）通过 EventHub Subscriber 通道进行订阅。
• BODs 必须在 BOD Processor 中按会计实体启用，此操作需要 M3EC-Administrator 角色。（Infor 文档）

如果尚未配置推送，可轮询 PMS100MI 列表事务，或通过 Compass 按变更时间戳执行查询。

借助 SkyPlanner 自带的 webhook，回写流程从一开始就由事件驱动。

1. 首次加载主数据。通过 Compass 批量读取物料、产品结构、工序和工作中心。应根据排程需求，明确将每个 M3 工作中心映射到 SkyPlanner 的工作中心还是工作中心组。如果一个 M3 工作中心代表三台并行设备，而您希望分别排程，就应将其映射为三个 SkyPlanner 工作中心。

2. 订单同步。从 PMS100MI 或 MWOOPE 读取已下达的制造订单及其工序，同时读取库存和未结采购订单行。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。排程时会同时检查这两类数据。

只对已确定的制造订单进行排程。计划制造订单（PMS170）会由 MRP 重新生成，而 M3 每次重新计划时都会重建这些订单的负荷。

3. 排程回写。对于引擎安排或调整过的每道工序，SkyPlanner 都会将计划开始和结束时间写入对应的制造订单工序。回写使用租户目录中针对制造订单工序的 M3 MI 事务；如果您的配置需要，也可使用 XtendM3 MI 程序。数量、状态和成本核算仍由 M3 管理。

4. 车间报工。操作员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业。SkyPlanner 通过 PMS070MI Report operation 发送准备时间、运行时间和数量，并在工序完成后调用 Confirm 或 Close operation。Infor 指出：”it is important that every operation is reported,”（对每道工序进行报工很重要），这种做法可使 M3 中的负荷与 SkyPlanner 中的进度保持一致。（PMS070MI）

每道工序只选择一个报工渠道。如果同时从 SkyPlanner 和 M3 的 PMS070 对同一道工序报工，数量就会重复计入。

5. 数据管理归属与冲突处理规则。上线前应书面明确以下规则：

冲突主要源于 M3 自身的日期逻辑。关于负荷，文档说明：”is automatically generated when a manufacturing order or planned manufacturing order is generated or replanned.”（创建或重新计划制造订单或计划制造订单时，会自动生成负荷。）应将重新计划后的制造订单视为新版本，重新同步，再由 SkyPlanner 重新排程。生产发生变化时，Autopilot 会自动重新排程。SkyPlanner 不需要 M3 Scheduling Workbench；如果您已购买 SWB 许可，应由 SkyPlanner 统一管理工序日期，避免两个系统相互覆盖。

• 没有独立的工艺路线对象。工序保存在产品结构（PDS002）中，也以制造订单工序的形式保存在制造订单上。不要寻找工艺路线 API。
• 产品结构不能没有工序。产品结构至少需要一道工序，否则 M3 不会生成负荷，SkyPlanner 也就收不到生产任务。
• M3 的有限产能标志会与外部计划冲突。PDS010 标志和 CRS786 瓶颈设置会改变 M3 自身的日期。请在 M3 中将工作中心保留为无限产能，由 SkyPlanner 按实际产能约束排程。
• API 规范因租户而异。v1 与 v2 的响应不同，事务名称也会随目录和 XtendM3 扩展而变化。请使用 v2，并显式指定公司和事业部参数。
• 推送默认未启用。Event Hub 需要配置订阅者，BODs 则需要按会计实体分别启用。请明确由谁配置 ION 和 IEC，或先从轮询开始。
• 限流与分页。ION API 按租户策略限流，Compass 每页最多返回 100,000 行或 10 MB 数据。轮询时只读取增量，不要全量重载。
• M3 不是 CloudSuite Industrial。CSI 使用 IDO APIs，M3 使用 MI 程序。每份规范都应明确写出所用的 M3 对象。