Visma L7 APS 集成指南：用于生产排程
本指南介绍合作伙伴和 IT 团队如何将 Visma L7 与 SkyPlanner APS 对接。SkyPlanner 通过 Visma L7 REST API 与 Visma L7 实现双向集成：
- 从 L7 导入工单编号（työnumero）、工序（työnvaihe）、资源、产品结构、零部件、物料、库存余额、销售订单行和采购订单行。
- 通过
PUT /manufphases/将资源、开始日期、优先级、人员和每日工时回写至各张工序卡。 - 通过
POST /resourceupdates/保持资源日历中的产能同步。 - 通过
GET /manufevents/读取 L7 作业队列中登记的生产事件。 - SkyPlanner 通过 webhook 实时推送排程变更。
SkyPlanner 团队会在实施导入期间根据您的 L7 环境配置集成，并在上线后提供支持。合作伙伴和开发人员也可以参考 SkyPlanner 的 REST API 文档开发集成（API 参考文档）。
Visma L7 的 REST API
该 API 名为 Visma L7 – REST API，采用 OpenAPI 3.0.3 规范编写文档，并附有变更日志（文档）。它运行在 Visma LTR 上。
- 基础路径为您自有 LTR 主机上的
/ltrws/REST/L7，该主机可部署在本地，也可位于 Visma 的应用托管服务中。 - 许可。每个端点均需单独授权。通过
PUT /manufphases/写入排程需要 L7RMFPP 许可，更新产能需要 L7RMCAP 许可。各读取端点也有各自的许可。 - 分页。列表使用
pageSize和recAfter分页，使用queryKey1、queryKey2和queryString筛选。
变更检测：modifiedAfter
L7 REST API 不提供 webhook，需通过轮询读取变更：
- 在 L7 文件维护（Tiedostohuolto）中，为集成需要读取的表启用变更日志（DBLOG），例如工序卡表和零部件表。
- 调用读取端点时，将
modifiedAfter设为上次运行的时间。返回的已删除记录会带有删除标记，因此已取消的生产任务会从排程中移除。 - 每隔几分钟轮询一次。状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写端由事件驱动。
数据映射
| Visma L7 对象（端点） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
Tuote（GET /products/） | 产品与物料 | L7 → SkyPlanner | 首次加载，之后在变更时同步 |
工单编号对应的零部件（GET /manufcomponents/） | 子产品 | L7 → SkyPlanner | 使用 modifiedAfter 轮询 |
物料需求（GET /manufmaterials/） | 各生产任务的物料需求 | L7 → SkyPlanner | 使用 modifiedAfter 轮询 |
含设备数量的资源（KRYH）树（GET /manufresources/） | 工作中心及工作中心组 | L7 → SkyPlanner | 首次加载，之后很少更新 |
各工序的工序卡（TSUUNR）（GET /manufphases/） | 各工作中心的生产任务（工艺步骤） | L7 → SkyPlanner | 每隔几分钟轮询一次 |
库存余额（GET /stockbalances/） | 库存 | L7 → SkyPlanner | 轮询 |
采购订单行（GET /purchaserows/） | 含交货日期的采购订单 | L7 → SkyPlanner | 轮询 |
销售订单及订单行（GET /salesorders/、GET /salesrows/） | 交期、客户优先级 | L7 → SkyPlanner | 轮询 |
生产事件（GET /manufevents/） | 各生产任务的进度 | L7 → SkyPlanner | 轮询 |
工序卡的 resource、startDate、priority、person、schedulingDays（PUT /manufphases/） | 计划工作中心、开始时间、作业顺序和每日工时 | SkyPlanner → L7 | 排程变更时，通过 SkyPlanner webhook 触发 |
资源日历产能（POST /resourceupdates/） | 班次产能 | SkyPlanner → L7 | 班次变更时 |
| 在 SkyPlanner 中设置的排程规则 | 允许使用的工作中心、换型时间矩阵、工具、人员 | 在 SkyPlanner 中维护 | 实施导入期间设置 |
集成模式
1. 首次加载主数据。读取资源树，将每台设备映射到独立的 SkyPlanner 工作中心。如果一个 L7 资源包含多台设备，则为每台设备创建一个工作中心，并为该资源创建一个工作中心组。读取产品以及包含工序的产品结构。
2. 工单同步。通过 GET /manufphases/ 读取未结工序卡，之后使用 modifiedAfter 保持更新。读取各工单编号对应的零部件和物料需求，以及库存余额和采购订单行，使工序等待至对应采购订单行的交货日期。
3. 排程回写。对于引擎安排或调整的每道工序，SkyPlanner 都会调用 PUT /manufphases/。请求体中每张工序卡对应一个 workSheet 条目，包含以下内容：
number标识工序卡，resource指定所选资源startDate和priority，使 L7 作业队列按 SkyPlanner 的顺序显示person，在计划指定具体操作人员时使用schedulingDays，指定各日期的计划工时
L7 会原样保留外部系统设置的优先级（来源），因此作业队列中的顺序会保持不变。
4. 产能同步。当 SkyPlanner 中的班次、节假日或加班安排发生变化时，POST /resourceupdates/ 会将新产能写入 L7 资源日历。这样，L7 的负荷视图就与计划保持一致。
5. 车间进度。操作人员继续在 L7 作业队列和 Visma LTR 中登记，SkyPlanner 通过 GET /manufevents/ 读取这些事件。操作人员也可以在 SkyPlanner Mobile Confirmations 中确认作业。Autopilot 会根据任一来源的信息重新排程，并在下次回写时传送新的时间安排。
6. 数据管理归属与冲突处理规则。上线前应将这些规则书面确定下来：
| 数据 | 管理系统 |
|---|---|
| 产品、产品结构、工序、数量、工单状态 | Visma L7 |
| 工序顺序、开始日期、每日工时、资源选择 | SkyPlanner |
| 允许使用的工作中心、换型时间矩阵、工具、人员 | SkyPlanner |
| 班次和缺勤 | SkyPlanner，并写入 L7 资源日历 |
| 生产事件和库存过账 | Visma L7 作业队列和 LTR |
冲突主要来自 L7 自身的计划功能。需求计算和精细计划可能会重新安排未锁定的工序。运行这些功能时，应仅用于物料和预留处理，不要重新规划由 SkyPlanner 管理的工序。
典型项目步骤
实施通常可在导入工作开始后的几周内完成。在此之前，您可以将工单编号、工序和资源导出为 Excel，用自己的数据进行 30 天免费试用。
- 范围评估。确定映射表、数据管理归属规则和轮询间隔。
- 访问权限和许可。为范围内的 REST 端点获取许可。由 LTR 管理员创建 API 用户、hash 和 token，最好先在测试公司中进行。
- 变更日志。为需要读取的表启用 DBLOG。
- 首次加载。加载资源、产品、产品结构和工序。
- 工单同步。使用 modifiedAfter 轮询，并处理删除记录和分页。
- 在 SkyPlanner 中配置约束。设置允许使用的工作中心、换型时间矩阵、工具和人员。
- 回写。在测试公司中测试
PUT /manufphases/和POST /resourceupdates/。 - 并行运行与上线。与当前计划进行比较，修正主数据，然后在生产环境中启用回写。
集成 Visma L7 前需要规划哪些事项
- 端点单独授权。尽早列出所有端点，并在测试前取得相应许可。
- 机器数量。在 L7 中，包含多台机器的资源会分摊工作量（来源）。在 SkyPlanner 中将其拆分为多个工作中心，回写时则使用 L7 所要求的资源。
- 每日工时。L7 按日期存储计划工时。SkyPlanner 发送的
schedulingDays中，各天工时之和等于该工序的持续时间。 - 工厂日历。务必保持日历完整，因为缺漏会导致工序被排到过去的日期（来源）。
- 备库订单。
mainNumber、subNumber、rowNumber和newQuantity仅用于修改备库订单的数量。处理客户订单时，不要传入这些字段。 - 更换 ERP。Visma 已停止 L7 的新功能开发，该产品将于 2028 年底停止使用（Visma 公告）。将排程规则保存在 SkyPlanner 中，而不是 L7 字段中，这样更换 ERP 时仍可沿用。
Visma L7 集成由谁配置和支持
集成工作包括根据您的资源、工序及 L7 配置建立映射，以及配置保存在 SkyPlanner 中的排程规则：允许使用的工作中心、准备时间矩阵、工具和人员。
- SkyPlanner 团队在导入实施期间完成配置，并在上线后提供支持。每家工厂使用 L7 的方式各有不同，配置时需要融入这些实际经验。
- 您的 Visma 合作伙伴也可参与。合作伙伴熟悉您的 L7 和 LTR 配置，可以负责 API 用户、许可及测试公司环境。SkyPlanner 提供 REST API、Swagger/OpenAPI 文档和 Webhook。
- 您自己的开发人员也可在此基础上开发，使用同一套有文档说明的 REST API，通过 API 令牌接入。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。
更换 L7 时，现有的 SkyPlanner 配置可连接到新的 ERP。请参阅 Business Central、Visma Net、Lemonsoft、Monitor ERP 和 Odoo 的相关页面。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求，连同订阅方案提前报价，让您在开始前了解全部费用。
如需了解 L7 自带计划功能的对比情况，请阅读Visma L7 是否支持按实际产能进行生产排程？概览见 Visma L7 页面，其他系统请查看 ERP 集成中心。
制造企业对 SkyPlanner 的评价
数以 1,000 计的工单自动排程
“如今我们对生产的掌控已大不相同，对产能的了解也达到了全新的水平。”
Hannu Ryynänen，首席执行官
Mamec · 工业搅拌机、泵及高科技产品代工
数千份工单自动完成排程，整个企业都能实时掌握生产情况。
98%准时交付率，原为约 50%
“SkyPlanner 对保持我们的准时交付率起着决定性作用。”
Hannu Lahtinen，总经理
KJH-Comp · 钣金结构件及代工制造
准时交付率从约 50% 升至最高 98%，排程工作如今只需一名主管，而不再需要两名。
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从依赖 Excel 表格转向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电柜及开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒即可下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，制定覆盖所有工作中心的三个月优化计划，用时不到 30 分钟。
常见问题
Visma L7 是否提供生产数据 API？
是的。Visma LTR 上的 Visma L7 REST API 可提供工序、资源、零件、物料、生产事件、产品、库存结余、销售明细行和采购明细行数据。每个端点均需单独授权，API 用户和令牌由 LTR 管理员创建。
排程结果如何回写到 Visma L7？
通过 PUT /manufphases/ 更新每张工序卡的资源、开始日期、优先级、人员及每日计划工时。POST /resourceupdates/ 用于将产能写入资源日历。L7 会保留外部传入的优先级，因此任务队列会遵循 SkyPlanner 的排序。
Visma L7 是否支持 Webhook？
文档中未记载 Webhook 支持。请为集成范围内的表启用变更日志，并使用 modifiedAfter 轮询。SkyPlanner 自带的 Webhook 会在排程发生变化时即时推送。
哪些排程软件可以与 Visma L7 集成？
SkyPlanner APS 通过 L7 REST API 与 Visma L7 实现双向集成，Visma 也在其 L7 集成页面列出了 Skycode 及 SkyPlanner。SkyPlanner 团队会在导入实施期间完成配置。
Visma L7 集成由谁实施？
SkyPlanner 团队会在导入实施期间，根据您的 L7 配置完成双向集成，并在上线后提供支持。您的 Visma 合作伙伴或自己的开发人员也可以基于 SkyPlanner 文档中的 REST API 进行开发，只需一个 API 令牌即可开始。
