Guide til monday.com-integration med SkyPlanner APS til produktionsplanlægning

monday.com stiller ét GraphQL API til rådighed på POST https://api.monday.com/v2. Der udgives en ny version hvert kvartal, og I låser integrationen til en version med headeren API-Version. Udfasninger varsles mindst seks måneder i forvejen. (API-versionering)

En integration til detailplanlægning bruger følgende objekter:

• Boards og groups, som ofte bruges til faser eller uger.
• Items og subitems. Et item er normalt en ordre eller opgave, mens subitems indeholder operationerne.
• Kolonneværdier: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards og Mirror.
• Webhooks til hændelser ved ændringer.

Data læses med items_page indlejret i et board eller en gruppe. En side indeholder som standard 25 elementer, og “the maximum is 500.” (dette er maksimum). I henter de næste sider med next_items_page, og “each cursor will expire 60 minutes after the first request.” (hver cursor udløber efter det angivne antal minutter regnet fra den første forespørgsel). Filtrer med query_params for kun at læse åbne ordrer. (items_page)

Data skrives med create_item, create_subitem, change_column_value og change_multiple_column_values. Sidstnævnte opdaterer flere kolonner for ét element i et enkelt kald. Det er netop det, der er brug for, når planen skal skrives tilbage.

Til store datamængder findes ingest_items og backfill_items fra API-version 2026-07 og frem. I uploader en CSV-fil til en forhåndssigneret URL og forespørger derefter løbende om jobbets status. (masseimport)

Opret et abonnement med create_webhook(board_id, url, event, config). En integration til detailplanlægning har brug for følgende hændelser:

• create_item og create_subitem til nye ordrer og operationer.
• change_column_value eller change_specific_column_value til ændringer i leveringsfrist, antal eller prioritet.
• change_status_column_value til statusændringer foretaget af brugere.
• item_archived, item_deleted og item_moved_to_specific_group til annullerede eller afsluttede ordrer.

Den modtagende URL skal svare på et challenge-token, når webhooken oprettes. Ved mislykkede leveringer gælder: “retry once a minute for 30 minutes,” (der forsøges igen hvert minut i det angivne tidsrum), hvorefter forsøgene stopper. Derfor foretager integrationen også periodiske afstemninger ved at læse med items_page og filtrere på nyligt opdaterede elementer. (webhooks)

I den anden retning sender SkyPlanner webhooks, når tilstanden eller planen ændres. Integrationstjenesten modtager dem og skriver de nye datoer til monday.com. Tilbageskrivningen er dermed hændelsesstyret.

1. Første indlæsning af stamdata. Læs produkter, materialer og åbne ordrer med items_page. Opret arbejdsstationer, skift og begrænsninger i SkyPlanner, eller importer dem fra Excel. Afgør tidligt, om operationer skal ligge som subitems eller på et tilknyttet board.

2. Ordresynkronisering. Webhooks på produktionsboardet sender nye og ændrede items til SkyPlanner som ordrer. Hvis I registrerer indkøbsordrer på et board, regner SkyPlanner det bestilte materiale som tilgængeligt på leveringsdatoen og opdaterer lagerbeholdningen, når indkøbsordren markeres som Delivered.

3. Tilbageskrivning af planen. Integrationen kalder change_multiple_column_values for hver ordre, som planlægningsmotoren har placeret eller flyttet. Den angiver planlagt start og slut i Timeline-kolonnen og udfylder kolonnen med arbejdsstationen. Ét kald pr. item holder antallet af forespørgsler nede.

4. Fremdrift på produktionsgulvet. Operatørerne registrerer arbejdet med Mobile Confirmations, Production Timer eller Quick Log Mode. Tidsregistreringerne holder planen ajour, og den tilsvarende Status-etiket skrives tilbage til boardet, så salgsafdelingen kan se fremdriften uden at spørge.

5. Dataejerskab og regler for konflikter. Skriv dem ned før idriftsættelsen:

Den største kilde til konflikter er manuelle ændringer i Timeline-kolonnen. Aftal, at kun SkyPlanner skriver til den kolonne, eller behandl en manuel ændring som en anmodning, og lad SkyPlanner omplanlægge. Autopilot omplanlægger automatisk, når produktionen ændrer sig.

• Ordrer modelleres forskelligt på hver konto. Ét board pr. kunde, operationer som items eller subitems, maskiner som People- eller Status-kolonner. Map kolonne-ID’er for hver konto, aldrig ud fra kolonnetitlen.
• Abonnementets grænser. Free, Basic og Standard tillader 1.000 API-kald pr. dag, Pro 10.000 og Enterprise 25.000. Brug webhooks til ændringer, og saml tilbageskrivninger med change_multiple_column_values. (kaldgrænser)
• Der er en grænse for forbundne boards. Basic tillader én boardforbindelse og Standard fem, hvilket begrænser antallet af tilknyttede boards med operationer eller produkter. (grænser for Connect Boards)
• Lås API-versionen. Versionerne skifter hvert kvartal. Før version 2026-04 var boards med flere niveauer ikke med i standardforespørgslen efter boards.
• Cursorens udløbstid. En items_page-cursor er gyldig i 60 minutter. Langvarige afstemninger skal kunne genstartes korrekt fra bunden.
• Begrænsninger for webhooks. URL’en må højst være 255 tegn lang, og genforsøg stopper efter 30 minutter. Modtageren skal være idempotent.
• Enheder og varigheder. Numbers-kolonner har ingen enhed. Aftal før den første import, om varigheder angives i minutter eller timer.