Integracje / ERP / Visma L7
Integracja Visma L7 z APS do planowania produkcji — przewodnik
Ten przewodnik po integracji Visma L7 pokazuje partnerom i zespołom IT, jak połączyć Visma L7 ze SkyPlanner APS. SkyPlanner wymienia dane z Visma L7 w obu kierunkach przez Visma L7 REST API:
- Do SkyPlanner trafiają numery zleceń (työnumero), etapy pracy (työnvaihe), zasoby produkcyjne, struktury produktów, części, materiały, stany magazynowe oraz pozycje zamówień sprzedaży i zakupu.
- Do każdej karty pracy zapisywane są zwrotnie zasób produkcyjny, data rozpoczęcia, priorytet, osoba i godziny na poszczególne dni za pomocą
PUT /manufphases/. - Zdolności produkcyjne w kalendarzu zasobów są synchronizowane za pomocą
POST /resourceupdates/. - Zdarzenia produkcyjne zarejestrowane w kolejkach pracy L7 są odczytywane za pomocą
GET /manufevents/. - Webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji Twojego systemu L7, a po uruchomieniu produkcyjnym zapewnia jej wsparcie. Partnerzy i programiści mogą również tworzyć własne rozwiązania, korzystając z udokumentowanego REST API SkyPlanner (dokumentacja API).
REST API Visma L7
Interfejs nosi nazwę Visma L7 – REST API. Jego dokumentacja jest zgodna z OpenAPI 3.0.3 i zawiera historię zmian (dokumentacja). Działa na Visma LTR.
- Ścieżka bazowa to
/ltrws/REST/L7na Twoim serwerze LTR — lokalnym lub działającym w usłudze hostingu aplikacji Visma. - Licencje. Każdy endpoint wymaga osobnej licencji. Zapis harmonogramu wymaga licencji L7RMFPP dla
PUT /manufphases/, a aktualizacja zdolności produkcyjnych — L7RMCAP. Endpointy odczytu mają własne licencje. - Stronicowanie. Listy są stronicowane za pomocą
pageSizeirecAfter, a filtrowane za pomocąqueryKey1,queryKey2iqueryString.
Uwierzytelnianie
Każde wywołanie L7 zawiera dwa tokeny:
- hash wskazuje bazę danych i firmę.
- token identyfikuje użytkownika API.
Administrator LTR tworzy użytkownika API w Visma LTR, przypisuje go do firmy w L7, nadaje mu profile i tworzy token użytkownika (pierwsze kroki). Użyj osobnego konta do integracji, z uprawnieniami ograniczonymi do tych, których integracja potrzebuje.
Po stronie SkyPlanner uwierzytelnianie w REST API odbywa się za pomocą tokenu API wysyłanego w nagłówku Authorization-Token. Utworzysz go w sekcji Settings > API. Samouczek integracji przeprowadzi Cię przez pierwsze wywołania.
Wykrywanie zmian: modifiedAfter
REST API L7 nie obsługuje webhooków. Zmiany odczytuje się przez cykliczne odpytywanie:
- Włącz rejestrowanie zmian (DBLOG) w narzędziu do obsługi plików L7 (Tiedostohuolto) dla tabel odczytywanych przez integrację, takich jak karty pracy i części.
- Wywołuj endpointy odczytu z
modifiedAfterustawionym na czas ostatniego uruchomienia. Usunięte rekordy są zwracane z oznaczeniem usunięcia, dzięki czemu anulowane prace znikają z harmonogramu. - Odpytuj co kilka minut. SkyPlanner wysyła webhooki przy zmianie stanu lub harmonogramu, więc zapis zwrotny jest sterowany zdarzeniami.
Mapowanie danych
| Obiekt Visma L7 (endpoint) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
Tuote (GET /products/) | Produkty i materiały | L7 → SkyPlanner | Import początkowy, następnie przy zmianach |
Części zlecenia (GET /manufcomponents/) | Podprodukty | L7 → SkyPlanner | Cykliczne odpytywanie z modifiedAfter |
Potrzeby materiałowe (GET /manufmaterials/) | Zapotrzebowanie materiałowe dla każdej operacji | L7 → SkyPlanner | Cykliczne odpytywanie z modifiedAfter |
Drzewo zasobów produkcyjnych (KRYH) z liczbą maszyn (GET /manufresources/) | Stanowiska robocze i ich grupy | L7 → SkyPlanner | Import początkowy, później sporadycznie |
Karta pracy (TSUUNR) dla każdego etapu (GET /manufphases/) | Operacje (kroki procesu) na poszczególnych stanowiskach roboczych | L7 → SkyPlanner | Odpytywanie co kilka minut |
Stany magazynowe (GET /stockbalances/) | Zapasy | L7 → SkyPlanner | Cykliczne odpytywanie |
Pozycje zamówień zakupu (GET /purchaserows/) | Zamówienia zakupu z datami dostaw | L7 → SkyPlanner | Cykliczne odpytywanie |
Zamówienia sprzedaży i ich pozycje (GET /salesorders/, GET /salesrows/) | Terminy realizacji, priorytet klienta | L7 → SkyPlanner | Cykliczne odpytywanie |
Zdarzenia produkcyjne (GET /manufevents/) | Postęp każdej operacji | L7 → SkyPlanner | Cykliczne odpytywanie |
Pola karty pracy: resource, startDate, priority, person, schedulingDays (PUT /manufphases/) | Zaplanowane stanowisko robocze, rozpoczęcie, kolejność i godziny na poszczególne dni | SkyPlanner → L7 | Przy zmianie harmonogramu, przez webhook SkyPlanner |
Zdolności produkcyjne w kalendarzu zasobów (POST /resourceupdates/) | Zdolności produkcyjne na zmianach | SkyPlanner → L7 | Przy zmianie rozkładu zmian |
| Reguły harmonogramowania ustawione w SkyPlanner | Dozwolone stanowiska robocze, macierz czasów przezbrojeń, narzędzia, pracownicy | Utrzymywane w SkyPlanner | Konfiguracja podczas wdrożenia |
Schematy integracji
1. Początkowy import danych podstawowych. Odczytaj drzewo zasobów produkcyjnych i przypisz każdej maszynie osobne stanowisko robocze w SkyPlanner. Jeśli jeden zasób w L7 obejmuje kilka maszyn, utwórz osobne stanowisko dla każdej maszyny oraz grupę stanowisk dla tego zasobu. Odczytaj produkty i ich struktury wraz z etapami pracy.
2. Synchronizacja zleceń. Odczytaj otwarte karty pracy za pomocą GET /manufphases/, a następnie aktualizuj je za pomocą modifiedAfter. Odczytaj części i potrzeby materiałowe dla każdego numeru zlecenia, a także stany magazynowe i pozycje zamówień zakupu, tak aby etap czekał na datę dostawy z powiązanej pozycji zakupu.
3. Zapis zwrotny harmonogramu. SkyPlanner wywołuje PUT /manufphases/ dla każdego etapu, który silnik umieścił lub przesunął w harmonogramie. Treść żądania zawiera jeden wpis workSheet na kartę pracy, z następującymi polami:
number— karta pracy, orazresource— wybrany zasób produkcyjnystartDateipriority— dzięki nim kolejki pracy L7 pokazują kolejność ustaloną przez SkyPlannerperson— gdy zaplanowano konkretnego operatoraschedulingDays— zaplanowane godziny na poszczególne daty
L7 zachowuje bez zmian priorytet nadany przez system zewnętrzny (źródło), dzięki czemu kolejność w kolejkach pracy zostaje utrzymana.
4. Synchronizacja zdolności produkcyjnych. Gdy w SkyPlanner zmienia się rozkład zmian roboczych, dni wolnych lub nadgodzin, POST /resourceupdates/ zapisuje nowe zdolności produkcyjne w kalendarzu zasobów L7. Widoki obciążenia w L7 są wtedy zgodne z planem.
5. Postęp prac na hali. Operatorzy nadal rejestrują pracę w kolejkach L7 i w Visma LTR, a SkyPlanner odczytuje zdarzenia za pomocą GET /manufevents/. Operatorzy mogą też potwierdzać wykonanie pracy w SkyPlanner Mobile Confirmations. Autopilot aktualizuje harmonogram na podstawie danych z każdego z tych źródeł, a kolejny zapis zwrotny przekazuje nowe terminy.
6. Odpowiedzialność za dane i reguły rozstrzygania konfliktów. Spisz je przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Produkty, struktury, etapy pracy, ilości, stan zlecenia | Visma L7 |
| Kolejność etapów, daty rozpoczęcia, godziny na poszczególne dni, wybór zasobu produkcyjnego | SkyPlanner |
| Dozwolone stanowiska robocze, macierz czasów przezbrojeń, narzędzia, pracownicy | SkyPlanner |
| Zmiany robocze i nieobecności | SkyPlanner, z zapisem do kalendarza zasobów L7 |
| Zdarzenia produkcyjne i zapisy magazynowe | Kolejki pracy Visma L7 i LTR |
Głównym źródłem konfliktów jest planowanie w samym L7. Obliczanie zapotrzebowania i planowanie szczegółowe mogą ponownie rozplanować niezablokowane etapy. Uruchamiaj te funkcje wyłącznie na potrzeby materiałów i rezerwacji. Nie planuj ponownie etapów, za które odpowiada SkyPlanner.
Typowe etapy projektu
Wdrożenie zwykle kończy się w ciągu kilku tygodni od rozpoczęcia prac. Wcześniej możesz skorzystać z 30-dniowego bezpłatnego okresu próbnego na własnych danych: numerach zleceń, etapach i zasobach produkcyjnych wyeksportowanych do pliku Excel.
- Określenie zakresu. Ustal tabelę mapowania, reguły odpowiedzialności za dane i częstotliwość odpytywania.
- Dostęp i licencje. Uzyskaj licencje na endpointy REST objęte zakresem integracji. Administrator LTR tworzy użytkownika API, hash i token — najlepiej najpierw w firmie testowej.
- Rejestrowanie zmian. Włącz DBLOG dla odczytywanych tabel.
- Import początkowy. Zasoby produkcyjne, produkty, struktury i etapy pracy.
- Synchronizacja zleceń. Cykliczne odpytywanie z modifiedAfter, obsługa usunięć i stronicowanie.
- Konfiguracja ograniczeń w SkyPlanner. Dozwolone stanowiska robocze, macierz czasów przezbrojeń, narzędzia i pracownicy.
- Zapis zwrotny.
PUT /manufphases/iPOST /resourceupdates/, przetestowane w firmie testowej. - Praca równoległa i uruchomienie produkcyjne. Porównaj wyniki z bieżącym planem, popraw dane podstawowe, a następnie włącz zapis zwrotny w środowisku produkcyjnym.
Co uwzględnić przy planowaniu integracji z Visma L7
- Osobne licencje na każdy endpoint. Już na początku sporządź listę wszystkich endpointów i wykup licencje przed rozpoczęciem testów.
- Liczba maszyn. W L7 praca jest rozdzielana między maszyny należące do jednego zasobu (źródło). Rozdziel taki zasób na stanowiska robocze w SkyPlanner, a przy zapisie zwrotnym przekaż zasób oczekiwany przez L7.
- Godziny na poszczególne dni. L7 przechowuje plan jako liczbę godzin przypisaną do każdej daty. SkyPlanner przesyła
schedulingDays, w których suma godzin odpowiada czasowi trwania etapu. - Kalendarz zakładowy. Zadbaj o jego kompletność, ponieważ luki przesuwają etapy na daty z przeszłości (źródło).
- Zlecenia na magazyn. Pola
mainNumber,subNumber,rowNumberinewQuantitysłużą wyłącznie do zmiany ilości w zleceniu na magazyn. Pomijaj je przy zleceniach dla klientów. - Zmiana systemu ERP. Visma zakończyła rozwój nowych funkcji L7, a możliwość korzystania z produktu kończy się z końcem 2028 roku (komunikat Visma). Przechowuj reguły harmonogramowania w SkyPlanner, a nie w polach L7, aby zachować je po zmianie systemu ERP.
Integracja z Visma L7: kto ją konfiguruje i zapewnia wsparcie
Prace obejmują mapowanie z uwzględnieniem zasobów produkcyjnych, etapów pracy i konfiguracji L7 w Twoim zakładzie. Obejmują też reguły harmonogramowania przechowywane w SkyPlanner: dozwolone stanowiska robocze, macierz czasów przezbrojeń, narzędzia i pracowników.
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Każdy zakład korzysta z L7 nieco inaczej — konfiguracja uwzględnia tę specyfikę.
- Twój partner Visma może uczestniczyć w pracach. Zna konfigurację Twoich systemów L7 i LTR i może zająć się użytkownikiem API, licencjami oraz firmą testową. SkyPlanner udostępnia REST API, dokumentację Swagger/OpenAPI i webhooki.
- Twoi programiści również mogą rozwijać integrację, korzystając z tego samego udokumentowanego REST API i tokena API. Do rozpoczęcia prac wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby.
Gdy zastąpisz L7 innym systemem ERP, połączysz z nim SkyPlanner, zachowując dotychczasową konfigurację. Zobacz strony poświęcone systemom Business Central, Visma Net, Lemonsoft, Monitor ERP i Odoo.
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 abonamentem, odpowiednio do Twojego procesu i potrzeb — dzięki temu znasz pełny koszt przed rozpoczęciem prac.
Sprawdź, jak na tym tle wypada planowanie w samym L7, w artykule Czy Visma L7 oferuje harmonogramowanie produkcji z uwzględnieniem ograniczeń zdolności produkcyjnej? Ogólne informacje znajdziesz na stronie Visma L7, a pozostałe systemy — na stronie integracji z systemami ERP.
Opinie firm produkcyjnych o SkyPlanner
1 000 i więcejzleceń produkcyjnych planowanych automatycznie
„Mamy teraz zupełnie inną kontrolę nad produkcją, a nasza wiedza o zdolnościach produkcyjnych jest na całkiem innym poziomie.”
Hannu Ryynänen, dyrektor generalny
Mamec · Mieszadła przemysłowe, pompy i zaawansowana technologicznie produkcja kontraktowa
Tysiące zleceń produkcyjnych są planowane automatycznie, a cała organizacja ma wgląd w produkcję w czasie rzeczywistym.
98%terminowości dostaw — wzrost z około 50%
„SkyPlanner odgrywa decydującą rolę w utrzymaniu naszej terminowości dostaw.”
Hannu Lahtinen, dyrektor zarządzający
KJH-Comp · Wytwarzanie elementów z blach i produkcja kontraktowa
Terminowość dostaw wzrosła z około 50% do nawet 98%, a harmonogramowaniem zajmuje się teraz jeden kierownik zamiast dwóch.
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 elektryczne i aparatura rozdzielcza
Planowanie produkcji zajmuje o 2 godziny mniej tygodniowo, a nowa kolejka zadań trafia na linię w ciągu kilku sekund.
+90%wydajności produkcji
„Wydajność produkcji wzrosła o 90%.”
Abdul Rucyinga, szef 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 Visma L7 udostępnia API do danych produkcyjnych?
Tak. REST API systemu Visma L7 dostępne w Visma LTR udostępnia etapy pracy, zasoby produkcyjne, części, materiały, zdarzenia produkcyjne, produkty, stany magazynowe oraz pozycje sprzedaży i zakupów. Każdy endpoint wymaga osobnej licencji, a administrator LTR tworzy użytkownika API i tokeny.
Jak harmonogram jest zapisywany z powrotem w Visma L7?
Za pomocą PUT /manufphases/, które aktualizuje zasób, datę rozpoczęcia, priorytet, osobę i planowane godziny na poszczególne dni dla każdej karty pracy. POST /resourceupdates/ zapisuje zdolność produkcyjną w kalendarzu zasobów. L7 zachowuje priorytet z zewnętrznego systemu, więc kolejki zadań są zgodne z kolejnością ustaloną w SkyPlanner.
Czy Visma L7 obsługuje webhooki?
Dokumentacja nie opisuje webhooków. Włącz rejestrowanie zmian dla tabel objętych integracją i cyklicznie odpytuj je z użyciem modifiedAfter. Własne webhooki SkyPlanner przesyłają zmiany harmonogramu na bieżąco.
Jakie oprogramowanie do planowania produkcji integruje się z Visma L7?
SkyPlanner APS integruje się dwukierunkowo z Visma L7 przez REST API systemu L7. Visma wymienia Skycode wraz ze SkyPlanner na swojej stronie integracji L7. Zespół SkyPlanner konfiguruje integrację podczas wdrożenia.
Kto tworzy integrację z Visma L7?
Zespół SkyPlanner konfiguruje dwukierunkową integrację podczas wdrożenia, dostosowując ją do Twojej konfiguracji L7, i zapewnia wsparcie po uruchomieniu produkcyjnym. Twój partner Visma lub Twoi programiści również mogą tworzyć rozwiązania z wykorzystaniem udokumentowanego REST API SkyPlanner. Do rozpoczęcia prac wystarczy token API.
Czy możemy przetestować SkyPlanner przed stworzeniem integracji?
Tak. Bezpłatny 30-dniowy okres próbny pozwala korzystać z maksymalnie 20 stanowisk roboczych i importować dane z L7 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.
