SAP S/4HANA 集成指南：对接 SkyPlanner APS 生产排程

S/4HANA 通过已发布的 OData 服务提供集成接口，服务清单见 SAP Business Accelerator Hub（api.sap.com）。排程集成使用 OData V2 服务。IDoc 和 BAPI 仍然可用，但本指南采用已发布的 OData API。

各版本的身份验证方式

• 本地部署版和 Private Edition。在 SAP Gateway 中通过事务 /IWFND/MAINT_SERVICE 激活服务。集成用户需要具备相应的授权对象，例如报工需要 C_AFRU_AWK，随报工一起过账的货物移动项目需要 C_AFKO_AWK，计划订单需要 M_PLAF_ORG。
• Public Edition。服务只能通过通信安排对外提供。按照 SAP 入站通信设置说明，在 Communication Arrangements 应用中，基于 SAP 通信场景（SAP_COM_xxxx）创建通信用户、通信系统和通信安排。该场景决定开放哪些服务，以及可用的身份验证方式：

– 基于令牌：采用 OAuth、SAML 或 OpenID Connect 的持有者令牌流程，并将主体身份传递至业务用户 – 客户端证书 – 使用技术通信用户进行基本身份验证

SAP 建议使用令牌或证书进行身份验证。

SkyPlanner 端提供采用 JWT 身份验证的 REST API，其 Swagger/OpenAPI 文档见 API 参考。因此，中间件在 SAP 端处理 SAP 身份验证，在 SkyPlanner 端处理 JWT。

生产排程相关 API

服务	使用的实体和动作	用途
API_PRODUCTION_ORDER_2_SRV（Production Order, Version 2）	A_ProductionOrder_2、A_ProductionOrderItem_2、A_ProductionOrderOperation_2、A_ProductionOrderComponent_2、A_ProductionOrderStatus_2、A_ProductionRsceTools_2；动作：ReleaseOrder、ReleaseOperation、ScheduleProductionOrderOperation	订单、工序、组件、生产资源/工具（PRTs）、状态、排程回写
API_WORK_CENTERS	A_WorkCenters, A_WorkCenterAllCapacity_2, A_WorkCenterCapacity, A_WorkCenterCapacityInterval_2, A_WorkCenterCapacityShift_2, A_WorkCenterCapPerBucket	工作中心、能力类别、有效区间和班次
API_PRODUCTION_ROUTING	ProductionRoutingHeader, ProductionRoutingSequence, ProductionRoutingOperation, ProductionRoutingSubOperation, ProductionRoutingMatlAssgmt, ProductionRoutingOpCompAlloc	标准工艺路线，用于在创建订单前进行计划
API_BILL_OF_MATERIAL_SRV;v=2	MaterialBOM, MaterialBOMItem, MaterialBOMSubItem	多层产品结构
API_PRODUCT_SRV（Product Master A2X）	A_Product	物料（在 API 中称为 Product）。对于大多数产品实体，SAP 目前建议使用 Product (Version 2) API
API_PLANNED_ORDERS	A_PlannedOrder, A_PlannedOrderComponent, A_PlannedOrderCapacity	转换前的 MRP Live 输出结果
API_MATERIAL_STOCK_SRV	A_MaterialStock, A_MatlStkInAcctMod	按工厂和库存地点划分的库存，用于确定物料可用性
API_PURCHASEORDER_PROCESS_SRV	A_PurchaseOrder, A_PurchaseOrderItem	待到货物料的未结采购订单
API_PROD_ORDER_CONFIRMATION_2_SRV	ProdnOrdConf2、ProdnOrdConfMatlDocItm；动作：GetConfProposal、GetGdsMvtProposal、CancelProdnOrdConf	车间报工和货物移动

在生产订单 API 中，工序以 OrderInternalBillOfOperations 和 OrderIntBillOfOperationsItem 的组合作为键，而不是计划员看到的工序编号。报工 API 的 GetConfProposal 则通过 OrderID 和 OrderOperation 定位同一道工序。从首次加载开始，就应将内部键和工序编号一并存入 SkyPlanner。

事件

S/4HANA 会触发 Production Order Created 和 Production Order Changed 业务事件，其载荷包含 ManufacturingOrder、ProductionOrder、ProductionOrderType 和 ProductionPlant。载荷仅携带键，因此集成程序需要重新读取订单及其工序。订单的每一次变更都会触发 Changed 事件，因此需要做防抖处理。反向传输时，排程或生产任务状态一旦发生变化，SkyPlanner webhook 就会实时推送。

从文件导入开始

试用时，可从 S/4HANA 列表报表中将生产订单和工作中心导出为 Excel 或 CSV 文件，再导入 SkyPlanner。这样，无需先配置 Gateway 或通信安排，就能验证排程效果。

1. 加载主数据。加载物料、BOM、工作中心及其产能区间和班次，以及工艺路线。在此阶段确定由哪个系统管理班次。一种可行的分工是：工厂日历保留在 S/4HANA 中，详细的班次安排、缺勤和加班则在 SkyPlanner 中管理，供计划员日常调整。

2. 订单同步。订阅 Production Order Created/Changed 事件；如果未配置业务事件，则按变更时间戳轮询 A_ProductionOrder_2。按工厂、订单类型和状态筛选。在订单创建时就将其发送到 SkyPlanner，以便提前规划；待 SkyPlanner 完成排程后，再在 S/4HANA 中下达（ReleaseOrder 或 ReleaseOperation）。

3. 排程回写。当 SkyPlanner webhook 通知排程变更时，集成程序会针对每道发生变更的工序，调用 API_PRODUCTION_ORDER_2_SRV 中的 ScheduleProductionOrderOperation。发送的内容包括：

• 作为键的 ManufacturingOrder、OrderInternalBillOfOperations 和 OrderIntBillOfOperationsItem
• OpSchedulingMode 设为 F（正向），并在 OpSchedldStartDate 和 OpSchedldStartTime 中传入 SkyPlanner 的开始日期和时间
• OpSchedulingStatus 设为 DISP（派工），必填的 OpSchedulingStrategy 设为 M
• 在 if-match 中传入 ETag

同一订单的所有工序按 SkyPlanner 中的顺序放入同一个变更集，使 S/4HANA 能在一次调用中派发该订单的完整计划。绝不使用模式 K：该模式会保留原有工序日期，忽略传入的日期。

SkyPlanner 使用与 S/4HANA 相同的工艺路线标准值和工作中心产能公式计算工序时长。因此，S/4HANA 根据派发的开始日期算出的结束日期会与 SkyPlanner 计划一致。每个变更集处理完毕后，集成程序都会重新读取工序，并标记存在差异的日期，让计划员在下一班次开始前看到。

4. 车间报工。Mobile Confirmations 或 Production Timer 中的每条工时记录都会转为 S/4HANA 报工。SkyPlanner webhook 会触发 ProdnOrdConf2 提交，包含合格品数量、报废数量和作业时间。集成程序会先调用 GetConfProposal，由 S/4HANA 提供数量、作业量、日期和人员数据的建议值。GetGdsMvtProposal 则提供货物移动建议。

在途物料。未结采购订单也纳入入站同步。SkyPlanner 将已订购物料视为在采购订单的预计交货日期可用。等待外购组件的作业会安排在物料到货当天，而不会因当前库存不足而无法排程。

S/4HANA 仍是收货数据的权威来源：收货过账后，库存增加，采购订单行项目的未结数量减少。下一次同步会更新 SkyPlanner 中的库存，并将已全部收货的采购订单标记为 Delivered；部分收货后，剩余未结数量仍按计划行日期计入待到货物料。SkyPlanner 如何处理采购订单，详见 SkyPlanner 文档。

5. 数据管理权规则。S/4HANA 负责数量、BOM、工艺路线、成本核算和状态。SkyPlanner 负责工序顺序、工作中心分配和工序日期。绝不能让两个系统写入同一个字段。如果计划员仍在 Capacity Scheduling Board 中移动工序，就必须确定以哪一方为准：要么在下一次订单同步时将这些调整带入 SkyPlanner，要么将该工作中心排除在 SkyPlanner 的管理范围之外。

• 回写需要调用动作并携带 ETag。文档规定的工序排程方式是调用 ScheduleProductionOrderOperation，而不是对 A_ProductionOrderOperation_2 执行 PATCH。F 模式从开始时间正向排程，B 模式从结束时间反向排程；K 和 S 则保留现有日期，忽略传入的日期。if-match 中的 ETag 根据订单的 LastChangeDateTime（YYYYMMDDHHMMSS）构建，因此订单发生任何变更都会使其失效。应实现写入前读取机制和重试队列。
• 工作中心抬头不包含产能数据。可用产能取决于能力类别（001 机器、002 人工）、工厂日历，以及覆盖日历设置的有效区间和班次。产能公式将工艺路线的标准值换算为准备、加工和拆卸的能力需求。读取 A_WorkCenterCapacityInterval_2 和班次实体，并商定如何将公式换算为 SkyPlanner 中的时长。
• 标准值需要清理。为成本核算维护的工艺路线，往往使用平均准备时间，或将准备作业计入了错误的产能类别。
• 报工规则严格。SAP 建议使用批量调用进行大批量过账。一个变更集要么全部成功，要么全部失败，因此一条有误的工票就会阻止该变更集中的其余记录过账。批次中的取消操作必须按 ConfirmationCount 的逆序执行。不能在同一订单中混用报工类型，不能在没有报工的情况下过账货物移动，也不能对触发点需要弹出对话框的工序进行报工。
• 检查是否已启用 PP/DS。嵌入式 PP/DS 需要执行 Customizing 配置活动 Activate Advanced Planning and Scheduling，并使用 SAP HANA integrated liveCache。SAP 将其作为独立产品 SAP S/4HANA Manufacturing for planning and scheduling 销售。如果已启用，就要逐项确定物料由哪个系统排程：标记为高级计划的物料归 PP/DS 管理。SAP 还在计划订单 API 文档中说明：”Automatic integration to PP/DS is not enabled from this API.”（此 API 未启用上述自动集成功能。）
• 计量单位。工序数量、工艺路线基准数量和确认数量所用的单位可能不同。必须明确进行换算，使用工序单位，而非物料基本单位。
• 版本差异。SAP Learning 显示，传统的 CM21/CM22 计划表正被 Manage Work Center Capacity、Capacity Scheduling Table 和 Capacity Scheduling Board 取代。Public Edition 仅通过通信场景开放 API，所提供的服务版本可能与本地部署版不同。工艺路线 API 无法删除工艺路线，也无法更新物料分配。SkyPlanner 团队会在范围评估阶段，依据 API Business Accelerator Hub 中对应发行版的条目，为每个客户系统锁定服务版本。
• 工艺路线无法涵盖的约束。与顺序相关的换型、工具冲突和多人协同工序，应在 SkyPlanner 中管理，而不是放入工艺路线标准值。准备时间矩阵记录每一对产品之间的换型时间。订单 PRT 中的工具属于有限资源，同一时间只能供一个工作中心使用，而一道工序可以同时需要多名人员。