Sage 100 集成指南：使用 SkyPlanner APS 进行生产排程
本 Sage 100 集成指南向 Sage 合作伙伴和 IT 团队介绍如何将 Sage 100 接入 SkyPlanner APS，涵盖同名的两款产品：美国和加拿大市场搭配 Production Management 的 Sage 100，以及德国和奥地利市场搭配 Sage 100 Produktion 的 Sage 100。SkyPlanner 与 Sage 100 支持双向集成：
- 将工单或 Fertigungsaufträge 及其工序或 Arbeitsgänge 导入 SkyPlanner，同时导入工作中心、物料、库存和采购订单。
- 将计划日期回写到各道工序或 Arbeitsgang。
- 将操作员的工时记录回写为人工工时条目（美国版）或 Rückmeldungen（德国版）。
SkyPlanner 团队会在实施期间根据您的 Sage 100 环境配置集成，并在上线后提供支持。本指南面向希望参与集成，或自行基于 SkyPlanner 提供文档的 REST API（API 参考文档）进行开发的合作伙伴和开发人员。
美国版 Sage 100：集成接口
美国版 Sage 100 采用本地部署，提供 Standard、Advanced 和 Premium 版本。集成接口位于 Sage 100 服务器上。
Business Object Interface (BOI)。
“The Business Objects Interface allows third-party developers with the necessary skills to access Sage 100 programs and applications using Component Object Model (COM).”（Business Objects Interface 允许具备相应技能的第三方开发人员通过 Component Object Model (COM) 访问该系统的程序和应用。）（Sage 100 帮助）Sage 开发者门户将其称为 “Sage 100’s internal API layer, giving you access to the same logic used by the application itself.”（该系统的内部 API 层，让您能够调用应用程序本身使用的逻辑。）（developer.sage.com）BOI 用于写入数据：每次创建或更新都要经过与用户在 Sage 100 中操作时相同的校验。
ODBC。
ProvideX ODBC 驱动程序可读取 Sage 100 数据表，用于报表和批量读取。Advanced 版本还提供客户端/服务器 ODBC 驱动程序。集成通过 ODBC 批量读取工单、物料和采购订单，通过 BOI 写入数据。
Visual Integrator (VI)。
VI 的导入和导出任务负责在 Sage 100 与文件或 ODBC 数据源之间传输数据。Sage 的说明是：”One of the most powerful features of the Visual Integrator module is its ability to directly import data from and export data to an ODBC data source.”（Visual Integrator 模块最强大的功能之一，是能够直接从 ODBC 数据源导入数据，以及向其导出数据。）（来源）VI 包含在 Essentials 套餐中，适合基于文件的数据交换。
eBusiness Web Services 基于 SOAP，涵盖 “the Sage 100 sales order, customer, and customer contact entities.”（该系统的销售订单、客户和客户联系人实体。）（来源）它可以传输销售订单，生产数据则通过 BOI 和 ODBC 传输。
集成程序在 Sage 100 所在环境中运行，使用的 Sage 100 用户须具有所需 Production Management、Inventory 和 Purchase Order 任务的操作权限。对外连接通过 HTTPS 访问 SkyPlanner 的 REST API。
德国版 Sage 100：集成接口
德国版 Sage 100 基于 Microsoft SQL Server 运行，可本地安装，也可采用云端版本。Sage 表示，用户可以 “Partnerlösungen via API-Schnittstelle ergänzen”（通过 API 接口接入合作伙伴解决方案）（Sage 100）。Sage 列出的生产类扩展基于 Sage AppDesigner 和 Sage 100 业务对象构建。
集成采用与 Sage 合作伙伴解决方案相同的路径：从 Sage 100 的 SQL Server 数据库读取 Fertigungsaufträge、Arbeitsgänge、Arbeitsplätze、Ressourcenlisten、Artikel 和 Bestellungen。Arbeitsgang 的日期和 Rückmeldungen 则通过写入路径回传；该路径由您的 Sage 合作伙伴与 SkyPlanner 团队在范围评估时确定，确保数据记入遵循 Sage 100 自身的逻辑。您的 Sage 合作伙伴负责确认版本（例如 9.0）和访问配置。
身份验证与访问
| 系统端 | 身份验证方式 |
|---|---|
| 美国版 Sage 100，BOI | 通过 Sage 100 服务器上的 Sage 100 用户会话访问，用户角色须具有所用各项任务的权限 |
| 美国版 Sage 100，ODBC | 通过 Sage 100 安装环境中的 DSN 访问，具有读取权限 |
| 德国版 Sage 100 | 与您的 Sage 合作伙伴商定用于回写的 Sage 100 用户和 SQL Server 读取权限 |
| SkyPlanner | 在 SkyPlanner 的设置 > API 中创建 API 令牌，并通过 Authorization-Token 请求头传递 |
SkyPlanner 的 REST API 文档采用 Swagger/OpenAPI 格式。集成教程会带您完成最初的 API 调用。
变更检测
通过定时读取获取 Sage 100 中的变更。以较短周期读取未结工单或 Fertigungsaufträge，每小时读取库存和采购订单。按状态和变更日期筛选，确保每次只读取发生变更的数据。
排程发生变化时，SkyPlanner 会发送 webhook，因此向 Sage 100 的回写由事件驱动。
数据映射
| Sage 100（美国版） | Sage 100（德国版） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|---|
| Item | Artikel | 产品和物料 | Sage 100 → SkyPlanner | 首次导入，此后每天同步 |
| Bill of Materials、模板物料 | Ressourcenliste 中的 Stückliste | 产品结构、子产品、各产品所需物料 | Sage 100 → SkyPlanner | 变更时 |
| 工作中心：工人或机器、每周各日的工时、停工时段 | Arbeitsplatz、Ressource（Mitarbeiter、Maschine） | 工作中心、工作中心组、人员、班次 | Sage 100 → SkyPlanner | 首次导入 |
| 工单模板工序、活动代码 | Arbeitsplan、含 Rüst- 和 Stückzeiten 的 Arbeitsgänge | 工序及其准备时间和运行时间 | Sage 100 → SkyPlanner | 变更时 |
| 工单及其工序、交期 | Fertigungsauftrag 及其 Arbeitsgänge、Liefertermin | 订单和生产任务及其交期 | Sage 100 → SkyPlanner | 短周期读取 |
| 各仓库的库存数量 | Lagerbestand | 库存结余 | Sage 100 → SkyPlanner | 每小时 |
| 采购订单行、需求日期 | Bestellungen、Liefertermine | 采购订单及其预计到货日期 | Sage 100 → SkyPlanner | 每小时 |
| 销售订单行、承诺交期 | Kundenaufträge | 客户交期、客户优先级 | Sage 100 → SkyPlanner | 短周期读取 |
| 工单工序日期（BOI） | Arbeitsgang-Termine | 各工序的计划开始时间、结束时间和工作中心 | SkyPlanner → Sage 100 | 变更时，通过 webhook |
| Labor Entry、工单完工（BOI） | Rückmeldung：Zeiten、Mengen | 工时记录和操作员报工 | SkyPlanner → Sage 100 | 每次报工或每个班次 |
| 不在 Sage 100 中保存 | 不在 Sage 100 中保存 | 准备时间矩阵、作为有限资源的工具、各生产任务的操作员、备选工作中心 | 在 SkyPlanner 中维护 | 实施期间 |
集成模式
1. 首次导入主数据。先导入物料和工作中心，再导入模板或 Arbeitspläne 及其工序。美国版中的一个工作中心如果包含三台机器和两名操作员，在 SkyPlanner 中就对应三个工作中心、一个工作中心组和两名人员。随后，每项资源都有各自的时间轴。
2. 订单同步。读取未结工单或 Fertigungsaufträge 及其工序，同时读取库存和未结采购订单。SkyPlanner 在安排生产任务前，会检查现有库存和待到货物。Sage 100 继续提出生产建议，SkyPlanner 则对您下达的订单进行排程。
3. 排程回写。对于引擎安排或调整的每道工序，SkyPlanner 都会发送计划开始时间、结束时间和工作中心。在美国版 Sage 100 中，集成通过 BOI 更新工单工序日期；在德国版 Sage 100 中，则通过范围评估时确定的路径更新 Arbeitsgang 日期。数量、分配和成本核算仍由 Sage 100 管理。
4. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录会使排程保持最新。在美国版 Sage 100 中，记录的工时会生成对应工单工序的 Labor Entry，最终报工则将工单标记为完工。在德国版 Sage 100 中，这些记录会生成包含时间和数量的 Rückmeldung。如果工厂已通过 Betriebsdatenerfassung 或条码应用记录工时，请统一使用一个记录渠道。
5. 数据归属与冲突处理规则。上线前应明确记录以下分工：
| 数据 | 负责管理的系统 |
|---|---|
| 物料、物料清单、模板、订单数量、成本 | Sage 100 |
| 工序顺序、开始和结束时间、工作中心分配 | SkyPlanner |
| 准备时间矩阵、工具、各生产任务的操作人员、替代资源 | SkyPlanner |
| Labor 和 Rückmeldungen | Sage 100，数据来自 SkyPlanner 工时记录 |
冲突主要源于同时使用另一套排程工具。如果计划员继续运行美国版 Sage 100 的 Enhanced Scheduling，或继续在德国版 Sage 100 的 Plantafel 上拖动任务，就会出现两个系统同时管理日期的情况。应由 SkyPlanner 统一管理工序日期。启用 Autopilot 后，生产发生变化时，SkyPlanner 会自动重新排程。
典型项目步骤
实施通常可在实施启动后的数周内完成。在此之前，可将未结工单或 Fertigungsaufträge 导出为 CSV 或 Excel 文件，在 30 天免费试用期间验证排程结果。随后，项目按以下步骤推进：
- 范围评估。确认产品（美国版或德国版 Sage 100）、版本及部署情况、读取和写入方式、同步频率，以及工时登记渠道。
- 访问配置。由您的 Sage 合作伙伴设置 Sage 100 用户、用户权限及数据库访问。
- 首次加载。导入物料、工作中心、模板或 Arbeitspläne、物料清单及班次。
- 订单同步。定时同步工单或 Fertigungsaufträge、采购订单及库存。
- 在 SkyPlanner 中设置约束。配置准备时间矩阵、工具、各生产任务所需的操作人数，以及替代设备或人员。
- 排程回写。将工序的计划日期回写至 Sage 100，随后回写工时及 Rückmeldungen。
- 并行测试与上线。将排程日期与当前计划进行比较，修正主数据，然后启用回写。
Sage 100 集成需要提前考虑什么
- 明确使用的是哪一款 Sage 100。美国版和德国版 Sage 100 的数据模型与接口不同。首次范围评估沟通时，应说明产品及版本。
- 一个工作中心可能包含多台设备。美国版的工作中心是一个产能单位，由“one or more persons or machines”（一名或多名人员，或一台或多台设备）组成。应逐一确定每个工作中心在 SkyPlanner 中对应一个工作中心、多个工作中心，还是一个组。
- 准备时间与加工时间。SkyPlanner 排程所用的时间数据保存在模板和 Arbeitspläne 中。上线前，应与实际加工时间核对。
- 日历。美国版工作中心记录了一周内每天的工作时数及停工时段。将这些数据导入为 SkyPlanner 班次，再在 SkyPlanner 中补充每位操作人员的班次和缺勤情况。
- 计量单位。工序可以按件、按批次或按小时计量。应为每道工序映射相应单位。
- BOI 权限。BOI 遵循 Sage 100 的角色权限控制。缺少某项任务权限就会导致写入失败。应使用集成账户测试每一项写入操作。
- 日期由一个系统统一管理。一旦由 SkyPlanner 管理日期，就应停用其他并行排程，或停止在 Plantafel 中移动任务。
Sage 100 集成由谁配置和支持
- SkyPlanner 团队在实施阶段完成配置，并在上线后提供支持。
- 您的 Sage 合作伙伴也可以参与。合作伙伴了解您的 Sage 100 版本，负责设置用户和权限，并确认数据库访问。
- 您自己的开发人员也可以在此基础上开发，使用 SkyPlanner 文档中说明的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。
连接完成后，Arcturus 引擎会根据 Sage 100 的实时订单排程，为每道工序确定计划日期。SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，提前提供集成报价及套餐费用，让您在开始前了解全部成本。您可以查看价格和功能，并通过 Sage 100 生产排程了解它与 Sage 100 自带计划功能的对比。概览请见 Sage 100 页面。Sage 200 和 Sage X3 的专属指南分别位于 Sage 200 和 Sage X3 页面，其他 ERP 请参阅 ERP 集成中心。
制造企业对 SkyPlanner 的评价
6 个月销售团队可提前查看的可用产能
“SkyPlanner 为所有生产计划工作奠定了基础，也提供了可靠保障。”
Anu Järvinen，生产经理
Fredman Operations · 符合食品安全要求的包装纸
销售团队可以提前六个月查看可用产能。过去需要一小时甚至更久才能回复的排程变更请求，现在几秒钟就能答复。
100%自 2021 年以来的准时交付率
“SkyPlanner 让我们清楚掌握产能，也让计划工作变得可预测。”
Dan Berglund，COO/CFO
Opes Corporation · 化工与食品制造
自 2021 年开始使用 SkyPlanner 以来，准时交付率始终保持在 100%。
常见问题
Sage 100 是否提供用于工单的 REST API？
美国版 Sage 100 通过 Business Object Interface 开放业务逻辑，使用 ODBC 读取数据，并通过 Visual Integrator 处理文件作业。SkyPlanner 通过 ODBC 和 BOI 读取工单，通过 BOI 写入工序日期和工时。德国版 Sage 100 的数据从其 SQL Server 数据库读取，回写方式则在范围评估时与您的 Sage 合作伙伴确定。
谁负责构建 Sage 100 集成？
SkyPlanner 团队会在导入阶段，根据您的 Sage 100 环境配置双向集成，并在上线后提供支持。您的 Sage 合作伙伴负责设置用户、权限及数据库访问，也可以参与集成工作。您自己的开发人员同样可以使用 SkyPlanner 文档中说明的 REST API 进行开发，只需一个 API 令牌即可开始。
计划日期如何回写至 Sage 100？
在美国版 Sage 100 中，集成通过 BOI 更新每张工单中各道工序的计划日期，并根据操作人员的工时记录提交 Labor Entry。在德国版 Sage 100 中，集成更新每个 Fertigungsauftrag 的 Arbeitsgang 日期，并通过您的 Sage 合作伙伴与 SkyPlanner 团队在范围评估时确定的写入方式登记 Rückmeldungen。
Sage 100 能实时推送变更吗？
SkyPlanner 通过定时读取获取 Sage 100 的变更：以较短周期读取未结订单，每小时读取库存和采购订单。反向传输时，SkyPlanner 的 webhooks 会在排程发生变化时即时推送。
