PSIpenta 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向 PSI 合作伙伴和 IT 团队，介绍如何将 PSIpenta/ERP 接入 SkyPlanner APS。SkyPlanner 通过 PSI 自有接口与 PSIpenta 实现双向集成：
- 导入生产订单（Fertigungsaufträge）及其工序（Arbeitsgänge）、工艺路线（Arbeitspläne）、物料清单（Stücklisten），以及工作中心、机器、工装（Betriebsmittel）、库存和采购订单。
- 将各工序的计划开始时间、结束时间和工作中心回写到生产订单。
- 您可以选择将操作人员的工时记录作为 BDE 报工（Rückmeldungen）回传。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
SkyPlanner 团队会在导入实施期间根据您的 PSIpenta 配置完成集成配置，并在上线后提供支持。本指南面向希望参与集成，或希望参照 SkyPlanner REST API 文档自行开发的合作伙伴和开发人员（API 参考文档）。
PSIpenta 的集成接口
PSI 为外部排程系统提供三种接入途径（PSI 产品手册）：
- PSIpenta/ERP REST API。PSI 列出了 PSIpenta/ERP 的 REST 和 SOAP API，并说明所有 PSIpenta 组件均可通过 RESTful Web 服务集成到现有架构中。这是读取生产数据和写入计划日期的主要途径。
- PSIpenta/BDE REST 和 SOAP API。车间数据采集模块有自己的 API，用于提交操作人员的报工数据。
- PSIintegration。这是 PSI 用于连接各 PSIpenta 模块的标准集成层。它采用中心辐射式架构，在适配器中以图形化方式配置消息映射，并将每条消息归档到数据库。如果您的系统已经通过它连接外部系统，集成时也应使用这一路径。
PSIpenta/ERP 10 新增了 BPMN 2.0 工作流，可通过基于 Web 的 Workflow Developer 构建，用于集成外部系统（PSI）。工作流可以响应 PSIpenta 中的变更并调用 SkyPlanner。
身份验证与访问权限
- PSIpenta 端。集成使用专用技术账号运行，权限仅限于需要读写的对象。您的 PSI 合作伙伴负责在您的系统中配置该账号及 API 访问权限。
- 网络。PSIpenta 通常部署在本地。集成通过 IT 团队允许的路径访问它，例如对外开放的 API 端点，或部署在内部网络中的小型连接器。
- SkyPlanner 端。REST API 使用
Authorization-Token请求头中的 API 令牌进行身份验证。令牌在 Settings > API 中创建。API 文档采用 Swagger/OpenAPI 格式，集成教程则逐步介绍如何完成最初的调用。
事件与轮询
在 PSIpenta 端，集成通过轮询 REST API 获取未结生产订单和近期变更，也可以由 BPMN 工作流或 PSIintegration 消息将变更推送到 SkyPlanner。同步频率按工厂设置，例如订单每隔几分钟同步一次，库存每小时同步一次。
当状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写采用事件驱动方式。
数据映射
| PSIpenta 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 物料（Artikel）、计量单位 | 产品和物料 | PSIpenta → SkyPlanner | 首次导入，之后轮询 |
| 多层物料清单（Stücklisten） | 产品结构、子产品、各产品所需物料 | PSIpenta → SkyPlanner | 首次导入，之后在变更时同步 |
| 工艺路线（Arbeitspläne），含工序、准备时间和加工时间 | 工艺步骤及其时长、准备时间和收尾时间 | PSIpenta → SkyPlanner | 首次导入，之后在变更时同步 |
| 工作中心（Arbeitsplätze）和机器 | 工作中心、工作中心组、效率 | PSIpenta → SkyPlanner | 首次导入，之后很少同步 |
| 工具和夹具（Betriebsmittel） | 作为数量有限的共享资源使用的工装 | PSIpenta → SkyPlanner | 首次加载，之后在变更时同步 |
| 班次日历 | 班次和非工作日 | PSIpenta → SkyPlanner | 每天同步，或在 SkyPlanner 中单独维护班次 |
| 生产订单（Fertigungsaufträge）及其工序和物料 | 订单和生产任务，含交期与物料需求 | PSIpenta → SkyPlanner | 每隔几分钟轮询一次 |
| 现有库存 | 库存结余 | PSIpenta → SkyPlanner | 每小时或运行排程时轮询 |
| 采购订单（Bestellungen）及其交货日期 | 采购订单、按交货日期确定的到货物料 | PSIpenta → SkyPlanner | 每小时或运行排程时轮询 |
| 生产订单各工序的计划开始时间、结束时间和工作中心 | 每项生产任务排定的开始和结束时间 | SkyPlanner → PSIpenta | 排程变更时，通过 SkyPlanner webhook 同步 |
| BDE 报工（Rückmeldungen）：各工序的工时、数量及员工 | 工时记录和操作员报工 | SkyPlanner → PSIpenta | 如选择回写，则每次报工或每个班次同步 |
| SkyPlanner 排程规则 | 换型时间矩阵、每项生产任务所需操作员人数、备选设备和人员 | 在 SkyPlanner 中维护 | 实施接入期间设置 |
集成方式
1. 首次加载主数据。通过 PSIpenta/ERP REST API 读取零件、物料清单、工艺路线、工作中心、机器、Betriebsmittel 和日历。工作中心的映射需要明确规划：一个包含四台机器的工作中心，可以映射为一个工作中心组，也可以映射为四个工作中心。
2. 订单同步。读取已下达的生产订单及其工序和物料，以及未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日可用，并在采购订单标记为 Delivered 时更新库存。采购建议在转为订单之前仍保留在 PSIpenta 中。
3. 排程回写。排程引擎安排或移动工序时，SkyPlanner webhook 会触发对 PSIpenta/ERP REST API 的调用，更新生产订单上该工序的计划开始时间、计划结束时间和工作中心。订单日期由其各工序的日期决定。适用于您系统的资源和字段，会在导入实施的范围评估阶段确定。
4. 车间报工。操作人员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录让排程保持更新。您可以选择是否回传实际工时。如果选择回传，工时和数量将按工序通过 PSIpenta/BDE API 作为 BDE 报工提交。如果继续使用 BDE 终端，则由 SkyPlanner 从 PSIpenta 读取报工数据。
5. 数据归属与冲突处理规则。上线前请将以下规则明确记录下来：
| 数据 | 归属系统 |
|---|---|
| 零件、物料清单、工艺路线、数量、订单状态 | PSIpenta |
| 工序顺序、开始和结束时间、机器分配 | SkyPlanner |
| 准备时间矩阵、操作人员数量、替代资源 | SkyPlanner |
| Betriebsmittel 主数据 | PSIpenta；各时段的可用性由 SkyPlanner 规划 |
| 班次和非工作日 | 由一个系统维护，在范围评估阶段确定 |
| 报工、物料出库和入库 | PSIpenta，可直接录入，也可由 SkyPlanner 工时记录回传 |
工序日期只能由一个系统写入。如果 Leitstand、Adaptive Planung 或 MES Scheduling 也会设置计划日期，请对由 SkyPlanner 排程的订单关闭这一功能。
典型项目步骤
实施通常在导入工作启动后数周内完成。在此之前，可将 PSIpenta 中的工作中心、工艺路线和未结生产订单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 数据映射。确定映射表、数据归属规则、同步频率，以及是否回传报工数据。
- PSIpenta 访问配置。创建技术账号，与 PSI 合作伙伴一起启用 API 访问路径，并先在测试环境中验证。
- 首次加载。加载零件、物料清单、工艺路线、工作中心、机器、Betriebsmittel 和日历。
- 生产订单和采购订单同步。采用支持筛选、分页和重试的轮询方式，或由工作流触发消息。
- 在 SkyPlanner 中设置约束。配置准备时间矩阵、工装、每项生产任务所需的操作人员数量，以及可替代的机器或人员。
- 排程回写。通过 SkyPlanner webhook 回写工序日期；如选择回传报工数据，同时回传 BDE 报工。
- 并行测试。将 SkyPlanner 与现有计划并行运行，对比日期并修正主数据。
- 上线。数据核对一致后，启用回写。
PSIpenta 集成需要提前考虑什么
- 模块组合。确认哪些 PSI 计划模块已获许可并投入使用。凡是会写入日期的模块，都需要明确的规则。
- 工作中心还是机器。确定 SkyPlanner 按工作中心级别还是机器级别排程，并在双向同步中保持一致。
- Betriebsmittel。Betriebsmittel 清单中的夹具和工具，在 SkyPlanner 中作为数量有限的工装资源管理，因此安排工序时也会占用相应工装。
- 准备时间和加工时间的单位。导入时须按正确的单位和计时基准换算准备时间与加工时间，否则所有时长都会出错。
- 外协工序。外协工序只计入所需时长，不占用您的产能。请将其建模为仅计时长的工序。
- 已开工工序。每次排程前先从报工数据中读取进度，让排程以已完成的工作为基础。随后，Running Time Lock 会锁定接下来数小时内的生产任务。
谁负责 PSIpenta 集成的配置与支持
- SkyPlanner 团队在导入实施期间完成配置，并在上线后提供支持，范围涵盖双方约定的 API 调用和消息。每家工厂使用 PSIpenta 的方式不同，配置与支持正是这些实践经验发挥作用的环节。
- 您的 PSI 合作伙伴可以参与。合作伙伴熟悉您的模块、自定义字段和 PSIintegration 配置，可以与 SkyPlanner 团队一起开通 API 访问。
- 您的开发人员也可以在此基础上自行开发，使用 API 令牌调用 SkyPlanner REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。相关文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用根据您的流程和需求，与所选套餐一并提前报价。请参阅价格、PSIpenta 生产排程（按实际机器和人员产能排程）、PSIpenta 页面及 ERP 集成中心。
制造企业如何评价 SkyPlanner
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划告别了 Excel 表格，实现了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电板及开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒即可下达到产线。
+90%生产效率提升幅度
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
100%自 2021 年以来的准时交付率
“SkyPlanner 让我们清楚掌握产能，让计划变得可预测。”
Dan Berglund，首席运营官兼首席财务官（COO/CFO）
Opes Corporation · 化工与食品制造
自 2021 年开始使用 SkyPlanner 以来，准时交付率始终保持在 100%。
更少因缺料导致的停产
“SkyPlanner 对我们的价值在于，它是一款日常工作中真正好用的工具，尤其是在确定交期时。”
Tommi Männistö，生产计划经理
Eskomatic · 机械加工服务
自动安排生产负荷让交期更准确，因缺料导致的停产也大幅减少。
常见问题
PSIpenta 是否提供生产订单 API？
是的。PSI 列出了 PSIpenta/ERP 和 PSIpenta/BDE 的 REST 与 SOAP API，并说明所有 PSIpenta 组件均可通过 RESTful Web 服务集成。PSIintegration 则提供了一个基于消息的跨模块集成层。
计划日期如何回写到 PSIpenta？
通过 PSIpenta/ERP REST API 回写。每次排程发生变化时，SkyPlanner 的 webhook 都会触发更新，将生产订单中每道工序的计划开始时间、计划结束时间和工作中心写回。
SkyPlanner 能否向 PSIpenta BDE 提交报工数据？
可以，您可以选择启用这一功能。SkyPlanner 中的操作员工时记录会通过 PSIpenta/BDE API 作为 BDE 报工数据提交，包含每道工序的工时和数量。保留 BDE 终端的工厂则由 SkyPlanner 读取报工数据。
PSI 合作伙伴应该推荐 PSIpenta Leitstand 还是 SkyPlanner？
如果客户希望在几周内获得一套可用且符合实际产能约束的生产排程，应推荐 SkyPlanner。Leitstand、Adaptive Planung 和 MES Scheduling 是 PSI 模块化产品中的独立模块（PSI）。SkyPlanner 通过 PSIpenta/ERP 和 BDE API 连接，在生产发生变化时自动重新排程，并统筹换型、工具、班组和物料。用户数量不限，每月 199 € 起。
集成是否需要 PSIpenta/MES？
不需要。SkyPlanner 连接 PSIpenta/ERP，并通过 PSIpenta/BDE 处理报工数据。操作员可以在手机或平板电脑上使用 SkyPlanner 记录工作。
