proALPHA 集成指南：使用 SkyPlanner APS 进行生产排程
本 Proalpha 集成指南面向合作伙伴和 IT 团队，介绍如何将 Proalpha ERP 接入 SkyPlanner APS。SkyPlanner 与 Proalpha 之间支持双向集成：
- 从 Proalpha 导入物料、包含工序的工单、资源、日历、库存和采购订单。
- 通过 setWorkOrderOperationDates 回写各工序的计划开始和结束时间。
- 通过 changeWorkOrderOperationResource 回写资源变更。
- 通过 operationDataEntry 回写操作员的报工记录。
- SkyPlanner 通过 webhook 实时推送排程变更。
SkyPlanner 团队会在实施阶段根据您的 Proalpha 环境配置集成，并在上线后继续提供支持。本指南适用于希望参与集成，或参照 SkyPlanner 的 REST API 文档（API 参考）自行开发的合作伙伴和开发人员。
Proalpha 接口
Proalpha ERP 运行在 Progress OpenEdge 上，Release 9 将平台升级到了 OpenEdge 12。（Proalpha）与排程相关的接口有四类。
- Proalpha ERP REST APIs。公开的 Proalpha API Portal 列出了
api/web/v1下的 108 份 OpenAPI 3.0 规范。这些接口用于回写数据，以及读取物料和库存。 - Integration Workbench (INWB)。Proalpha 将 INWB 描述为 “is a central platform which connects different IT systems, machines, sites”（连接不同 IT 系统、机器和厂区的中央平台），并说明它 “converts the data into the format of the target system.”（将数据转换为目标系统的格式。）（Proalpha）它通过
POST /api/web/v1/inwb/message接收 pAX 消息，可用于向 Proalpha 导入工单或从中导出工单。 - Proalpha Integration Platform。该平台于 2026 年 4 月发布，由 n8n 提供技术支持，”will be available to customers either on-premises or in the cloud.”（将提供本地部署和云端部署两种方式。）Proalpha “will rely on an API-centric reference architecture and REST interfaces.”（将采用以 API 为中心的参考架构和 REST 接口。）（Proalpha）
- EDI 和文件导出。INWB 可处理行业专用文件格式；SkyPlanner 试用期间，通过文件导出即可满足数据需求。
生产相关端点
| Proalpha API | 端点 | 集成用途 |
|---|---|---|
| Production Workorder Operation Dates API V1 | POST /api/web/v1/pps/prod/setWorkOrderOperationDates | 各工序的计划开始和结束时间（guid、startTimePoint、endTimePoint） |
| Production Workorder Operation Resource API V1 | POST /api/web/v1/pps/prod/changeWorkOrderOperationResource | 排程选定的资源（guid、resourceGUID） |
| Production Workorder Operation API V1 | POST /api/web/v1/pps/prod/operationDataEntry/{combined, setup, process} | 报工：postingQty、scrapQty、finishOperation、employeeID、resourceTime |
| Part API | GET/POST /api/web/v1/master/part | 物料及其 partNumber、partType、quantityUnitCode 字段 |
| Material API V1 | GET /api/web/v1/mawi/MRPArea/{mrpAreaGuid}/part/{partGuid}/stock | 各 MRP 区域的库存 |
身份验证
已发布的 Proalpha 规范采用 HTTP Basic 身份验证。端点取决于具体环境，格式为 {schema}://{host}:{port}/api/web/v1/...，位于您的 Proalpha 服务器或 Proalpha Cloud 上。请创建专用的技术用户账号，仅授予其访问映射表中对象的权限。与 IT 团队一起规划从 SkyPlanner 云端到该端点的网络访问。
SkyPlanner 的 REST API 使用 API 令牌进行身份验证（SkyPlanner Settings > API），并提供 Swagger/OpenAPI 文档。只需一个 API 令牌即可开始。集成教程会逐步介绍如何完成首次调用。
事件与轮询
Proalpha API Portal 未列出 webhook 订阅 API。Proalpha 的变更数据可通过以下方式传出：
- 通过 INWB 消息流发送新增或变更的工单及其工序
- 使用 Proalpha Integration Platform 上的 n8n 工作流
- 定时轮询 Material API，获取库存
状态或排程发生变化时，SkyPlanner 会发送 webhook，因此向 Proalpha 回写数据采用事件驱动方式。
数据映射
| Proalpha 对象或 API | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| Part（Part API） | 产品和物料 | Proalpha → SkyPlanner | 首次加载，之后在变更时同步 |
| 产品工艺模型：process、activities；工单 BOM 行项目 | 产品结构、子产品、工序 | Proalpha → SkyPlanner | 首次加载，之后在变更时同步 |
| 包含数量和交期的工单（Fertigungsauftrag） | 包含交期和优先级的订单及生产任务 | Proalpha → SkyPlanner | 通过 INWB 或 n8n 推送，或每隔几分钟同步 |
| 工单工序：targetSetupTime、targetProcessTime、resource | 包含准备时间和加工时长的工序 | Proalpha → SkyPlanner | 随工单同步 |
| 资源、资源组、替代资源组 | 工作中心、工作中心组、替代工作中心 | Proalpha → SkyPlanner | 首次加载 |
| 包含 intensity 和 overloadIntensity 的资源日历时段 | 班次和工作中心效率 | Proalpha → SkyPlanner | 首次加载；之后每日同步或在 SkyPlanner 中维护 |
| 各 MRP 区域的库存 | 物料库存 | Proalpha → SkyPlanner | 每小时或每次运行排程前 |
| 包含交货日期的采购订单 | 按交货日期到货的物料 | Proalpha → SkyPlanner | 每小时或每次运行排程前 |
| setWorkOrderOperationDates | 各工序排定的开始和结束时间 | SkyPlanner → Proalpha | 排程变更时，通过 SkyPlanner webhook 同步 |
| changeWorkOrderOperationResource | 引擎选定的工作中心 | SkyPlanner → Proalpha | 排程变更时 |
| operationDataEntry (setup, process, combined) | 来自 Mobile Confirmations 的工时记录和数量 | SkyPlanner → Proalpha | 每次报工或每个班次 |
| SkyPlanner 排程规则 | 换型时间矩阵、作为有限资源的工具、操作员人数 | 在 SkyPlanner 中维护 | 实施阶段配置 |
集成模式
1. 首次加载主数据。通过 Part API 读取物料，并通过 INWB 或文件导出一次性加载资源、资源组和日历。逐一确认每个 Proalpha 资源与 SkyPlanner 工作中心的映射关系。替代资源组映射为替代工作中心。
2. 订单同步。通过 INWB 消息流或 n8n 工作流发送未结工单及其工序、目标工时和资源。库存按 MRP 区域从 Material API 获取，未结采购订单则通过 INWB 获取。SkyPlanner 将已订购的物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。
3. 排程回写。对于引擎安排或调整的每道工序，集成程序都会调用 setWorkOrderOperationDates，传入工序 guid、开始时间和结束时间。如果引擎选择了其他资源，随后还会调用 changeWorkOrderOperationResource。
4. 车间报工。操作人员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业。工时记录用于保持排程实时更新，并通过 operationDataEntry 过账到 Proalpha。如果工厂已经使用 PDC 终端报工，请只保留一个报工渠道，避免重复过账。
5. 数据归属与冲突处理规则。上线前请将这些规则明确记录下来：
| 数据 | 负责系统 |
|---|---|
| 零件、工艺模型、数量、工单状态 | Proalpha |
| 工序顺序、起止时间、资源分配 | SkyPlanner |
| 换型时间矩阵、工装、操作人员数量 | SkyPlanner |
| 班次与缺勤 | 由一个系统负责，在范围评估阶段确定 |
| 报工与库存过账 | Proalpha，数据来自 SkyPlanner 工时记录或 PDC |
如果已启用 Proalpha APS 或 Feinplanung，请确定由哪个系统负责工序日期。两个排程系统写入同一组日期，会相互覆盖。启用 Autopilot 后，SkyPlanner 会在生产发生变化时自动重新排程。
典型项目步骤
实施通常在上线准备工作开始后的数周内完成。在此之前，您可以使用自己的数据进行 30 天免费试用。将 Proalpha 中的未结工单、工序和资源导出为 CSV 或 Excel 文件，再导入 SkyPlanner 并验证排程。
- 映射研讨。与您的 Proalpha 合作伙伴共同确定映射表、数据归属规则、同步频率和报工渠道。
- 接口配置。启用 REST API 和 INWB 流程，创建技术用户并开放网络访问。先在测试系统中配置，再配置生产系统。
- 初始加载。加载零件、资源、资源组和日历。
- 订单、库存和采购订单同步。通过 INWB 或 n8n 推送工单，通过轮询获取库存，并配置重试机制。
- 在 SkyPlanner 中设置约束。设置换型时间矩阵、工装、操作人员数量和备选工作中心。
- 排程回写。配置 setWorkOrderOperationDates 和 changeWorkOrderOperationResource，并在此阶段加入 operationDataEntry。
- 并行运行。将 SkyPlanner 的日期与当前计划进行对比，并修正主数据。
- 上线。数据核对一致后，启用回写。
Proalpha 集成需要提前考虑的事项
- 没有工艺路线对象。Proalpha 基于产品工艺模型制定计划。直接沿用 SAP 或 Business Central 项目的工具，会因查找工艺路线而遗漏数据。应从工单中读取工序和 BOM 行。
- 日历负荷强度。日历时间块包含 intensity 和 overloadIntensity。请将其映射为 SkyPlanner 的班次和效率，而不是直接复制原始小时数。
- 计量单位。检查 quantityUnitCode，并确认目标准备时间是按订单还是按件计算。单位错误会导致所有时长失真。
- 端点托管在客户侧。REST 层运行在您的 Proalpha 服务器上。防火墙、端口和证书的准备情况决定了项目何时能够启动，因此请尽早完成相关配置并开放访问。
- 版本。确定映射前，请与合作伙伴确认您使用的 Proalpha 版本提供哪些 REST API。
- 文档需登录访问。Proalpha 的在线帮助需要通过 Documentation Portal 登录后查看。请与合作伙伴确认字段名称，不要凭猜测填写。
Proalpha 集成由谁配置和支持
- SkyPlanner 团队在上线准备阶段负责配置，并在上线后提供支持。每套 Proalpha 系统的建模方式都不同，这正是团队专业经验发挥作用的地方。
- 您的 Proalpha 合作伙伴也可以参与。合作伙伴了解您的工艺模型、INWB 流程和版本，并可配置 API 访问。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhook。
- 您自己的开发人员也可以在此基础上开发，使用 API 令牌访问同一套 REST API。SkyPlanner 团队会在需要时提供协助。产品文档已公开，可在 SkyPlanner 文档中查看。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，提前提供集成报价，并与套餐费用一并列明，让您在开始前了解全部成本。了解 Proalpha 如何规划产能，请阅读proALPHA 是否支持考虑实际产能的生产排程？；查看概览，请访问 proALPHA 页面；了解其他系统，请访问 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 表格走向了实时生产优化。”
Kalle Kalliomäki，供应链专家
UTU · 配电柜与开关设备
生产计划工作每周节省 2 小时，新的作业队列只需数秒即可下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心生成覆盖三个月的优化计划，用时不到 30 分钟。
99.2%准时交付率
“SkyPlanner 让生产瓶颈更容易识别，也让生产管理更加清晰。”
Toni Tuori，生产经理
Piristeel · 屋面安全设施与雨水系统
今年准时交付率达到 99.2%，排程工作每天最多可节省四小时。
减少缺料造成的停工
“SkyPlanner 给我们带来的价值在于，它是一款在日常工作中真正实用的工具，尤其适合用来确定交货日期。”
Tommi Männistö，生产计划经理
Eskomatic · 机械加工服务
自动负荷排程让交货日期更准确，缺料造成的生产停工也大幅减少。
常见问题
集成使用哪些 Proalpha 接口？
使用 Proalpha REST API 获取零件和库存，并回写日期、资源和报工数据。INWB 消息流或基于 n8n 的 Integration Platform 传输工单及其工序。试用和批量加载则使用文件导出。
计划日期写入 Proalpha 的哪个位置？
通过 setWorkOrderOperationDates，将开始和结束时间点写入工单工序。如果引擎将生产任务移到另一台机器，则通过 changeWorkOrderOperationResource 更新资源。
Proalpha 支持 webhook 吗？
Proalpha API Portal 未列出 webhook 订阅 API。变更通过 INWB 消息流、n8n 工作流或轮询传递给 SkyPlanner。SkyPlanner 自身的 webhook 可让回写由事件驱动。
操作人员的报工数据可以过账到 Proalpha 吗？
可以。SkyPlanner Mobile Confirmations 的工时记录通过 operationDataEntry 过账，包含数量、员工工时和资源工时。如果同时使用 PDC 终端，请只保留一个报工渠道。
是否需要 Proalpha APS？如果已经在用，该如何处理？
不需要。SkyPlanner 会根据您的工单、工序和资源，自行生成符合实际产能约束的生产排程，并由 Autopilot 保持更新。如果已启用 Proalpha APS，请在范围评估阶段确定由哪个系统负责工序日期。之后，SkyPlanner 只写入由其负责的日期，确保两套计划不会相互覆盖。
