Integracje / ERP / Lemonsoft
Przewodnik po integracji Lemonsoft z systemem SkyPlanner APS do harmonogramowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Lemonsoft ERP ze SkyPlanner APS. Integracja SkyPlanner z Lemonsoft działa dwukierunkowo przez REST API Lemonsoft:
- Do SkyPlanner trafiają numery zleceń (työnumero), operacje (työvaihe), maszyny, struktury produktów, materiały i zaplanowane zmiany robocze.
- Planowane terminy rozpoczęcia i zakończenia oraz wybrana maszyna są zapisywane z powrotem w operacjach.
- Potwierdzenia operatorów wracają jako wpisy rejestrujące wykonanie.
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Kaskea Group korzysta ze SkyPlanner z dwukierunkową integracją z Lemonsoft. Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji Lemonsoft klienta i zapewnia jej wsparcie po uruchomieniu produkcyjnym. Partnerzy i programiści mogą również tworzyć własne rozwiązania w oparciu o udokumentowane REST API SkyPlanner (dokumentacja API).
REST API Lemonsoft
API integracyjne Lemonsoft to LemonRest, udokumentowane w formacie Swagger 2.0, w wersji v1. Wydanie „LemonRest 2026.10 release-2026.10.2” zawiera 422 ścieżki. (Swagger)
- Bazowy adres URL jest przypisany do środowiska. Znajdziesz go w zarządzaniu użytkownikami, w sekcji zarządzania środowiskami i adresów usług, w polu Rest API. Na platformie Azure Lemonsoft jest to
https://rest.lemon.fi. - Dostępność. U klientów korzystających z usługi platformowej Lemonsoft (Alustapalvelu) interfejsy REST API są już zainstalowane. Wystarczy nadać uprawnienia użytkownikowi. (źródło)
- Środowisko testowe. Klient końcowy zamawia je w Lemonsoft Service Desk.
Oddzielne API Kellokortti do ewidencji czasu pracy nie jest potrzebne do harmonogramowania.
Uwierzytelnianie
LemonRest korzysta z sesji:
POST /api/auth/loginz parametrami UserName, Password, Database i ApiKey zwracasession_id.- Przesyłaj go w nagłówku
Session-Idprzy każdym wywołaniu. - Odnawiaj sesję przez
POST /api/auth/renew. Do sprawdzania jej stanu służyGET /api/auth/alive.
POST /api/auth/login/token przyjmuje Token zamiast nazwy użytkownika i hasła. Utwórz osobnego użytkownika integracji z kluczem API i wyłącznie uprawnieniami niezbędnymi do jej działania. (źródło)
Po stronie SkyPlanner REST API korzysta z uwierzytelniania tokenem API (SkyPlanner Settings > API) i ma dokumentację w formacie Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Wykrywanie zmian: zapytania przyrostowe
LemonRest nie udostępnia endpointów webhooków ani subskrypcji. Zmiany odczytuje się za pomocą zapytania przyrostowego:
GET /api/production/main_ws/changed?updated_after=...zwraca operacje zmienione od ostatniego uruchomienia.- Dodaj
optimization=true. Parametr ten wprowadzono w wydaniu 2026.6.3, aby usunąć zależność od dziennika i przyspieszyć zapytanie. (informacje o wydaniu) GET /api/log/deletion_eventswykrywa usunięte operacje, dzięki czemu anulowane prace znikają z harmonogramu.
Odpytuj API co kilka minut. SkyPlanner wysyła webhooki przy zmianie stanu lub harmonogramu, więc zapis zwrotny działa w oparciu o zdarzenia.
Mapowanie danych
| Obiekt Lemonsoft (endpoint) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
Tuote, product_code (/api/products) | Produkty i materiały | Lemonsoft → SkyPlanner | Import początkowy, następnie przy zmianach |
Tuoterakenne z wierszami Työvaiheet (/api/products/structure, all_levels) | Struktura produktu, podprodukty, etapy procesu z czasami przezbrojenia | Lemonsoft → SkyPlanner | Import początkowy, następnie przy zmianach |
Kone, Koneryhmä (/api/production/machines, /api/settings/machine_groups) | Stanowiska robocze, grupy stanowisk roboczych | Lemonsoft → SkyPlanner | Import początkowy, później sporadycznie |
Työnumero jako ProductMainWorkStage (/api/production/workstage, main_ws/changed) | Zlecenia z terminami realizacji i priorytetem | Lemonsoft → SkyPlanner | Odpytanie o zmiany co kilka minut |
Työvaihe jako ProductSubWorkStage (main_ws/sub_ws): machine, setting_time, duration, work_amount_left | Operacje (etapy procesu) na poszczególnych stanowiskach roboczych | Lemonsoft → SkyPlanner | Odpytanie o zmiany co kilka minut |
Zapotrzebowanie na komponenty (main_ws/{worknumber}/materials) | Zapotrzebowanie materiałowe dla każdej operacji | Lemonsoft → SkyPlanner | Wraz z każdą operacją |
Zaplanowane zmiany robocze (/api/persons/plannedshifts) | Zmiany robocze, personel | Lemonsoft → SkyPlanner | Codziennie lub zarządzanie zmianami roboczymi w SkyPlanner |
Zamówienie sprzedaży powiązane z numerem zlecenia (/api/orders/work/{work_number}) | Informacje o kliencie i priorytecie | Lemonsoft → SkyPlanner | Wraz z każdą operacją |
Pola start_time, end_time, machine_id w Työvaihe (PUT /api/production/workstage) | Planowane rozpoczęcie, zakończenie i stanowisko robocze | SkyPlanner → Lemonsoft | Przy zmianie harmonogramu, przez webhook SkyPlanner |
Wpis rejestrujący wykonanie (POST main_ws/sub_ws/completion_entry) | Potwierdzenia: ilość wykonana i liczba braków, godziny, osoba | SkyPlanner → Lemonsoft | Przy każdym potwierdzeniu |
| Reguły harmonogramowania ustawione w SkyPlanner | Dozwolone stanowiska robocze dla każdej operacji, macierz czasów przezbrojenia, narzędzia | Zarządzane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Odczytaj maszyny i ich grupy, struktury produktów wraz z operacjami oraz standardowe etapy pracy. Przypisz każdą konkretną maszynę do stanowiska roboczego w SkyPlanner. Maszyn nadrzędnych (Isäkone) używaj wyłącznie do grupowania, ponieważ sumują one zdolności produkcyjne maszyn podrzędnych.
2. Synchronizacja numerów zleceń. Odczytaj otwarte numery zleceń wraz z operacjami z /api/production/workstage lub main_ws/sub_ws, stosując filtrowanie według stanu i stronicowanie. Następnie aktualizuj je przez main_ws/changed. Mapuj work_amount_left, a nie work_amount, ponieważ Lemonsoft harmonogramuje na podstawie ilości pozostałej do wykonania. Zamówienia zakupu dostarczają danych do harmonogramowania w SkyPlanner z uwzględnieniem dostępności materiałów, więc operacja czeka do terminu dostawy z zamówienia zakupu.
3. Zapis zwrotny harmonogramu. Dla każdej operacji, którą silnik umieścił w harmonogramie lub przesunął, SkyPlanner wysyła PUT /api/production/workstage ze zleceniem i jego sub_workstages. Każda operacja zawiera start_time i end_time, a po przeniesieniu na alternatywną maszynę także machine_id.
4. Potwierdzenia z hali produkcyjnej. Operatorzy potwierdzają wykonanie pracy za pomocą SkyPlanner Mobile Confirmations lub Production Timer. Każde potwierdzenie trafia do completion_entry z polami sub_workstage_id, person_number, done_amount, hours, failed_amount i job_done. Jeśli operacja zużywa materiał, dołącz material_consumptions, a Lemonsoft zaksięguje standardowe wykonanie produkcji (valmistuskirjaus).
5. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Produkty, struktury, operacje, ilości, stan operacji | Lemonsoft |
| Kolejność operacji, terminy rozpoczęcia i zakończenia, wybór maszyny | SkyPlanner |
| Dozwolone stanowiska robocze dla każdej operacji, macierz czasów przezbrojenia, narzędzia | SkyPlanner |
| Zmiany robocze i nieobecności | Jeden system, wybrany przy określaniu zakresu |
| Rejestracja wykonania i księgowania magazynowe | Lemonsoft, na podstawie potwierdzeń ze SkyPlanner |
Głównym źródłem konfliktów są automatyczne harmonogramowanie w Lemonsoft i funkcja odświeżania: oba mechanizmy ponownie rozmieszczają niezablokowane operacje. Gdy za harmonogram odpowiada SkyPlanner, utrzymuj AUTOTIMING na wartości 0. Jeśli pozostawisz tę funkcję włączoną, ustaw blokadę harmonogramu dla każdego zapisywanego numeru zlecenia — unieruchamia ona wszystkie jego operacje. Sama funkcja Koneiden kapasiteetin lukitus nie wystarczy, ponieważ automatyczne harmonogramowanie przenosi niezablokowane operacje poza zablokowany dzień. (źródło)
Typowy przebieg 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: numerach zleceń, operacjach i maszynach wyeksportowanych do pliku Excel.
- Określenie zakresu. Ustal tabelę mapowania, odpowiedzialność za dane i częstotliwość odpytywania.
- Dostęp. Klient końcowy zamawia środowisko testowe w Lemonsoft Service Desk oraz tworzy użytkownika integracji i klucz API.
- Import początkowy. Maszyny, grupy, struktury produktów i operacje.
- Synchronizacja numerów zleceń. Cykliczne odpytywanie o zmiany, zdarzenia usunięcia i odnawianie sesji.
- Konfiguracja ograniczeń w SkyPlanner. Dozwolone stanowiska robocze dla każdej operacji, macierz czasów przezbrojeń i narzędzia.
- Zapis zwrotny. Terminy rozpoczęcia i zakończenia operacji oraz wpisy potwierdzające wykonanie, sprawdzone w środowisku testowym.
- Praca równoległa i uruchomienie produkcyjne. Porównaj wyniki z obecnym wykresem Gantta, popraw dane podstawowe, a następnie włącz zapis zwrotny w środowisku produkcyjnym.
Co uwzględnić przy planowaniu integracji z Lemonsoft
- Jedna maszyna na etap. W Lemonsoft do etapu przypisana jest jedna maszyna. Podczas wdrożenia określa się na podstawie listy lub właściwości produktu, które maszyny mogą go wytwarzać. SkyPlanner wybiera następnie spośród tych maszyn.
- Dzienna zdolność produkcyjna. Stała zdolność produkcyjna jest określana jako wielkość dzienna, a odstępstwa nie mają przypisanych godzin. Odwzoruj rzeczywiste zmiany robocze w SkyPlanner lub odczytaj zaplanowane zmiany.
- Pozostała ilość. Zmapuj
work_amount_left. Ustawienia STARTJOB_AUTOTIMENOW i JOBDONE_AUTOTIMENOW przesuwają również obciążenie w samym Lemonsoft. - Sesje wygasają. Odnawiaj sesję przed długimi synchronizacjami i uwzględnij obsługę wymuszonego ponownego logowania.
- Zasady potwierdzania. Przed wysłaniem każdego potwierdzenia sprawdź jego zgodność ze stanem etapu i rozłóż w czasie serie wywołań.
- Dwie aplikacje klienckie. LemonOnline i wersja dla Windows korzystają z jednej bazy danych, więc integracja obsługuje obie.
- Rozbudowane struktury. Przy dużych importach używaj
/api/async/product/structurewraz z/api/async/status/{jobId}.
Integracja z Lemonsoft: kto ją konfiguruje i zapewnia wsparcie
Prace obejmują mapowanie danych z uwzględnieniem maszyn, etapów pracy i konfiguracji Lemonsoft w Twoim zakładzie. Obejmują też reguły harmonogramowania przechowywane w SkyPlanner: dozwolone stanowiska robocze dla każdej operacji, macierz czasów przezbrojeń i narzędzia.
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Każdy zakład korzysta z Lemonsoft inaczej — właśnie na tym etapie wykorzystujemy wiedzę o tych różnicach.
- Twój partner Lemonsoft może uczestniczyć w pracach. Zna Twoją konfigurację i może zająć się kontem użytkownika API, uprawnieniami i środowiskiem testowym. SkyPlanner udostępnia REST API, dokumentację Swagger/OpenAPI i webhooki.
- Twoi programiści mogą rozwijać integrację, korzystając z tego samego udokumentowanego REST API i tokena API. Do rozpoczęcia prac wystarczy token API, a zespół SkyPlanner pomoże w razie potrzeby.
Po połączeniu systemów silnik Arcturus układa harmonogram na podstawie bieżących zleceń w Lemonsoft, a zaplanowane terminy są zapisywane w etapach pracy. Cena SkyPlanner zaczyna się od 199 € miesięcznie i obejmuje 5 stanowisk roboczych, z rozliczeniem co miesiąc. Integrację wyceniamy z góry, odpowiednio do Twoich procesów i potrzeb, razem z wybranym planem. Dzięki temu znasz pełny koszt przed rozpoczęciem prac.
Zobacz, jak wypadają w porównaniu własne funkcje planowania Lemonsoft, w artykule Harmonogramowanie produkcji w Lemonsoft z uwzględnieniem rzeczywistych zdolności maszyn i personelu. Ogólne informacje znajdziesz na stronie Lemonsoft, a pozostałe systemy — w katalogu integracji z ERP.
Opinie firm produkcyjnych o SkyPlanner
Lemonsoftdwukierunkowa integracja ze SkyPlanner
Kaskea Group
Produkcja kontraktowa: obróbka CNC, konstrukcje stalowe i montaż
Produkcja jest planowana w SkyPlanner, który jest dwukierunkowo zintegrowany z Lemonsoft.
Mniejprzestojów z powodu braków materiałowych
„Wartość SkyPlanner polega dla nas na tym, że to narzędzie sprawdza się w codziennej pracy, zwłaszcza przy ustalaniu terminów dostaw.”
Tommi Männistö, kierownik ds. planowania produkcji
Eskomatic · Obróbka na zlecenie
Automatyczne harmonogramowanie obciążenia pozwala dokładniej wyznaczać terminy dostaw, a liczba przestojów produkcyjnych spowodowanych brakami materiałowymi znacznie spadła.
2 hoszczędności co tydzień
„Dzięki SkyPlanner przeszliśmy od planowania produkcji w arkuszach Excel do optymalizacji produkcji w czasie rzeczywistym.”
Kalle Kalliomäki, specjalista ds. łańcucha dostaw
UTU · Rozdzielnice i aparatura łączeniowa
Planowanie produkcji zajmuje o 2 godziny pracy mniej w każdym tygodniu, 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.
Najczęściej zadawane pytania
Czy Lemonsoft udostępnia API do danych produkcyjnych?
Tak. LemonRest udostępnia zlecenia produkcyjne i etapy pracy, maszyny, struktury produktów, materiały i zmiany robocze oraz umożliwia rejestrowanie wykonania. U klientów Alustapalvelu jest już zainstalowany. Wymaga klucza API i uprawnień użytkownika.
Czy Lemonsoft obsługuje webhooki?
W LemonRest nie wymieniono żadnych endpointów webhooków. Co kilka minut system pobiera zmiany za pomocą zapytania przyrostowego main_ws/changed oraz sprawdza zdarzenia usunięcia. Własne webhooki SkyPlanner wysyłają zmiany harmonogramu na bieżąco.
Jak zaplanowane terminy są zapisywane z powrotem w Lemonsoft?
Za pomocą PUT /api/production/workstage, które aktualizuje zlecenie i jego etapy pracy, zapisując czas rozpoczęcia, czas zakończenia i maszynę. Gdy SkyPlanner zarządza harmonogramem, pozostaw automatyczne harmonogramowanie Lemonsoft wyłączone lub ustaw blokadę harmonogramu dla każdego zapisywanego numeru zlecenia. Dzięki temu terminy pozostaną takie, jak ustalił je SkyPlanner.
Czy potwierdzenia operatorów ze SkyPlanner mogą trafiać do Lemonsoft?
Tak. Każde potwierdzenie jest zapisywane jako wpis wykonania zawierający ilość wykonaną i ilość braków, godziny oraz osobę. W projektach klientów działa to na co dzień.
Kto tworzy integrację z Lemonsoft?
Zespół SkyPlanner podczas wdrożenia konfiguruje dwukierunkową integrację zgodnie z Twoją konfiguracją Lemonsoft i zapewnia wsparcie po uruchomieniu produkcyjnym. Twój partner Lemonsoft lub Twoi programiści mogą również tworzyć rozwiązania w oparciu o udokumentowane REST API SkyPlanner. Do rozpoczęcia prac wystarczy token API.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. Bezpłatny 30-dniowy okres próbny pozwala korzystać z maksymalnie 20 stanowisk roboczych i importować dane z Lemonsoft w plikach Excel lub CSV. Nie wymaga karty kredytowej. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
