Ghid de integrare monday.com pentru programarea producției cu SkyPlanner APS

monday.com pune la dispoziție un singur GraphQL API la POST https://api.monday.com/v2. Versiunile sunt lansate trimestrial, iar versiunea utilizată se fixează prin antetul API-Version. Retragerile din uz sunt anunțate cu cel puțin șase luni înainte. (Versionarea API-ului)

Obiectele folosite pentru integrarea cu un sistem de programare a producției:

• Boards și groups, folosite adesea pentru etape sau săptămâni.
• Items și subitems. Un element reprezintă de obicei o comandă sau o operație, iar subelementele conțin operațiile.
• Valorile coloanelor: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards și Mirror.
• Webhookuri pentru evenimentele de modificare.

Citirea datelor se face cu items_page, inclus într-un panou sau grup. O pagină conține implicit 25 de elemente, iar limita este „the maximum is 500.” (acesta este numărul maxim de elemente). Citirea continuă cu next_items_page, iar „each cursor will expire 60 minutes after the first request.” (fiecare cursor expiră după acest interval, calculat de la prima cerere). Folosiți query_params pentru a filtra datele și a citi doar comenzile deschise. (items_page)

Scrierea datelor se face cu create_item, create_subitem, change_column_value și change_multiple_column_values. Ultima metodă actualizează mai multe coloane ale unui element printr-un singur apel, exact ce este necesar pentru a scrie programul de producție înapoi în monday.com.

Pentru încărcări de volume mari de date, versiunea API 2026-07 și versiunile ulterioare adaugă ingest_items și backfill_items. Încărcați un fișier CSV la un URL presemnat, apoi verificați periodic starea procesului. (Import în masă)

Creați un abonament cu create_webhook(board_id, url, event, config). Pentru integrarea cu un sistem de programare a producției sunt necesare următoarele evenimente:

• create_item și create_subitem pentru comenzi și operații noi.
• change_column_value sau change_specific_column_value pentru modificări ale termenului de livrare, cantității sau priorității.
• change_status_column_value pentru schimbările de stare efectuate de utilizatori.
• item_archived, item_deleted și item_moved_to_specific_group pentru comenzi anulate sau finalizate.

La crearea webhookului, URL-ul receptor trebuie să răspundă la un token de verificare. Regula pentru livrările eșuate este „retry once a minute for 30 minutes,” (reîncercați o dată pe minut pe durata indicată), după care încercările se opresc. De aceea, integrarea citește periodic datele și pentru reconciliere, folosind items_page cu un filtru pentru elementele actualizate recent. (Webhookuri)

În sens invers, SkyPlanner trimite webhookuri când se schimbă starea sau programul de producție. Serviciul de integrare le primește și scrie noile date în monday.com. Astfel, scrierea înapoi este declanșată de evenimente.

1. Încărcarea inițială a nomenclatoarelor. Citiți produsele, materialele și comenzile deschise cu items_page. Creați centrele de lucru, schimburile și constrângerile în SkyPlanner sau importați-le din Excel. Stabiliți de la început dacă operațiile vor fi păstrate ca subelemente sau într-un panou asociat.

2. Sincronizarea comenzilor. Webhookurile din panoul de producție trimit elementele noi și modificate către SkyPlanner sub formă de comenzi. Dacă urmăriți comenzile de achiziție într-un panou, SkyPlanner consideră materialul comandat disponibil la data livrării și actualizează stocul când comanda de achiziție este marcată ca Delivered.

3. Scrierea programului de producție înapoi în monday.com. Pentru fiecare comandă programată sau mutată de motor, integrarea apelează change_multiple_column_values. Completează coloana Timeline cu începutul și sfârșitul programate, precum și coloana centrului de lucru. Un singur apel pentru fiecare element menține numărul de cereri la un nivel redus.

4. Progresul din secția de producție. Operatorii înregistrează activitatea cu Mobile Confirmations, Production Timer sau Quick Log Mode. Înregistrările de timp mențin programul de producție la zi, iar eticheta Status corespunzătoare este trimisă înapoi în panou. Astfel, echipa de vânzări vede progresul fără să mai ceară informații.

5. Responsabilitatea pentru date și regulile de soluționare a conflictelor. Documentați-le înainte de punerea în funcțiune:

Principala sursă de conflicte este modificarea manuală a coloanei Timeline de către utilizatori. Stabiliți că doar SkyPlanner scrie în această coloană sau tratați modificările manuale ca solicitări și lăsați SkyPlanner să refacă programarea. Autopilot reface automat programarea când apar schimbări în producție.

• Fiecare cont modelează comenzile diferit. Un panou pentru fiecare client, operații reprezentate ca elemente sau subelemente, utilaje reprezentate prin coloane People sau Status. Mapați ID-urile coloanelor pentru fiecare cont, niciodată după titlul coloanei.
• Limitele abonamentelor. Free, Basic și Standard permit 1.000 de apeluri API pe zi, Pro 10.000, iar Enterprise 25.000. Folosiți webhook-uri pentru modificări și scrieți datele înapoi în loturi cu change_multiple_column_values. (limitele de apelare)
• Numărul de panouri conectate este limitat. Basic permite conectarea unui singur panou, iar Standard a cinci, ceea ce limitează panourile de operații sau produse care pot fi asociate. (limitele Connect Boards)
• Fixați versiunea API. Versiunile se schimbă trimestrial. Înainte de versiunea 2026-04, panourile cu mai multe niveluri erau excluse din interogarea implicită a panourilor.
• Expirarea cursorului. Un cursor items_page este valabil 60 de minute. Procesele lungi de reconciliere trebuie să poată fi reluate de la început fără erori.
• Limitele webhook-urilor. URL-ul poate avea cel mult 255 de caractere, iar reîncercările se opresc după 30 de minute. Componenta care primește notificările trebuie să fie idempotentă.
• Unități de măsură și durate. Coloanele Numbers nu au o unitate de măsură asociată. Stabiliți înainte de primul import dacă duratele sunt exprimate în minute sau în ore.