在上线准备阶段，SkyPlanner 团队会根据您的 Plex 配置完成集成设置，并在上线后继续提供支持。本指南面向希望参与集成，或自行基于 SkyPlanner 的 REST API 进行开发的合作伙伴和开发人员。该 API 提供完整文档（API 参考）。
Plex 集成接口
Plex 是统一的多租户云平台，因此所有租户都运行当前版本。集成有四种途径：
- Plex Connect REST APIs。Plex 于 2015 年推出 Plex Connect，称其为 “a new REST/JSON API.”（一种新的接口。）（来源）其带版本的接口集合涵盖零件、供应商、客户、采购订单、工作中心和工具。
- Plex Custom APIs。Plex 的产品资料写道：”The developer portal is also available for creating unique APIs.”（也可通过开发者门户创建专用 API。）（来源）对于没有标准接口集合的对象，合作伙伴可采用这种方式。
- Plex UX Data Sources。Plex 通过 REST 开放数据源。生产任务、任务工序、生产记录和库存容器通常通过此接口读取。
- Plex Classic Data Sources。这是旧版 SOAP 接口，仅在 Classic 数据源没有对应的 UX 数据源时使用。
SkyPlanner 通过 Plex Connect 获取主数据和采购数据，通过 Plex Data Sources 获取生产任务、工序和生产数据。
访问配置与 PCN
API 访问权限按应用在 Plex Developer Portal 中配置，并在其中启用集成所需的 API 集合。每次调用都针对一个 PCN，即 Plant Control Number，用于在 Plex 中标识工厂或法人单位。一个拥有三家工厂的集团有三个 PCN。集成时，可将每个 PCN 映射至独立的 SkyPlanner 配置，也可映射至同一配置下的不同工作中心组。
调用 Data Source 时，使用各 PCN 对应的 Web 服务凭据。请创建专用集成账户，仅授予其访问所需数据源的权限。
SkyPlanner 端的 REST API 使用 API 令牌进行身份验证（SkyPlanner Settings > API），并提供 Swagger/OpenAPI 文档。集成教程会逐步介绍最初几次调用。
同步模式
Plex 端采用定时同步。SkyPlanner 按各工厂设定的频率，从 Plex Connect 和 Data Sources 读取新增及变更的生产任务、工序和库存。Plex 合作伙伴也可以利用 Plex 端的触发事件，例如创建生产任务时，将变更直接推送至 SkyPlanner 的 REST API。
状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写端采用事件驱动方式。
数据映射
| Plex 对象（接口） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| Part（Plex Connect parts 集合） | 产品和物料 | Plex → SkyPlanner | 首次加载，之后增量同步 |
| Bill of Materials（Data Source） | 产品结构、子产品及各产品所需物料 | Plex → SkyPlanner | 首次加载，之后在变更时同步 |
| 工艺路线和零件工序：工作中心、标准工时（Data Source） | 工序及其准备时间和运行时间 | Plex → SkyPlanner | 首次加载，之后在变更时同步 |
| 工作中心：单台设备、生产单元或区域（Plex Connect work centers） | 工作中心、工作中心组及效率 | Plex → SkyPlanner | 首次加载，之后很少同步 |
| 生产任务及任务工序：数量、交期（Data Source） | 订单和生产任务 | Plex → SkyPlanner | 每隔几分钟同步，或在创建生产任务时推送 |
| 库存和容器（Data Source） | 库存结存 | Plex → SkyPlanner | 每小时或每次排程前同步 |
| 采购订单及预计到货信息（Plex Connect purchase orders） | 按交货日期计入待到货物料；标记为 Delivered 时更新库存 | Plex → SkyPlanner | 每小时或每次排程前同步 |
| 工具（Plex Connect tools） | 作为有限共享资源的工具 | Plex → SkyPlanner | 首次加载，之后在 SkyPlanner 中维护 |
| 各工序及工作中心的计划开始和结束时间（Custom API 或 Data Source） | 排程 | SkyPlanner → Plex | 排程变更时，通过 SkyPlanner webhook 同步 |
| 生产记录：数量、开始、结束、停机 | 工时记录和操作员报工 | SkyPlanner → Plex | 每次报工或每个班次同步 |
| SkyPlanner 约束数据 | 准备时间矩阵、各生产任务所需操作员人数、可替代的工作中心和人员 | 在 SkyPlanner 中维护 | 上线准备阶段配置 |
集成模式
1. 首次加载主数据。加载零件、BOM、包含零件工序的工艺路线、工作中心和工具。务必明确工作中心的建模层级。Plex 中的工作中心可以是单台设备、生产单元或区域；SkyPlanner 应在共用一个任务队列的层级进行排程。
2. 同步生产任务。读取已下达的生产任务及其工序、数量和交期，同时读取库存和未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。排程时会同时检查现有库存和待到货采购物料。
3. 回写排程。对于引擎已安排或调整的每道工序，SkyPlanner 都会通过约定的 Custom API 或数据源，将计划开始时间、结束时间和工作中心回写至 Plex。生产任务及其数量和状态仍由 Plex 管理。
4. 车间报工。操作员通过 Mobile Confirmations、Production Timer 或 Quick Log Mode 记录开工、数量和停机情况，排程随生产进展更新。报工数据作为生产记录回写至 Plex。每个工作中心只能选择一个报工渠道：操作员要么在 SkyPlanner 中报工，要么在 Plex Control Panel 中报工，不能同时使用两者。
5. 数据管理归属及冲突处理规则。上线前应将这些规则明确记录下来：
| 数据 | 管理系统 |
|---|---|
| 零件、BOM、工艺路线、生产任务数量和状态、库存 | Plex |
| 工序顺序、开始和结束时间、工作中心分配 | SkyPlanner |
| 准备时间矩阵、工具和操作员需求、可替代资源 | SkyPlanner |
| 班次和缺勤 | 由一个系统管理，在范围评估时确定 |
| 生产记录 | Plex，由 SkyPlanner 报工数据写入 |
在 Plex 中更改生产任务数量或工艺路线后，该生产任务即形成新版本。SkyPlanner 会重新读取；生产发生变化时，Autopilot 会自动重新排程。
典型项目步骤
实施通常可在上线准备启动后数周内完成。在此之前，您可以使用自己的数据进行 30 天免费试用。从 Plex 将未结生产任务、工序和工作中心导出为 Excel 或 CSV，导入后验证排程，再开展集成工作。
随后，项目分七步进行：
- 映射。确定映射表、PCN 和工作中心层级、数据管理归属规则及同步频率。
- Plex 访问配置。在 Developer Portal 中启用 Plex Connect 集合，并为每个 PCN 配置 Data Source 账户。
- 首次加载。加载零件、BOM、工艺路线、工作中心和工具。
- 同步生产任务和采购订单。定时同步生产任务、工序、库存和未结采购订单。
- 在 SkyPlanner 中配置约束。设置准备时间矩阵、各生产任务所需操作员人数、可替代的工作中心和人员。
- 回写与报工。将计划时间和生产记录写入 Plex。
- 并行运行与上线。让 SkyPlanner 与现有计划并行运行，修正主数据后，再启用回写。
Plex 集成需要提前考虑哪些事项
- 选对数据源。Plex 有许多数据源，字段之间存在重叠。Plex 集成最难的部分，是选出能返回所需数量或状态的数据源。在范围评估阶段，应逐一按名称确认所用的数据源。
- 工作中心的划分粒度。如果一个工作中心实际代表包含四台机器的区域，就需要将其建模为四个工作中心，或设为带有效率参数的资源组，否则排程会超出其产能。
- 计量单位。流程型工厂按克或升进行批次生产，下一道工序则按件计量。导入时，应按各道工序换算单位。
- 容器库存与零件总量。Plex 按车间内的容器跟踪库存。应汇总排程可用容器中的数量，并排除冻结或隔离库存。
- 标准工时。首次运行排程前，应根据实际生产记录核对零件各道工序的准备时间和运行时间。
- 多个 PCN。在映射中区分各个工厂，确保一个工厂的生产任务不会被安排到另一个工厂的工作中心。
Plex 集成由谁配置和提供支持
这项工作包括映射您的生产任务、工艺路线、工作中心和 PCN，以及配置 SkyPlanner 排程所依据的约束条件：准备时间矩阵、操作人员数量和备选资源。
- SkyPlanner 团队在实施阶段完成配置，并在上线后提供支持，涵盖 SkyPlanner 端和双方约定的 Plex 接口。每家工厂使用 Plex 的方式都不同，配置时需要用到对这些具体情况的了解。
- 您的 Plex 合作伙伴可以参与或负责开发集成。合作伙伴熟悉您的 PCN、数据源和 Custom APIs。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhook。
- 您的开发人员也可以自行开发集成，使用同一套文档中说明的 REST API，通过 API 令牌访问。有了 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。公开文档涵盖采购订单以及产品和物料 API，详见 SkyPlanner 文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求提前报价，并与订阅方案一并提供，让您在开始前了解全部费用。要比较 Plex 自带的排程功能，请参阅 Plex 生产排程；要了解概况，请访问 Plex 页面；其他系统则见 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 表格转向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘与开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒钟即可下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
6 个月销售可查看的未来空闲产能
“SkyPlanner 为所有生产计划工作奠定了基础，让计划可靠有据。”
Anu Järvinen，生产经理
Fredman Operations · 食品级包装纸
销售人员可以看到未来六个月的空闲产能；以往需要一小时或更久才能答复的排程变更请求，现在几秒钟就能得到答复。
100%自 2021 年以来的准时交付率
“SkyPlanner 让我们看清产能情况，也让计划结果变得可预测。”
Dan Berglund，首席运营官兼首席财务官（COO/CFO）
Opes Corporation · 化工与食品制造
自 2021 年开始使用 SkyPlanner 以来，准时交付率始终保持在 100%。
常见问题
Plex 是否提供用于获取生产排程数据的 API？
是的。Plex Connect 提供零件、采购订单、工作中心和工具的 REST/JSON API。Plex Data Sources 可提供生产任务、工序、生产记录和库存数据。其他需求可通过 Plex Custom APIs 满足。
谁负责开发 Plex 集成？
SkyPlanner 团队在实施阶段根据您的 Plex 配置完成双向集成，并在上线后提供支持。您的 Plex 合作伙伴或内部开发人员也可以使用 SkyPlanner 文档中说明的 REST API 进行开发，有了 API 令牌即可开始。
为什么要接入 SkyPlanner，而不是增购 Plex Finite Scheduling 或 Finite Scheduler？
Plex 将考虑实际产能约束的生产排程纳入 MES/MOM 功能（来源），并将 Finite Scheduler 宣传为 “An Adaptive Plex MES Integration”（一种自适应的 Plex MES 集成）（来源）。SkyPlanner 可连接您现有的 Plex 套件，在实施开始后数周内上线；每当发生影响排程的变化，Autopilot 都会自动重新排程。SkyPlanner 团队负责双向集成的配置与支持，您的 Plex 合作伙伴可以负责 Plex 端。
需要在 Plex 中安装任何东西吗？
不需要。访问权限在 Plex Developer Portal 中按 PCN 分别配置。SkyPlanner 在云端运行，与 Plex 配合使用。
Plex 能实时推送变更吗？
Plex 端采用定时同步，通常每隔几分钟同步一次。Plex 合作伙伴也可以根据 Plex 端的触发事件，将新的生产任务推送到 SkyPlanner 的 REST API。反向传输时，SkyPlanner 的 webhook 会在排程发生变更时即时推送。
