Integracja Sylob ERP — przewodnik po planowaniu produkcji z SkyPlanner APS

Dokumentacja Sylob opisuje dwa publiczne REST API: „L’ERP Sylob expose deux types d’API REST publiques (autrement nommées \”webservices\”) qui autorise la lecture et l’écriture de données.” (ERP Sylob udostępnia dwa rodzaje publicznych REST API, nazywanych również usługami sieciowymi, które umożliwiają odczyt i zapis danych). (Baza wiedzy Forterro)

1. API REST Système d’information (odczyt). Uruchamia zapisane zapytanie (requête) utworzone w funkcji „Interroger le système d’information”. Adres URL do wywołania danego zapytania można uzyskać przez „Autres actions” > „Afficher le web service”. Ma on postać /rest/query/{identifiantQuery}/resultat. Parametry określają limit wyników, formatowanie liczb, zmienne zapytania i strukturę wyników. Domyślnie wyniki są zwracane w XML, a po dodaniu nagłówka Accept: application/json — w JSON. To API jest dostępne w ramach ERP.
2. API REST Action (odczyt i zapis). Uruchamia akcję zdefiniowaną w funkcji „Gérer les actions web service”, czyli katalogu akcji Sylob. Udostępnia dwie operacje: GET /rest/v2/action/{code}/describe zwraca schemat danych akcji, a POST /rest/v2/action/{code}/execute uruchamia ją z treścią żądania w JSON. Dostępne są między innymi następujące typy akcji:

– Modification de données: zmienia jedno lub więcej pól rekordu za pomocą mechanizmu szybkiej edycji Sylob. Describe podaje listę pól dostępnych do edycji. – Message EDI: tworzy, zmienia lub usuwa rekordy za pomocą komunikatu EDI. – Scénario de saisie: uruchamia scenariusz wprowadzania danych, pytanie po pytaniu. Przykład podany przez Sylob to „Déclarer un début ou une fin”, czyli zgłoszenie rozpoczęcia lub zakończenia operacji (Sylob_Action_006). – Publikowanie, przesyłanie i pobieranie dokumentów.

1. Komunikaty EDI. Mechanizm EDI w Sylob obsługuje eksport i import. Standardowy komunikat Sylob_Recup_Decl_Pro pobiera zgłoszenia produkcyjne. (Forterro)
2. Pliki i ETL. Sylob ERP Cloud oferuje „Intégration de fichiers via SFTP pour une migration facile des intégrations existantes.” (integrację plikową przez SFTP, która ułatwia migrację istniejących integracji). (Sylob) Wyniki zapytań można również eksportować do Excela — to szybki sposób na rozpoczęcie testów SkyPlanner.

Publiczna baza wiedzy Sylob nie opisuje subskrypcji wychodzących webhooków. Zmiany trafiają do SkyPlanner przez cykliczne wykonywanie zapisanych zapytań, które filtrują otwarte OF i ostatnie zmiany. Częstotliwość wykonywania zapytań ustalasz samodzielnie.

Sylob chroni ERP przed nadmiernym obciążeniem zapytaniami. Od wersji 2025.Q2 parametr firmy „Protection des API” włącza ograniczanie liczby wywołań na użytkownika i stronicowanie dużych wyników. Sylob zapowiada, że od wersji 2026.Q2 ochrona ta będzie stosowana standardowo. Odpowiedzi zawierają nagłówki RateLimit, a wywołanie przekraczające limit zwraca HTTP 429 Too Many Requests z wartością Retry-After. (Forterro) Uwzględnij to przy projektowaniu synchronizacji: stosuj zapytania przyrostowe, stronicowanie i wydłużanie odstępów między ponowieniami po odpowiedzi 429.

Z kolei SkyPlanner wysyła webhooki przy zmianie stanu lub harmonogramu, więc zapis zwrotny do Sylob jest wyzwalany zdarzeniami.

1. Początkowy import danych podstawowych. Utwórz po jednym zapisanym zapytaniu dla każdego obiektu (articles, nomenclatures, gammes, gniazda produkcyjne, pracownicy) i odczytaj dane przez API Système d’information lub zaimportuj je jednorazowo z pliku wyeksportowanego do Excela. Starannie zaplanuj mapowanie gniazd produkcyjnych. W Sylob centre de charge to grupa zasobów, więc gniazdo z trzema maszynami zwykle staje się w SkyPlanner grupą stanowisk roboczych obejmującą trzy stanowiska robocze.

2. Synchronizacja zleceń. Odczytuj zatwierdzone OF wraz z ich operacjami, a także stany magazynowe i otwarte zamówienia zakupu. SkyPlanner traktuje zamówiony materiał jako dostępny w dniu dostawy podanym w zamówieniu zakupu i aktualizuje zapasy po oznaczeniu zamówienia statusem Delivered. Harmonogram uwzględnia więc zarówno zapasy, jak i planowane dostawy zakupowe.

Harmonogramuj zatwierdzone OF, a nie propozycje CBN. Propozycje zmieniają się przy kolejnym obliczeniu zapotrzebowania netto.

3. Zapis zwrotny harmonogramu. Dla każdej operacji, którą silnik umieścił w harmonogramie lub przesunął, integracja wywołuje akcję Modification de données na operacji OF (Opération d’ordre de fabrication), przekazując planowany początek, planowany koniec i gniazdo produkcyjne. Akcja korzysta z mechanizmu szybkiej edycji Sylob — tego samego, którego używa planista edytujący operację. Describe zwraca pola dostępne do edycji, dzięki czemu integracja sprawdza poprawność danych żądania przed pierwszym wywołaniem. Próba zapisu rekordu edytowanego przez użytkownika kończy się przewidzianym błędem; ponów ją przy następnej zmianie.

4. Zgłoszenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer. Rozpoczęcie i zakończenie są przekazywane zwrotnie przez scenariusz „Déclarer un début ou une fin”. Zapisy czasu pracy i ilości stają się zgłoszeniami produkcyjnymi dla tej samej operacji OF: obejmują czas przezbrojenia, czas wykonania, wyprodukowaną ilość, braki i zakończenie operacji. Jeśli zakład już rejestruje zgłoszenia przez Sylob Apps lub terminale na hali, zachowaj jeden kanał zgłoszeń, aby uniknąć podwójnych wpisów.

5. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:

SkyPlanner nie wymaga CADPLAN ani funkcji planowania przy ograniczonych zdolnościach produkcyjnych w Sylob. Powierz SkyPlanner zarządzanie terminami operacji — gdy dwa systemy planistyczne zapisują te same terminy, wzajemnie nadpisują swoje dane. Gdy za terminy odpowiada SkyPlanner, Autopilot automatycznie aktualizuje harmonogram po każdej istotnej zmianie, a nowe terminy trafiają z powrotem do Sylob.

• Licencja na Action API. Odczyt przez zapisane zapytania jest wliczony w cenę. Zapis przez katalog akcji wymaga modułu „Webservice” w Sylob lub licencji API w MyForterro. Uzgodnij to z opiekunem Sylob przed etapem zapisu danych do systemu.
• Zapytania wyznaczają kontrakt integracji. Odczyt opiera się na zapisanych zapytaniach. Nadawaj im jednoznaczne nazwy, przekazuj filtry jako zmienne atrybuty podczas wywołania i wersjonuj zapytania razem z integracją.
• Grupowanie zasobów. Jedno gniazdo produkcyjne w Sylob może obejmować kilka maszyn. Dla każdego gniazda zdecyduj, czy SkyPlanner ma je widzieć jako jedną grupę stanowisk roboczych, czy jako poszczególne maszyny.
• Planowanie wstecz i obliczanie obciążenia. Sylob planuje wstecz od terminów zapotrzebowania, a zaplanowane obliczenie obciążenia może zmieniać harmonogram opóźnionych OF. Uzgodnij, która funkcja — jeśli w ogóle jakakolwiek — nadal może zapisywać terminy operacji, gdy zarządza nimi już SkyPlanner.
• Jednostki czasu przezbrojenia i wykonania. Przed importem sprawdź jednostki oraz to, czy czas przezbrojenia jest określony dla całego OF, czy dla sztuki. Błędne jednostki zniekształcają wszystkie czasy trwania.
• Kalendarze. Tygodniowe rozkłady pracy gniazd produkcyjnych i wyjątki muszą obejmować cały horyzont harmonogramu. W przeciwnym razie zdolności produkcyjne znikną z planu.
• Limity wywołań. Sylob ogranicza liczbę wywołań na użytkownika i dzieli duże zestawy wyników na strony. Przyrostowe odpytywanie pozostawia duży zapas względem limitu.
• CORS i przeglądarki. Wywołania między serwerami nie podlegają ograniczeniom CORS. Klienty przeglądarkowe wymagają skonfigurowania dozwolonych źródeł po stronie Sylob.