HELIOS 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向合作伙伴和 IT 团队，介绍如何将 HELIOS iNuvio 和 HELIOS Nephrite 连接到 SkyPlanner APS。SkyPlanner 通过 HELIOS 自身的接口实现双向集成：
- 导入生产订单（výrobní příkazy）及其工序、制造零件、BOM、工艺路线、工位、机器、工种、人员资源、库存和采购订单。
- 将计划开始日期和完成日期回写到生产订单。
- 您可以选择将操作员的工时记录作为工序记录（evidence výrobních operací）回写。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
SkyPlanner 团队会在实施导入期间，根据您的 HELIOS 配置完成集成设置，并在上线后提供支持。本指南面向希望参与集成，或希望自行基于 SkyPlanner 已提供文档的 REST API（API 参考文档）进行开发的 HELIOS 合作伙伴和开发人员。
HELIOS 的集成接口
Helios Inuvio Server（Inuvio REST API）。Asseco 将其描述为 HELIOS iNuvio 的独立组成部分，可通过 REST API 访问 HELIOS iNuvio 的业务模块（Helios Inuvio Server 帮助）。它随 iNuvio 发行包提供，OpenAPI 规范以 Rapidoc 和 Redoc 形式发布。该 API 操作 HELIOS 的数据视图（browses），每个视图都有自己的 ID 和权限：
- GET /browses/list 和 GET /browses/meta 列出可用视图及其列。
- /browses/data 读取视图中的数据行；如果视图允许创建、更新和删除，也可写入数据行。
- /api/v1/actions/meta 和 /api/v1/actions/execute/{dbName}/{browseIdent}/{actionIdent} 可对视图执行外部操作。目前支持 Procedure、Browse 和 Plugin 类型的外部操作。
排程人员使用的生产视图包括生产计划（výrobní plán）、生产订单（výrobní příkazy）、生产订单零件、生产用物料和半成品、工种、人员资源、工艺路线工序预设以及工序记录。库存、入库、出库和已发出的采购订单（vydané objednávky）也可通过相同方式获取。
HELIOS Nephrite REST API。Nephrite 路线图列出了 REST API 开发计划（HELIOS Nephrite 路线图）。在范围评估期间，SkyPlanner 团队会与您及您的 HELIOS 合作伙伴确认当前安装环境可用的 Nephrite 端点，下述数据流保持不变。
Excel 和 CSV。HELIOS 的每个视图都可导出到 Microsoft Office，这已足以满足试用阶段的数据导入需求。
身份验证与许可
- 两种身份验证方式。iNuvio 提供较早的专有身份验证 API（/api/token），以及基于 RFC 6749 的新版 OAuth2 API（/oauth/token、/oauth/revoke）。令牌通过 POST /oauth/token 或 GET /api/token 刷新。
- 许可。Helios Inuvio Server 本身免费，REST API 则需要许可。从 3.0.2026.0301 版本起，系统 API 与业务模块 API 合并为统一的 Inuvio REST API，API 访问不再受用户数量限制。
- 权限。集成用户需要具有生产和库存视图的读取权限，以及执行约定外部操作的权限。
SkyPlanner 端的 REST API 使用 Authorization-Token 请求头中的 API 令牌进行身份验证（SkyPlanner Settings > API），相关文档以 Swagger/OpenAPI 形式提供。集成教程会逐步指导您完成最初的 API 调用。
事件与轮询
SkyPlanner 定期读取 HELIOS 数据。通过调用 /browses/data，筛选未结生产订单和近期变更，获取新增生产任务。读取频率按工厂设置，生产订单可每隔几分钟读取一次，库存可每小时读取一次。
状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写采用事件驱动方式。
数据映射
| HELIOS 对象（视图） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 物料卡片和制造零件（vyráběné dílce）、计量单位 | 产品和物料 | HELIOS → SkyPlanner | 首次导入，之后轮询 |
| 带有效日期的 BOM（kusovník, kusovníkové vazby） | 产品结构、子产品、各产品所需物料 | HELIOS → SkyPlanner | 首次加载，之后在变更时同步 |
| 工艺路线（technologický postup）：工序、工位、机器和操作员准备时间、单件时间、收尾时间、工序间隔时间 | 工艺步骤及其时长、准备和拆卸时间 | HELIOS → SkyPlanner | 首次加载，之后在变更时同步 |
| 工位（pracoviště）、机器（stroje）、替代工位 | 工作中心、工作中心组、替代工作中心 | HELIOS → SkyPlanner | 首次加载，之后很少同步 |
| 工种（výrobní profese）、人员资源（výrobní personální zdroje） | 人员及每项生产任务所需的操作员人数 | HELIOS → SkyPlanner | 首次导入，之后在变更时同步 |
| 计划日历（plánovací kalendáře） | 班次和非工作日 | HELIOS → SkyPlanner | 每天同步，或在 SkyPlanner 中自行维护班次 |
| 生产订单（výrobní příkazy）、订单零件和工序、生产用物料 | 订单和生产任务，包括交期与物料需求 | HELIOS → SkyPlanner | 每隔几分钟轮询一次 |
| 库存（stav skladu） | 库存结余 | HELIOS → SkyPlanner | 每小时或执行排程时轮询 |
| 已发出的采购订单（vydané objednávky）及其交货日期 | 采购订单、按交货日期列示的待到货物料 | HELIOS → SkyPlanner | 每小时或运行排程时轮询 |
| 生产订单各工序的计划开始和完成时间（外部操作） | 每项生产任务的计划开始和结束时间 | SkyPlanner → HELIOS | 排程变更时，通过 SkyPlanner webhook 同步 |
| 工序记录（evidence výrobních operací） | 工时记录和操作员报工 | SkyPlanner → HELIOS | 如选择启用，则每次报工或每个班次同步 |
| HELIOS 中不包含 | 准备时间矩阵、作为有限资源的工具、多人协同生产任务 | 在 SkyPlanner 中维护 | 在实施导入期间设置 |
集成模式
1. 首次导入主数据。从 TPV 视图中读取制造零件、BOM、工艺路线、工位、机器、工种、人员资源和日历。HELIOS 中的每项资源都有是否纳入产能规划的标志，因此需逐项确定哪些资源由 SkyPlanner 排程。一个配有四台机器的工位可建模为一个工作中心组，或四个工作中心。
2. 订单同步。读取生产订单及其零件、工序和物料，以及已发出的采购订单。SkyPlanner 将已订购的物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。对已下达的生产订单进行排程。生产计划中的计划数量在转为生产订单之前仍保留在 HELIOS 中。
3. 排程回写。当引擎安排或移动生产任务时，SkyPlanner webhook 会通过 /api/v1/actions/execute 触发生产订单视图上的外部操作。该操作是范围评估时约定的 HELIOS 过程，用于设置订单工序的计划开始和完成时间。HELIOS 按自身逻辑校验这项变更。
4. 车间报工。操作员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录工作，工时记录会持续更新排程。您可以选择是否将实际工时回写到 HELIOS。如果选择回写，外部操作会按订单工序将其写入工序记录；如果不回写，操作员继续在 HELIOS 终端报工，SkyPlanner 则读取这些记录。
5. 数据归属与冲突处理规则。 上线前应将这些规则书面确定：
| 数据 | 负责维护的系统 |
|---|---|
| 物料、BOM、工艺路线、数量、订单状态 | HELIOS |
| 工序顺序、开始和完成时间、机器分配 | SkyPlanner |
| 准备时间矩阵、工具和操作员需求、替代资源 | SkyPlanner |
| 班次和非工作日 | 由一个系统维护，在范围评估时确定 |
| 工序记录、物料出库和入库 | HELIOS：直接录入，或由 SkyPlanner 工时记录回写 |
订单日期只能由一个系统写入。如果 HELIOS 产能规划或 Nephrite APS 仍在写入日期，应针对由 SkyPlanner 排程的订单关闭该功能，或者仅将 HELIOS 计划保留为测试计划。
典型项目步骤
实施通常在导入工作开始后的数周内完成。在此之前，可将 HELIOS 中的工位、工艺路线和未结生产订单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 映射。确定映射表、数据管理权规则、同步频率，以及是否回写工序记录。
- HELIOS 访问配置。配置 Helios Inuvio Server、集成用户、OAuth2 凭据和 REST API 许可。先在数据库副本上测试。
- 首次导入。导入制造零件、BOM、工艺路线、工位、机器、工种和日历。
- 生产订单与采购订单同步。采用支持筛选、分页和重试的轮询机制。
- 在 SkyPlanner 中配置约束。设置准备时间矩阵、工具、各生产任务所需的操作员人数，以及可替代的机器或人员。
- 排程回写。创建并测试用于回写计划日期的外部操作；如选择回写工序记录，也需创建并测试相应操作。
- 并行测试。让 SkyPlanner 与现有计划并行运行，对比日期并修正主数据。
- 上线。 数据核对一致后，启用回写。
HELIOS 集成需要提前考虑的事项
- 规划标志。只有标记为纳入产能规划的资源才有可靠的产能数据。首次导入前，请检查工位、机器、工种和外协的标志。
- 时间单位。准备时间、单件时间和收尾时间可按小时、分钟或秒录入。导入时必须换算，否则所有时长都会出错。
- 工序间隔时间。固定的工序间隔时间是工序之间的等待时间，不是机器加工时间。建模时应将其设为等待时间，不占用产能。
- 外协工序（kooperace）。送出和运回都需要计入运输时间。外协应建模为仅计时间的步骤。
- 可写入的视图。所有视图都支持读取，但只有部分支持创建、更新和删除。调用 GET /browses/list 并使用筛选条件 browseCreateImplemented=1，即可查看哪些视图支持这些操作。生产订单视图为只读，因此计划日期需通过约定的外部操作写回。
谁负责配置和支持 HELIOS 集成
- SkyPlanner 团队在实施阶段负责配置，并在上线后提供支持，范围涵盖约定的视图和外部操作。每家工厂使用 HELIOS 的方式都不同，团队会在配置和支持过程中运用相关经验，适应这些差异。
- 您的 HELIOS 合作伙伴也可以参与。合作伙伴了解您的部署环境、定制过程和许可情况，可以与 SkyPlanner 团队一起配置 Helios Inuvio Server 和外部操作。
- 您自己的开发人员也可以在此基础上扩展开发，使用 API 令牌对接 SkyPlanner 的 REST API。有 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求，与订阅方案一并提前报价。请参阅价格、HELIOS 生产排程、HELIOS 页面和 ERP 集成中心。如需了解排程基础知识，请参阅生产排程。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划摆脱了 Excel 表格，实现了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘与开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒就能下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划只需不到 30 分钟。
数以 1,000 计的工单自动完成排程
“如今我们对生产的掌控方式与以往不同，对产能的了解也达到了全新的水平。”
Hannu Ryynänen，首席执行官
Mamec · 工业搅拌机、泵及高科技合同制造
数千份工单自动完成排程，整个组织都能实时了解生产情况。
100%自 2021 年以来的准时交付率
“SkyPlanner 让我们清楚掌握产能，让计划变得可预测。”
Dan Berglund，COO/CFO
Opes Corporation · 化工与食品制造
自 2021 年开始使用 SkyPlanner 以来，准时交付率始终保持在 100%。
常见问题
HELIOS 是否提供生产订单 API？
是的。Helios Inuvio Server 可通过 REST 访问 HELIOS iNuvio 概览，包括生产计划、生产订单、订单零件、生产用料和工序记录。对于 HELIOS Nephrite，SkyPlanner 团队会在实施阶段的范围评估中，与您及您的 HELIOS 合作伙伴一起确定适合您部署环境的对接方式。
SkyPlanner 如何获取 HELIOS 中的变更？
SkyPlanner 按各工厂设定的周期轮询 HELIOS 概览，只获取未结生产订单和近期变更。SkyPlanner 自身的 webhook 则会在排程变更发生时立即推送。
计划日期如何写回 HELIOS？
通过生产订单概览上的外部操作写回，使用 /api/v1/actions/execute 执行。该操作是在范围评估阶段约定的 HELIOS 过程，因此 HELIOS 会按自身逻辑处理收到的每个日期。
Inuvio REST API 使用哪种身份验证方式？
可通过 /oauth/token 使用符合 RFC 6749 的 OAuth2，也可使用较早的专有接口 /api/token。SkyPlanner 自身的 API 使用 API 令牌，并将其放在 Authorization-Token 请求头中。
HELIOS 合作伙伴应该推荐 HELIOS APS 还是 SkyPlanner？
如果客户的计划经常变动，而且排程必须遵守实际产能限制，就应推荐 SkyPlanner。HELIOS 通过对一个当前生效的计划进行计算来制定计划，可以切换为无限产能以满足日期要求，并将冲突留给计划员处理（HELIOS 帮助）。SkyPlanner 通过 REST API 连接，自动重新排程，将换型、工具、班组和物料纳入计划，用户数量不限，每月 199 € 起。
