在上线准备期间，SkyPlanner 团队会根据您的 abas 部署配置集成，并在上线后持续提供支持。本指南面向希望参与集成，或自行基于 SkyPlanner 已提供文档的 REST API（API 参考文档）进行开发的合作伙伴和开发人员。
abas ERP 接口
- abas REST API。 “The Abas REST API is a web interface for real-time data access to Abas ERP.”（Abas REST API 是用于实时访问 Abas ERP 数据的 Web 接口。）（abas）这是读取工单、生产清单、库存和采购订单，以及回写计划日期的主要途径。
- abas Connect。 这是一个云端集成平台，可用于 “configure interfaces and connections to third-party systems yourself.”（自行配置接口及与第三方系统的连接。）（abas）可通过它构建事件驱动的数据流，将 abas 中发生变更的工单推送到集成端。
- abas ESDK (Essentials SDK) 和 AJO Java API。 合作伙伴可通过它们在 abas 内部实现服务端逻辑。公开的示例代码使用了
de.abas.erp.db.schema.part.Product等类。（GitHub） - MS SQL Connector 和 ODBC。 “The MS SQL Connector enables flexible and automated export of ERP data.”（MS SQL Connector 支持灵活、自动地导出 ERP 数据。）（abas）仅限读取和导出。切勿通过此途径写入计划结果，因为这不会触发 abas 的业务逻辑。
- abas Data Import Toolkit 和文件导出。 用于批量加载数据，也是快速开始 SkyPlanner 试用的途径。
身份验证
在 abas 端，通过 abas Web 服务访问数据，使用在您的部署中配置的技术用户或令牌。请使用专用的集成用户，并将其权限限定为映射表中的对象。由于每个 abas 部署的数据结构和权限配置不同，这项配置由您的 abas 合作伙伴完成。
在 SkyPlanner 端，REST API 使用 API 令牌进行身份验证（SkyPlanner Settings > API），文档采用 Swagger/OpenAPI 格式。只需 API 令牌即可开始。集成教程会逐步指导您完成首次调用。
事件与轮询
abas 的公开文档未提供 webhook 订阅 API。向外发送的变更数据可来自以下三种途径之一：
- 通过 abas Connect 流程，将已变更的工单发送到集成端
- 通过 ESDK 事件处理程序，在保存工单或工序时触发
- 定时轮询 abas REST API，筛选未结工单及自上次运行以来的变更
在另一端，SkyPlanner 会在状态或排程发生变化时发送 webhook，因此向 abas 回写数据由事件驱动。
数据映射
| abas ERP 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 零件 / 产品（Teil, Artikel） | 产品与物料 | abas → SkyPlanner | 首次加载，之后在变更时同步 |
| 生产清单（Fertigungsliste）：物料及多层级结构 | 产品结构、子产品及各产品所需物料 | abas → SkyPlanner | 首次加载，之后在变更时同步 |
| 工序（Arbeitsgänge），含加工时间和准备时间 | 工艺步骤，含持续时间和准备时间 | abas → SkyPlanner | 首次加载，之后在变更时同步 |
| 机器、资源及产能日历 | 工作中心、工作中心组、班次及缺勤 | abas → SkyPlanner | 首次加载；班次每日同步，或在 SkyPlanner 中维护 |
| 已下达工单（Betriebsauftrag），含数量和交期 | 订单和作业，含交期和优先级 | abas → SkyPlanner | 每隔几分钟轮询，或通过 abas Connect 推送 |
| 库存量 | 物料库存 | abas → SkyPlanner | 每小时或每次排程前 |
| 采购订单，含交货日期 | 按交货日期到货的物料 | abas → SkyPlanner | 每小时或每次排程前 |
| 工单工序：计划开始时间、结束时间、机器 | 各工序排定的开始时间、结束时间和工作中心 | SkyPlanner → abas | 排程变更时，通过 SkyPlanner webhook 同步 |
| 完工确认（Rückmeldungen） | 来自 Mobile Confirmations 的工时记录和数量 | SkyPlanner → abas | 每次确认或每个班次 |
| SkyPlanner 约束数据 | 准备时间矩阵、作为有限资源的工具、替代机器和人员 | 在 SkyPlanner 中维护 | 在上线准备期间配置 |
集成模式
1. 首次加载主数据。 通过 abas REST API 读取零件、生产清单和机器，或通过导出文件一次性加载这些数据。仔细确定每台 abas 机器与 SkyPlanner 工作中心的映射关系，并明确一个机器组应映射为一个工作中心组，还是多个工作中心。
2. 订单同步。 读取已下达工单及其工序，同时读取库存和未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。因此，排程会同时检查现有库存和待到货的采购物料。
应对已下达工单进行排程，而不是工单建议（Fertigungsvorschläge）。工单建议是 MRP 的计算结果，会随下一次 MRP 运行而变化。
3. 排程回写。 对于引擎已安排或调整的每道工序，集成程序通过 abas REST API，将计划开始时间、结束时间和机器写入对应的工单工序。通过 API 写入会保留 abas 的校验机制，与计划员编辑工单时相同。
4. 车间完工确认。 操作人员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业。工时记录使排程保持最新，并作为完工确认回传至 abas。如果您的工厂已通过 abas PDC 终端进行确认，请只保留一个确认渠道，避免重复录入。
5. 数据归属与冲突处理规则。 上线前应将这些规则书面确定：
| 数据 | 负责维护的系统 |
|---|---|
| 零件、生产清单、数量、工单状态 | abas ERP |
| 工序顺序、开始和结束时间、机器分配 | SkyPlanner |
| 准备时间矩阵、工具、操作人员数量、替代资源 | SkyPlanner |
| 班次和缺勤 | 由一个系统维护，在范围评估时确定 |
| 完工确认和库存过账 | abas ERP，数据来自 SkyPlanner 工时记录或 PDC |
SkyPlanner 不依赖 abas APS。如果您也购买了 abas APS 许可，应由 SkyPlanner 负责维护工序日期，因为两个排程系统同时写入相同日期字段会相互覆盖。由 SkyPlanner 接管后，Autopilot 会在每次发生影响排程的变更时自动重新排程，并将新日期回传至 abas，无需手动启动优化。
典型项目步骤
实施通常在上线准备开始后数周内完成。在此之前，您可以使用自己的数据进行 30 天免费试用。先将 abas 中的未结工单、工序和机器导出为 CSV 或 Excel 文件，再导入 SkyPlanner，在开展任何集成工作之前验证排程。
- 映射研讨。 与您的 abas 合作伙伴共同确定映射表、数据归属规则、同步频率和完工确认渠道。
- 接口配置。 启用 abas REST API 或 abas Connect 流程，并创建集成用户。先在沙箱环境配置，再部署到生产环境。
- 首次加载。 加载零件、生产清单、机器和日历。
- 同步订单、库存和采购订单。 采用轮询或 Connect 推送，并配置重试机制。
- 在 SkyPlanner 中配置约束。 设置准备时间矩阵、工具、操作人员数量，以及替代机器或人员。
- 排程回写。 将计划日期写入工单工序，并在此阶段加入完工确认。
- 并行运行。 对比 SkyPlanner 的排定日期与当前计划，并修正主数据。
- 上线。 数据核对一致后，启用回写。
abas ERP 集成需要提前考虑哪些事项
- 定制的数据结构。大多数 abas 系统都有自定义字段和对象。请与合作伙伴一起，逐个对象明确集成涉及哪些字段，不要假定其他工厂的映射也适合您。
- 没有独立的工艺路线对象。工序存放在生产清单中，而不是工艺路线对象中。直接沿用 SAP 或 Business Central 项目的工具会去查找工艺路线，因而遗漏数据。
- “Scheduling”指的是 MRP。在 abas 英文版中，Scheduling 指 MRP 运算。
- 准备时间与加工时间。导入前，请核对时间单位，并确认准备时间是按工单还是按单件计算。单位错误会导致所有时长失真。
- 日历未及时更新。设备日历必须覆盖整个排程周期，否则计划中就会缺失相应产能。
- SQL 仅用于读取。MS SQL Connector 和 ODBC 用于导出数据。写入则通过 REST API、abas Connect 或 ESDK 完成。
- 文档需要登录才能查看。abas 官方帮助文档位于客户门户内。请向合作伙伴确认字段名称，不要凭猜测。
abas ERP 集成：谁负责配置和支持
这项工作包括映射您的生产清单、设备和工单，以及配置 SkyPlanner 中的约束条件，例如准备时间矩阵和工具。
- SkyPlanner 团队在上线准备期间完成配置，并在上线后提供支持。大多数 abas 系统都经过定制，配置集成时正需要这些专业经验。
- 您的 abas 合作伙伴也可以参与。合作伙伴了解您的数据结构、自定义字段和 ESDK 应用，可以配置 REST API 访问或 Connect 流程。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhooks。
- 您自己的开发人员也可以开发集成，使用 API 令牌访问同一套 REST API。SkyPlanner 团队会在需要时提供协助。产品文档已公开，可在 SkyPlanner 文档中查阅。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，提前提供集成报价及套餐费用，让您在开始前了解全部成本。有关 abas 如何规划产能，请阅读abas ERP 是否支持按实际产能进行生产排程？；概览请见 abas ERP 页面，其他系统请见 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%。
6 个月销售可提前查看空闲产能的时间跨度
“SkyPlanner 为所有生产计划奠定基础，并提供可靠保障。”
Anu Järvinen，生产经理
Fredman Operations · 食品级包装纸
销售人员可以提前六个月查看空闲产能。过去需要一小时甚至更久才能答复的排程变更请求，如今几秒内就能得到答复。
常见问题
集成使用 abas 的哪个接口？
通过 abas REST API 读取订单和主数据，并回写计划日期。abas Connect 流程或 ESDK 事件处理程序可以将发生变更的工单从 abas 推送出去。试用和批量加载则可以使用文件导出。
abas ERP 支持 webhooks 吗？
abas 文档中未提供公开的 webhook 订阅 API。变更通过 abas Connect 流程、ESDK 事件处理程序或每隔几分钟轮询一次的方式传递到 SkyPlanner。SkyPlanner 自身的 webhooks 则可实现事件驱动的回写。
可以使用 MS SQL Connector 进行集成吗？
可以用于读取数据，它能高效导出 abas 数据。计划结果则通过 REST API、abas Connect 或 ESDK 回写，确保每项变更都经过 abas 业务逻辑的校验。
计划日期会写入 abas 的哪个位置？
写入已下达工单（Betriebsauftrag）的工序中，包括计划开始时间、结束时间和设备。数量、状态和成本仍由 abas 管理。
SkyPlanner 能在排程中考虑 abas 的库存和采购订单吗？
可以。每小时或每次排程运行前，都会从 abas 读取库存量和未结采购订单。已订购的物料在其交货日期被视为可用。
abas 合作伙伴应该推荐 abas APS 还是 SkyPlanner？
如果客户希望快速让全厂采用实时排程，就推荐 SkyPlanner。当前一代 abas APS 随服务包 Abas 2024.Q3.1 推出，通过拖放或运行优化来优化排程。SkyPlanner 连接 abas REST API，自动重新排程，统筹换型、工具、班组和物料，并为操作人员提供 Mobile Confirmations，每月 199 € 起。（abas）
