SAP Business ByDesign 集成指南：使用 SkyPlanner APS 进行生产排程

ByDesign 在Web 服务 API 列表中，按版本列出正式发布的 A2X SOAP Web 服务。排程集成会用到以下服务：

• Manage Production Orders (ManageProductionOrderIn)。READ_PROD_ORDER 返回要求的、最早和最晚的开始与结束时间，资源及其计划时长和已执行时长，以及优先级、执行状态和排程状态。MAINTAIN_BUNDLE_V2 用于更新 EarliestStartPeriod 或 LatestEndPeriod，以及工序的 MainResourceID（SAP 帮助）。
• Manage Production Lots (ManageProductionLotsIn)。MaintainBundle 用于创建或更新生产任务：记录每个报告点的确认数量、报废数量和确认完成标识；完成任务并记录执行员工及执行时间；记录资源利用情况（SAP 帮助）。
• 查询服务。包括 Query Production Orders、Query Production Lots、Query Production Model、Query Production Bill of Materials、Query Production Bill of Operations（也支持按资源查询）、Query Materials、Read Equipment Resources、Query Labour Resource、Query Purchase Orders、Query Identified Stocks 和 Determine Availability of Products。
• OData。支持针对业务对象的自定义 OData 服务，也支持面向数据源和分析报表的 OData。SAP 表示，”companies are fully empowered to decide which business objects”（企业完全有权决定哪些业务对象）对外开放（SAP 集成场景）。

读取数据使用 Query 服务或 OData；所有写入操作均使用上述两个 Manage 服务。

每次排程变更时，SkyPlanner 都会发送 webhook，因此计划一经调整，就会回写至 ByDesign。

要获取 ByDesign 中的变更，请轮询 Query 服务。每隔几分钟读取已下达的生产订单和生产批次，物料、库存及采购订单则以较低频率读取。查询结果通过 QueryHitsMaximumNumberValue 和 LastReturnedObjectID 分页；默认每页条数请参阅 SAP 的 Web 服务页面。

1. 首次加载主数据。读取物料、Production Models、Bills of Material 和 Bills of Operations，以及设备与人力资源。资源映射需要明确规划：包含四台设备的资源组，可映射为一个工作中心组，也可映射为四个工作中心。属于工装的设备资源，在 SkyPlanner 中映射为有数量限制的工装。

2. 同步生产订单。读取已下达的生产订单及其工序和物料，同时读取未结采购订单。SkyPlanner 将已订购物料视为在采购订单交货日期可用，并在采购订单标记为 Delivered 时更新库存。生产建议在转为生产订单之前，仍保留在 ByDesign Supply Planning 中。

3. 回写排程。当引擎安排订单或调整订单排程时，SkyPlanner webhook 会触发 Manage Production Orders 的 MAINTAIN_BUNDLE_V2，设置 EarliestStartPeriod，以及 SkyPlanner 所选工序的 MainResourceID。

4. 车间报工。操作员通过 SkyPlanner Mobile Confirmations 或 Production Timer 记录作业，工时记录会让排程保持更新。您可以选择是否回写实际执行数据。如选择回写，Manage Production Lots 的 MaintainBundle 会写入确认数量、报废数量、已完成的任务及其执行员工。如不回写，则仍按原方式在 ByDesign 中报工。

5. 数据维护权与冲突处理规则。上线前应将以下规则明确记录下来：

订单日期只应由一个系统写入。不要对 SkyPlanner 负责排程的资源运行 Load Leveling，并确认计划运行不会调整由 SkyPlanner 管理的已下达订单。

• 每次调用只更新一个日期。 “The EarliestStartPeriod and the LatestEndPeriod cannot be updated together.”（EarliestStartPeriod 和 LatestEndPeriod 不能同时更新。）回写时以开始日期为基准。
• 不支持锁定。 A2X 服务无状态，因此 SAP 明确说明无法实施事务锁或逻辑锁。每次写入前都要重新读取订单，并处理冲突。
• 完成标记不可撤销。 “Confirmation Finished Indicator cannot be unchecked once it is set.”（Confirmation Finished Indicator 一旦勾选就无法取消。）只有在操作员关闭生产任务后，才提交完成状态。
• 主要资源与附加资源。 ByDesign 排程会考虑主要资源。将附加资源中的操作员和工具在 SkyPlanner 中建模为有限产能资源，让排程也检查这些资源的可用情况。
• 准备与拆卸。 Bills of Operations 将准备和拆卸记录为活动。将随生产顺序而变化的换型时间移入准备时间矩阵。