Integracja monday.com z SkyPlanner APS do harmonogramowania produkcji — przewodnik

monday.com udostępnia jedno GraphQL API pod adresem POST https://api.monday.com/v2. Nowe wersje są wydawane co kwartał, a konkretną wersję wskazujesz w nagłówku API-Version. Wycofywanie funkcji jest zapowiadane z co najmniej sześciomiesięcznym wyprzedzeniem. (Wersjonowanie API)

Integracja do harmonogramowania wykorzystuje następujące obiekty:

• Boards i groups — tablice i grupy, często używane do podziału na etapy lub tygodnie.
• Items i subitems — elementy i podelementy. Element zwykle reprezentuje zamówienie lub operację, a podelementy zawierają operacje.
• Column values: Status, Date, Timeline, Numbers, People, Dependency, Time Tracking, Connect Boards i Mirror.
• Webhooks do powiadamiania o zmianach.

Do odczytu służy items_page zagnieżdżone w tablicy lub grupie. Domyślnie strona zawiera 25 elementów, a „the maximum is 500.” (tyle elementów można pobrać maksymalnie). Kolejne strony pobierasz przez next_items_page, przy czym „each cursor will expire 60 minutes after the first request.” (każdy kursor wygasa po wskazanym czasie od pierwszego żądania). Użyj filtra query_params, aby odczytywać tylko otwarte zamówienia. (items_page)

Do zapisu służą create_item, create_subitem, change_column_value i change_multiple_column_values. Ostatnia z tych metod aktualizuje kilka kolumn jednego elementu w jednym wywołaniu — właśnie tego wymaga zapis harmonogramu z powrotem do monday.com.

Do wczytywania dużych ilości danych API od wersji 2026-07 udostępnia ingest_items i backfill_items. Przesyłasz plik CSV pod wstępnie podpisany adres URL, a następnie cyklicznie sprawdzasz status zadania. (Import zbiorczy)

Utwórz subskrypcję za pomocą create_webhook(board_id, url, event, config). Integracja do harmonogramowania wymaga następujących zdarzeń:

• create_item i create_subitem dla nowych zamówień i operacji.
• change_column_value lub change_specific_column_value dla zmian terminu realizacji, ilości lub priorytetu.
• change_status_column_value dla zmian statusu wprowadzanych przez użytkowników.
• item_archived, item_deleted i item_moved_to_specific_group dla anulowanych lub zakończonych zamówień.

Przy tworzeniu webhooka punkt odbiorczy pod wskazanym adresem URL musi odpowiedzieć na token weryfikacyjny. W razie nieudanej próby dostarczenia obowiązuje zasada „retry once a minute for 30 minutes,” (ponawianie co minutę przez wskazany czas), po czym próby ustają. Dlatego integracja dodatkowo okresowo odczytuje dane za pomocą items_page, z filtrem obejmującym ostatnio zaktualizowane elementy, aby uzgodnić dane. (Webhooki)

W przeciwnym kierunku SkyPlanner wysyła webhooki po zmianie stanu lub harmonogramu. Usługa integracyjna odbiera je i zapisuje nowe terminy w monday.com, więc zapis zwrotny jest wyzwalany zdarzeniami.

1. Początkowe wczytanie danych podstawowych. Odczytaj produkty, materiały i otwarte zamówienia za pomocą items_page. Utwórz stanowiska robocze, zmiany robocze i ograniczenia w SkyPlanner lub zaimportuj je z programu Excel. Już na początku ustal, czy operacje będą zapisywane jako podelementy, czy na połączonej tablicy.

2. Synchronizacja zamówień. Webhooki na tablicy produkcyjnej przesyłają nowe i zmienione elementy do SkyPlanner jako zamówienia. Jeśli prowadzisz zamówienia zakupu na tablicy, SkyPlanner traktuje zamówiony materiał jako dostępny w dniu dostawy i aktualizuje stan magazynowy po oznaczeniu zamówienia zakupu statusem Delivered.

3. Zapis harmonogramu do monday.com. Dla każdego zamówienia, które silnik umieścił lub przesunął w harmonogramie, integracja wywołuje change_multiple_column_values. Wpisuje planowany początek i koniec do kolumny Timeline oraz uzupełnia kolumnę stanowiska roboczego. Jedno wywołanie na element pozwala utrzymać niską liczbę żądań.

4. Postęp prac na hali produkcyjnej. Operatorzy rejestrują pracę za pomocą Mobile Confirmations, Production Timer lub Quick Log Mode. Dzięki zapisom czasu pracy harmonogram pozostaje aktualny, a odpowiednia etykieta Status trafia z powrotem na tablicę. Dział sprzedaży widzi więc postęp bez dopytywania.

5. Odpowiedzialność za dane i zasady rozstrzygania konfliktów. Spisz je przed uruchomieniem:

Głównym źródłem konfliktów jest ręczna edycja kolumny Timeline. Ustal, że zapisuje w niej tylko SkyPlanner, albo traktuj ręczną zmianę jako zgłoszenie i pozwól SkyPlanner ponownie ułożyć harmonogram. Autopilot automatycznie aktualizuje harmonogram, gdy w produkcji zachodzą zmiany.

• Na każdym koncie zlecenia są odwzorowane inaczej. Osobna tablica dla każdego klienta, operacje jako elementy lub podelementy, maszyny w kolumnach People lub Status. Mapuj identyfikatory kolumn dla każdego konta osobno, nigdy według nazw kolumn.
• Limity planów. Plany Free, Basic i Standard pozwalają na 1 000 wywołań API dziennie, Pro na 10 000, a Enterprise na 25 000. Używaj webhooków do obsługi zmian i grupuj zapisy zwrotne za pomocą change_multiple_column_values. (limity wywołań)
• Liczba połączonych tablic jest ograniczona. Basic pozwala na jedno połączenie z tablicą, a Standard na pięć, co ogranicza liczbę powiązanych tablic operacji lub produktów. (limity Connect Boards)
• Ustaw stałą wersję API. Wersje zmieniają się co kwartał. Przed wersją 2026-04 domyślne zapytanie boards nie uwzględniało tablic wielopoziomowych.
• Wygasanie kursora. Kursor items_page jest ważny przez 60 minut. Długie procesy uzgadniania danych muszą umożliwiać poprawne ponowne uruchomienie od początku.
• Ograniczenia webhooków. Adres URL może mieć najwyżej 255 znaków, a ponawianie prób kończy się po 30 minutach. Odbiornik musi być idempotentny.
• Jednostki i czasy trwania. Kolumny Numbers nie zawierają jednostki. Przed pierwszym importem ustal, czy czas trwania jest wyrażony w minutach, czy w godzinach.