SkyPlanner 团队会在上线准备期间，根据您的 SYSPRO 环境配置集成，并在上线后提供支持。本指南面向希望参与集成，或自行基于 SkyPlanner 已有文档的 REST API（API 参考文档）开展开发的合作伙伴和开发人员。
SYSPRO 的集成接口
SYSPRO 为外部排程系统提供两种数据访问途径：
- e.net Solutions Business Objects。外部系统可通过它调用 SYSPRO 业务逻辑，输入和输出均为 XML。业务对象分为三类：Query（例如 WIPQBL，即 WIP Balance Query）、Transaction 或 Post（例如 WIPTJB，即 WIP Job Creation and Maintenance），以及用于主数据的 Setup。业务对象执行与 SYSPRO 界面相同的校验，并在不同版本间保持兼容。SYSPRO 的最佳实践指南明确指出：”SYSPRO’s Business Objects are used to query and post data to SYSPRO.”（SYSPRO 业务对象用于查询 SYSPRO 数据及向其提交数据。）
- SYSPRO OData Service (OData v4)。通过 RESTful 方式只读访问公司数据库、系统数据库及 Business Activity Queries，后者是在 SYSPRO 中定义的 SQL 视图。该服务从 SYSPRO 8 2021 R2 起提供。在 SYSPRO Cloud ERP 中，”Syspro OData is the only mechanism available when applications need access to SYSPRO data.”（应用程序需要访问 SYSPRO 数据时，Syspro OData 是唯一可用的机制。）
业务对象通过 e.net Communications 服务调用，使用的是 SYSPRO WCF Service 或 SYSPRO Web Service。
Master Data Take On (IMPIMP) 通过 Setup 业务对象导入电子表格，适合一次性导入主数据。SYSPRO Harmony 将于 2026 年 12 月 31 日终止支持，因此不要再基于它开发新功能。
身份验证与许可
- e.net 登录。集成程序以 SYSPRO Operator 身份登录指定公司，获取用于后续调用的会话 GUID。
- 许可。您的 SYSPRO 许可必须涵盖该操作员调用的业务对象功能域。
- OData。使用已配置 OData 访问权限的操作员账号，通过 HTTPS 访问。
在 SkyPlanner 端，REST API 使用 API 令牌进行身份验证（SkyPlanner Settings > API），并提供 Swagger/OpenAPI 文档。集成教程会带您完成最初几次调用。
事件与轮询
SYSPRO 不向外发送 webhook。Electronic Signature Transaction Setup 可以在事务成功时触发邮件发送或 VBScript 等操作。但 SYSPRO 明确指出：”It is not intended that triggers from e.net Business Objects fire VBScript triggers.”（e.net Business Objects 的触发器并非设计用于触发 VBScript 触发器。）
因此，需要对 SYSPRO 端进行轮询。通过业务对象查询或 OData 请求，筛选未结工单和近期变更，获取新增工单。轮询频率按工厂设置，从每隔几分钟读取工单到每小时读取库存不等。
SkyPlanner 会在状态或排程发生变化时发送 webhook，因此回写端采用事件驱动方式。
数据映射
| SYSPRO 对象（接口） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| Stock Codes、计量单位（OData 或 Query 业务对象） | 产品与物料 | SYSPRO → SkyPlanner | 首次导入，之后轮询 |
| Structures（组件、名义件、联产品） | 产品结构、子产品及各产品所需物料 | SYSPRO → SkyPlanner | 首次加载，之后在变更时同步 |
| Routings：工作中心、准备时间、运行时间、排队时间、转运时间、Maximum units | 工序及其持续时间、准备时间和收尾时间 | SYSPRO → SkyPlanner | 首次加载，之后在变更时同步 |
| Work Centers（生产单元、产能）和 Machines | 工作中心、工作中心组、效率 | SYSPRO → SkyPlanner | 首次导入，之后很少更新 |
| Capacity Calendar、Shift Patterns | 班次和非工作日 | SYSPRO → SkyPlanner | 每天同步，或在 SkyPlanner 中自行维护班次 |
| 工单及子工单（WipMaster）、工单工序、工单物料 | 订单和生产任务，含交期及物料需求 | SYSPRO → SkyPlanner | 每隔几分钟轮询 |
| 各 Stock Code 的仓库现有库存 | 库存结余 | SYSPRO → SkyPlanner | 每小时或每次运行排程时轮询 |
| 采购订单及其交期 | 采购订单、按交货日期确定的待到货物料 | SYSPRO → SkyPlanner | 每小时或每次运行排程时轮询 |
| 工单计划开始日期和完成日期（WIPTJB，WIP Job Creation and Maintenance） | 各生产任务的计划开始和结束时间 | SkyPlanner → SYSPRO | 排程变更时，通过 SkyPlanner webhook 回写 |
| Labor Posting：按工单工序、机器、员工记录的准备时间和运行时间 | 工时记录和操作员报工 | SkyPlanner → SYSPRO | 如选择回写，则每次报工或每班次回写 |
| Job Receipts（WIP Job Receipts 业务对象） | 完工数量 | SkyPlanner → SYSPRO | 如选择回写，则每次报工时回写 |
| SYSPRO 中无对应数据 | 换型时间矩阵、作为有限资源的工具、可替代的机器和人员 | 在 SkyPlanner 中维护 | 上线准备期间配置 |
集成模式
1. 首次导入主数据。通过 OData 或 Query 业务对象读取 Stock Codes、Structures and Routings、工作中心、机器和日历。工作中心如何映射到 SkyPlanner，需要明确规划：一个拥有四台机器的工作中心，可以映射为一个工作中心组，也可以映射为四个工作中心。
2. 工单同步。读取正式工单及其工序和物料，同时读取未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期当天可用，并在采购订单标记为 Delivered 时更新库存。
只对正式工单进行排程。建议工单保留在 MRP 快照中，直到 MRP Job Review 将其转为正式工单。
3. 排程回写。引擎安排或移动生产任务时，SkyPlanner webhook 会触发向 WIP Job Creation and Maintenance 业务对象（WIPTJB）提交数据，设置工单的计划开始日期和完成日期。该业务对象对变更的校验方式与 Job Entry 完全相同。
4. 车间报工。操作员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录生产工作，工时记录会让排程保持更新。实际工时是否回写 SYSPRO，由您决定。如果回写，准备时间和运行时间会按工单工序提交到 Labor Posting，完工数量则提交到 Job Receipts。如果不回写，仍按原有方式在 SYSPRO 中录入人工报工数据。
5. 数据归属与冲突处理规则。 上线前应将这些规则书面确定：
| 数据 | 负责维护的系统 |
|---|---|
| Stock Codes、Structures and Routings、数量、工单状态 | SYSPRO |
| 工序顺序、开始和完成时间、机器分配 | SkyPlanner |
| 换型时间矩阵、工具和操作员需求、替代资源 | SkyPlanner |
| 班次和非工作日 | 由一个系统维护，在范围评估时确定 |
| 人工报工、物料发料和入库 | SYSPRO，可直接录入，也可从 SkyPlanner 工时记录提交 |
工单日期只能由一个系统写入。SkyPlanner 不需要 SYSPRO 的排程模块，因此会取代 Factory Scheduling、Visual APS 或 APS (Nexsys)，负责写入计划日期。如果其中某个模块仍在更新计划日期，请针对由 SkyPlanner 排程的工单关闭该功能。在 Factory Scheduling 中，对应的 Job Entry 选项为 “Update planned dates to scheduled dates.”（将计划日期更新为排程日期。）
典型项目步骤
实施通常可在上线准备启动后的数周内完成。在此之前，您可以将 SYSPRO 中的工作中心、工艺路线和未结工单导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 映射。确定映射表、数据归属规则、同步频率，以及是否回写人工报工数据。
- SYSPRO 访问。创建集成专用操作员账号，确认业务对象许可，并在需要时启用 OData。先在公司数据副本中测试。
- 首次导入。导入 Stock Codes、Structures and Routings、工作中心、机器和日历。
- 工单与采购订单同步。采用带筛选、分页和重试机制的轮询。
- 在 SkyPlanner 中配置约束。设置换型时间矩阵、工具、各生产任务所需的操作员人数，以及可替代的机器或人员。
- 排程回写。由 SkyPlanner webhook 触发 WIPTJB 数据提交；如选择回写人工报工数据，也一并配置。
- 并行测试。让 SkyPlanner 与现有计划并行运行，对比日期并修正主数据。
- 上线。 数据核对一致后，启用回写。
SYSPRO 集成中需要提前考虑的问题
- _TMP 工单。在 Job Entry 中进行有限产能试算时，可能会在 WipMaster 中创建 _TMP 工单。每次读取时都要将其过滤掉。
- 已开工工序。如果已开工工序无法排入，Forward Finite Scheduling 会报错。每次运行排程前，都应将工序进度读入 SkyPlanner，让排程以已完成的工作为基础。随后，Running Time Lock 会锁定接下来数小时的生产任务。
- 工艺路线的时间单位。准备时间、运行时间、排队时间和转运时间都需要使用正确的单位和计算基准。排队和转运属于等待时间，不是机器占用时间。导入时必须进行换算，否则所有时长都会出错。
- 外协工序。Offsite Days 和 Dock to Stock Days 表示经过的时间，并非本厂产能。应将其建模为只计时间、不占用产能的工序。
谁负责配置和支持 SYSPRO 集成
- SkyPlanner 团队在实施阶段负责配置，并在上线后提供支持，服务范围涵盖双方约定的业务对象和 OData 查询。每家工厂使用 SYSPRO 的方式都不同，配置集成时需要运用对这些具体使用方式的了解。
- 您的 SYSPRO 合作伙伴也可以参与。合作伙伴了解您的系统配置、自定义表单和许可情况，可以与 SkyPlanner 团队一起设置操作员及 OData 访问权限。
- 您的开发人员可以在此基础上继续开发，使用 API 令牌调用 SkyPlanner 的 REST API。有 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。我们会根据您的流程和需求，在您选择订阅方案时一并提前提供集成报价。请参阅价格、SYSPRO 生产排程、SYSPRO 页面和 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划摆脱了 Excel 电子表格，实现了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电盘与开关设备
每周用于生产计划的工作时间减少了 2 小时，新的任务队列只需几秒即可下达到产线。
+90%生产效率提升幅度
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 药品制造
生产效率提高了 90%，为所有工作中心制定覆盖三个月的优化计划，用时不到 30 分钟。
98%准时交付率，原为约 50%
“SkyPlanner 对维持我们的准时交付率起着决定性作用。”
Hannu Lahtinen，总经理
KJH-Comp · 钣金加工与合同制造
准时交付率从约 50% 提升至最高 98%，排程工作现在只需一名主管，而原来需要两名。
99.2%准时交付率
“SkyPlanner 让生产瓶颈清晰可见，也让生产管理更加清晰。”
Toni Tuori，生产经理
Piristeel · 屋面安全设施与雨水系统
今年准时交付率达到了 99.2%，每天用于排程的工作时间最多可节省四小时。
常见问题
SYSPRO 是否提供用于生产任务的 API？
是的。e.net Solutions Business Objects 可查询和提交 SYSPRO 数据，其中 WIPTJB 用于创建和维护生产任务。SYSPRO OData 服务还提供 RESTful 只读访问，可读取数据表和 Business Activity Queries。
SYSPRO 是否支持 webhook？
不提供出站 webhook。Electronic Signature Transaction Setup 中的触发器并非设计为由业务对象调用来触发，因此集成会按各工厂设定的时间间隔轮询 SYSPRO。SkyPlanner 自身的 webhook 则会在排程发生变化时即时推送。
如何将计划日期回写到 SYSPRO？
通过 WIP Job Creation and Maintenance 业务对象（WIPTJB）设置生产任务的计划开始和结束日期。SYSPRO 使用与 Job Entry 相同的规则验证提交的数据。
该集成是否适用于 SYSPRO Cloud ERP？
是的。SkyPlanner 通过 SYSPRO OData 服务读取 Cloud ERP 数据，SYSPRO 将该服务指定为此环境中唯一的数据访问途径。在范围评估阶段，SkyPlanner 团队会与您及您的 SYSPRO 合作伙伴一起设置回写途径。
SYSPRO 合作伙伴应该推荐 SYSPRO MOM Visual APS 还是 SkyPlanner？
如果客户希望在几周内获得一份可执行、符合实际产能约束的生产排程，应选择 SkyPlanner。Visual APS 随 SYSPRO MOM 套件提供，需单独许可，并依托 SYSPRO SQL Server 安装；MOM Workbench 用户还需要席位许可（SYSPRO 帮助）。SkyPlanner 通过 e.net Business Objects 和 OData 连接，可自动重新排程，并统筹安排换型、工具、班组和物料，用户数量不限，每月 199 € 起。
