Fulcrum連携ガイド SkyPlanner APSで生産スケジューリングを行うには

Fulcrumは単一のマルチテナント型クラウド製品であり、すべてのお客様が同じAPIを利用します。開発者ハブでは、この公開APIについて “REST API calls directly into your Fulcrum site.”（お客様のFulcrumサイトを直接呼び出すREST API）と説明しています。

• 仕様。OpenAPI “Fulcrum PublicAPI” v1は、https://api.fulcrumpro.com/swagger/v1/swagger.jsonからダウンロードできます。Fulcrumは、この仕様から型付きクライアントを生成することを推奨しています。日付付きのHistoryページに、すべての変更が掲載されています。
• ホスト。標準サイトはhttps://api.fulcrumpro.comを使用します。ITARサイトはapi.fulcrumpro.usを使用します。ITARトークンで.comホストにアクセスすると、401が返されます。
• 呼び出し形式。一覧の取得にはPOST .../listを使い、リクエストボディでフィルターを指定します。ページングにはSkipとTake、並べ替えにはSort.Field / Sort.Dirを使います。多くのオブジェクトはPUTに対応し、作業はJSON Patchにも対応しています。

スケジューリング連携で使用するエンドポイントは次のとおりです。

Fulcrumの連携紹介ページも、必要な作業を明確に説明しています。”Every system is a little bit different and requires some configuration.”（システムはそれぞれ少しずつ異なるため、設定が必要です。）この設定を、導入時にSkyPlannerチームが担当します。

FulcrumはWebhookに対応しており、管理者が設定します。2026年9月以降、失敗したWebhookは無期限に再試行されるのではなく、一時停止され、毎日再テストされます。APIのHistoryには、PurchaseOrderUpdatedやItemUpdatedなどのイベントが記載されています。

連携では、次のようにFulcrumからデータを読み取ります。

• 未完了の作業をscheduledとinProgress、およびhasIncompleteOperations: trueで絞り込み、数分ごとにポーリングします。これは、スケジュール画面と一致するデータを取得するためにFulcrum自身が提示しているフィルターです。
• 購買発注と在庫は、スケジューリングの実行前に毎回取得します。PurchaseOrderUpdatedのWebhookが設定されている場合は、その受信時に取得します。
• 品目、工順、設備、シフトは、変更時または毎晩取得します。

逆方向では、SkyPlannerのWebhookがスケジュールの変更を発生時に送信するため、書き戻しはイベント駆動で行われます。

1. マスタデータの初回取り込み。品目、材料、工順、作業区、設備を取得し、続いて部門のシフトと停止時間を取得します。Fulcrumの各作業区は、その配下の設備をメンバーとするSkyPlannerのリソースグループになります。工順の各工程で選択されている設備は、その工程で使用可能なリソースになります。炉や塗装ブースなど、Unlimited Capacityが設定された設備はバッチ作業として扱われます。

2. オーダーの同期。未完了の作業とその製造対象品目・工程に加え、未完了の購買オーダーと在庫を読み込みます。SkyPlannerは、発注済みの材料を購買オーダーの納入日に使用可能とみなし、購買オーダーがDeliveredになると在庫を更新します。スケジュールを再計画するたびに、在庫と入荷予定を確認します。

3. スケジュールの書き戻し。FulcrumはscheduledStartUtc、scheduledEndUtc、scheduledEquipmentIdを自ら計算し、読み取り専用で返します。工程の更新ではcustomFieldsへの書き込みが可能です。SkyPlannerは、各作業工程のカスタムフィールドに開始予定、終了予定、リソースを書き込み、作業のカスタムフィールドにも終了予定を書き込みます。営業担当者と購買担当者は、Fulcrumの作業データでSkyPlannerの予定日を確認できます。

4. 製造現場での実績登録。 作業者はMobile Confirmations、Production Timer、Quick Log Modeを使ってSkyPlannerに作業実績を記録します。SkyPlannerは/api/job-tracking-timers/startと/stopを通じて時間をFulcrumに送信するか、/api/timersを通じて完了した作業時間をまとめて送信します。数量はadd-quantity-completedで、廃棄数量を含む最終数量はcompleteで送信します。Fulcrumの作業原価には常に最新の実績が反映されます。

5. データの管理責任と競合時のルール。 Fulcrumのスケジューラは”dictates the order of operations in Job Tracking.”（Job Trackingでの工程順序を決定します）。そのため、各工程への作業指示は、SkyPlannerの作業者向けキューかFulcrum Job Trackingのどちらかに統一します。本稼働前に、次の管理ルールを文書化してください。

• 人員の制約はシフトごとの設備数に反映されます。 FulcrumのシフトごとのMax Equipmentは、”is usually determined by how many people you have working in a certain area at that time.”（通常、その時間帯に対象エリアで働く人数によって決まります）。作業者個人とそのシフトはSkyPlannerで設定します。氏名は/api/usersのユーザーデータから取得します。
• スケジュールは設備単位で組みます。 Fulcrumの作業区は、相互に代替可能な設備をまとめたものです。工順で選択した設備がエンジンの割り当て候補になるため、正確に設定しておく必要があります。
• 製造指図は複数の作業をまとめます。 製造指図は、ネスティングなどのために複数の作業の工程をまとめるものです。グループ内の工程でタイマーを開始すると、代わりに製造指図のタイマーが開始され、グループ内のすべての作業工程が計測対象になります。
• タイマーの制限。 /api/timersで過去の実績として登録する時間枠は、”may not be in the future, older than 30 days, or longer than 7 days.”（未来の日時は指定できず、さかのぼれる日数と記録する期間にも上限があります）。作業者が時間を記録する都度、送信してください。
• 時刻の形式はデータによって異なります。 シフトには現地時刻のHHmm値を使用し、停止時間と予定日時にはUTCを使用します。工程の見積時間は秒単位で取得します。
• 設備の更新ではレコード全体が置き換わります。 設備へのPUTでは、省略したフィールドがすべてクリアされます。SkyPlannerは設備データの読み取りのみを行い、書き込みは一切行いません。
• ITAR環境。 .usホストとITARトークンを使用します。