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のBearerフローを使用し、ビジネスユーザーへのプリンシパル伝播に対応 – クライアント証明書 – 技術通信用ユーザーによる基本認証

SAPは、トークンまたは証明書による認証を推奨しています。

SkyPlanner側はJWT認証を使用するREST APIで接続します。仕様はSwagger/OpenAPIで公開しています（APIリファレンス）。そのため、ミドルウェアは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	製造指図、工程、構成品目、PRT、ステータス、スケジュールの書き戻し
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で管理する方法です。計画担当者は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は一回の呼び出しで指図全体の計画を割り付けます。Mode Kは使用しません。元の作業日付を維持し、送信した日付を無視するためです。

SkyPlannerは、S/4HANAと同じ工順の標準値と作業区の能力計算式から、作業所要時間を算出します。そのため、割り付けた開始日からS/4HANAが計算する終了日は、SkyPlannerの計画と一致します。連携処理では、変更セットごとに作業を再取得し、日付に相違があればフラグを付けます。計画担当者は次のシフトが始まる前に、その相違を確認できます。

4. 製造現場の作業実績確認。 Mobile ConfirmationsまたはProduction Timerの各作業時間記録を、S/4HANAの作業実績確認として登録します。SkyPlannerのWebhookを契機に、良品数量、不良数量、活動時間を含むProdnOrdConf2をPOSTします。連携処理では先に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に統合された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に登録された工具は有限の資源として扱い、同時には一つのリソースでしか使用できません。また、一つの作業に複数人を同時に必要とする条件も設定できます。