E2 Shop System 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向合作伙伴和 IT 团队，介绍如何将 E2 Shop System (E2 SHOP) 或 E2 MFG 接入 SkyPlanner APS。SkyPlanner 与 E2 之间支持双向集成：
- 将订单和生产任务及其工艺路线中的工序、工作中心、员工与班次、物料清单、物料需求和采购订单导入 SkyPlanner。
- 将计划开始和结束时间，以及 SkyPlanner 分配的设备和员工，回写到每道任务工序。
- 您也可以选择将已完成的工序和记录的工时回写到生产任务。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
SkyPlanner 团队会在上线准备期间，根据您的 E2 部署配置集成，并在上线后继续提供支持。本指南面向希望参与集成，或自行使用 SkyPlanner 的 REST API 开发的合作伙伴和开发人员。该 API 的说明见API 参考文档。
您使用的是哪款 E2？
先确认这一点，因为它决定了集成方式：
| 您使用的产品 | 产品现状 | 集成方式 |
|---|---|---|
| E2 Shop System（桌面版，部署在您的服务器上） | Shoptech 最初面向按单加工企业推出的 E2 | 直接连接您的 E2 服务器，并在适用时辅以文件交换 |
| E2 MFG (E2 Manufacturing System) | 面向重复制造、离散制造和混合模式生产的 E2 版本，ECI 将其列为 “for existing customers”（供现有客户使用） | 与本地部署的 E2 Shop System 相同 |
| 托管版 E2 SHOP | 由 ECI 重构为 JobBOSS² 的 Web 平台 | 如果您现在使用 JobBOSS²，请参阅 JobBOSS² 集成指南 |
ECI 将 JobBOSS² 描述为 “formerly E2 Shop”（前身为 E2 Shop），并表示它 “combines E2 SHOP’s cloud-native, user-friendly platform with JobBOSS’ depth of functionality”（将 E2 SHOP 易用的云原生平台与 JobBOSS 的深度功能相结合）（ECI）。本指南其余内容适用于使用 E2 Shop System 或 E2 MFG 的制造企业。
E2 的集成方式
ECI 在 ECI 制造 API 文档网站上公开的制造 API 适用于 JobBOSS²、M1、Macola 和 Deacom。E2 则通过自身部署环境接入，这很适合本地部署的 E2：数据就存放在您自己的 IT 团队管理的服务器上。具体的读写方式会在上线准备的范围评估阶段确定。
- 直接连接服务器（本地部署）。部署在您网络中的集成服务从 E2 数据库读取未结生产任务、工艺路线中的工序、工作中心、员工、物料和采购订单，并将计划开始和结束时间回写到任务工序。访问权限、专用服务账户以及具体写入哪些字段，均由您的 IT 团队批准。这是实现实时双向集成的主要方式。
- 定时导出和导入。通过 E2 报表和表格导出功能，可将生产任务、工艺路线和工作中心导出为 CSV 或 Excel 文件，再由 SkyPlanner 的数据导入功能读取。这种方式适用于试用，也适用于仅需偶尔加载的主数据。
- 托管部署。如果 E2 由 ECI 托管，需与 ECI 协商数据访问事宜。请尽早联系您的 ECI 客户经理。
在 SkyPlanner 端，REST API 可读写订单、产品、物料、工序、工时记录和采购订单。身份验证使用 Authorization-Token 请求头中的 API 令牌（SkyPlanner Settings > API），接口文档采用 Swagger/OpenAPI。集成教程介绍了如何完成最初的接口调用。
事件与轮询
E2 端采用轮询。集成服务读取自上次运行以来发生变更的生产任务和工艺路线工序；生产任务每隔几分钟读取一次，库存和采购订单每小时读取一次，具体频率按各企业的约定执行。
状态或排程发生变化时，SkyPlanner 会发送 webhook。集成服务收到后立即将新的日期写入 E2，因此回写端采用事件驱动方式。也可以定时通过 SkyPlanner 的 /timelogs 端点读取车间事件。
数据映射
| E2 对象 | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 零件与估价、多级物料清单 | 产品、物料、产品结构 | E2 → SkyPlanner | 首次加载，之后在变更时同步 |
| 工艺路线中的工序：工作中心、准备时间、加工时间 | 工序及其时长和准备时间 | E2 → SkyPlanner | 首次加载，之后在变更时同步 |
| 工作中心和设备 | 工作中心、工作中心组、效率 | E2 → SkyPlanner | 首次加载，之后很少更新 |
| 员工、班次、部门、非工作日 | 人员、班次、日历 | E2 → SkyPlanner | 每天同步，或在 SkyPlanner 中维护班次 |
| 订单和生产任务：任务编号、零件、数量、到期日、优先级、紧急任务标记 | 订单及其到期日和优先级 | E2 → SkyPlanner | 每隔几分钟轮询一次 |
| 生产任务工艺路线中的工序：状态、已完成数量、剩余工时 | 各道工序对应的生产任务 | E2 → SkyPlanner | 每隔几分钟轮询一次 |
| 物料需求、采购订单及其到期日 | 物料需求、按交付日期安排的采购订单 | E2 → SkyPlanner | 每小时或运行排程时轮询 |
| 任务工序的计划开始和结束时间、工作中心、员工 | 各道工序的计划开始和结束时间、设备和操作员 | SkyPlanner → E2 | 排程变更时，通过 SkyPlanner webhook 同步 |
| 各道工序的任务工时和已完成数量 | 工时记录和操作员报工 | SkyPlanner → E2 | 如选择启用，则在每次报工时或按班次同步 |
| E2 中无对应数据 | 换型时间矩阵、作为有限资源的工具、备选设备和人员 | 在 SkyPlanner 中维护 | 在上线准备期间设置 |
集成模式
1. 首次加载主数据。读取零件、物料清单、工艺路线、工作中心、员工和班次。工作中心的映射需要仔细确定：一个拥有三台铣床的工作中心，应映射为一个工作中心组或三个工作中心，以便 SkyPlanner 为每台设备分别排程。
2. 同步生产任务。读取未结生产任务及其工艺路线工序、物料需求，以及未结采购订单。SkyPlanner 将已订购物料视为在采购订单交付日期可用，并在采购订单标记为 Delivered 时更新库存。跳过已关闭和已暂停的生产任务。将紧急任务标记转换为 SkyPlanner 中的优先级。
3. 回写排程。排程引擎安排或移动工序时，SkyPlanner webhook 会触发集成服务。服务将计划开始和结束时间写入 E2 中对应的任务工序；如果 SkyPlanner 将工序改派到其他设备或人员，还会写入相应的工作中心和员工。随后，Whiteboard 和 Planning Board 就会显示 SkyPlanner 的日期。
4. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录工作，工时记录让排程保持更新。您可以选择是否将实际工时回写到 E2。如果选择回写，每次报工都会转换为任务工序上的工时和数量；如果不回写，E2 Data Collection 保持现状，SkyPlanner 则从任务工序读取进度。
5. 数据维护权与冲突处理规则。上线前应将以下规则明确记录下来：
| 数据 | 负责维护的系统 |
|---|---|
| 估价、工艺路线、数量、到期日、生产任务状态 | E2 |
| 工序顺序、开始和结束时间、各道工序的设备和操作员 | SkyPlanner |
| 换型时间矩阵、工具和操作员要求、备选资源 | SkyPlanner |
| 班次和非工作日 | 由一个系统统一维护，在范围评估时选定 |
| 工时、领料、收货、成本核算 | E2，直接在其中录入，或由 SkyPlanner 工时记录回写 |
只指定一个系统写入任务工序日期。计划员在 SkyPlanner 中调整生产任务，日期随之同步到 E2。对于由 SkyPlanner 排程的生产任务，必须停止在 Planning Board 上拖动卡片，否则两边的排程会出现偏差。
典型项目步骤
实施通常可在上线准备启动后的几周内完成。在此之前，先将 E2 中的工作中心、工艺路线和未结生产任务导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 范围评估。确认 E2 的产品版本和版本号、服务器、映射表、数据归属规则，以及是否回写工时。
- 访问权限。由您的 IT 团队创建服务账户并批准读写权限。先对 E2 做完整备份，再用企业数据的副本进行测试。
- 初始导入。导入零件、物料清单、工艺路线、工作中心、员工和班次。
- 同步生产任务和采购订单。通过轮询获取变更，并配置重试和日志记录。
- 在 SkyPlanner 中设置约束。配置换型时间矩阵、工具、每项生产任务所需的操作人员数量，以及可替代的设备或人员。
- 回写排程结果。通过 webhook 触发，将日期回写到生产任务的各道工序；如果选择启用，也会回写工时和数量。
- 并行测试。让 SkyPlanner 与现有的 Whiteboard 并行运行，对比日期并修正主数据。
- 上线。数据核对一致后，启用回写。
E2 集成需要提前考虑什么
- 产品版本和版本号。E2 Shop System 和 E2 MFG 的安装环境因版本而异。在范围评估时确认您使用的版本，并在每次 E2 更新后重新测试集成。
- 您的服务器，由您制定规则。本地部署的 E2 运行在您的网络中。请与 IT 团队商定集成服务的运行位置、使用的账户，以及允许写入的字段。
- 工作中心背后的设备。一个工作中心可以是一台设备、一组设备或一个生产单元。首次导入前，请确定各工作中心如何映射到 SkyPlanner 工作中心。
- 外协加工。供应商执行的工序应计入交货期，而不占用您的产能。请将其建模为仅计时、不占用产能的工序。
- 时间单位。准备时间和加工时间可能按件、按批或按小时计。导入时必须换算，否则所有时长都会出错。
- 紧急任务。E2 会标记高优先级的生产任务。将该标记映射到 SkyPlanner 的优先级或 Fast Track，确保紧急任务保持优先顺序。
- 计划迁移到 JobBOSS²？SkyPlanner 端只需搭建一次。迁移到 JobBOSS² 后，同一套排程方案可通过 ECI 的 JobBOSS² API（托管版）或 ERP API 连接，详见 JobBOSS² 指南。
谁负责 E2 集成的配置和支持
- SkyPlanner 团队在上线准备期间负责配置，上线后继续提供支持，范围涵盖双方约定的对象和同步规则。每家工厂使用 E2 的方式都不同，团队会将相关经验用于配置和后续支持。
- 您的 E2 合作伙伴或 IT 服务商也可以参与。他们了解您的服务器和 E2 配置，可以与 SkyPlanner 团队协作处理访问权限和服务账户。
- 您自己的开发人员也可以在此基础上扩展，使用 API 令牌调用 SkyPlanner 的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。相关文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求，与订阅方案一并提前报价。请参阅价格、E2 Shop System 生产排程、E2 Shop System 页面、SkyPlanner 功能和 ERP 集成中心。
使用 SkyPlanner 的制造企业
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划从 Excel 电子表格走向了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘和开关设备
生产计划工作每周节省 2 小时，新的任务队列只需几秒即可下达到产线。
+90%生产效率提升
“生产效率提升了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 药品制造
生产效率提升了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
数以 1,000 计自动排程的工单
“我们对生产的掌控方式焕然一新，对产能的了解也达到了全新的水平。”
Hannu Ryynänen，首席执行官
Mamec · 工业搅拌机、泵及高科技产品合同制造
数千张工单实现自动排程，整个企业都能实时了解生产情况。
98%准时交付率，由约 50% 提升
“SkyPlanner 对维持我们的准时交付率起着决定性作用。”
Hannu Lahtinen，总经理
KJH-Comp · 钣金加工与合同制造
准时交付率从约 50% 提升至最高 98%，排程工作也从需要两名主管减少到只需一名。
常见问题
E2 Shop System 有 API 吗？
ECI 已发布的制造业 API 面向 JobBOSS²、M1、Macola 和 Deacom。本地部署的 E2 Shop System 和 E2 MFG 在安装环境中对接：集成服务运行在您的网络内，使用 IT 团队批准的权限读写 E2 数据，其余数据通过文件导出处理。
计划日期如何回写到 E2？
按生产任务的各道工序回写。SkyPlanner 的 Webhook 触发集成服务，将计划开始和结束时间写入 E2 中对应的工序。如果 SkyPlanner 调整了该工序的资源安排，还会回写工作中心和员工。
SkyPlanner 能将车间工时回写到 E2 吗？
可以，由您选择是否启用。SkyPlanner 中的每次报工确认都会转为对应工序的工时和数量记录。希望继续使用 E2 Data Collection 的工厂可以保留该模块，由 SkyPlanner 从 E2 读取进度。
我们使用托管版 E2 SHOP，应该参考哪份指南？
托管版 E2 SHOP 已转为 JobBOSS²。如果您现在登录的是 JobBOSS²，请参阅 JobBOSS² 集成指南。如果您仍在使用托管版 E2，则会在范围评估期间与 ECI 商定数据访问方式。
以后迁移到 JobBOSS²，现有集成还能继续使用吗？
SkyPlanner 端保持不变，包括工作中心、约束条件、换型时间矩阵和排程。只需将 E2 连接替换为 ECI 的 JobBOSS² API 或 ERP API。
