SkyPlanner 团队会在实施阶段根据您的 Sylob 配置完成集成设置，并在上线后提供支持。本指南面向希望参与集成，或参照 SkyPlanner 的 REST API 文档（API 参考文档）自行开发的合作伙伴和开发人员。
Sylob ERP 接口
Sylob 文档介绍了两类公共 REST API：”L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.”（Sylob ERP 提供两类公共 REST API，也称为“webservices”，用于读取和写入数据。）（Forterro 知识库）
- API REST Système d’information（读取）。此接口执行在“Interroger le système d’information”活动中创建并保存的查询（requête）。查询的调用 URL 可通过“Autres actions”>“Afficher le web service”获取，格式为
/rest/query/{identifiantQuery}/resultat。通过参数可设置返回结果数量上限、数字格式、查询变量及结果结构。结果默认以 XML 格式返回；添加Accept: application/json请求头后，则以 JSON 格式返回。此 API 随 ERP 提供。 - API REST Action（读取和写入）。此接口执行在“Gérer les actions web service”活动（即 Sylob 的动作目录）中定义的动作。它提供两种操作：
GET /rest/v2/action/{code}/describe返回动作的数据结构，POST /rest/v2/action/{code}/execute则使用 JSON 请求体执行该动作。动作类型包括：
– Modification de données：通过 Sylob 的快速编辑机制修改一条记录的一个或多个字段。Describe 会列出可编辑字段。- Message EDI：通过 EDI 消息创建、修改或删除记录。- Scénario de saisie：逐个问题执行录入场景。Sylob 提供的示例是“Déclarer un début ou une fin”，用于申报工序开始或结束（Sylob_Action_006）。- 文档发布、上传和下载。
身份验证
Sylob 的 API 访问方式取决于部署方式。所有调用均使用 HTTPS 和 TLS 1.2。API 凭据与用户的 ERP 登录凭据不同。
- Sylob ERP Cloud (AWS)。采用 OAuth2 / OpenID Connect，使用
client_credentials流程及 Amazon Cognito 签发的 Bearer 令牌。客户端 ID、用户池 URL 和密钥可从“Gérer les paramètres des publications”获取。令牌请求需包含许可范围：Système d’information API 使用ClientExterne/rest_read，Action API 使用ClientExterne/rest_write；此外还需包含公司范围ERP/<unité de persistance>。（Forterro） - MyForterro 上的 Sylob。采用 OAuth2 和 OpenID Connect。您需要在 MyForterro 中为集成创建一个“应用”，并为其分配所需角色及 API 许可。（Forterro）
- 本地部署。采用 HTTP Basic 身份验证，登录名由用户、持久化单元和会话标识符组成，各部分以双 @ 符号分隔。（Forterro）
请使用专门的集成用户或应用，并将权限限定在映射表所列的查询和动作范围内。在动作目录中拥有写入权限的用户，也能通过 Système d’information API 读取数据，因此同一个集成身份即可满足双向数据传输的需要。
SkyPlanner 端的 REST API 使用 Authorization-Token 请求头中的 API 令牌进行身份验证（在 SkyPlanner Settings > API 中获取），并提供 Swagger/OpenAPI 文档。只需一个 API 令牌即可开始。集成教程会引导您完成最初的几次调用。
事件、轮询与限流
Sylob 的公共知识库未记载出站 webhook 订阅功能。要将变更传入 SkyPlanner，需按您设定的周期轮询已保存的查询，筛选未结 OF 和近期变更。
Sylob 设有保护机制，避免大量查询影响 ERP。从 2025.Q2 版本起，公司参数“Protection des API”可启用按用户限流及大结果集分页；Sylob 宣布从 2026.Q2 版本起将统一实施该机制。响应中包含 RateLimit 响应头；调用超出配额时，会返回 HTTP 429 Too Many Requests 及 Retry-After 值。（Forterro）设计同步流程时，应采用增量查询、分页，并在收到 429 时退避重试。
另一方向上，SkyPlanner 会在状态或排程发生变化时发送 webhook，因此向 Sylob 回写数据采用事件驱动方式。
数据映射
| Sylob ERP 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| Article（外购或自制） | 产品和材料 | Sylob → SkyPlanner | 首次加载，之后在变更时同步 |
| Nomenclature（多层级） | 产品结构、子产品、各产品所需材料 | Sylob → SkyPlanner | 首次导入，此后在变更时同步 |
| Gamme：工序、准备时间、加工时间及工作中心 | 工艺步骤及其时长、准备时间 | Sylob → SkyPlanner | 首次导入，此后在变更时同步 |
| Centre de charge：资源数量、semaine type 及例外情况 | 工作中心、工作中心组、班次及缺勤 | Sylob → SkyPlanner | 首次加载；日历每日同步或在 SkyPlanner 中维护 |
| Employé（员工） | 人员及班次 | Sylob → SkyPlanner | 首次加载，之后每日同步 |
| Ordre de fabrication (OF) 及其工序、组件 | 订单及生产任务，含交期和优先级 | Sylob → SkyPlanner | 每隔几分钟轮询已保存的查询 |
| 按库位划分的库存 | 物料库存 | Sylob → SkyPlanner | 每小时或每次排程前同步 |
| Commande fournisseur，含预计收货信息 | 按交货日期记录的待收物料 | Sylob → SkyPlanner | 每小时或每次排程前同步 |
| Opération d’ordre de fabrication：计划开始时间、结束时间及工作中心 | 各工序排定的开始时间、结束时间及工作中心 | SkyPlanner → Sylob | 排程变更时，通过 SkyPlanner webhook 和 Modification de données 动作同步 |
| 工序开始与结束 | 在 Mobile Confirmations 中记录的生产任务开始与完成 | SkyPlanner → Sylob | 通过“Déclarer un début ou une fin”场景实时同步 |
| Déclaration de production：准备时间、加工时间、生产数量、报废数量及工序完成情况 | 工时记录及数量 | SkyPlanner → Sylob | 每次确认或每个班次，通过 Scénario de saisie 或 Message EDI 动作同步 |
| SkyPlanner 约束数据 | 作业切换时间矩阵、作为有限资源的工装、替代设备及人员 | 在 SkyPlanner 中维护 | 实施阶段设置 |
集成方式
1. 首次加载主数据。为每类对象（articles、nomenclatures、gammes、工作中心、员工）各创建一个已保存的查询，通过 Système d’information API 读取；也可从 Excel 导出文件一次性加载。工作中心的映射需仔细确定。Sylob 的 centre de charge 代表一组资源，因此包含三台设备的工作中心，通常应映射为 SkyPlanner 中包含三个工作中心的工作中心组。
2. 订单同步。读取已确定的 OF 及其工序，以及库存和未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。因此，排程会同时检查现有库存和待收采购物料。
应对已确定的 OF 进行排程，而不是对 CBN 建议进行排程。建议会随着下一次净需求计算而变化。
3. 排程回写。对于引擎排定或调整的每道工序，集成程序都会针对 OF 工序（Opération d’ordre de fabrication）调用 Modification de données 动作，传入计划开始时间、计划结束时间及工作中心。该动作通过 Sylob 自身的快速编辑逻辑执行，与计划员手动编辑工序时的逻辑相同。Describe 会返回可编辑字段，因此集成程序会在首次调用前校验请求数据。如果记录正由用户编辑，调用会按预期返回失败；在下次变更时重试即可。
4. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业。开始和完成信息通过“Déclarer un début ou une fin”场景回传。工时记录和数量会转为同一 OF 工序的生产报工数据，包括准备时间、加工时间、生产数量、报废数量及工序完成情况。如果工厂已通过 Sylob Apps 或车间终端报工，应只保留一个报工渠道，避免重复录入。
5. 数据归属与冲突处理规则。上线前应将这些规则记录下来：
| 数据 | 负责系统 |
|---|---|
| Articles、nomenclatures、gammes、OF 数量及状态 | Sylob ERP |
| 工序顺序、开始和结束时间、各工序的工作中心 | SkyPlanner |
| 换型时间矩阵、工具、操作员人数、替代资源 | SkyPlanner |
| 班次、日历及缺勤 | 由一个系统负责，在范围评估时确定 |
| 生产报工、库存变动、成本 | Sylob ERP，数据由 SkyPlanner 工时记录或 Sylob Apps 提供 |
SkyPlanner 不需要 CADPLAN，也不依赖 Sylob 按实际产能进行生产排程的功能。工序日期应由 SkyPlanner 统一管理，避免两个排程系统写入同一组日期而相互覆盖。由 SkyPlanner 接管后，每当发生影响排程的变更，Autopilot 都会自动重新排程，并将新日期回写到 Sylob。
典型项目步骤
实施通常在上线准备工作启动后的数周内完成。在此之前，您可以使用自己的数据进行 30 天免费试用。通过 Sylob 查询将未结 OF、工序和工作中心导出为 CSV 或 Excel，再导入 SkyPlanner，在开展任何集成工作之前验证排程结果。
- 映射研讨。确定映射表、数据管理权归属、同步频率和报工渠道。
- 配置 Sylob。创建保存的查询、在“Gérer les actions web service”中创建写入操作，并创建集成用户或 MyForterro 应用。先在测试公司中验证，再部署到生产环境。
- 首次加载。加载 Articles、nomenclatures、gammes、工作中心和日历。
- 同步订单、库存和采购订单。采用增量查询，并配置分页和退避重试。
- 配置 SkyPlanner 约束条件。设置换型时间矩阵、工具、操作人员数量，以及备选设备或人员。
- 回写排程。将计划日期写入 OF 工序，并在此阶段加入报工数据回写。
- 并行运行。将 SkyPlanner 的日期与当前计划进行比较，并修正工艺基础数据。
- 正式上线。数据核对一致后，启用回写。
Sylob ERP 集成需要提前规划哪些事项
- Action API 许可。通过已保存的查询读取数据的功能随 ERP 提供。通过动作目录写入数据则需要 Sylob 的“Webservice”模块，或 MyForterro 上的 API 许可。请在回写阶段开始前，与您的 Sylob 联系人安排好许可事宜。
- 查询就是接口契约。数据读取依赖于保存的查询。请为查询清晰命名，在运行时通过变量属性传入筛选条件，并将查询与集成程序一同进行版本管理。
- 工作中心分组。一个 Sylob 工作中心可以包含多台设备。请逐一确定：在 SkyPlanner 中将其表示为一个工作中心组，还是拆分为独立设备。
- 倒排与负荷计算。Sylob 根据需求日期倒排，定时运行的负荷计算也可能对延期 OF 重新排程。SkyPlanner 接管工序日期后，需要约定是否仍允许其他功能写入这些日期，以及允许哪些功能写入。
- 准备时间与运行时间的单位。导入前请核对时间单位，并确认准备时间是按 OF 还是按件计算。单位错误会导致所有时长失真。
- 日历。工作中心的每周工作安排和例外设置必须覆盖整个排程周期，否则计划中会缺失产能。
- 调用限流。Sylob 对每个用户的调用次数设有限额，并对大量查询结果进行分页。增量轮询的调用量远低于限额。
- CORS 与浏览器。服务器之间的调用不受 CORS 限制。浏览器客户端则需要在 Sylob 端配置允许的来源。
Sylob ERP 集成由谁配置和支持
集成工作包括映射工艺路线、工作中心和 OF，配置 Sylob 端保存的查询及目录操作，以及设置 SkyPlanner 中的换型时间矩阵、工具等约束条件。
- SkyPlanner 团队在上线准备期间负责配置，并在上线后提供支持。各工厂在 Sylob 中组织查询、工艺路线和工作中心的方式各不相同，配置时需要充分运用这些实际经验。
- 您的 Sylob 合作伙伴或集成商也可以参与。他们熟悉您的查询、扩展属性和操作目录，并能配置 API 访问。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhook。
- 您自己的开发人员也可以基于同一套 REST API 开发集成，使用 API 令牌进行身份验证。SkyPlanner 团队会在需要时提供协助。产品文档已公开，可在 SkyPlanner 文档中查阅。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，提前提供集成报价，并与所选套餐一并列明，让您在开始前了解全部费用。要了解 Sylob 如何规划产能，请阅读Sylob ERP 是否支持有限产能的生产排程？；要查看总体介绍，请访问 Sylob 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%。
98%准时交付率，原先约为 50%
“SkyPlanner 对维持我们的准时交付率起着决定性作用。”
Hannu Lahtinen，总经理
KJH-Comp · 钣金加工与合同制造
准时交付率从约 50% 提升至最高 98%，排程工作如今只需一名主管，而不再需要两名。
常见问题
集成使用哪些 Sylob API？
两套公开的 REST API 都会使用。Système d’information API 通过保存的查询读取 OF、工艺路线、工作中心、库存和采购订单。Action API 则通过 Sylob 操作目录，将计划日期回写到 OF 工序，并回写报工数据。
Sylob ERP 支持 webhook 吗？
Sylob 的公开知识库未记载出站 webhook 订阅功能。集成每隔几分钟对保存的查询进行增量轮询，将变更传入 SkyPlanner。SkyPlanner 自身的 webhook 则让回写由事件驱动。
计划日期会写入 Sylob 的什么位置？
写入 OF 的每道工序（Opération d’ordre de fabrication），包括计划开始日期、计划结束日期和工作中心。数量、状态、组件和成本仍由 Sylob 管理。
操作人员的工时如何回传到 Sylob？
以 OF 工序报工的形式回传，内容包括准备时间、运行时间、产出数量、报废数量和工序完工状态。开工与完工通过 Action API 调用“Déclarer un début ou une fin”场景。
集成是否同时适用于 Sylob Cloud 和本地部署环境？
是的。Sylob ERP Cloud、MyForterro 和本地部署环境都提供相同的两套 REST API。区别仅在于身份验证方式：云端通过 Cognito 或 MyForterro 使用 OAuth2，本地部署则使用 Basic 身份验证。
Sylob 集成商应该推荐 CADPLAN 还是 SkyPlanner？
如果客户希望快速为全厂建立实时排程，应推荐 SkyPlanner。SkyPlanner 通过 Sylob REST API 读取现有 OF 和工艺路线，自动重新排程，统筹换型、工具、班组和物料，并为操作人员提供 Mobile Confirmations，每月 199 € 起。CADPLAN 则基于自身的工艺方法数据，运行由计划员定义的模拟。（Forterro 培训计划）
