APplus 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向 APplus 合作伙伴和 IT 团队，介绍如何将 APplus 连接到 SkyPlanner APS。SkyPlanner 使用 Asseco 自身的接口与 APplus 进行双向集成：
- 导入生产订单（Fertigungsaufträge）及其工序（Arbeitsgänge），以及工艺路线（Arbeitspläne）、物料清单（Stücklisten）、产能单元（Kapazitätsstellen 和 Kapazitätseinheiten）、工装（Betriebsmittel）、库存和采购订单。
- 将每道工序的计划开始时间、结束时间和产能单元回写到生产订单。
- 您也可以选择将操作员的工时记录以 BDE 消息的形式回写到订单。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
在实施接入期间，SkyPlanner 团队会根据您的 APplus 配置设置集成，并在上线后继续提供支持。本指南面向希望参与集成的合作伙伴和开发人员，也适用于希望自行基于 SkyPlanner REST API 进行开发的团队。该 API 配有文档（API 参考）。
APplus 集成接口
APplus 为外部排程系统提供以下接入方式：
- APplus Web 服务。APplus 基于 Web 服务架构构建。Asseco 表示，排程所需的所有功能都可以通过互联网直接访问，供客户和供应商的 IT 系统使用（Asseco）。这是读取生产数据和写入计划日期的主要方式。
- Business Integration Framework。从 APplus 6.3 起，该框架便可通过自适应数据结构连接第三方系统，无需编程（Asseco）。可使用该框架将 APplus 对象映射到 SkyPlanner 的 REST API。
- Universal Cloud Connector。APplus 7.1 新增此功能，用于将合作伙伴的解决方案和 SaaS 服务连接到 APplus，并为传输的数据提供高度安全保障（Asseco）。
在 APplus 10 中，Flow Mode 可在指定时间或特定事件发生时自动启动流程，无需手动操作（Asseco）。每类对象采用哪种接入方式，在实施接入的范围评估阶段确定。
事件与轮询
在 APplus 端，集成通过轮询 Web 服务获取未结生产订单和近期变更，也可以由 Business Integration Framework 向 SkyPlanner 发送变更。同步频率按工厂设置，订单可每隔几分钟同步一次，库存可每小时同步一次。
当状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写采用事件驱动方式。
数据映射
| APplus 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 物料（Artikel）、计量单位 | 产品和物料 | APplus → SkyPlanner | 首次导入，之后轮询 |
| 物料清单（Stücklisten、Strukturstücklisten） | 产品结构、子产品、各产品所需物料 | APplus → SkyPlanner | 首次导入，之后在变更时同步 |
| 工艺路线（Arbeitspläne），含工序、准备时间和加工时间 | 工艺步骤及其时长、准备时间和收尾时间 | APplus → SkyPlanner | 首次导入，之后在变更时同步 |
| 产能点和产能单元（Kapazitätsstellen、Kapazitätseinheiten） | 工作中心组、工作中心及其效率 | APplus → SkyPlanner | 首次导入，之后很少同步 |
| 人员产能 | 人员及其班次 | APplus → SkyPlanner | 每日同步，或在 SkyPlanner 中单独维护班次 |
| 工具和夹具（Betriebsmittel） | 作为有限共享资源的工装 | APplus → SkyPlanner | 首次导入，之后在变更时同步 |
| 生产订单（Fertigungsaufträge）及其工序和物料 | 订单和生产任务，含交期与物料需求 | APplus → SkyPlanner | 每隔几分钟轮询一次 |
| 现有库存 | 库存结余 | APplus → SkyPlanner | 每小时或运行排程时轮询 |
| 采购订单（Bestellungen）及其交货日期 | 采购订单、按交货日期确定的到货物料 | APplus → SkyPlanner | 每小时或运行排程时轮询 |
| 生产订单中每道工序的计划开始时间、结束时间和产能单元 | 每项生产任务排定的开始和结束时间 | SkyPlanner → APplus | 排程变更时，通过 SkyPlanner webhook 同步 |
| BDE 消息：各工序的工时、数量及员工 | 工时记录和操作员报工 | SkyPlanner → APplus | 如选择回写，则每次报工或每个班次同步 |
| APplus 中无对应数据 | 换型时间矩阵、每项生产任务所需操作员人数、备选设备和人员 | 在 SkyPlanner 中维护 | 实施接入期间设置 |
集成方式
1. 首次导入主数据。通过 APplus Web 服务读取物料、物料清单、工艺路线、产能点和产能单元、Betriebsmittel 以及人员产能。映射关系需仔细确定：一个包含四个 Kapazitätseinheiten 的 Kapazitätsstelle，应映射为一个包含四个工作中心的工作中心组。
2. 订单同步。读取生产订单及其工序和物料，同时读取未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。采购建议在转为订单之前仍保留在 APplus Disposition 中。
3. 排程回写。当引擎安排或移动某道工序时，SkyPlanner webhook 会通过范围评估时约定的方式（Web 服务或 Business Integration Framework）触发 APplus 更新。它会在生产订单中设置该工序的计划开始时间、计划结束时间和产能单元，使 APplus 计划看板显示 SkyPlanner 排定的顺序。
4. 车间工单下达。计划员仍在 APplus 中下达车间工单（Werkstattaufträge），但使用的是 SkyPlanner 排定的日期。已下达的工单及其状态会在下次同步时传回 SkyPlanner。
5. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录会让排程保持更新。您可以选择是否回写实际工时。如果选择回写，工时和数量将按工序以 BDE 消息的形式写入订单。如果继续使用条码 BDE，则改由 SkyPlanner 从 APplus 读取这些消息。
6. 数据归属与冲突处理规则。上线前应将以下规则形成书面记录：
| 数据 | 负责系统 |
|---|---|
| 物料、物料清单、工艺路线、数量、订单状态、车间工单下达 | APplus |
| 工序顺序、开始和结束时间、产能单元分配 | SkyPlanner |
| 换型时间矩阵、操作员人数、备选资源 | SkyPlanner |
| Betriebsmittel 主数据 | APplus；各时段的可用性在 SkyPlanner 中规划 |
| 班次和非工作日 | 由一个系统负责，在范围评估时选定 |
| BDE 消息、物料出入库 | APplus，可直接在其中录入，也可由 SkyPlanner 工时记录回写 |
工序日期只能由一个系统写入。如果 PPS 排程正在运行，或 Feinplanung、APplus APS 正在写入日期，应针对由 SkyPlanner 排程的订单关闭这些功能。
典型项目步骤
实施接入启动后，通常可在几周内完成实施。在此之前，可将 APplus 中的产能单元、工艺路线和未结生产订单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 映射。确定映射表、数据归属规则、同步频率，以及是否回写 BDE 消息。
- APplus 访问。创建技术账户，与您的 APplus 合作伙伴一起启用 Web 服务，并先在测试系统中验证。
- 首次导入。导入物料、物料清单、工艺路线、产能点和产能单元、Betriebsmittel 及人员数据。
- 订单与采购订单同步。采用支持筛选、分页和重试的轮询方式，或通过 Business Integration Framework 推送。
- 在 SkyPlanner 中配置约束。设置准备时间矩阵、工具、每项生产任务所需的操作人员数量，以及可替代的机器或人员。
- 回写排程结果。通过 SkyPlanner webhook 回写工序日期；如选择回写 BDE 消息，也一并回写。
- 并行测试。让 SkyPlanner 与现有计划看板并行运行，比较日期并修正主数据。
- 上线。数据一致后，启用回写。
APplus 集成需要提前考虑什么
- 有限产能与无限产能单元。在 APplus 中，部分产能单元可能按无限产能安排计划。SkyPlanner 中的每个工作中心都有产能限制，因此导入时要逐一核查班次和效率。
- 正在使用的计划层级。检查 Feinplanung 或 APplus APS 是否已获授权并上线，并指定唯一的日期写入方。
- 车间单据和条码。BDE 消息会记录到已打印车间单据的订单上。需商定订单下达和单据打印是否仍像目前一样在 APplus 中完成。
- 准备时间和运行时间的单位。导入时，须按正确的单位和计算基准换算准备时间与运行时间，否则所有时长都会出错。
- 外协工序。外协工序占用的是日历时间，而非厂内产能。建模时应将其设为仅计时、不占用产能的步骤。
- 托管部署。如果使用托管版本，应尽早与托管服务商商定访问 Web 服务的网络路径。
谁负责 APplus 集成的配置和支持
- SkyPlanner 团队在实施阶段负责配置，并在上线后提供支持，范围涵盖双方约定的 Web 服务和数据映射。每家工厂使用 APplus 的方式都不同，团队会将对这些差异的了解运用到配置和支持工作中。
- 您的 APplus 合作伙伴也可以参与。合作伙伴了解您的定制配置、用户权限和 Business Integration Framework 设置，可以与 SkyPlanner 团队一起开通访问。
- 您自己的开发人员也可以在此基础上开发，使用 API 令牌调用 SkyPlanner 的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成将根据您的流程和需求，与所选套餐一并提前报价。请参阅价格、APplus 生产排程、APplus 页面和 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 · 符合食品安全要求的包装纸
销售团队可以提前看到未来六个月的空闲产能；过去需要一小时或更久才能答复的排程变更请求，现在几秒钟就能得到答复。
减少缺料导致的停工
“SkyPlanner 给我们带来的价值在于，它是一款日常工作中真正用得上的工具，尤其适合用来确定交期。”
Tommi Männistö，生产计划经理
Eskomatic · 机械加工承包服务
自动负荷排程让交期更加准确，因缺料导致的停工也大幅减少。
常见问题
APplus 是否提供生产订单 API？
是的。APplus 基于 Web 服务架构构建。Asseco 表示，客户和供应商的 IT 系统可以直接使用其排程功能。Business Integration Framework 通过自适应数据结构对接第三方系统，Universal Cloud Connector 则将 SaaS 产品连接到 APplus。
计划日期如何回写到 APplus？
每次排程变更时，SkyPlanner webhook 都会触发更新，写入生产订单各道工序的计划开始时间、计划结束时间和产能单元。更新通过 APplus Web 服务或 Business Integration Framework 完成，具体路径在实施阶段的范围评估中确定。
SkyPlanner 能否向 APplus 发送 BDE 消息？
可以，是否启用由您决定。SkyPlanner 中操作人员的工时记录可作为 BDE 消息发送，包含订单上各道工序的时间和数量。如果工厂保留条码 BDE，则改由 SkyPlanner 读取这些消息。
APplus 合作伙伴应推荐 APplus APS 还是 SkyPlanner？
如果客户希望在数周内获得一份切实可用、符合实际产能限制的生产排程，应选择 SkyPlanner。APplus APS 是集成在 APplus 中的合作伙伴产品，用于处理涉及多种工具的准备时间矩阵和多资源计划（Asseco）。SkyPlanner 同样覆盖这些场景，通过 APplus Web 服务连接，可自动重新排程，且不限制用户数量，每月 199 € 起。
该集成是否支持托管版 APplus？
支持。APplus 可以本地部署，也可以使用托管版本，SkyPlanner 均可通过 Web 服务连接。网络路径会在范围评估时与您的 IT 团队或托管服务商商定。
