Integracje / ERP / Acumatica Cloud ERP
Przewodnik po integracji Acumatica ze SkyPlanner APS do harmonogramowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Acumatica Cloud ERP (Manufacturing Edition) ze SkyPlanner APS. Integracja SkyPlanner z Acumatica działa w obu kierunkach:
- Do SkyPlanner trafiają zlecenia produkcyjne wraz z operacjami, gniazda produkcyjne, maszyny, narzędzia, zmiany robocze, pozycje magazynowe i zamówienia zakupu.
- Planowane daty rozpoczęcia i zakończenia są zapisywane w operacjach zlecenia produkcyjnego, a samo zlecenie zostaje zamrożone.
- Rejestry czasu pracy operatorów wracają do Acumatica jako zapisy pracy i przesunięć.
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji Acumatica i zapewnia jej wsparcie po uruchomieniu produkcyjnym. Ten przewodnik jest przeznaczony dla partnerów i programistów, którzy chcą uczestniczyć w tych pracach lub samodzielnie tworzyć rozwiązania oparte na udokumentowanym REST API SkyPlanner (dokumentacja API).
Interfejsy integracyjne Acumatica
Integracja korzysta z interfejsów dostępnych standardowo w Acumatica. W instancji nie instaluje się żadnych dodatków.
- REST API oparte na kontraktach. Endpointy są wersjonowane zgodnie z wydaniami systemu. Endpoint Manufacturing (na przykład 26.200.001 dla 2026 R2) udostępnia
ProductionOrder,OrderOperationDetail,BillOfMaterial,WorkCenter,Machine,Tool,Shift,WorkCenterCrewSchedule,LaborEntry,MoveEntryiMaterialEntry. Endpoint Default obejmujeStockItem,PurchaseOrderiSalesOrder. Adresy URL mają postać{instance}/entity/{Endpoint}/{version}/{Entity}. - Akcje w tym samym endpoincie.
FirmProductionOrder,UndoFirmProductionOrder,ReleaseLaborEntry,ReleaseMoveEntryiReleaseMaterialEntrywykonują tę samą logikę co przyciski na ekranach systemu. - OData. Każde zapytanie Generic Inquiry (SM208000) można udostępnić przez OData. Najszybszy sposób masowego odczytu to Generic Inquiry obejmujące otwarte operacje produkcyjne wraz z datami.
- Powiadomienia push (SM302000). Opierają się na Generic Inquiry lub wbudowanym zapytaniu i wysyłają dodane oraz usunięte wiersze pod skonfigurowany adres URL.
- Scenariusze importu i eksportu z dostawcami danych CSV i Excel do masowego ładowania danych.
Listę encji i akcji można znaleźć na ekranie Web Service Endpoints (SM207000) oraz w repozytorium klienta REST Acumatica.
Uwierzytelnianie i limity
Acumatica korzysta z OAuth 2.0 i OpenID Connect za pośrednictwem aplikacji klienckich zarejestrowanych na ekranie Connected Applications (SM303010). Udokumentowane przepływy to Authorization Code, Implicit, Resource Owner Password Credentials i Hybrid. Na potrzeby integracji serwerowej zarejestruj dedykowanego użytkownika integracyjnego z rolami o minimalnych uprawnieniach. Użyj przepływu Authorization Code z tokenem odświeżania lub Resource Owner Password Credentials.
Limity wynikają z licencji: ekran License Monitoring Console (SM604000) pokazuje dozwoloną liczbę żądań API na minutę i użytkowników API.
Po stronie SkyPlanner REST API korzysta z uwierzytelniania tokenem API (SkyPlanner Settings > API), a jego dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Mapowanie danych
| Obiekt Acumatica (endpoint / formularz) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
StockItem (Default; Stock Items IN202500) | Produkty i materiały | Acumatica → SkyPlanner | Import początkowy, następnie przyrostowo |
BillOfMaterial (AM208000): materiały, operacje | Struktura produktu, podprodukty, materiały przypisane do produktu | Acumatica → SkyPlanner | Import początkowy, następnie po zmianach |
| Operacje BOM: Setup, Run, Machine, Queue, Finish, Move Time | Etapy procesu z czasami trwania, przygotowania i czynności końcowych | Acumatica → SkyPlanner | Import początkowy, następnie po zmianach |
WorkCenter (AM207000), Machine (AM204500), WorkCenterSubstitute | Stanowiska robocze, grupy stanowisk roboczych, wskaźniki wydajności, alternatywne stanowiska robocze | Acumatica → SkyPlanner | Import początkowy, później sporadycznie |
Shift, Work Calendar (CS209000), WorkCenterCrewSchedule | Zmiany robocze i dostępność personelu | Acumatica → SkyPlanner | Codziennie lub zarządzanie zmianami roboczymi w SkyPlanner |
Tool (AM205500) | Narzędzia jako zasoby produkcyjne o ograniczonej dostępności | Acumatica → SkyPlanner | Import początkowy |
ProductionOrder z OrderOperationDetail (Planned, Released, In Process) | Zlecenia i zadania z terminami realizacji, priorytetem wykonania i zapotrzebowaniem materiałowym | Acumatica → SkyPlanner | Powiadomienia push lub odpytywanie co kilka minut |
Pozycje PurchaseOrder (Default) | Zamówienia zakupu z przewidywaną datą dostawy | Acumatica → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
| Ilości pozycji w magazynach | Stany magazynowe | Acumatica → SkyPlanner | Odpytywanie co godzinę lub przy uruchomieniu harmonogramowania |
OrderOperationDetail: StartDate, EndDate, WorkCenter | Planowany początek, koniec i stanowisko robocze każdej operacji | SkyPlanner → Acumatica | Po zmianie harmonogramu, przez webhook SkyPlanner |
Akcja FirmProductionOrder | Chroni zapisane daty przed zmianą przez Acumatica APS | SkyPlanner → Acumatica | Po każdym zapisie zwrotnym |
LaborEntry, MoveEntry z akcjami zatwierdzania | Rejestry czasu pracy, wykonane ilości, potwierdzenia operatorów | SkyPlanner → Acumatica | Po każdym potwierdzeniu lub raz na zmianę roboczą |
| Brak w Acumatica | Macierz czasów przezbrojeń, operatorzy wskazani imiennie, zadania dla wielu operatorów | Zarządzane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Najpierw odczytaj gniazda produkcyjne, maszyny, narzędzia, zmiany robocze i kalendarze. Następnie odczytaj pozycje magazynowe i zestawienia materiałowe. Ustal, jak odwzorować gniazdo produkcyjne z kilkoma maszynami: jako jedną grupę stanowisk roboczych, w której maszyny są stanowiskami, czy jako jedno stanowisko robocze. Pole Basis for Capacity w Acumatica wskazuje, które podejście stosuje zakład.
2. Synchronizacja zleceń. Zlecenia produkcyjne wraz z operacjami odczytuj ze zleceń, a nie z BOM. Operacje są kopiowane do zlecenia i to tam planiści je zmieniają. Skonfiguruj powiadomienia push dla Generic Inquiry obejmującego otwarte zlecenia i operacje albo odpytuj to zapytanie cyklicznie. Odczytuj też otwarte pozycje zamówień zakupu. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy podanym w zamówieniu zakupu i aktualizuje stan magazynowy, gdy zamówienie otrzyma status Delivered.
3. Zapis zwrotny harmonogramu. Dla każdej operacji umieszczonej lub przesuniętej w harmonogramie przez silnik SkyPlanner zapisuje StartDate i EndDate w OrderOperationDetail. Jeśli pracę przeniesiono do alternatywnego gniazda produkcyjnego, zapisuje również to gniazdo. Następnie wywołuje FirmProductionOrder. Acumatica: „When you run finite scheduling of production orders, the system does not reschedule the firmed production orders.” (Podczas harmonogramowania zleceń produkcyjnych z uwzględnieniem ograniczonych zdolności produkcyjnych system nie zmienia harmonogramu zamrożonych zleceń.) (źródło)
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą SkyPlanner Mobile Confirmations lub Production Timer. Rejestry czasu pracy są przekształcane w dokumenty LaborEntry (czas i wykonana ilość dla każdej operacji) lub MoveEntry (tylko ilość), zatwierdzane odpowiednią akcją. Jeśli na hali praca jest już raportowana w Acumatica przez Labor (AM301000) lub Shop Floor Kiosk, dane o postępie płyną w przeciwnym kierunku. Wybierz jeden kanał, nigdy oba.
5. Odpowiedzialność za dane i reguły rozwiązywania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Pozycje magazynowe, BOM, ilości, status zlecenia, kalkulacja kosztów | Acumatica |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, przypisanie stanowisk roboczych | SkyPlanner |
| Macierz czasów przezbrojeń, narzędzia, wymagania dotyczące operatorów, alternatywne zasoby produkcyjne | SkyPlanner |
| Zmiany robocze i nieobecności | Jeden system, wybrany podczas określania zakresu |
| Transakcje pracy i przesunięć | Acumatica — zapisy na podstawie rejestrów czasu pracy SkyPlanner lub danych wprowadzanych na hali produkcyjnej |
Głównym źródłem konfliktów jest własny APS systemu Acumatica. Rough Cut Planning lub APS Maintenance Process mogą przeliczyć terminy zleceń, dla których SkyPlanner utworzył harmonogram. Zamrożenie każdego zapisanego zlecenia zapobiega takim zmianom. Zlecenia ujęte w harmonogramie należy też wykluczyć z przebiegów APS.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia prac wdrożeniowych. Wcześniej można skorzystać z 30-dniowego bezpłatnego okresu próbnego na własnych danych. Wyeksportuj z Generic Inquiry do Excela gniazda produkcyjne i otwarte zlecenia produkcyjne wraz z operacjami, zaimportuj je i zweryfikuj harmonogram.
- Mapowanie. Ustal tabelę mapowania, zasady odpowiedzialności za dane, częstotliwość synchronizacji i sposób księgowania czasu pracy.
- Dostęp. Zarejestruj aplikację kliencką, utwórz użytkownika integracyjnego i role oraz potwierdź wersję punktu końcowego w Web Service Endpoints. Zacznij od środowiska testowego.
- Początkowe załadowanie danych. Gniazda produkcyjne, maszyny, narzędzia, zmiany robocze, pozycje magazynowe i BOM.
- Synchronizacja zleceń i zamówień. Zlecenia produkcyjne, operacje i zamówienia zakupu przesyłane za pomocą powiadomień push lub cyklicznego odpytywania.
- Konfiguracja ograniczeń w SkyPlanner. Macierz czasów przezbrojeń, przypisani imiennie operatorzy, zadania wymagające wielu operatorów i warianty alternatywne.
- Zapis zwrotny. Terminy operacji, zamrażanie zleceń oraz zapisy czasu pracy lub przesunięć.
- Praca równoległa. Porównaj terminy ze SkyPlanner z bieżącym planem i popraw dane podstawowe.
- Uruchomienie produkcyjne. Włącz zapis zwrotny, gdy dane będą zgodne.
Co uwzględnić przy integracji z Acumatica
- Sprawdź, który silnik APS jest włączony. Classic i Optimized przechowują ustawienia oddzielnie, a włączony może być tylko jeden z nich. Przed pierwszym zapisem zwrotnym sprawdź Enable/Disable Features (CS100000).
- Ustaw stałą wersję punktu końcowego. Wersja jest częścią adresu URL. Aktualizacja systemu dodaje nową wersję, dlatego przy każdej aktualizacji ponów testy.
- Aktualizacja operacji. Niektóre pola operacji są dostępne przez REST tylko do odczytu. Znaczenie ma też status zlecenia. Przetestuj w środowisku testowym sekwencję zapisu zwrotnego dla zleceń ze statusem Released i In Process.
- Jednostki i pola czasu. Czas wykonania odnosi się do Run Units, a czas maszynowy do Machine Units. Czasy oczekiwania i transportu „affect the calculated schedule but do not occupy work center capacity.” (wpływają na obliczony harmonogram, ale nie zajmują zdolności produkcyjnych gniazda). Zadbaj o poprawne przeliczenia podczas importu.
- Ocena dostępności materiałów. Classic APS wymaga dostępności wszystkich materiałów w pełnej ilości. SkyPlanner planuje na podstawie zapasów i terminów dostaw z zamówień zakupu. Ustal, na wynikach którego systemu mają opierać się planiści.
- Limity API. Liczba żądań na minutę zależy od licencji. Odczytuj tylko zmienione dane i korzystaj z powiadomień push zamiast ponownie ładować cały zestaw danych.
Kto konfiguruje i obsługuje integrację z Acumatica
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Każdy zakład korzysta z Acumatica inaczej — właśnie na tym etapie wykorzystujemy wiedzę o tych różnicach.
- W pracach może uczestniczyć Twój partner Acumatica. Zna on Twoje modyfikacje, Generic Inquiries i role. SkyPlanner udostępnia REST API, dokumentację Swagger/OpenAPI i webhooki.
- Twoi programiści mogą samodzielnie zbudować integrację, korzystając z tego samego REST API i tokenu API. Do rozpoczęcia prac wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby. Laboratory & Allied wybrało tę drogę przy integracji z SAP Business One: wewnętrzny zespół IT zbudował integrację w dużej mierze samodzielnie, przy wsparciu SkyPlanner.
Cena SkyPlanner zaczyna się od 199 € miesięcznie i obejmuje 5 stanowisk roboczych, z rozliczeniem co miesiąc. Integrację wyceniamy z góry, wraz z wybranym planem, na podstawie Twoich procesów i potrzeb. Dzięki temu znasz pełny koszt przed rozpoczęciem prac. Sprawdź porównanie z własnym APS systemu Acumatica w artykule Harmonogramowanie produkcji w Acumatica z uwzględnieniem dostępnych zdolności produkcyjnych, ogólne informacje na stronie Acumatica oraz inne systemy w centrum integracji z ERP.
Opinie firm produkcyjnych o SkyPlanner
2 hoszczędności co tydzień
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excela do optymalizacji produkcji w czasie rzeczywistym.”
Kalle Kalliomäki, specjalista ds. łańcucha dostaw
UTU · Rozdzielnice i aparatura rozdzielcza
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka zadań trafia na linię w kilka sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, szef działu IT
Laboratory & Allied · Produkcja farmaceutyczna
Wydajność produkcji wzrosła o 90%, a przygotowanie zoptymalizowanego planu na trzy miesiące dla wszystkich stanowisk roboczych zajmuje mniej niż 30 minut.
1 000 i więcejzleceń automatycznie ujętych w harmonogramie
„Mamy teraz zupełnie inną kontrolę nad produkcją, a nasza wiedza o zdolnościach produkcyjnych jest na całkiem innym poziomie.”
Hannu Ryynänen, prezes
Mamec · Mieszalniki przemysłowe, pompy i zaawansowana technologicznie produkcja kontraktowa
Tysiące zleceń są automatycznie ujmowane w harmonogramie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
99,2%terminowości dostaw
„SkyPlanner zapewnił nam wgląd potrzebny do identyfikacji wąskich gardeł i uporządkował zarządzanie produkcją.”
Toni Tuori, kierownik produkcji
Piristeel · Systemy bezpieczeństwa dachowego i systemy rynnowe
Terminowość dostaw osiągnęła w tym roku 99,2%, a harmonogramowanie pozwala zaoszczędzić do czterech godzin pracy dziennie.
Najczęściej zadawane pytania
Czy API Acumatica udostępnia zlecenia produkcyjne?
Tak. Punkt końcowy Manufacturing w REST API opartym na kontraktach udostępnia ProductionOrder, OrderOperationDetail, BillOfMaterial, WorkCenter, Machine, Tool oraz zapisy czasu pracy i przesunięć, a także akcje takie jak FirmProductionOrder.
Kto tworzy integrację z Acumatica?
Zespół SkyPlanner konfiguruje dwukierunkową integrację zgodnie z konfiguracją Twojego systemu Acumatica podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Twój partner Acumatica lub Twoi programiści mogą również tworzyć integrację przy użyciu udokumentowanego REST API SkyPlanner. Do rozpoczęcia prac wystarczy token API.
Czy do tej integracji potrzebujemy Acumatica APS?
Nie. Acumatica uruchamia własne harmonogramowanie z uwzględnieniem dostępnych zdolności produkcyjnych za pomocą formularza Rough Cut Planning, a Classic APS planuje zlecenia kończące się po upływie 120 dni bez ograniczeń zdolności produkcyjnych (źródło). SkyPlanner samodzielnie tworzy szczegółowy harmonogram uwzględniający dostępne zdolności produkcyjne na podstawie zleceń produkcyjnych, operacji, gniazd produkcyjnych, maszyn i narzędzi. Integracja działa więc niezależnie od tego, czy APS jest włączony — według Acumatica moduł ten „is subject to licensing” (podlega licencjonowaniu). Autopilot utrzymuje harmonogram na bieżąco, a operatorzy rejestrują pracę za pomocą Mobile Confirmations.
Jak zapobiec nadpisywaniu terminów ze SkyPlanner przez Acumatica APS?
SkyPlanner blokuje możliwość przeplanowania każdego zlecenia produkcyjnego po zapisaniu terminów jego operacji. Harmonogramowanie w Acumatica uwzględniające dostępne zdolności produkcyjne nie zmienia terminów tak zablokowanych zleceń.
Czy Acumatica może przesyłać zmiany w czasie rzeczywistym?
Tak. Powiadomienia push (SM302000) skonfigurowane dla Generic Inquiry wysyłają zmienione wiersze pod wskazany adres URL na bieżąco. Webhooki SkyPlanner przesyłają zmiany harmonogramu w przeciwnym kierunku.
Z jakiego uwierzytelniania powinna korzystać integracja?
Z OAuth 2.0 za pośrednictwem klienta zarejestrowanego w Connected Applications (SM303010), z dedykowanym użytkownikiem integracyjnym i rolami o minimalnych wymaganych uprawnieniach. Przepływ uwierzytelniania dla Twojej instancji potwierdzamy podczas określania zakresu integracji.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. W 30-dniowym bezpłatnym okresie próbnym można korzystać z maksymalnie 20 stanowisk roboczych i importować dane z Generic Inquiry w Acumatica przez pliki Excel lub CSV. Karta kredytowa nie jest wymagana. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
