Guide til monday.com-integrasjon for produksjonsplanlegging med SkyPlanner APS

monday.com tilbyr ett GraphQL API på POST https://api.monday.com/v2. Det får nye versjoner hvert kvartal, og du låser integrasjonen til en versjon med API-Version-headeren. Utfasing varsles minst seks måneder i forveien. (API-versjonering)

En integrasjon for produksjonsplanlegging bruker disse objektene:

• Boards og groups, som ofte brukes til faser eller uker.
• Items og subitems. Et element er vanligvis en ordre eller jobb, mens underelementene inneholder operasjoner.
• Kolonneverdier: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards og Mirror.
• Webhooks for endringshendelser.

Data leses med items_page nøstet under en tavle eller gruppe. En side inneholder som standard 25 elementer, og «the maximum is 500.» (dette er øvre grense). Du henter neste side med next_items_page, og «each cursor will expire 60 minutes after the first request.» (hver markør utløper etter den angitte tiden, regnet fra første forespørsel). Filtrer med query_params for å lese bare åpne ordrer. (items_page)

Data skrives med create_item, create_subitem, change_column_value og change_multiple_column_values. Den siste oppdaterer flere kolonner for ett element i ett enkelt kall, slik tilbakeskriving av planen krever.

For store datamengder er ingest_items og backfill_items tilgjengelige fra API-versjon 2026-07. Du laster opp en CSV-fil til en forhåndssignert URL og sjekker jobbstatusen med jevne mellomrom. (masseimport)

Opprett et abonnement med create_webhook(board_id, url, event, config). En integrasjon for produksjonsplanlegging trenger disse hendelsene:

• create_item og create_subitem for nye ordrer og operasjoner.
• change_column_value eller change_specific_column_value for endringer i leveringsfrist, antall eller prioritet.
• change_status_column_value for statusendringer gjort av brukere.
• item_archived, item_deleted og item_moved_to_specific_group for kansellerte eller fullførte ordrer.

Mottaker-URL-en må svare på et verifiseringstoken når webhooken opprettes. Ved mislykket levering gjelder «retry once a minute for 30 minutes,» (nye forsøk hvert minutt i den angitte perioden), før forsøkene stopper. Derfor leser integrasjonen også data regelmessig for avstemming med items_page og et filter for nylig oppdaterte elementer. (webhooks)

I motsatt retning sender SkyPlanner webhooks når tilstanden eller planen endres. Integrasjonstjenesten mottar dem og skriver de nye datoene til monday.com. Tilbakeskrivingen er dermed hendelsesstyrt.

1. Førstegangsinnlasting av grunndata. Les produkter, materialer og åpne ordrer med items_page. Opprett arbeidsstasjoner, skift og begrensninger i SkyPlanner, eller importer dem fra Excel. Avklar tidlig om operasjoner skal ligge som underelementer eller på en tilknyttet tavle.

2. Ordresynkronisering. Webhooks på produksjonstavlen sender nye og endrede elementer til SkyPlanner som ordrer. Hvis du følger opp innkjøpsordrer på en tavle, regner SkyPlanner bestilt materiale som tilgjengelig på leveringsdatoen og oppdaterer lagerbeholdningen når innkjøpsordren merkes som Levert.

3. Tilbakeskriving av planen. Integrasjonen kaller change_multiple_column_values for hver ordre planleggingsmotoren har plassert eller flyttet. Den setter Timeline-kolonnen til planlagt start og slutt og fyller ut kolonnen for arbeidsstasjon. Ett kall per element holder antallet forespørsler nede.

4. Fremdrift på produksjonsgulvet. Operatørene registrerer arbeid med Mobile Confirmations, Production Timer eller Quick Log Mode. Tidsregistreringene holder planen oppdatert, og den tilhørende Status-etiketten sendes tilbake til tavlen. Dermed kan salgsavdelingen se fremdriften uten å spørre.

5. Regler for dataeierskap og konflikter. Dokumenter dem før løsningen settes i drift:

Den vanligste kilden til konflikter er at brukere redigerer Timeline-kolonnen manuelt. Avtal at bare SkyPlanner skal skrive til denne kolonnen, eller behandle en manuell endring som en forespørsel og la SkyPlanner planlegge på nytt. Autopilot planlegger automatisk på nytt når produksjonen endres.

• Hver konto modellerer ordrer forskjellig. Én tavle per kunde, operasjoner som elementer eller underelementer, maskiner som People- eller Status-kolonner. Koble feltene etter kolonne-ID for hver konto, aldri etter kolonnetittel.
• Abonnementsgrenser. Free, Basic og Standard tillater 1 000 API-kall per dag, Pro 10 000 og Enterprise 25 000. Bruk webhooks for endringer og skriv tilbake flere verdier samlet med change_multiple_column_values. (grenser for API-kall)
• Antallet tavlekoblinger er begrenset. Basic tillater én tavlekobling og Standard fem. Det begrenser hvor mange tavler for operasjoner eller produkter som kan kobles til. (grenser for Connect Boards)
• Lås API-versjonen. Versjonene endres hvert kvartal. Før versjon 2026-04 var tavler med flere nivåer ikke inkludert i standardspørringen for boards.
• Utløp av markør. En items_page-markør er gyldig i 60 minutter. Lange avstemmingskjøringer må kunne startes på nytt fra bunnen av.
• Begrensninger for webhooks. URL-en kan være på høyst 255 tegn, og nye leveringsforsøk stopper etter 30 minutter. Mottakeren må være idempotent.
• Enheter og varighet. Numbers-kolonner angir ingen enhet. Avtal om varighet skal oppgis i minutter eller timer før første import.