Przewodnik po integracji Fulcrum z SkyPlanner APS do harmonogramowania produkcji

Fulcrum to jeden produkt chmurowy w architekturze wielodostępnej, więc wszyscy klienci korzystają z tego samego API. Portal dla programistów opisuje je jako publiczne API do „REST API calls directly into your Fulcrum site.” (wywołań REST API bezpośrednio do instancji Fulcrum).

• Specyfikacja. OpenAPI „Fulcrum PublicAPI” v1, do pobrania pod adresem https://api.fulcrumpro.com/swagger/v1/swagger.json. Fulcrum zaleca wygenerowanie na jej podstawie klienta z typowaniem. Strona History zawiera wszystkie zmiany wraz z datami.
• Hosty. Standardowe instancje korzystają z https://api.fulcrumpro.com. Instancje ITAR używają api.fulcrumpro.us, a żądania z tokenami ITAR wysyłane do hosta .com otrzymują odpowiedź 401.
• Sposób wywoływania. Listy pobiera się przez POST .../list z filtrem w treści żądania, stronicowaniem za pomocą Skip i Take oraz sortowaniem przez Sort.Field / Sort.Dir. Wiele obiektów obsługuje PUT, a zlecenia także JSON Patch.

Endpointy używane przez integrację do harmonogramowania:

Na stronie integracji Fulcrum wprost opisano zakres prac: „Every system is a little bit different and requires some configuration.” (Każdy system jest nieco inny i wymaga pewnej konfiguracji). Właśnie tę konfigurację zespół SkyPlanner bierze na siebie podczas wdrożenia.

Fulcrum obsługuje webhooki konfigurowane przez administratora. Od września 2026 webhooki, które kończą się błędem, są wstrzymywane i ponownie testowane codziennie, zamiast ponawiać próby bez końca. Historia API wymienia zdarzenia takie jak PurchaseOrderUpdated i ItemUpdated.

Integracja odczytuje dane z Fulcrum w następujący sposób:

• Otwarte zlecenia są pobierane co kilka minut z filtrem statusów scheduled i inProgress oraz warunkiem hasIncompleteOperations: true. To filtr zalecany przez Fulcrum, aby uzyskać dane zgodne z jego stroną harmonogramu.
• Zamówienia zakupu i stany magazynowe są odczytywane przed każdym przeliczeniem harmonogramu lub po otrzymaniu webhooka PurchaseOrderUpdated, jeśli jest skonfigurowany.
• Pozycje, marszruty technologiczne, urządzenia i zmiany są odczytywane po zmianie danych lub co noc.

W przeciwnym kierunku webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco, więc zapis zwrotny jest wyzwalany zdarzeniami.

1. Początkowy import danych podstawowych. Pobierz pozycje, materiały, marszruty technologiczne, gniazda produkcyjne i urządzenia, a następnie zmiany robocze w działach i przestoje. Każde gniazdo produkcyjne Fulcrum staje się w SkyPlanner grupą stanowisk roboczych, do której należą przypisane do niego urządzenia. Urządzenia wybrane dla każdej operacji marszruty wyznaczają jej dozwolone stanowiska robocze. Urządzenia z ustawieniem Unlimited Capacity, takie jak piece i kabiny lakiernicze, są odwzorowywane jako operacje wsadowe.

2. Synchronizacja zamówień. Odczytaj otwarte zlecenia wraz z pozycjami do wyprodukowania i operacjami, a także otwarte zamówienia zakupu i stany magazynowe. SkyPlanner uznaje zamówiony materiał za dostępny w terminie dostawy zamówienia zakupu i aktualizuje zapas, gdy zamówienie otrzyma status Delivered. Przy każdym ponownym przeliczeniu harmonogramu sprawdzane są zapasy i oczekiwane dostawy z zakupów.

3. Zapis zwrotny harmonogramu. Fulcrum samodzielnie oblicza scheduledStartUtc, scheduledEndUtc i scheduledEquipmentId i zwraca te pola tylko do odczytu. Aktualizacja operacji obsługuje customFields. SkyPlanner zapisuje planowany początek, planowane zakończenie i stanowisko robocze w polach niestandardowych każdej operacji zlecenia, a planowane zakończenie zlecenia — w jego polu niestandardowym. Działy sprzedaży i zakupów widzą terminy ze SkyPlanner bezpośrednio w zleceniu w Fulcrum.

4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę w SkyPlanner za pomocą Mobile Confirmations, Production Timer lub Quick Log Mode. SkyPlanner przesyła czas do Fulcrum przez /api/job-tracking-timers/start i /stop lub jako zakończony blok czasu przez /api/timers. Ilości są przesyłane przez add-quantity-completed, a końcowa liczba sztuk wraz z brakami — przez complete. Kalkulacja kosztów zleceń w Fulcrum pozostaje aktualna.

5. Zasady odpowiedzialności za dane i rozstrzygania konfliktów. Mechanizm harmonogramowania Fulcrum „dictates the order of operations in Job Tracking.” (narzuca kolejność operacji w Job Tracking). Dlatego dla każdej operacji wybierz jeden kanał przekazywania pracy operatorom: kolejkę operatora w SkyPlanner albo Fulcrum Job Tracking. Spisz zasady przed uruchomieniem produkcyjnym:

• Obsada zmian określa dostępność pracowników. Parametr Max Equipment na zmianę w Fulcrum „is usually determined by how many people you have working in a certain area at that time.” (zwykle zależy od liczby osób pracujących w danym obszarze w tym czasie). Konkretnych operatorów i ich zmiany konfiguruje się w SkyPlanner. Ich imiona i nazwiska pochodzą z danych użytkowników w /api/users.
• Operacje są planowane na urządzeniach. Gniazda produkcyjne w Fulcrum to grupy urządzeń, które mogą się wzajemnie zastępować. Zadbaj o prawidłowy dobór urządzeń w marszrucie technologicznej, ponieważ to spośród nich mechanizm harmonogramowania wybiera zasób.
• Zlecenia produkcyjne grupują zadania. Zlecenie produkcyjne grupuje operacje kilku zadań, na przykład w ramach jednego rozkroju. Uruchomienie licznika czasu dla zgrupowanej operacji uruchamia zamiast tego licznik zlecenia produkcyjnego, który obejmuje wszystkie operacje zadań w grupie.
• Ograniczenia rejestrów czasu. Bloki czasu rejestrowane wstecz przez /api/timers „may not be in the future, older than 30 days, or longer than 7 days.” (nie mogą dotyczyć przyszłości, a ich wiek i długość nie mogą przekraczać podanych limitów). Przesyłaj czas na bieżąco, gdy operatorzy go rejestrują.
• Formaty czasu są różne. Zmiany używają czasu lokalnego w formacie HHmm, przestoje i zaplanowane terminy są podawane w UTC, a szacowane czasy operacji — w sekundach.
• Aktualizacja urządzenia zastępuje cały rekord. Żądanie PUT dla urządzenia czyści każde pominięte pole. SkyPlanner tylko odczytuje dane urządzeń — nigdy ich nie zapisuje.
• Instancje ITAR. Użyj hosta .us i tokenu ITAR.