monday.com integrációs útmutató a SkyPlanner APS-sel végzett gyártásütemezéshez

A monday.com egyetlen GraphQL API-t biztosít a POST https://api.monday.com/v2 címen. Negyedévente jelenik meg új verzió; a használni kívánt verziót az API-Version fejlécben rögzítheti. A kivezetéseket legalább hat hónappal előre bejelentik. (API-verziókezelés)

Az ütemezési integráció a következő objektumokat használja:

• Boards és groups: gyakran szakaszok vagy hetek szerinti felosztásra használják őket.
• Items és subitems. Egy elem általában egy rendelést vagy gyártási feladatot jelöl, az alelemek pedig a műveleteket tartalmazzák.
• Column values: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards és Mirror.
• Webhookok a változási eseményekhez.

Az adatokat a táblába vagy csoportba ágyazott items_page lekérdezéssel olvashatja ki. Az alapértelmezett oldalméret 25 elem; a felső határ: „the maximum is 500.” (a maximum ötszáz). A folytatáshoz a next_items_page használható. A kurzorok érvényességéről a dokumentáció ezt írja: „each cursor will expire 60 minutes after the first request.” (minden kurzor az első kéréstől számított hatvan perc múlva lejár). A query_params segítségével szűrjön a nyitott rendelésekre. (items_page)

Az íráshoz a create_item, create_subitem, change_column_value és change_multiple_column_values hívások használhatók. Az utóbbi egyetlen hívással frissíti egy elem több oszlopát, éppen erre van szükség az ütemterv visszaírásához.

Nagy adatmennyiségek betöltéséhez a 2026-07-es és újabb API-verziókban az ingest_items és a backfill_items is elérhető. Egy CSV-fájlt kell feltölteni egy előre aláírt URL-re, majd időközönként lekérdezni a feldolgozás állapotát. (Tömeges importálás)

Hozzon létre feliratkozást a create_webhook(board_id, url, event, config) hívással. Az ütemezési integrációhoz a következő események szükségesek:

• create_item és create_subitem az új rendelésekhez és műveletekhez.
• change_column_value vagy change_specific_column_value a határidő, a mennyiség vagy a prioritás változásaihoz.
• change_status_column_value a felhasználók által végzett állapotváltoztatásokhoz.
• item_archived, item_deleted és item_moved_to_specific_group a lemondott vagy teljesített rendelésekhez.

A fogadó URL-nek a webhook létrehozásakor válaszolnia kell az ellenőrző tokenre. A sikertelen kézbesítések újrapróbálásáról a dokumentáció ezt írja: „retry once a minute for 30 minutes,” (harminc percen át percenként egyszer újrapróbálkozik), ezután az újrapróbálkozások leállnak. Ezért az integráció időszakos adategyeztető lekérdezést is végez az items_page használatával, a nemrég frissített elemekre szűrve. (Webhookok)

A másik irányban a SkyPlanner webhookokat küld, ha az állapot vagy az ütemterv megváltozik. Az integrációs szolgáltatás fogadja ezeket, és visszaírja az új dátumokat a monday.com-ba, így a visszaírás eseményvezérelt.

1. A törzsadatok kezdeti betöltése. Kérdezze le a termékeket, anyagokat és nyitott rendeléseket az items_page használatával. Hozza létre a munkaállomásokat, műszakokat és korlátokat a SkyPlannerben, vagy importálja őket Excelből. Már az elején döntse el, hogy a műveleteket alelemként vagy összekapcsolt táblán kezeli.

2. Rendelések szinkronizálása. A gyártási tábla webhookjai rendelésként küldik el az új és módosított elemeket a SkyPlannernek. Ha a beszerzési rendeléseket is táblán követi, a SkyPlanner a megrendelt anyagot a szállítás napjától tekinti elérhetőnek, és frissíti a készletet, amikor a beszerzési rendelés megkapja a Delivered jelölést.

3. Az ütemterv visszaírása. Az integráció minden olyan rendelésnél meghívja a change_multiple_column_values műveletet, amelyet az ütemezőmotor elhelyezett vagy áthelyezett. A Timeline oszlopba beírja a tervezett kezdést és befejezést, és kitölti a munkaállomás oszlopát. Elemenként egyetlen hívásra van szükség, így alacsony marad a kérések száma.

4. Üzemi előrehaladás. A dolgozók a Mobile Confirmations, a Production Timer vagy a Quick Log Mode segítségével rögzítik a munkát. Az időbejegyzések naprakészen tartják az ütemtervet, a megfelelő Status címke pedig visszakerül a táblára, így az értékesítés külön kérdezés nélkül is látja az előrehaladást.

5. Adatgazdai és ütközéskezelési szabályok. Rögzítse őket az éles indulás előtt:

Az ütközések fő oka a Timeline oszlop kézi szerkesztése. Állapodjanak meg abban, hogy ezt az oszlopot kizárólag a SkyPlanner írhatja, vagy kezeljék a kézi módosítást kérésként, és bízzák az újraütemezést a SkyPlannerre. Az Autopilot automatikusan újraütemez, ha változás történik a gyártásban.

• Minden fiókban másképp épülnek fel a rendelések. Ügyfelenként külön tábla, a műveletek elemként vagy alelemként, a gépek pedig People vagy Status oszlopokban szerepelhetnek. Az oszlopazonosítókat fiókonként rendelje hozzá, soha ne az oszlop neve alapján.
• A csomagok korlátai. A Free, a Basic és a Standard naponta 1 000 API-hívást engedélyez, a Pro 10 000-et, az Enterprise pedig 25 000-et. A változások követéséhez használjon webhookokat, a kötegelt visszaíráshoz pedig a change_multiple_column_values műveletet. (API-hívási korlátok)
• A táblakapcsolatok száma korlátozott. A Basic egy táblakapcsolatot engedélyez, a Standard ötöt, ami korlátozza a kapcsolható műveleti vagy terméktáblák számát. (A Connect Boards korlátai)
• Rögzítse az API verzióját. A verziók negyedévente változnak. A 2026-04 verzió előtt a többszintű táblák nem szerepeltek az alapértelmezett boards lekérdezés eredményében.
• A kurzor lejárata. Az items_page kurzora 60 percig érvényes. A hosszú egyeztetési folyamatoknak képesnek kell lenniük az elejéről, hibamentesen újraindulni.
• A webhookok korlátai. Az URL legfeljebb 255 karakterből állhat, az újrapróbálkozások pedig 30 perc után leállnak. A fogadó oldalnak idempotensnek kell lennie.
• Mértékegységek és időtartamok. A Numbers oszlopok nem tartalmaznak mértékegységet. Az első importálás előtt egyeztessék, hogy az időtartamokat percben vagy órában adják meg.