monday.com Schnittstelle: Leitfaden zur Feinplanung mit SkyPlanner APS

monday.com stellt eine GraphQL API unter POST https://api.monday.com/v2 bereit. Jedes Quartal erscheint eine neue Version; mit dem Header API-Version legen Sie die verwendete Version fest. Abkündigungen werden mindestens sechs Monate im Voraus angekündigt. (API-Versionierung)

Für die Anbindung der Feinplanung werden folgende Objekte verwendet:

• Boards und groups, häufig zur Gliederung nach Phasen oder Wochen.
• Items und subitems. Ein Item steht üblicherweise für einen Auftrag oder Arbeitsgang; Subitems bilden die einzelnen Arbeitsgänge ab.
• Spaltenwerte: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards und Mirror.
• Webhooks für Änderungsereignisse.

Zum Lesen verwenden Sie items_page innerhalb einer Board- oder Gruppenabfrage. Standardmäßig enthält eine Seite 25 Items; „the maximum is 500.“ (Dies ist die Höchstzahl pro Seite.) Mit next_items_page rufen Sie weitere Seiten ab. Dabei gilt: „each cursor will expire 60 minutes after the first request.“ (Nach dieser Frist ab der ersten Anfrage verliert jeder Cursor seine Gültigkeit.) Filtern Sie mit query_params, um nur offene Aufträge zu lesen. (items_page)

Zum Schreiben dienen create_item, create_subitem, change_column_value und change_multiple_column_values. Der letzte Aufruf aktualisiert mehrere Spalten eines Items auf einmal – genau das wird benötigt, um die Planung zurückzuschreiben.

Für große Datenmengen stehen ab API-Version 2026-07 zusätzlich ingest_items und backfill_items zur Verfügung. Sie laden eine CSV-Datei über eine vorsignierte URL hoch und fragen den Status des Importauftrags regelmäßig ab. (Massenimport)

Mit create_webhook(board_id, url, event, config) richten Sie ein Abonnement ein. Für die Anbindung der Feinplanung sind folgende Ereignisse relevant:

• create_item und create_subitem für neue Aufträge und Arbeitsgänge.
• change_column_value oder change_specific_column_value für Änderungen an Liefertermin, Menge oder Priorität.
• change_status_column_value für Statusänderungen durch Benutzer.
• item_archived, item_deleted und item_moved_to_specific_group für stornierte oder abgeschlossene Aufträge.

Beim Anlegen des Webhooks muss die empfangende URL auf ein Challenge-Token antworten. Für fehlgeschlagene Zustellungen gilt: „retry once a minute for 30 minutes,“ (während dieses Zeitraums einmal pro Minute erneut versuchen), danach enden die Versuche. Deshalb ruft die Integration zusätzlich regelmäßig Daten zum Abgleich ab: mit items_page und einem Filter für kürzlich aktualisierte Items. (Webhooks)

In der Gegenrichtung sendet SkyPlanner Webhooks, wenn sich der Status oder die Planung ändert. Der Integrationsdienst empfängt sie und schreibt die neuen Termine nach monday.com zurück. Das Rückschreiben erfolgt damit ereignisgesteuert.

1. Stammdaten erstmals laden. Lesen Sie Produkte, Materialien und offene Aufträge mit items_page aus. Legen Sie Arbeitsstationen, Schichten und Restriktionen in SkyPlanner an oder importieren Sie diese aus Excel. Entscheiden Sie frühzeitig, ob Arbeitsgänge als Subitems oder auf einem verknüpften Board geführt werden.

2. Aufträge synchronisieren. Webhooks auf dem Produktionsboard senden neue und geänderte Items als Aufträge an SkyPlanner. Wenn Sie Bestellungen auf einem Board führen, berücksichtigt SkyPlanner bestelltes Material ab dem Liefertermin als verfügbar und aktualisiert den Bestand, sobald die Bestellung als geliefert markiert wird.

3. Planung zurückschreiben. Für jeden Auftrag, den die Planungsengine eingeplant oder verschoben hat, ruft die Integration change_multiple_column_values auf. Sie trägt den geplanten Start und das geplante Ende in die Timeline-Spalte ein und füllt die Spalte für die Arbeitsstation. Ein Aufruf pro Item hält die Anzahl der Anfragen gering.

4. Fortschritt vom Shopfloor melden. Bediener erfassen ihre Arbeit mit Mobile Confirmations, dem Production Timer oder Quick Log Mode. Die Zeitbuchungen halten die Planung aktuell. Der entsprechende Statuswert wird an das Board zurückgegeben, sodass der Vertrieb den Fortschritt ohne Rückfragen sieht.

5. Datenhoheit und Konfliktregeln. Halten Sie diese vor dem Produktivstart schriftlich fest:

Konflikte entstehen vor allem, wenn Benutzer die Timeline-Spalte manuell bearbeiten. Vereinbaren Sie, dass nur SkyPlanner diese Spalte beschreibt. Alternativ behandeln Sie eine manuelle Änderung als Anfrage und lassen SkyPlanner neu planen. Autopilot plant automatisch neu, wenn sich in der Produktion etwas ändert.

• Jeder Account bildet Aufträge anders ab. Ein Board pro Kunde, Arbeitsgänge als Items oder Subitems, Maschinen als People- oder Status-Spalten. Ordnen Sie die Spalten für jeden Account anhand ihrer IDs zu, niemals anhand ihrer Titel.
• Tarifabhängige Limits. Free, Basic und Standard erlauben 1.000 API-Aufrufe pro Tag, Pro 10.000 und Enterprise 25.000. Nutzen Sie Webhooks für Änderungen und schreiben Sie Daten gebündelt mit change_multiple_column_values zurück. (Aufruflimits)
• Board-Verknüpfungen sind begrenzt. Basic erlaubt eine Board-Verknüpfung, Standard fünf. Das begrenzt die Anzahl verknüpfter Boards für Arbeitsgänge oder Produkte. (Limits für Connect Boards)
• API-Version fest vorgeben. Die Versionen wechseln quartalsweise. Vor Version 2026-04 waren mehrstufige Boards von der standardmäßigen boards-Abfrage ausgeschlossen.
• Cursor-Gültigkeit. Ein items_page-Cursor ist 60 Minuten gültig. Lange Abgleichläufe müssen sauber neu gestartet werden können.
• Webhook-Limits. Die URL darf höchstens 255 Zeichen lang sein. Nach 30 Minuten enden die Zustellversuche. Der Empfänger muss idempotent sein.
• Einheiten und Zeitdauern. Numbers-Spalten enthalten keine Einheit. Legen Sie vor dem ersten Import fest, ob eine Zeitdauer in Minuten oder Stunden angegeben wird.