Kaskea Group 使用 SkyPlanner，并与 Lemonsoft 实现了双向集成。SkyPlanner 团队会在上线准备阶段根据您的 Lemonsoft 配置完成集成设置，并在上线后提供支持。合作伙伴和开发人员也可以基于附有文档说明的 SkyPlanner REST API 开发集成（API 参考文档）。
Lemonsoft 的 REST API
Lemonsoft 的集成 API 为 LemonRest，其文档采用 Swagger 2.0 规范，API 版本为 v1。构建版本“LemonRest 2026.10 release-2026.10.2”列出了 422 个路径。（Swagger）
- 基础 URL 因环境而异。可在用户管理中进入环境管理和服务地址，在 Rest API 字段中查看。在 Lemonsoft 的 Azure 平台上，基础地址为
https://rest.lemon.fi。 - 可用性。Lemonsoft 平台服务（Alustapalvelu）客户的 REST API 已预装，只需配置用户权限即可。（来源）
- 测试环境。由最终客户向 Lemonsoft Service Desk 订购。
排程不需要使用独立的 Kellokortti 工时记录 API。
身份验证
LemonRest 使用会话机制：
- 调用
POST /api/auth/login，传入 UserName、Password、Database 和 ApiKey，即可获得session_id。 - 每次调用时，都在
Session-Id请求头中传入该值。 - 使用
POST /api/auth/renew续期会话。GET /api/auth/alive用于健康检查。
POST /api/auth/login/token 接收 Token，而非用户名和密码。请创建专用集成用户，为其配置 API 密钥，并仅授予集成所需的权限。（来源）
SkyPlanner 的 REST API 使用 API 令牌进行身份认证（SkyPlanner Settings > API），并提供 Swagger/OpenAPI 文档。集成教程会逐步介绍最初几次调用的操作。
变更检测：增量查询
LemonRest 不提供 webhook 或订阅端点。需通过增量查询读取变更：
GET /api/production/main_ws/changed?updated_after=...返回自上次运行以来发生变更的生产任务。- 添加
optimization=true。2026.6.3 版本新增了此参数，用于消除对日志的依赖并加快查询速度。（版本说明） GET /api/log/deletion_events用于获取已删除的生产任务，以便将已取消的任务从排程中移除。
每隔几分钟轮询一次。SkyPlanner 会在状态或排程发生变化时发送 webhook，因此回写端采用事件驱动方式。
数据映射
| Lemonsoft 对象（端点） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
Tuote、product_code（/api/products） | 产品和物料 | Lemonsoft → SkyPlanner | 首次加载，之后在变更时同步 |
包含 Työvaiheet 行的 Tuoterakenne（/api/products/structure、all_levels） | 产品结构、子产品及包含准备时间的工序 | Lemonsoft → SkyPlanner | 首次加载，之后在变更时同步 |
Kone、Koneryhmä（/api/production/machines、/api/settings/machine_groups） | 工作中心、工作中心组 | Lemonsoft → SkyPlanner | 首次加载，之后很少同步 |
以 ProductMainWorkStage 表示的 Työnumero（/api/production/workstage、main_ws/changed） | 包含交期和优先级的订单 | Lemonsoft → SkyPlanner | 每隔几分钟进行增量轮询 |
以 ProductSubWorkStage 表示的 Työvaihe（main_ws/sub_ws）：machine、setting_time、duration、work_amount_left | 各工作中心的生产任务（工序） | Lemonsoft → SkyPlanner | 每隔几分钟进行增量轮询 |
组件需求（main_ws/{worknumber}/materials） | 各生产任务的物料需求 | Lemonsoft → SkyPlanner | 随各生产任务同步 |
计划班次（/api/persons/plannedshifts） | 班次、人员 | Lemonsoft → SkyPlanner | 每天同步，或在 SkyPlanner 中维护班次 |
工单号关联的销售订单（/api/orders/work/{work_number}） | 客户及优先级相关信息 | Lemonsoft → SkyPlanner | 随各生产任务同步 |
Työvaihe 的 start_time、end_time、machine_id（PUT /api/production/workstage） | 计划开始时间、结束时间及工作中心 | SkyPlanner → Lemonsoft | 排程变更时，通过 SkyPlanner webhook 同步 |
完工记录（POST main_ws/sub_ws/completion_entry） | 报工信息：完成数量、不合格数量、工时、人员 | SkyPlanner → Lemonsoft | 每次报工时同步 |
| 在 SkyPlanner 中设置的排程规则 | 各生产任务允许使用的工作中心、准备时间矩阵、工具 | 在 SkyPlanner 中维护 | 在上线准备阶段设置 |
集成方式
1. 首次加载主数据。读取机器及机器组、包含工序的产品结构，以及标准工序。将每台实际机器映射到一个 SkyPlanner 工作中心。父级机器（Isäkone）仅用于分组，因为其产能是下属机器产能的总和。
2. 工单号同步。通过 /api/production/workstage 或 main_ws/sub_ws 按状态筛选并分页读取未结工单号及其工序，再通过 main_ws/changed 持续更新。应映射 work_amount_left，而不是 work_amount，因为 Lemonsoft 按剩余数量排程。采购订单为 SkyPlanner 的物料驱动排程提供依据，因此工序需要等到采购订单的交货日期才能开始。
3. 排程回写。对于排程引擎安排或调整的每道工序，SkyPlanner 都会发送 PUT /api/production/workstage 请求，包含生产任务及其 sub_workstages。每道工序均携带 start_time 和 end_time；若改用了备选机器，还会携带 machine_id。
4. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 报工。每次报工都会提交到 completion_entry，包含 sub_workstage_id、person_number、done_amount、hours、failed_amount 和 job_done。如果工序消耗物料，还应一并发送 material_consumptions，Lemonsoft 随后会执行常规完工过账（valmistuskirjaus）。
5. 数据归属与冲突处理规则。上线前应将这些规则记录下来：
| 数据 | 负责系统 |
|---|---|
| 产品、产品结构、工序、数量、生产任务状态 | Lemonsoft |
| 工序顺序、开始和结束时间、机器选择 | SkyPlanner |
| 各生产任务允许使用的工作中心、准备时间矩阵、工具 | SkyPlanner |
| 班次与缺勤 | 由一个系统负责，在范围评估时确定 |
| 完工与库存过账 | Lemonsoft，根据 SkyPlanner 报工信息过账 |
冲突主要来自 Lemonsoft 自带的自动排程和刷新操作：两者都会重新安排未锁定的工序。由 SkyPlanner 负责排程时，应将 AUTOTIMING 保持为 0。如果保留自动排程，则须对每个已回写的工单号设置排程锁定，这会固定该工单号下的所有工序。仅启用 Koneiden kapasiteetin lukitus 并不足够，因为自动排程会将未锁定的生产任务从已锁定的日期移走。（来源）
典型项目步骤
实施通常可在上线准备工作启动后的几周内完成。在此之前，您可以将工单号、工序和机器数据导出为 Excel，用自己的数据进行 30 天免费试用。
- 范围评估。确定映射表、数据归属规则和轮询间隔。
- 访问配置。最终客户向 Lemonsoft Service Desk 订购测试环境，并创建集成用户和 API 密钥。
- 首次加载。导入机器、机器组、产品结构和工序。
- 工单号同步。配置增量轮询、删除事件处理和会话续期。
- 在 SkyPlanner 中设置约束。配置每项生产任务可用的工作中心、准备时间矩阵和工装。
- 数据回写。在测试环境中验证工序时间和完工记录的回写。
- 并行运行与上线。与现有甘特图对比，修正主数据，然后在生产环境中启用回写。
Lemonsoft 集成需要提前考虑哪些事项
- 每道工序对应一台设备。Lemonsoft 的每道工序只关联一台设备。在实施阶段，通过清单或产品属性确定各产品可用的设备，SkyPlanner 再从这些备选设备中选择。
- 每日产能。固定产能按每日总量记录，产能调整不包含具体时刻。可在 SkyPlanner 中建立实际班次模型，或读取计划班次。
- 剩余数量。映射
work_amount_left。STARTJOB_AUTOTIMENOW 和 JOBDONE_AUTOTIMENOW 设置也会调整 Lemonsoft 自身的负荷安排。 - 会话会过期。长时间同步前应续期会话，并处理强制重新登录的情况。
- 报工规则。提交每条报工记录前，先根据工序状态进行校验，并控制突发批量调用的频率。
- 两种客户端。LemonOnline 与 Windows 版共用一个数据库，因此该集成同时适用于两者。
- 大型产品结构。导入大量数据时，将
/api/async/product/structure与/api/async/status/{jobId}配合使用。
Lemonsoft 集成由谁配置和支持
这项工作包括根据您的设备、工序和 Lemonsoft 配置建立映射，也包括配置在 SkyPlanner 中维护的排程规则：每项生产任务可用的工作中心、准备时间矩阵和工装。
- SkyPlanner 团队在实施阶段负责配置，并在上线后提供支持。各工厂使用 Lemonsoft 的方式各不相同，配置时会将这些实际使用经验纳入考虑。
- 您的 Lemonsoft 合作伙伴可以参与。合作伙伴熟悉您的配置，可以负责 API 用户、权限和测试环境。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 webhooks。
- 您自己的开发人员也可以在此基础上开发，使用 API 令牌调用同一套有文档说明的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。
连接完成后，Arcturus 引擎会根据 Lemonsoft 中的实时工单进行排程，并将计划时间写入工序。SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，提前提供集成报价，并与您选择的套餐一并列明，让您在开始前了解全部费用。
查看Lemonsoft 生产排程，了解遵循实际产能约束的排程与 Lemonsoft 自带计划功能有何不同。集成概览见 Lemonsoft 页面，其他系统请参阅 ERP 集成中心。
制造企业对 SkyPlanner 的评价
Lemonsoft与 SkyPlanner 双向集成
Kaskea Group
合同制造：CNC 加工、钢结构与装配
使用 SkyPlanner 制定生产计划，并与 Lemonsoft 双向集成。
减少缺料导致的停工
“SkyPlanner 给我们带来的价值在于，它是一款日常工作中真正好用的工具，尤其是在确定交期方面。”
Tommi Männistö，生产计划经理
Eskomatic · 委托机械加工
自动负荷排程让交期更准确，缺料导致的生产停工也大幅减少。
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 表格迈向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电柜与开关设备
制定生产计划每周可节省 2 小时工作时间，新的任务队列只需几秒钟就能下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
常见问题
Lemonsoft 是否提供生产数据 API？
是的。LemonRest 提供生产任务、工序、设备、产品结构、物料和班次的数据访问接口，也支持提交完工记录。Alustapalvelu 客户已预装 LemonRest，使用时需要 API 密钥和用户权限。
Lemonsoft 支持 webhooks 吗？
LemonRest 未列出 webhook 端点。集成通过 main_ws/changed 增量查询和删除事件读取变更，每隔几分钟轮询一次。SkyPlanner 自身的 webhooks 则会在排程发生变更时即时推送。
计划时间如何回写到 Lemonsoft？
通过 PUT /api/production/workstage 更新生产任务及其工序的开始时间、结束时间和设备。由 SkyPlanner 负责排程时，应关闭 Lemonsoft 的自动排程，或为每个已回写的工单设置排程锁定，以保留 SkyPlanner 设定的时间。
SkyPlanner 中的操作员报工记录能提交到 Lemonsoft 吗？
可以。每条报工记录都会作为完工记录提交，包含完成数量、不合格数量、工时和人员。客户项目每天都在使用这一功能。
谁来实施 Lemonsoft 集成？
SkyPlanner 团队会在实施阶段根据您的 Lemonsoft 配置完成双向集成，并在上线后提供支持。您的 Lemonsoft 合作伙伴或自己的开发人员也可以基于 SkyPlanner 有文档说明的 REST API 进行开发，只需一个 API 令牌即可开始。
