Monitor ERP連携ガイド SkyPlanner APSで生産スケジューリング

Monitor G5でドキュメントが公開されている連携インターフェースは、Monitor ERP API v1です。CQRSとRESTを組み合わせた方式で、HTTPS経由でJSONを送受信します。（Monitor ERP API）

• クエリはGETでデータを読み取ります。OData形式のオプションとして、$filter、$select、$expand、$orderby、$top、$skipを使用できます。
• コマンドはPOSTでデータを書き込みます。例えば、Manufacturing/ManufacturingOrderOperations/Updateがあります。
• Batchは、POST /api/v1/Batchを通じて複数のコマンドを一つのトランザクションで実行し、すべて成功するか、すべて取り消されるかのいずれかになります。/Simulateまたは/Validateを末尾に付けると、バッチをテストしてロールバックできます。これにより、スケジュール全体を安全に書き込めます。（Batch）

ベースURLはhttps://{host}:8001/{languageCode}/{companyNumber}/api/v1/です。会社番号はデータベース番号と会社IDを組み合わせたもので、例えば004.1となります。

ライセンスについて、Monitorは次のように説明しています。”It is free to query and extract information from the API for all our customers. However, in order to use commands and write data to the ERP system, you need to purchase Monitor ERP API.”（すべてのお客様がAPIから無料で情報を照会・抽出できます。ただし、コマンドを使ってERPシステムにデータを書き込むには、Monitor ERP APIの購入が必要です。）プロジェクトの初期段階から、書き込み用ライセンスの手配を計画に含めてください。（api.monitor.se）

Monitor ERP APIのリファレンスには、Webhookやイベント購読の記載がありません。変更はポーリングで取得します。

• Common/EntityChangeLogs（2.33以降）は、ChangeType（Update、Create、Delete）、EntityTypeId、EntityId、ModifiedTimestampを返します。数分おきにポーリングし、変更されたレコードだけを取得します。（EntityChangeLog）
• 製造オーダーのクエリは未完了のオーダーに絞り込み、$topと$skipでページ分割して取得します。

SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻しはイベント駆動で行えます。

1. マスタデータの初回取り込み。作業区、工程行、代替工程行、資材行、品目、シフトスケジュールを読み取ります。各作業区をSkyPlannerのどのリソースに対応付けるか、慎重に決めてください。Pool作業区はリソースグループに、その配下の作業区はエンジンが割り当て先を選ぶ際の候補リソースになります。

2. オーダーの同期。未完了の製造オーダーをノード、工程、資材とともに読み取り、在庫と未完了の購買オーダーも取得します。SkyPlannerは発注済みの資材を購買オーダーの納入日から利用可能とみなし、購買オーダーがDeliveredになると在庫を更新します。初回取り込み後は、Common/EntityChangeLogsに基づいて差分を同期します。

3. スケジュールの書き戻し。エンジンが配置または移動した各工程について、SkyPlannerはPlannedStartDateとPlannedFinishDateを指定してManufacturingOrderOperations/Updateを送信します。プール内の別の機械に工程を移した場合は、先にSetWorkCenterを実行します。一つのオーダーのコマンドを一つのBatchにまとめることで、Monitorはすべてを受け付けるか、すべてを取り消すかのいずれかになります。テスト時は/Validateを使ってバッチを実行してください。

Monitor 24.5より前のバージョンでは、Updateで予定日時を書き込むことはできません。代わりに、StartDateとFinishDateを指定してManufacturingOrders/ReplanOperation（2.40以降）を使用し、運用ルールに合わせてRestrictToOrderBoundsを設定してください。

4. 製造現場の実績報告。報告経路は一つに統一します。

• Monitorでの報告を継続する場合。作業者は従来どおり、Recording terminalまたは機械連携を通じて報告します。SkyPlannerはManufacturingOrderOperationReportingsを進捗データとして読み取り、再スケジューリングします。
• SkyPlannerでの報告に切り替える場合。作業者はMobile ConfirmationsまたはProduction Timerで作業を記録し、SkyPlannerがMonitorにReportManufacturingOrderOperationをPOSTします。

両方のシステムから報告すると、作業時間と数量が二重計上されます。

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

競合の主な原因は、計画担当者が引き続き優先順位計画を変更することです。Rescheduling according to New finishの実行やPriority planningでの行のドラッグ操作は、SkyPlannerが書き込んだ日時を上書きします。SkyPlannerで工程順序を管理するようになったら、Priority planningは参照用として使います。Autopilotを使えば、生産状況が変わるとSkyPlannerが自動で再スケジューリングします。

• 稼働率。Monitorは稼働率を使い、総能力から正味能力を算出します。新規作業区の初期値は80 %です。SkyPlannerの効率に反映するか、シフト時間を短くするか、どちらか一方で適用し、二重に適用しないでください。
• 計画の時間単位。Day planningの作業区では、能力を一日当たりの基本時間で管理し、シフトの時刻は保持していません。作業が勤務時間内に収まるよう、生産スケジュールを基に実際のシフトをSkyPlannerに設定してください。
• 待ち時間とオーバーラップ。工程行には待ち時間とオーバーラップ率（%）が保持されています。それぞれをSkyPlannerにどう対応付けるか、要件定義で決めてください。決めておかないと、本稼働後にリードタイムが変わってしまいます。
• プール。プール作業区の計画には、Priority planningではなくPool planningを使います。プールの行だけでなく、そのプールに含まれる作業区も読み取ってください。
• バージョン要件。Updateによる計画日時の更新には24.5が必要です。APIの作業区能力フィールドには24.3、OIDCには25.8が必要です。要件定義の前にビルドを確認してください。
• ネットワークと証明書。オンプレミスのMonitorは、自己署名証明書を使ってポート8001でAPIを提供します。SkyPlannerはクラウドで動作するため、ファイアウォールルールか中継手段を用意し、証明書を明示的に信頼する設定が必要です。
• ライセンス。書き込みを行うサードパーティーアプリケーションごとに、APIライセンスを割り当てた専用ユーザーが必要です。すべてのシステムに、読み取り専用のAPIユーザーが一つ付属します。