Cegid 集成指南：使用 SkyPlanner APS 进行生产排程
本指南面向合作伙伴和 IT 团队，介绍如何将 Cegid 制造业 ERP 与 SkyPlanner APS 连接。首先介绍 Cegid PMI，然后是 Cegid Primavera 和 Cegid Ekon。SkyPlanner 通过 Cegid 自身的接口实现双向集成：
- 从 Cegid 导入生产订单 OF（ordres de fabrication、ordens de fabrico、órdenes de fabricación）及其工序、工艺路线、物料清单、工作中心和机器，以及物料、库存和供应商订单。
- 将计划开始和结束日期回写到每个 OF 工序。
- 您也可以选择将操作员工时回写为 pointages（PMI）、Diários de Trabalho（Primavera）或 imputaciones（Ekon）。
Cegid 的集成接口
Cegid PMI. Cegid 为 PMI 提供了 Web API：”Facilitez les échanges sécurisés avec vos applications externes grâce à la mise à disposition de Web API depuis votre gestion de production Cegid.”（通过 Cegid 生产管理系统提供的 Web API，便捷地与外部应用安全交换数据。）借助 Web API，外部应用仍可完整遵循 Manufacturing PMI 的业务规则（Cegid PMI）。PMI 还提供 EDI、用于接收 CAD 技术数据的标准化 XML 文件，以及支持导出 Excel 的报表生成器。准备试用数据时，导出 Excel 是最快的方式。
Cegid Primavera. PRIMAVERA ERP V10 API “allows third party applications to perform both data query and writing operations”（允许第三方应用执行数据查询和写入操作），并覆盖产品的所有模块（V10 API 文档）。Web API 按模块组织，可通过 Swagger 查看文档并调用（Web API Swagger）。Produção (GPR) 模块涵盖技术资料、净需求、OF 下达、Planeamento、生产记录和 Diários de Trabalho（Produção 参考文档）。排程所需的主要服务包括：
- IGprBSOrdensFabrico 读取生产订单及其工序（GprBEOFOperacao）。
- IGprBSPlaneamento 加载 OF 以供规划，并通过 ActualizaPlaneamentoOperacao 更新工序计划。
- IGprBSCentrosTrabalho、IGprBSPostosTrabalho、IGprBSOperadores 和 IGprBSRoteiros 分别读取工作中心、工位、操作员和工艺路线。
- IGprBSDiariosTrabalho 通过 IniciaPicagem 和 TerminaPicagem 记录作业。
Cegid Ekon XRP Industria. Cegid 表示，Ekon 可与企业内的其他管理系统连接（Cegid Ekon）。SkyPlanner 团队会在范围评估阶段确定适合您所部署 Ekon 系统的接口。
身份验证与许可
- Cegid PMI. 在范围评估阶段，我们会与您的 Cegid 合作伙伴一起，为您部署的 PMI 系统启用集成所需的 Web API 访问权限。
- Cegid Primavera. 每个 Web API 实体都提供 Login 方法，返回包含会话密钥的 Bearer 令牌；令牌通过 token 端点续期（Web API Swagger）。集成用户需要具备所调用功能对应的 Produção 许可。
- SkyPlanner 端。 REST API 使用 Authorization-Token 请求头中的 API 令牌进行身份验证（SkyPlanner Settings > API），文档以 Swagger/OpenAPI 形式提供。集成教程将引导您完成首次调用。
事件与轮询
Cegid 端采用轮询方式。查询时筛选未结 OF 和近期变更，以获取新的生产任务。轮询频率按工厂设置：OF 可每几分钟查询一次，库存则可每小时查询一次。
状态或排程发生变化时，SkyPlanner 会发送 webhook，因此回写采用事件驱动方式。
数据映射
| Cegid 对象（PMI / Primavera） | SkyPlanner 对象 | 方向 | 频率 |
|---|---|---|---|
| 物料（Articles / artigos） | 产品与物料 | Cegid → SkyPlanner | 首次加载，之后轮询 |
| 物料清单 / 技术资料、组件（Nomenclatures / fichas técnicas, componentes） | 产品结构、子产品、各产品所需物料 | Cegid → SkyPlanner | 首次加载，之后在变更时同步 |
| 工艺路线与工序（Gammes / roteiros, operações） | 工序及其加工、准备和收尾时间 | Cegid → SkyPlanner | 首次加载，之后在变更时同步 |
| 工作中心和机器 / 工作中心、工位（Postes de charge / centros de trabalho, postos de trabalho） | 工作中心、工作中心组、效率 | Cegid → SkyPlanner | 首次加载，之后很少同步 |
| 员工 / 操作员（Salariés / operadores） | 人员 | Cegid → SkyPlanner | 首次加载，之后在变更时同步 |
| 日历 / 产能例外（exceções de capacidade） | 班次与非工作日 | Cegid → SkyPlanner | 每天同步，或在 SkyPlanner 中单独维护班次 |
| 工具与模具（Primavera 的 Ferramentas e moldes） | 作为有限资源的工具 | Cegid → SkyPlanner | 首次加载，之后在变更时同步 |
| 已确认和计划中的 OF / 生产订单及其工序（ordens de fabrico） | 订单与生产任务，包含交期和物料需求 | Cegid → SkyPlanner | 每几分钟轮询一次 |
| 按物料和仓库划分的库存 | 库存余额 | Cegid → SkyPlanner | 每小时或运行排程时轮询 |
| 供应商订单及交货日期 | 采购订单、按交货日期确定的到货物料 | Cegid → SkyPlanner | 每小时或运行排程时轮询 |
| OF 工序的计划开始和结束时间 / 通过 ActualizaPlaneamentoOperacao 更新 GprBEOFOperacao 的 DataIniPrevista、DataFimPrevista | 各工序的计划开始和结束时间、分配的工作中心 | SkyPlanner → Cegid | 排程变更时，通过 SkyPlanner webhook 同步 |
| 工时记录：Pointages / Diários de Trabalho（IniciaPicagem、TerminaPicagem） | 工时日志与操作员报工 | SkyPlanner → Cegid | 如选择回写，则每次报工或每班次同步 |
| Cegid 中没有 | 换型时间矩阵、作为有限资源的工具（PMI）、替代机器和人员 | 在 SkyPlanner 中维护 | 在上线准备阶段设置 |
集成方式
1. 首次加载主数据。读取物料、物料清单、工艺路线、工作中心、机器、操作员和日历。工作中心的映射需要仔细确定：一个包含四台机器的 poste de charge，应映射为一个工作中心组，组内包含四个工作中心。
2. 同步 OF。读取已确认的 OF 及其工序和组件，以及未结的供应商订单。SkyPlanner 将已订购的物料视为在采购订单交货日期当天可用，并在采购订单标记为 Delivered 时更新库存。在范围评估阶段，需要确定是否也对计划中的 OF（OF prévisionnels）进行排程，还是仅对已确认的 OF 排程。
3. 回写排程。引擎安排或移动生产任务时，SkyPlanner webhook 会触发向 Cegid 写入数据。在 PMI 中，计划开始和结束日期通过 Web API 写入 OF 工序，并遵循 PMI 的业务规则。在 Primavera 中，集成程序调用 IGprBSPlaneamento.ActualizaPlaneamentoOperacao，传入工序、工作中心以及计划开始和结束时间，从而更新生产订单工序上的 DataIniPrevista 和 DataFimPrevista。
4. 车间报工。操作员使用 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时日志使排程保持最新。您可以选择是否将工时回写至 Cegid。如果选择回写，工时将以 PMI 的 pointages 形式写入，或通过 IniciaPicagem 和 TerminaPicagem 写入 Primavera 的 Diários de Trabalho。如果不回写，则仍按原有方式在 Cegid 中通过条码采集工时。
5. 数据归属与冲突处理规则。上线前应将这些规则书面确定下来：
| 数据 | 负责维护的系统 |
|---|---|
| 物料、物料清单、工艺路线、OF 数量与状态 | Cegid |
| 工序顺序、开始和结束时间、机器分配 | SkyPlanner |
| 换型时间矩阵、工具与操作员需求、替代资源 | SkyPlanner |
| 班次与非工作日 | 由一个系统维护，在范围评估阶段确定 |
| 工时、耗用与完工记录 | Cegid，可直接录入，也可由 SkyPlanner 工时日志回写 |
OF 日期只应由一个系统写入。SkyPlanner 将取代 PMI 的计划程序和 Primavera 的计划算法，负责写入计划日期。对于由 SkyPlanner 排程的 OF，应停止运行上述程序和算法，避免相互覆盖。
典型项目步骤
实施通常可在开始上线准备后的数周内完成。在此之前，可先将 Cegid 中的 postes、gammes 和未结 OF 导出为 CSV 或 Excel，在 30 天免费试用期间验证排程。
- 数据映射。确定映射表、数据归属规则、同步频率，以及是否回写工时。
- Cegid 访问权限。创建集成用户，确认生产对象的访问权限和许可。先在测试公司中进行测试。
- 初始数据加载。加载物料、物料清单、工艺路线、工作中心、机器、操作人员和日历。
- 同步 OF 和采购订单。采用轮询方式，并设置筛选、分页和重试。
- 在 SkyPlanner 中设置约束。配置准备时间矩阵、工具、每项生产任务所需的操作人员数量，以及可替代的机器或人员。
- 回写排程。通过 SkyPlanner 的 webhooks 获取工序计划日期并回写；如果选择回写工时，也一并处理。
- 并行测试。将 SkyPlanner 与现有计划并行运行，对比日期，修正主数据。
- 上线。确认数据一致后，启用回写。
Cegid 集成需要提前考虑哪些问题
- 已确认 OF 与计划 OF。PMI 根据 CBN 创建这两类 OF。对计划 OF 进行排程可以查看未来负荷，但日期只能回写到已确认的 OF。
- 标记为不参与计划的工序。Primavera 中的工序可以标记为不参与计划（NaoSujeitaPlaneamento）。回写时应跳过这些工序。
- 机器工时与人工工时。Primavera 为每道工序分别记录机器工时和人工工时。两者都要映射，才能为需要多人操作的生产任务正确配备人员。
- 工序重叠。Primavera 的工序带有重叠系数。应将其映射到 SkyPlanner 的工序时间设置中，否则排程中的等待时间会长于车间实际所需的时间。
- 确认 Cegid ERP 产品。PMI、Primavera 和 Ekon 使用不同的接口。请先确认产品和版本；如果使用 Cegid XRP Flex，请参阅 Acumatica 集成指南。
谁负责 Cegid 集成的配置与支持
- SkyPlanner 团队在导入阶段负责配置，并在上线后提供支持，范围涵盖约定的 Cegid API 调用。每家工厂使用 Cegid 的方式都不同，团队会在这一环节运用相关经验。
- 您的 Cegid 合作伙伴也可以参与。合作伙伴了解您的配置、定制内容和许可情况，可以与 SkyPlanner 团队共同设置集成用户和 API 访问权限。
- 您自己的开发人员也可以在此基础上扩展，使用 API 令牌调用 SkyPlanner 的 REST API。只需一个 API 令牌即可开始，SkyPlanner 团队会在需要时提供协助。集成文档请参阅 SkyPlanner 集成文档。
SkyPlanner 每月 199 € 起，包含 5 个工作中心，按月计费。集成费用会根据您的流程和需求，与订阅方案一并提前报价。请参阅价格、Cegid 生产排程、Cegid 页面和 ERP 集成中心。
制造企业对 SkyPlanner 的评价
2 小时每周节省的时间
“SkyPlanner 让我们的生产计划摆脱了 Excel 电子表格，实现了实时生产优化。”
Kalle Kalliomäki，供应链专员
UTU · 配电柜与开关设备
生产计划工作每周可节省 2 小时，新的任务队列只需几秒即可下达到产线。
+90%生产效率提升
“生产效率提高了 90%。”
Abdul Rucyinga，IT 负责人
Laboratory & Allied · 制药
生产效率提高了 90%，为所有工作中心生成覆盖三个月的优化计划，用时不到 30 分钟。
6 个月销售团队可提前查看的空闲产能
“SkyPlanner 为所有生产计划工作打下基础，提供可靠保障。”
Anu Järvinen，生产经理
Fredman Operations · 食品级包装纸
销售团队可以提前六个月查看空闲产能；过去需要一小时甚至更久才能答复的排程变更请求，如今几秒内就能得到回应。
100%自 2021 年以来的准时交付率
“SkyPlanner 让我们看清产能状况，让计划工作变得可预测。”
Dan Berglund，COO/CFO
Opes Corporation · 化工与食品制造
自 2021 年开始使用 SkyPlanner 以来，准时交付率始终保持在 100%。
常见问题
Cegid PMI 提供 API 吗？
提供。Cegid 为 PMI 提供 Web API，可在不改变 Manufacturing PMI 业务规则的前提下，与外部应用安全交换数据。SkyPlanner 通过该接口读取 OF，并写入计划日期和 pointages。
Cegid Primavera 提供生产订单 API 吗？
提供。PRIMAVERA V10 API 支持所有模块的数据读写。Produção 模块开放了 ordens de fabrico、带有 ActualizaPlaneamentoOperacao 的 Planeamento，以及 Diários de Trabalho。
如何将计划日期回写到 Cegid？
在 PMI 中，通过 Web API 回写到每道 OF 工序。在 Primavera 中，通过 IGprBSPlaneamento.ActualizaPlaneamentoOperacao 设置 ordem de fabrico 工序的计划开始和结束时间。
Cegid 支持 webhooks 吗？
集成按各工厂设定的频率轮询 Cegid。SkyPlanner 自身的 webhooks 会在排程发生变化时即时推送，因此每次重新排程后，日期都会立即传入 Cegid。
Cegid 合作伙伴应该推荐 Cegid 内置计划功能，还是 SkyPlanner？
如果客户的约束不止机器和库存，应推荐 SkyPlanner。Cegid 自身也建议对接高级计划工具，以处理更多约束（Cegid PMI）。SkyPlanner 可统筹操作人员、工具、准备作业和物料，自动重新排程，且不限用户数，每月 199 € 起。
