monday.com-integratiehandleiding voor productieschema’s met SkyPlanner APS

monday.com biedt één GraphQL API op POST https://api.monday.com/v2. Elk kwartaal verschijnt een versie; met de API-Version-header legt u vast welke versie u gebruikt. Het uitfaseren van functionaliteit wordt ten minste zes maanden van tevoren aangekondigd. (API-versiebeheer)

Een integratie voor het inplannen van productie gebruikt de volgende objecten:

• Boards en groups, vaak gebruikt voor fasen of weken.
• Items en subitems. Een item is meestal een order of taak; subitems bevatten de bewerkingen.
• Kolomwaarden: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards en Mirror.
• Webhooks voor wijzigingsgebeurtenissen.

Voor het uitlezen gebruikt u items_page, genest in een board of group. Een pagina bevat standaard 25 items en “the maximum is 500.” (dit is het maximale aantal). U gaat verder met next_items_page; daarbij geldt: “each cursor will expire 60 minutes after the first request.” (elke cursor verloopt na deze termijn, gerekend vanaf de eerste aanvraag). Filter met query_params om alleen openstaande orders uit te lezen. (items_page)

Voor het schrijven gebruikt u create_item, create_subitem, change_column_value en change_multiple_column_values. Met die laatste werkt u meerdere kolommen van één item bij in één aanroep. Dat is nodig om het productieschema terug te schrijven.

Voor grote hoeveelheden gegevens zijn vanaf API-versie 2026-07 ook ingest_items en backfill_items beschikbaar. U uploadt een CSV naar een vooraf ondertekende URL en vraagt periodiek de status van de verwerking op. (bulkimport)

Maak een abonnement aan met create_webhook(board_id, url, event, config). Een integratie voor het inplannen van productie heeft de volgende gebeurtenissen nodig:

• create_item en create_subitem voor nieuwe orders en bewerkingen.
• change_column_value of change_specific_column_value voor wijzigingen in leverdatum, hoeveelheid of prioriteit.
• change_status_column_value voor statuswijzigingen door gebruikers.
• item_archived, item_deleted en item_moved_to_specific_group voor geannuleerde of afgeronde orders.

Bij het aanmaken van de webhook moet de ontvangende URL reageren op een challenge-token. Voor mislukte afleveringen geldt: “retry once a minute for 30 minutes,” (gedurende die periode elke minuut opnieuw proberen). Daarna stoppen de pogingen. Daarom leest de integratie ook periodiek gegevens uit met items_page en een filter op recent bijgewerkte items, om de gegevens te controleren en gelijk te trekken. (webhooks)

In de andere richting verstuurt SkyPlanner webhooks wanneer de status of het productieschema verandert. De integratieservice ontvangt deze en schrijft de nieuwe datums naar monday.com. Het terugschrijven gebeurt dus op basis van gebeurtenissen.

1. Eerste import van stamgegevens. Lees producten, materialen en openstaande orders uit met items_page. Maak werkcentra, ploegendiensten en planningsbeperkingen aan in SkyPlanner of importeer ze vanuit Excel. Bepaal vroegtijdig of u bewerkingen als subitems of op een gekoppeld bord vastlegt.

2. Orders synchroniseren. Webhooks op het productiebord sturen nieuwe en gewijzigde items als orders naar SkyPlanner. Als u inkooporders op een bord bijhoudt, beschouwt SkyPlanner het bestelde materiaal als beschikbaar op de leverdatum. Zodra de inkooporder als Delivered is gemarkeerd, werkt SkyPlanner de voorraad bij.

3. Productieschema terugschrijven. Voor elke order die de planningsengine heeft ingepland of verplaatst, roept de integratie change_multiple_column_values aan. Deze stelt de Timeline-kolom in op de geplande start- en einddatum en vult de werkcentrumkolom in. Met één aanroep per item blijft het aantal aanvragen laag.

4. Voortgang op de productievloer. Operators registreren hun werk met Mobile Confirmations, de Production Timer of Quick Log Mode. De tijdregistraties houden het productieschema actueel en het bijbehorende Status-label wordt teruggeschreven naar het bord. Zo ziet de verkoopafdeling de voortgang zonder ernaar te hoeven vragen.

5. Gegevenseigenaarschap en conflictregels. Leg deze vast vóór de ingebruikname:

Conflicten ontstaan vooral wanneer gebruikers de Timeline-kolom handmatig bewerken. Spreek af dat alleen SkyPlanner naar die kolom schrijft, of behandel een handmatige wijziging als een verzoek en laat SkyPlanner opnieuw plannen. Autopilot plant automatisch opnieuw wanneer de productie verandert.

• Elk account legt orders anders vast. Eén bord per klant, bewerkingen als items of subitems, machines als People- of Status-kolommen. Koppel kolom-ID’s per account, nooit op basis van de kolomtitel.
• Limieten per abonnement. Free, Basic en Standard staan 1.000 API-aanroepen per dag toe, Pro 10.000 en Enterprise 25.000. Gebruik webhooks voor wijzigingen en schrijf gegevens in batches terug met change_multiple_column_values. (aanroeplimieten)
• Het aantal gekoppelde borden is beperkt. Basic staat één bordkoppeling toe en Standard vijf. Dat beperkt het aantal gekoppelde borden voor bewerkingen of producten. (limieten voor Connect Boards)
• Zet de API-versie vast. Elk kwartaal verschijnt een nieuwe versie. Vóór versie 2026-04 werden borden met meerdere niveaus niet meegenomen in de standaardquery voor boards.
• Vervaltijd van cursors. Een items_page-cursor is 60 minuten geldig. Langdurige controles op gegevensverschillen moeten correct opnieuw kunnen starten.
• Webhooklimieten. De URL mag maximaal 255 tekens bevatten en herhaalpogingen stoppen na 30 minuten. De ontvanger moet idempotent zijn.
• Eenheden en tijdsduur. Numbers-kolommen bevatten geen eenheid. Spreek vóór de eerste import af of een tijdsduur in minuten of uren wordt uitgedrukt.