系统集成 / ERP / Infor CloudSuite Industrial
Infor CloudSuite Industrial 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向 Infor CloudSuite Industrial（CSI，原名 SyteLine）的合作伙伴和 IT 团队，介绍如何将 CSI 连接至 SkyPlanner APS。SkyPlanner 通过 Infor OS 与 CSI 实现双向集成：
- 导入生产任务、工序、资源、库存和采购订单。
- 将工序的计划日期回写至 CSI 中的生产任务。
- 将操作员工时以生产任务事务记录的形式回传，由 CSI 过账。
- 排程发生变化时，SkyPlanner webhook 会即时推送。
SkyPlanner 团队会在实施导入期间，根据您的 CSI 配置完成集成，并在上线后提供支持。本指南供希望参与集成，或自行参照 SkyPlanner 的 REST API 文档进行开发的合作伙伴和开发人员使用。
所有 CSI 集成都需考虑的基本条件
SkyPlanner 在云端运行，无需在 CSI 内安装任何 SkyPlanner 软件。在多租户 CSI 环境中，集成通过 Infor OS 进行，可采用以下两种方式之一：
- 通过 ION API Gateway 调用 Mongoose IDO REST API。CSI 的业务对象是基于 Mongoose 框架的 IDO（智能数据对象）。REST 服务位于
IDORequestService下，由 Infor 发布到 ION API 存储库中。REST 版本 1 提供LoadCollection、AddItem(s)、UpdateItem(s)、DeleteItem(s)、InvokeMethod、IDOInfo和FireAESEvent，响应格式为 XML 或 JSON。此外还有一组 REST 版本 2 端点。 - ION BOD（业务对象文档），由 ION 通过连接点路由。CSI 对外发布
SyncBOD，涵盖ProductionOrder、ItemMaster和PurchaseOrder，还发布InventoryAdjustment、InventoryCount和InventoryHold等库存文档。
2026.10 版本的出站 BOD 列表不包含物料清单、工艺路线或工作中心，因此排程集成以 IDO 为主，BOD 可作为生产任务变更通知的可选方式。
身份验证与许可
通过网关访问时，CSI 使用 ION API 签发的 OAuth 2.0 bearer 令牌：
- 在 ION API 中创建 Backend Service 应用，并下载其
.ionapi文件。该文件包含客户端凭据和服务账户密钥（saak、sask）。缺少这些信息，令牌请求就会失败。 - 每次通过 ION 发起调用时，都要发送
X-Infor-MongooseConfig请求头，用于指定目标 CSI 配置（站点）。 - 为每个环境分别保管
.ionapi文件。生产环境的文件无法用于沙箱租户的身份验证。
本地部署的 SyteLine 采用相同的 IDO 模式。Mongoose 文档说明，可以使用 GetSecurityToken 获取的安全令牌直接调用 IDO REST API，无需经过 ION API Gateway。
通过 IDO 层连接的外部应用需要使用 Automation 许可模块，该模块的会话类型始终为 IDO。Infor 自有应用（如 APS）不需要额外的此类许可。SkyPlanner 连接需要一个此类许可，以及您租户中的 ION API 访问权限。
在 SkyPlanner 端，REST API 可读写订单、产品、物料、工艺步骤、采购订单和工时记录。该 API 使用 JWT 身份验证，并提供 Swagger/OpenAPI 文档（API 参考）；另请参阅 SkyPlanner 文档。
变更检测：BOD 触发器、AES 与轮询
CSI 以 ION BOD 的形式向外发送变更，其中与排程相关的是 ProductionOrder BOD。在 Replication Document Outbound Cross References 表单中，通过发布定义进行配置：
| 触发器 | 发布内容 |
|---|---|
TriggerProductionOrderSyncSp | 所有生产订单，仅支持前台运行 |
TriggerProductionOrderBGSyncSp | 刚完成排程的订单，可作为后台任务运行 |
TriggerProductionOrderBGSchSyncSp | 发生变更的生产订单，可作为后台任务运行 |
Infor 的示例按工单状态筛选：排程变更使用 'Firm'；物料和人工变更还可选择使用 'Released'。示例还会筛选 RecordDate 晚于该后台任务上次手动发布日期的记录。
Mongoose 的 Application Event System (AES) 也能执行事件操作，REST API 则提供了 FireAESEvent。基本方式是 IDO 轮询：每隔几分钟调用 LoadCollection，读取 SLJobs 和 SLJobRoutes 中按记录日期筛选的数据。如果站点需要推送变更，再加入 ProductionOrder BOD。
在反向数据流中，SkyPlanner webhook 会在排程发生变化时即时推送，每次推送都会触发向 CSI 的回写。
数据映射
以下名称均为标准 IDO。扩展 IDO 的租户仍使用相同的对象，只是增加了属性；SkyPlanner 团队会在实施导入期间完成这些属性的映射。
| CSI 对象（IDO / BOD / 表单） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
物料（SLItems）、Sync ItemMaster BOD | 产品和物料 | CSI → SkyPlanner | 首次加载，之后通过 BOD 或每日增量同步 |
物料工艺路线（SLItemRoutes） | 工序及其准备时间和运行时间 | CSI → SkyPlanner | 首次加载，之后在变更时同步 |
| 准备资源组和准备时间查找表 | 准备时间矩阵（产品间的换型时间取决于加工顺序） | CSI → SkyPlanner，之后由 SkyPlanner 管理 | 首次加载 |
物料 BOM、工单用料（SLJobmatls） | 产品结构、子产品、各生产任务的物料需求 | CSI → SkyPlanner | 首次加载，之后随每个工单同步 |
| 资源组和资源（含成员顺序） | 工作中心组、工作中心、替代工作中心 | CSI → SkyPlanner | 首次加载，之后很少同步 |
| 各工序的工装和班组人数 | 作为数量有限的共享资源的工装、各工作中心的操作员人数 | 在 SkyPlanner 中维护 | 在实施导入期间设置 |
工作中心（SLWcs） | 不作为排程对象，仅保留作成本参考 | CSI → SkyPlanner | 可选 |
| 班次与节假日 | 班次和缺勤 | CSI → SkyPlanner | 每周同步，或由 SkyPlanner 管理 |
工单（SLJobs）、Sync ProductionOrder BOD | 订单及其交期和优先级 | CSI → SkyPlanner | BOD 触发或每隔几分钟轮询 |
工单工序（SLJobRoutes） | 各工序的生产任务及资源组 | CSI → SkyPlanner | 随每个工单同步 |
客户订单行（SLCoItems）、客户（SLCustomers） | 客户交期和客户优先级 | CSI → SkyPlanner | 轮询 |
| 物料仓库库存、库存 BOD | 库存（结存数量） | CSI → SkyPlanner | 每小时或每次排程前 |
采购订单（未结采购订单行）、Sync PurchaseOrder BOD | 采购订单、待到货物料及预计交付日期 | CSI → SkyPlanner | 每小时或收到 BOD 时同步，并在每次排程前同步 |
工单工序排程（各工序的开始和结束时间）及 SLJobs 上的工单 Start 和 End 日期，通过 UpdateItems 更新 | 各工序的计划开始和结束时间 | SkyPlanner → CSI | 每次排程变更时，由 SkyPlanner webhook 触发 |
未过账工单事务（SLJobtrans，通过 AddItems 创建）、员工（SLEmployees）、原因（SLReasons） | 工时记录、良品和报废数量、原因代码 | SkyPlanner → CSI | 每次报工时 |
集成模式
1. 首次加载主数据。通过 LoadCollection 读取物料、物料工艺路线、BOM、资源组、资源和班次。用资源和资源组建立 SkyPlanner 工作中心，而不是用 CSI 的工作中心。Infor 明确指出，工作中心 “captures costs only and does not affect the actual planning or scheduling.”（仅记录成本，不影响实际的计划或排程。）
2. 订单同步。发送已确认和已下达的生产工单，以及对应的工序和物料。APS 计划订单应保留在 CSI 中。APS Planning 每次运行都会删除并重新生成计划，因此计划订单没有可供排程使用的稳定标识。请先在 Planning Detail 中将其确认转换为生产工单。
3. 排程回写。由 SkyPlanner 排程 webhook 触发写入。集成程序从 SkyPlanner REST API 读取各工序最新的计划开始和结束时间，再以工单、后缀和工序号为键，通过 UpdateItems 写入工单工序排程。这些工序日期与 Scheduler 设置、Resource Gantt 编辑的是同一组日期，SLJobs 上的工单 Start 和 End 日期也会随之更新。
有些站点会保护排程字段，或要求每次变更都执行 CSI 端逻辑。这种情况下，通过 InvokeMethod 调用自定义 IDO 方法来写入，在执行相同更新的同时使用 CSI 自身的校验逻辑。
4. 车间报工。操作员通过手机或平板记录工时和数量（Mobile Confirmations、Production Timer、Quick Log Mode）。每条已结束的工时记录都对应一条未过账的 SLJobtrans 记录，通过 AddItems 创建，包含工单、后缀、工序、员工、工时以及良品和报废数量。随后，CSI 的 Job Labor Transaction Posting 按您选择的频率，将人工成本和制造费用过账到工单在制品成本中。
5. 数据管理归属、重试与冲突规则。
每条记录都以 CSI 自身的标识符（生产任务、后缀、工序号、事务 ID）为键，因此重复的 webhook 或轮询只会更新同一行，不会创建重复记录。写入失败时会重试，并记录 CSI 返回的错误文本。在 CSI 中设为 Complete 或 History 的生产任务，会在下次同步时从 SkyPlanner 排程中移除；已在 SkyPlanner 中取消的生产任务绝不会回写。
| 数据 | 管理归属 |
|---|---|
| 物料、工艺路线、物料清单、数量、生产任务状态、成本核算 | CSI |
| 工序顺序、开始与结束时间、资源分配 | SkyPlanner |
| 长期物料计划、Get CTP/ATP | CSI APS（如已获得许可） |
| 班次与节假日 | 由一个系统管理，在范围评估时确定 |
| 工时与产量 | 从 SkyPlanner 工时记录写入 CSI |
CSI 原生排程工具是冲突的主要来源。APS Planning 会将已排程的工序视为冻结，但随后运行的 Scheduler（通常每天运行一次，排程范围为一天）可能再次移动这些工序。当一组资源组的详细排序由 SkyPlanner 负责时，应将这些资源组排除在 CSI Scheduler 的处理范围之外。然后，在 Shop Floor Control Parameters 中关闭让 Scheduler 将计划订单视为需求的设置。MRP、APS 订单计划和 Get CTP 可以继续留在 CSI 中。SkyPlanner 的 Running Time Lock 可固定已开始的工序。在 SkyPlanner 内，生产发生变化时，Autopilot 会在您设定的锁定范围和优先级内自动重新排程。
典型项目步骤
实施通常可在导入启动后的数周内完成，大型企业也不例外。CSI 项目包含以下步骤：
- 使用导出数据试用。在 CSI 的生产任务、工序和资源列表中使用 Save to Excel，将文件转换为 CSV 后导入 SkyPlanner。先验证排程，再开展接口工作。
- 范围评估与主数据映射。确定映射表、各字段由哪个系统负责、同步频率、过账渠道，以及如何缩小原生 Scheduler 的处理范围。
- 配置 Infor OS。配置 Backend Service 应用、各租户的
.ionapi文件、Automation 许可证及 IDO REST 访问权限。部分租户需要单独启用 IDO REST，因此项目一开始就应向 Infor Cloud 支持团队申请开通。 - 首次加载。通过
LoadCollection加载物料、BOM、物料工艺路线、资源、资源组和班次，并在 SkyPlanner 中设置准备时间矩阵、工装和班组人数。 - 同步工单和采购订单。先通过 IDO 轮询同步工单、工序、物料和未结采购订单，再按需加入
ProductionOrderBOD 触发器。 - 与现行计划并行测试。将 SkyPlanner 与现有派工清单并行运行，修正工艺路线中的工时和资源数据。
- 排程回写和车间报工。确认日期和数据一致后，启用排程回写和
SLJobtrans人工记录写入。 - 为 SkyPlanner 负责的资源组正式上线。
CSI 集成常见问题
- 将工作中心映射为机器。
SLWcs看起来是最直接的 IDO 选择，却不适合用于产能建模。排程依据的是资源和资源组（含成员顺序）。 - BOD 筛选导致工单遗漏或重复。
ProductionOrder的发布取决于所选触发器和状态筛选条件。只筛选'Firm'会漏掉已下达工单的物料和人工变更；缺少上次发布日期筛选条件，则会重新发送全部记录。 - 工时回写被拒绝。生产任务状态不是 Released 或 Scheduled、工序已完成，或员工处于停用状态时，CSI 会拒绝工时记录。应先验证，并记录被拒绝的情况。
- 误以为写入记录就等于完成过账。在 Job Labor Transaction Posting 运行之前，
SLJobtrans记录始终处于未过账状态。与财务部门共同确定过账频率，确保在制品核算和薪资核算能按预期时间获取人工数据。 - APS 中的逾期生产任务。APS 从交期向前倒排；如果无法排入，则从今天起正向排程，绝不会排到过去的日期。对于逾期订单，应让 SkyPlanner 根据实际产能排程，而不是直接采用传入的开始日期。
- Mongoose 的细节。将
InvokeMethod参数值中的逗号转义为\x2c。
谁负责配置 CloudSuite Industrial 集成
- SkyPlanner 团队在实施导入期间完成配置，并在上线后提供支持。工作涵盖 SkyPlanner 端以及 IDO 和 BOD 接口，并根据您的租户配置进行映射。当资源组、IDO 扩展或生产任务状态发生变化时，团队会维护相应配置。各工厂使用 CSI 的方式不同，而处理这些映射正是团队的专长。
- 您的 Infor 合作伙伴可以参与。合作伙伴了解您的 IDO 扩展和 ION 配置，可依据 SkyPlanner 的 Swagger/OpenAPI 文档开展工作，并订阅其 webhook。
- 您自己的开发人员也可以在此基础上开发，使用同一套通过 JWT 验证的 REST API。只需一个 SkyPlanner API 密钥即可开始（参阅集成教程），SkyPlanner 团队会在需要时提供帮助。
为什么 CSI 团队选择引入 SkyPlanner，而不是继续调整批处理排程
SkyPlanner 尽量减少 CSI 端的工作量。它读取工单、工序、物料和资源，只回写两类数据：工序计划时间和 SLJobtrans 人工记录。在读写之间，它完成重新排程；而在 CSI 中，这些工作依赖计划员在 Resource Gantt 中手动编辑，以及下一次 Scheduler 运行：
- 事件驱动排程。Arcturus 可在数秒内生成符合机器和人员实际产能约束的生产排程；无论是 CSI 传来生产任务变更，还是操作员记录了进度，Autopilot 都会在生产发生变化时自动重新排程。随后，webhook 会将新的时间推送出去。
- 在现场采集人工数据。Mobile Confirmations、Production Timer 和 Quick Log Mode 将操作员输入转为工时记录，并映射到
SLJobtrans记录，让人工数据无需重复录入即可进入 CSI。 - 约束贴合车间实际。准备时间矩阵可选出准备耗时最少的换型顺序。工具作为数量有限的共享资源参与排程，多名操作员可以同时在一个工作中心作业；主要设备或人员繁忙时，替代设备和人员可接手。
- 按物料可用情况排序。接入生产任务所需物料、库存和 CSI 未结采购订单后，即可在排程中检查物料可用性。已订购的物料从采购订单交货日期起视为可用；采购订单标记为 Delivered 时，库存随之更新。
- 通过试用降低项目风险。将 Save to Excel 导出的数据载入 30 天试用环境，查看自己的生产任务如何在机器和人员实际产能约束下进行生产排程。试着让瓶颈资源停机、插入加急订单、推迟采购订单交货。在试用中验证的映射，将用于确定 IDO 接口工作的范围。
如果物料、生产任务和成本仍需以 CSI 为权威记录系统，就选择 SkyPlanner。您将获得排程工具和车间应用，集成接口精简清晰：输入生产任务和主数据，输出计划时间和工时。SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费，可随时取消。集成费用会根据您的流程和需求，与订阅方案一并提前报价，让您在开始前了解全部成本。
查看价格、功能和 SkyPlanner 文档。阅读 Infor CloudSuite Industrial 生产排程，对比 CSI APS、Scheduler 与云端排程工具。也可访问 Infor CloudSuite Industrial 页面和 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%，排程工作也从原先需要两名主管变为只需一名。
6 个月内的可用产能，销售团队均可查看
“SkyPlanner 为所有生产计划奠定了基础，并提供了可靠保障。”
Anu Järvinen，生产经理
Fredman Operations · 食品级包装纸
销售团队可以提前查看未来六个月的可用产能。排程变更请求过去要一个小时甚至更久才能得到答复，现在只需几秒。
常见问题
谁负责开发与 CloudSuite Industrial 或 SyteLine 的集成？
在实施阶段，SkyPlanner 团队会根据您的 CSI 配置，通过 IDO REST API 和 ION BODs 配置双向集成，并在上线后提供支持。您的 Infor 合作伙伴或内部开发人员也可以参照 SkyPlanner 的 REST API 文档进行开发，只需一个 API 密钥。试用期间，可以先使用导出的 CSV 或 Excel 文件。
与 CSI 进行排程集成时，应使用哪个 API？
使用通过 ION API Gateway 调用的 Mongoose IDO REST API，并凭借 Backend Service 的 .ionapi 文件进行 OAuth 2.0 身份验证。如果轮询速度不够快，可加入 ProductionOrder BOD 来检测工单变更。
计划日期和工时如何回写到 CSI？
通过 IDO UpdateItems，将工序的计划开始和结束时间回写到工单工序排程，同时更新 SLJobs 上的工单 Start 和 End 日期。如果站点保护这些字段，则通过 InvokeMethod 调用自定义 IDO 方法。人工数据通过 AddItems 写入为未过账的 SLJobtrans 记录，再由 Job Labor Transaction Posting 过账到在制品成本中。
连接外部排程系统是否需要额外的 Infor 许可证？
需要，须有 Automation 许可证。Infor 的许可文档说明，通过 IDO 层连接的外部应用程序会使用一个此类许可证，会话类型为 IDO。
能否在保留 CSI APS 的同时引入 SkyPlanner？
可以。CSI APS 继续负责物料计划和 Get CTP/ATP，SkyPlanner 则负责您交由其管理的资源组的生产排序。
CSI 集成项目需要多长时间？
实施通常在导入工作启动后的数周内完成。项目依次完成数据映射、首次加载、工单和采购订单同步、排程回写、SLJobtrans 报工、并行运行和上线。
