Monitor ERP 集成指南：使用 SkyPlanner APS 进行生产排程

Monitor G5 文档中提供的集成接口是 Monitor ERP API v1。该接口结合 CQRS 和 REST，通过 HTTPS 传输 JSON 数据。（Monitor ERP API）

• 查询通过 GET 读取数据，支持 OData 风格的选项：$filter、$select、$expand、$orderby、$top 和 $skip。
• 命令通过 POST 写入数据，例如 Manufacturing/ManufacturingOrderOperations/Update。
• Batch 通过 POST /api/v1/Batch 在同一个事务中执行多条命令，要么全部提交成功，要么全部回滚。追加 /Simulate 或 /Validate 可测试批处理并回滚。这是安全写入整份排程的方式。（Batch）

基础 URL 为 https://{host}:8001/{languageCode}/{companyNumber}/api/v1/。公司编号由数据库编号和公司 ID 组合而成，例如 004.1。

关于许可，Monitor 说明：”It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.”（所有客户均可免费通过 API 查询和提取信息。但要使用命令向 ERP 系统写入数据，则需购买 Monitor ERP API。）项目启动时就应将写入许可纳入计划。（api.monitor.se）

Monitor ERP API 参考文档未提供 webhook 或事件订阅接口。需要通过轮询获取变更：

• Common/EntityChangeLogs（从 2.33 起提供）返回 ChangeType（Update、Create、Delete）、EntityTypeId、EntityId 和 ModifiedTimestamp。每隔几分钟轮询一次，仅获取发生变更的记录。（EntityChangeLog）
• 查询制造订单时，仅筛选未结订单，并使用 $top 和 $skip 分页。

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

1. 首次加载主数据。读取工作中心、工序行、备选工序行、物料行、物料和班次计划。逐一确认 Monitor 工作中心与 SkyPlanner 工作中心的映射关系。Pool 类型的工作中心映射为工作中心组，其包含的各个工作中心则映射为组内工作中心，供引擎选择。

2. 订单同步。读取未结制造订单及其节点、工序和物料，同时读取库存和未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。首次加载后，通过 Common/EntityChangeLogs 进行增量同步。

3. 排程回写。对于引擎安排或调整的每道工序，SkyPlanner 都会发送 ManufacturingOrderOperations/Update，其中包含 PlannedStartDate 和 PlannedFinishDate。如果引擎将工序移至同一资源池中的另一台机器，则先调用 SetWorkCenter。同一订单的命令放在同一个 Batch 中，确保 Monitor 要么全部接受，要么全部不接受。测试期间，使用 /Validate 运行批处理。

在 24.5 之前的 Monitor 版本中，无法通过 Update 写入计划日期。应改用 ManufacturingOrders/ReplanOperation（从 2.40 起提供），传入 StartDate 和 FinishDate，并根据您的规则设置 RestrictToOrderBounds。

4. 车间报工。只保留一个报工渠道：

• 继续通过 Monitor 报工。操作人员仍按现有方式，在 Recording terminal 上或通过设备集成报工。SkyPlanner 读取 ManufacturingOrderOperationReportings 获取进度，并重新排程。
• 改为通过 SkyPlanner 报工。操作人员使用 Mobile Confirmations 或 Production Timer 记录作业，SkyPlanner 随后向 Monitor 提交 ReportManufacturingOrderOperation。

两端同时报工会导致工时和数量重复。

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

冲突的主要原因是计划员仍在调整优先级计划。执行 Rescheduling according to New finish 或在 Priority planning 中拖动行，都会覆盖 SkyPlanner 写入的日期。一旦工序顺序由 SkyPlanner 管理，Priority planning 就只用于查看。启用 Autopilot 后，生产发生变化时，SkyPlanner 会自动重新排程。

• 可用率系数。Monitor 使用可用率系数将总产能折算为净产能，新建工作中心的默认值为 80 %。这一系数只能应用一次：要么设为 SkyPlanner 中的效率，要么通过缩短班次体现，不能两者同时使用。
• 时间精度。使用 Day planning 的工作中心以每日基本工时表示产能，不包含班次时段。请根据生产日历，将实际班次映射到 SkyPlanner，确保作业安排在工作时间内。
• 排队时间与重叠比例。工序行包含排队时间和以 % 表示的重叠比例。应在范围评估时确定各项如何映射到 SkyPlanner，否则上线后生产提前期会发生变化。
• 资源池。资源池工作中心在 Pool planning 中规划，而不是在 Priority planning 中。应读取资源池包含的工作中心，不能只读取资源池行。
• 版本要求。通过 Update 写入计划日期需要 24.5 版本。API 中的工作中心产能字段需要 24.3 版本，OIDC 则需要 25.8 版本。在范围评估之前，请先核实具体版本。
• 网络与证书。本地部署的 Monitor 使用自签名证书，通过端口 8001 提供 API。SkyPlanner 在云端运行，因此需要提前配置防火墙规则或中继，并显式信任该证书。
• 许可。每个需要写入数据的第三方应用，都必须有专属且具有 API 许可的用户。每套系统均自带一个只读 API 用户。