Acumatica連携ガイド SkyPlanner APSによる生産スケジューリング

Acumaticaは、Connected Applications（SM303010）に登録したクライアントアプリケーションを通じて、OAuth 2.0とOpenID Connectを使用します。ドキュメントに記載されているフローは、Authorization Code、Implicit、Resource Owner Password Credentials、Hybridです。サーバー間連携では、必要最小限の権限を持つロールを割り当てた連携専用ユーザーを登録し、リフレッシュトークン付きのAuthorization Code、またはResource Owner Password Credentialsを使用してください。

利用上限はライセンスによって決まります。License Monitoring Console（SM604000）には、許可される毎分のAPIリクエスト数とAPIユーザー数が表示されます。

SkyPlanner側のREST APIはAPIトークン（SkyPlanner Settings > API）で認証し、仕様はSwagger/OpenAPIで公開されています。最初の呼び出し手順は、連携チュートリアルで説明しています。

1. マスタデータの初回取り込み。まず作業区、機械、工具、シフト、カレンダーを読み込み、次に在庫品目とBOMを読み込みます。複数の機械を持つ作業区を、一つのリソースグループとして各機械を個別のリソースにするか、作業区全体を一つのリソースにするかを決めてください。AcumaticaのBasis for Capacityを確認すれば、工場がどちらの考え方で能力を管理しているかが分かります。

2. 指図の同期。製造指図とその工程は、BOMではなく指図から読み込みます。工程は指図にコピーされ、計画担当者はそこで変更を加えるためです。未完了の指図と工程を取得するGeneric Inquiryにプッシュ通知を設定するか、ポーリングしてください。未入荷の発注明細も読み込みます。SkyPlannerは発注済み資材を発注書の入荷予定日に利用可能とみなし、発注書がDeliveredになると在庫を更新します。

3. スケジュールの書き戻し。エンジンが配置または移動したすべての工程について、SkyPlannerはOrderOperationDetailにStartDateとEndDateを書き戻します。代替作業区に移した場合は、作業区も書き戻します。その後、FirmProductionOrderを呼び出します。Acumaticaの説明：”When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.”（製造指図を実際の能力制約に基づいてスケジューリングする際、確定済みの製造指図は再スケジューリングされません。）（出典）

4. 製造現場からの実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録します。作業時間記録は、LaborEntry伝票（工程ごとの時間と完了数量）またはMoveEntry伝票（数量のみ）となり、対応するアクションでリリースされます。すでに現場でLabor（AM301000）やShop Floor Kioskを使ってAcumaticaに実績を報告している場合は、進捗データを逆方向に連携します。報告経路は必ず一つに絞り、両方を併用しないでください。

5. データの管理主体と競合時のルール。本稼働前に、次の内容を文書化してください。

競合の主な原因は、Acumatica自体のAPSです。Rough Cut PlanningやAPS Maintenance Processによって、SkyPlannerでスケジュールを組んだオーダーの日付が再計算されることがあります。書き戻したオーダーをそれぞれ確定すれば、これを防げます。スケジュール済みのオーダーは、APSの実行対象からも除外してください。

• 有効なAPSエンジンを確認する。ClassicとOptimizedでは設定が別々に保存され、有効にできるのは片方だけです。初回の書き戻し前に、Enable/Disable Features (CS100000)を確認してください。
• エンドポイントのバージョンを固定する。バージョンはURLの一部です。リリースのアップグレードで新しいバージョンが追加されるため、アップグレードのたびに再テストしてください。
• 工程の更新。工程フィールドの一部はREST経由では読み取り専用で、オーダーのステータスも更新に影響します。ReleasedとIn Processのオーダーについて、書き戻しの手順をサンドボックスでテストしてください。
• 単位と時間フィールド。稼働時間はRun Units単位、機械時間はMachine Units単位です。待ち時間と移動時間は、”affect the calculated schedule but do not occupy work center capacity.”（計算されるスケジュールには影響しますが、作業区の能力は消費しません）。取り込み時の換算には注意してください。
• 資材の利用可否の判断。Classic APSでは、すべての資材が全量揃っている必要があります。SkyPlannerは、在庫と入荷予定の購買オーダーを日付ごとに考慮して計画します。計画担当者がどちらの判断に従うかを決めてください。
• APIの制限。毎分のリクエスト数はライセンスで定められています。全件の再読み込みではなく、差分取得とプッシュ通知を使ってください。