monday.com連携ガイド SkyPlanner APSで生産スケジューリング

monday.comが公開する一つのGraphQL APIのエンドポイントは、POST https://api.monday.com/v2です。バージョンは四半期ごとに更新され、API-Versionヘッダーで使用するバージョンを固定します。非推奨化は少なくとも六か月前に告知されます。（APIのバージョン管理）

スケジューリング連携では、次のオブジェクトを使用します。

• Boardsとgroups。段階別や週別の管理によく使われます。
• Itemsとsubitems。通常、アイテムは受注や作業を表し、サブアイテムに工程を格納します。
• Column values：Status、Date、Timeline、Numbers、People、Dependency、Time Tracking、Connect Boards、Mirror。
• 変更イベントを通知するWebhook。

読み取りには、ボードまたはグループの配下にあるitems_pageを使用します。デフォルトは一ページあたり25件で、”the maximum is 500.”（これが取得件数の上限です）。続きを取得するにはnext_items_pageを使用します。”each cursor will expire 60 minutes after the first request.”（各カーソルは、最初のリクエストからこの時間が経過すると失効します）。query_paramsで絞り込めば、未完了の受注だけを読み取れます。（items_page）

書き込みには、create_item、create_subitem、change_column_value、change_multiple_column_valuesを使用します。最後のメソッドは、一回の呼び出しで一つのアイテムの複数列を更新できます。スケジュールの書き戻しには、この処理を使います。

大量のデータを取り込むために、APIバージョン2026-07以降ではingest_itemsとbackfill_itemsが追加されています。署名付きURLにCSVをアップロードし、処理状況をポーリングします。（一括インポート）

create_webhook(board_id, url, event, config)で購読を登録します。スケジューリング連携に必要なイベントは次のとおりです。

• 新しい受注や工程には、create_itemとcreate_subitem。
• 納期、数量、優先度の変更には、change_column_valueまたはchange_specific_column_value。
• ユーザーによるステータス変更には、change_status_column_value。
• キャンセル済みまたは完了済みの受注には、item_archived、item_deleted、item_moved_to_specific_group。

Webhookの作成時には、受信URLでチャレンジトークンに応答する必要があります。配信に失敗すると、”retry once a minute for 30 minutes,”（この時間内は毎分一回再試行します）。その後は再試行を停止します。そのため、連携処理ではitems_pageを使い、最近更新されたアイテムに絞って定期的に読み取り、データの整合性も確認します。（Webhook）

逆方向では、状態やスケジュールが変わるとSkyPlannerがWebhookを送信します。連携サービスがそれを受信し、新しい日程をmonday.comに書き戻します。このように、書き戻しはイベント駆動で行われます。

1. マスタデータの初回取り込み。items_pageで製品、資材、未完了の受注を読み取ります。リソース、シフト、制約条件はSkyPlannerで作成するか、Excelからインポートします。工程をサブアイテムで管理するか、接続したボードで管理するかは、早い段階で決めてください。

2. 受注の同期。生産ボードのWebhookが、新規作成・変更されたアイテムを受注としてSkyPlannerに送信します。ボードで発注を管理する場合、SkyPlannerは発注済みの資材を入荷日から使用可能として扱い、発注のステータスがDeliveredに設定されると在庫を更新します。

3. スケジュールの書き戻し。エンジンが配置または移動した受注ごとに、連携処理でchange_multiple_column_valuesを呼び出します。Timeline列に開始・終了予定を設定し、リソースの列にも値を入力します。アイテムごとに一回の呼び出しで済むため、リクエスト数を抑えられます。

4. 製造現場の進捗。作業者はMobile Confirmations、Production Timer、Quick Log Modeのいずれかで作業を記録します。作業時間の記録によってスケジュールが最新に保たれ、対応するStatusラベルがボードに書き戻されます。営業担当者は問い合わせずに進捗を確認できます。

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

競合の主な原因は、ユーザーがTimeline列を手動で編集することです。この列への書き込みはSkyPlannerだけが行うと取り決めるか、手動編集を変更要求として扱い、SkyPlannerに再スケジューリングさせてください。Autopilotは生産状況が変わると、自動で再スケジューリングします。

• オーダーの管理方法はアカウントごとに異なります。 顧客ごとにボードを分ける、工程をアイテムやサブアイテムにする、設備をPeopleやStatusカラムで表すなど、構成はさまざまです。マッピングには必ずアカウントごとのカラムIDを使い、カラム名では対応付けないでください。
• プランごとの上限。 日あたりのAPI呼び出し上限は、Free、Basic、Standardが1,000回、Proが10,000回、Enterpriseが25,000回です。変更の検知にはWebhookを使い、書き戻しはchange_multiple_column_valuesでまとめて処理してください。（レート制限）
• 接続できるボード数には上限があります。 Basicでは一つ、Standardでは五つまでのため、工程や製品のボードを関連付ける際に制約となります。（Connect Boardsの上限）
• APIバージョンを固定してください。 バージョンは四半期ごとに更新されます。2026-04より前のバージョンでは、多階層ボードはデフォルトのboardsクエリの対象外でした。
• カーソルの有効期限。 items_pageのカーソルは60分間有効です。整合性確認が長時間に及ぶ場合は、最初から正常にやり直せるようにする必要があります。
• Webhookの制限。 URLは最大255文字で、再試行は30分後に終了します。受信側の処理は冪等である必要があります。
• 単位と所要時間。 Numbersカラムには単位がありません。初回のインポート前に、所要時間を分と時間のどちらで扱うかを決めてください。