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

Sylobのドキュメントには、二種類の公開REST APIが記載されています。”L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.”（Sylob ERPは、データの読み書きができる二種類の公開REST APIを提供しています。これらは「webservices」とも呼ばれます。）（Forterroナレッジベース）

1. API REST Système d’information（読み取り）。アクティビティ「Interroger le système d’information」で作成・保存したクエリ（requête）を実行します。クエリ固有の呼び出しURLは、「Autres actions」>「Afficher le web service」から取得でき、形式は/rest/query/{identifiantQuery}/resultatです。パラメータで取得件数の上限、数値形式、クエリ変数、結果の構造を指定します。結果は既定でXMLとして返され、ヘッダーにAccept: application/jsonを指定するとJSONで返されます。このAPIはERPに含まれています。
2. API REST Action（読み取り・書き込み）。Sylobのアクションカタログにあたるアクティビティ「Gérer les actions web service」で定義したアクションを実行します。二つの操作が公開されており、GET /rest/v2/action/{code}/describeはアクションのデータスキーマを返し、POST /rest/v2/action/{code}/executeはJSONボディを渡してアクションを実行します。アクションの種類には、次のものがあります。

– Modification de données：Sylobのクイック編集機能を通じて、レコードの一つ以上のフィールドを変更します。Describeで編集可能なフィールドを確認できます。- Message EDI：EDIメッセージを通じてレコードを作成、変更、削除します。- Scénario de saisie：入力シナリオを質問ごとに順次実行します。Sylobが示す例は、工程の開始または終了を報告する「Déclarer un début ou une fin」（Sylob_Action_006）です。- ドキュメントの公開、アップロード、ダウンロード。

1. EDIメッセージ。SylobのEDIエンジンがエクスポートとインポートを処理します。標準メッセージのSylob_Recup_Decl_Proで、生産実績を取得できます。（Forterro）
2. ファイルとETL。Sylob ERP Cloudは、”Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.”（既存の連携を容易に移行するためのSFTP経由のファイル連携）を提供しています。（Sylob）クエリ結果はExcelにもエクスポートでき、SkyPlannerのトライアルを手早く始める方法として利用できます。

Sylobの公開ナレッジベースには、外部送信用Webhookのサブスクリプションについての記載がありません。未完了のOFと最近の変更を抽出する保存済みクエリを、指定した間隔でポーリングして、変更をSkyPlannerに取り込みます。

Sylobは、過剰なクエリによる負荷からERPを保護します。リリース2025.Q2以降では、会社パラメータ「Protection des API」でユーザーごとの流量制御と大量の結果のページングを有効にできます。Sylobは、リリース2026.Q2からこれを一律に適用すると発表しています。レスポンスにはRateLimitヘッダーが含まれ、上限を超えた呼び出しにはRetry-After値を伴うHTTP 429 Too Many Requestsが返されます。（Forterro）同期処理は、差分クエリ、ページング、429受信時のバックオフを組み込んで設計してください。

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

1. マスタデータの初回取り込み。オブジェクト（articles、nomenclatures、gammes、作業区、従業員）ごとに保存済みクエリを一つ作成し、Système d’information APIで読み取ります。または、Excelにエクスポートしたデータを初回に取り込みます。作業区の対応付けは慎重に行ってください。Sylobのcentre de chargeはリソースのグループなので、設備が三台ある作業区は、通常、SkyPlannerでは三つのリソースを持つリソースグループに対応します。

2. オーダーの同期。確定済みOFとその工程に加え、在庫と未完了の購買発注を読み取ります。SkyPlannerは、発注済みの資材を購買発注の納入日に使用可能とみなし、購買発注がDeliveredになると在庫を更新します。そのため、スケジューリングでは在庫と入荷予定の両方を確認します。

スケジューリングの対象は、CBNの提案ではなく確定済みOFにしてください。提案は、次回の正味所要量計算で変わります。

3. スケジュールの書き戻し。エンジンが配置または移動した各工程について、連携処理はOFの工程（Opération d’ordre de fabrication）に対してModification de donnéesアクションを呼び出し、開始予定、終了予定、作業区を渡します。このアクションは、計画担当者が工程を編集するときと同じSylobのクイック編集ロジックで実行されます。Describeで編集可能なフィールドが返されるため、連携処理は初回の呼び出し前に送信データを検証します。ユーザーが編集中のレコードに対しては、想定されたエラーが返されます。次の変更時に再試行してください。

4. 製造現場からの実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録します。開始と終了は「Déclarer un début ou une fin」シナリオを通じて書き戻します。作業時間記録と数量は、同じOF工程の生産実績として反映されます。対象は段取り時間、加工時間、生産数量、不良数量、工程完了です。すでにSylob Appsや現場端末で実績を報告している工場では、二重登録を避けるため、報告経路を一つに統一してください。

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

SkyPlannerにCADPLANやSylobの有限能力計画処理は必要ありません。二つの計画システムが同じ日付を書き込むと互いに上書きしてしまうため、工程日付の管理はSkyPlannerに任せてください。SkyPlannerで管理すれば、計画に影響する変更が発生するたびにAutopilotが自動で再スケジューリングし、新しい日付をSylobに書き戻します。

• Action APIのライセンス。保存済みクエリによる読み取りは標準で含まれています。アクションカタログ経由で書き込むには、Sylobの「Webservice」モジュール、またはMyForterroのAPIライセンスが必要です。書き戻しの段階に入る前に、Sylobの担当者と手配を進めてください。
• クエリを連携仕様として管理。データの読み取りは保存済みクエリに依存します。わかりやすい名前を付け、実行時に変数属性としてフィルターを渡し、連携の実装と併せてクエリのバージョンを管理してください。
• 作業区のグループ化。Sylobの一つの作業区に複数の設備が含まれることがあります。SkyPlannerで一つのリソースグループとして扱うか、設備を個別に扱うかを、作業区ごとに決めてください。
• バックワードスケジューリングと負荷計算。Sylobは所要日から逆算してスケジュールを作成し、定期実行の負荷計算によって遅延したOFを再計画できます。工程日付の管理をSkyPlannerに移した後も日付を書き込む処理を残すのか、残す場合はどの処理かを合意しておいてください。
• 段取り時間と加工時間の単位。インポート前に時間の単位を確認し、段取り時間がOF単位か製品一個単位かも確認してください。単位が間違っていると、すべての所要時間が不正確になります。
• カレンダー。作業区の週間稼働パターンと例外日は、スケジューリング対象期間の全体をカバーする必要があります。設定が不足すると、その期間の能力が計画に反映されません。
• 呼び出し制限。Sylobはユーザーごとの呼び出し回数を制限し、大量の結果はページに分割して返します。差分ポーリングなら、上限に十分な余裕を持って運用できます。
• CORSとブラウザー。サーバー間の呼び出しならCORSの制約を受けません。ブラウザークライアントを使う場合は、Sylob側で許可するオリジンを設定する必要があります。