Integracje / ERP / Visma Net ERP
Przewodnik po integracji Visma Net ze SkyPlanner APS do harmonogramowania produkcji
Ten przewodnik pokazuje partnerom i zespołom IT, jak połączyć Visma Net (Visma.net ERP) ze SkyPlanner APS. Integracja SkyPlanner z Visma Net działa w obu kierunkach przez Visma Net API:
- Do SkyPlanner trafiają obiekty Stock items i Kit specifications, zamówienia sprzedaży, stany magazynowe i zamówienia zakupu.
- Zaplanowane operacje stają się dokumentami Kit assembly, które są zatwierdzane po zakończeniu pracy.
- Godziny pracy operatorów wracają do Visma Net jako Employee time cards.
- Webhooki SkyPlanner przesyłają zmiany w harmonogramie na bieżąco.
Podczas wdrożenia zespół SkyPlanner dostosowuje integrację do konfiguracji Visma Net 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 Visma Net
- Visma Net ERP API. Interfejs REST ze specyfikacją OpenAPI, która nadal nosi tytuł „Visma.net ERP API v1”, oraz ze ścieżkami v1 i v2. Bazowy adres URL to
https://api.finance.visma.net. Od 1 lutego 2026 przepustowość starej domenyintegration.visma.netjest ograniczana i trwa jej wycofywanie (komunikat). - SalesOrder service v3 pod adresem
https://salesorder.visma.net. Endpointy zamówień sprzedaży w wersjach v1 i v2 zostały wycofane z eksploatacji. - Webhooki dostępne przez Visma Developer Portal.
- Background API. Nagłówek
erp-api-backgroundpozwala kolejkować długotrwałe wywołania. W odpowiedzi zwracany jest kod 202 z identyfikatorem zadania, a gdy wynik jest gotowy, wysyłane jest powiadomienie. - Scenariusze importu i eksportu w Visma Net, korzystające ze źródeł danych CSV, Excel lub SQL, służą do jednorazowego wczytywania danych podstawowych.
API nie udostępnia endpointów zleceń produkcyjnych, marszrut technologicznych ani gniazd produkcyjnych, ponieważ w Visma Net nie ma takich obiektów. Dane do harmonogramowania pochodzą z kartotek, zestawów, zamówień i stanów magazynowych:
GET /v1/inventory: Stock items i Non-stock items, w tym znacznik zestawu i klasa kartotekiGET /v1/KitSpecifications/{kitInventoryID}/{revisionID}: pozycje komponentów dla danej rewizjiGET /v1/kitassembly: istniejące dokumenty montażu zestawów, z możliwością filtrowania według typu i statusu- SalesOrder service v3: zapotrzebowanie z wymaganymi terminami i pozycjami zamówień
GET /v1/inventorysummary/{inventoryNumber}: stan fizyczny i ilość dostępna w poszczególnych magazynachGET /v1/purchaseorderiGET /v2/PurchaseReceipt: oczekiwane dostawy materiałów i przyjęcia
Wszystkie endpointy zwracające listy obsługują lastModifiedDateTime z lastModifiedDateTimeCondition oraz pageNumber i pageSize, dzięki czemu każda synchronizacja może być przyrostowa.
Uwierzytelnianie i limity
Visma Net korzysta z Visma Connect (OpenID Connect i OAuth 2.0):
- Zarejestruj Service Integration w Visma Developer Portal.
- Administrator dzierżawy zatwierdza integrację w Visma Net klienta.
- Pobierz tokeny w trybie client credentials pod adresem
https://connect.visma.com/connect/token, przekazująctenant_idi zakresy uprawnień API, takie jakvisma_api:read. Tokeny są ważne przez 3 600 sekund.
Limity wywołań obowiązują w stałych godzinnych oknach dla każdej pary firma–klient API. Odpowiedzi zawierają nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Po przekroczeniu limitu zwracany jest kod 429 z Retry-After (limity wywołań). Nagłówki ETag i If-Match zabezpieczają aktualizacje.
Partnerzy prowadzą testy na firmie demonstracyjnej w ramach bezpłatnego programu Visma Integrator Programme. Po stronie SkyPlanner uwierzytelnianie w REST API odbywa się za pomocą tokenu API (SkyPlanner Settings > API), a dokumentacja jest dostępna w Swagger/OpenAPI. Samouczek integracji prowadzi przez pierwsze wywołania.
Zdarzenia, webhooki i odpytywanie
Webhooki w Visma Developer Portal obsługują zdarzenia istotne dla harmonogramowania:
- Utworzenie, aktualizacja i zmiana kartoteki: Inventory Item Created, Updated i Changed
- Zmiana zamówienia zakupu i jego statusu: Purchase Order Changed i Status Changed
- Zmiana zamówienia sprzedaży i jego statusu: Sales Order Changed i Status Changed — zdarzenia przenoszone do wydawcy SalesOrderService
Dla Kit assembly i Kit specifications nie ma zdarzeń. SkyPlanner odpytuje te obiekty z użyciem filtrów lastModifiedDateTime. Stany magazynowe są pobierane przy uruchamianiu harmonogramowania. W przeciwnym kierunku SkyPlanner wysyła webhooki przy zmianach stanu lub harmonogramu.
Mapowanie danych
| Obiekt Visma Net (endpoint) | Obiekt SkyPlanner | Kierunek | Częstotliwość |
|---|---|---|---|
Stock items, Non-stock items (/v1/inventory) | Produkty i materiały | Visma Net → SkyPlanner | Wczytanie początkowe, następnie webhook |
Kit specifications (/v1/KitSpecifications) | Struktura produktu, materiały przypisane do produktu | Visma Net → SkyPlanner | Wczytanie początkowe, następnie odpytywanie |
| Zamówienia sprzedaży (SalesOrder service v3) | Zamówienia z terminami realizacji i priorytetem klienta | Visma Net → SkyPlanner | Webhook |
Kit assembly ze statusem On hold (/v1/kitassembly), jeśli dokumenty montażu są tworzone w Visma Net | Operacje | Visma Net → SkyPlanner | Odpytywanie |
Inventory summary (/v1/inventorysummary) | Stany magazynowe według magazynów | Visma Net → SkyPlanner | Odpytywanie przy uruchamianiu harmonogramowania |
Zamówienia zakupu i przyjęcia dostaw (/v1/purchaseorder, /v2/PurchaseReceipt) | Oczekiwane dostawy materiałów z datą dostawy; aktualizacja stanu po realizacji dostawy z zamówienia zakupu | Visma Net → SkyPlanner | Webhook, następnie odczyt |
| Brak w Visma Net | Etapy procesu, stanowiska robocze, zmiany robocze, macierz czasów przezbrojeń, narzędzia, zasoby alternatywne | Utrzymywane w SkyPlanner | Konfiguracja podczas wdrożenia |
Tworzenie i aktualizacja Kit assembly (POST/PUT /v1/kitassembly) | Zaplanowana operacja: kartoteka zestawu, ilość, planowana data zakończenia | SkyPlanner → Visma Net | Przy zmianie harmonogramu, przez webhook SkyPlanner |
Zatwierdzenie Kit assembly (/v1/kitassembly/{type}/{refNo}/action/release) | Zakończona operacja: wyprodukowana ilość i zużycie komponentów | SkyPlanner → Visma Net | Po zakończeniu |
Inventory receipt, Inventory issue (/v1/inventoryReceipt, /v1/inventoryissue, zatwierdzenie) | Wyprodukowana ilość i zużycie materiałów, gdy zestawy nie są używane | SkyPlanner → Visma Net | Po zakończeniu |
Employee time card (/v1/timeCard) | Zarejestrowane godziny pracy każdego operatora | SkyPlanner → Visma Net | Co tydzień |
Schematy integracji
1. Początkowe wczytanie danych podstawowych. Pobierz obiekty Stock items, klasy kartotek i najnowszą rewizję Kit specification dla każdego zestawu. Przypisz każdą pozycję komponentu do materiału w SkyPlanner. Następnie przygotuj dane, których nie ma w Visma Net: stanowiska robocze, zmiany robocze, etapy procesu z czasami przygotowania i wykonania, macierz czasów przezbrojeń oraz wymagania dotyczące narzędzi. Zaimportuj je z plików CSV lub Excel. To największa część projektu.
2. Synchronizacja zamówień. Wybierz jeden model zapotrzebowania:
- Na podstawie zamówień sprzedaży. Otwarte pozycje zamówień sprzedaży dotyczące zestawów stają się zamówieniami w SkyPlanner. Wymagany termin jest przyjmowany jako termin realizacji.
- Na podstawie dokumentów montażu. Dokumenty Kit assembly utworzone w Visma Net ze statusem On hold stają się operacjami w SkyPlanner.
Otwarte zamówienia zakupu są pobierane wraz z terminami. SkyPlanner uznaje zamówiony materiał za dostępny w dniu dostawy wskazanym w zamówieniu zakupu i aktualizuje stan magazynowy po nadaniu zamówieniu statusu Delivered. Dzięki tym danym oraz zestawieniu stanów magazynowych harmonogram uwzględnia zarówno zapasy, jak i oczekiwane zakupy.
3. Zapis zwrotny harmonogramu. W konfiguracji opartej na zamówieniach sprzedaży SkyPlanner tworzy dla każdej zaplanowanej operacji dokument Kit assembly typu Production. Ustawia kartotekę zestawu, rewizję, magazyn, ilość i komponenty oraz wiąże dokument z pozycją zamówienia sprzedaży. Data dokumentu montażu to planowana data zakończenia. Gdy Autopilot przesuwa operację, wywołanie PUT aktualizuje datę przed zatwierdzeniem dokumentu.
Kit assembly ma jedno pole Date, dlatego czasy poszczególnych operacji pozostają w SkyPlanner, a do Visma Net trafia data istotna dla sprzedaży i stanów magazynowych.
4. Potwierdzenia z hali produkcyjnej. Operatorzy rejestrują pracę za pomocą Mobile Confirmations lub Production Timer, a wpisy czasu pracy pozwalają utrzymać aktualny harmonogram. Po zakończeniu ostatniego etapu SkyPlanner wywołuje akcję zatwierdzenia dokumentu Kit assembly. Zatwierdzenie księguje wyprodukowaną ilość i zużycie komponentów, po czym powstaje paczka zapisów w księdze głównej. Godziny są agregowane w tygodniowe Employee time cards lub, w przypadku pracy realizowanej w ramach projektów, w transakcje projektowe.
5. Odpowiedzialność za dane i rozstrzyganie konfliktów. Spisz te zasady przed uruchomieniem produkcyjnym:
| Dane | System odpowiedzialny |
|---|---|
| Indeksy, Kit specifications, zamówienia sprzedaży, zamówienia zakupu, stany magazynowe, koszty | Visma Net |
| Etapy procesu, stanowiska robocze, zmiany, przezbrojenia, narzędzia | SkyPlanner |
| Kolejność operacji, czasy rozpoczęcia i zakończenia, przypisanie do stanowisk roboczych | SkyPlanner |
| Data dokumentu Kit assembly przed zatwierdzeniem | SkyPlanner |
| Zatwierdzone dokumenty Kit assemblies i karty czasu pracy | Visma Net; księgowanie inicjowane przez SkyPlanner |
Zmiana w Kit specification tworzy nową rewizję. Odczytaj najnowszą rewizję i ponownie ją zmapuj, ponieważ tylko ostatnia rewizja może służyć do produkcji. Ręczne zmiany komponentów w dokumencie montażu pozostają ważne w Visma Net, dlatego SkyPlanner ponownie odczytuje ten dokument przed zatwierdzeniem.
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 ze scenariusza eksportu Visma Net, zaimportowanych w formacie CSV lub Excel.
- Określenie zakresu. Ustal model zapotrzebowania, tabelę mapowania, zasady odpowiedzialności za dane oraz docelowy sposób zapisu zwrotnego (Kit assembly lub przyjęcia magazynowe).
- Konfiguracja Visma Connect. Zarejestruj Service Integration i uzyskaj zgodę administratora tenanta. Najpierw przeprowadź testy w firmie demonstracyjnej.
- Model produkcji. Stanowiska robocze, zmiany, etapy procesu, przezbrojenia i narzędzia w SkyPlanner.
- Początkowe wczytanie danych. Stock items, klasy indeksów, Kit specifications, magazyny, stany magazynowe.
- Synchronizacja zamówień sprzedaży i zakupu. Webhooki dla zamówień sprzedaży, zamówień zakupu i indeksów; cykliczne odpytywanie dla zestawów i stanów magazynowych. Ten etap obejmuje też odnawianie tokenów i obsługę odpowiedzi 429.
- Zapis zwrotny. Tworzenie, aktualizacja i zatwierdzanie dokumentów Kit assembly oraz zapis kart czasu pracy.
- Testy równoległe. Uruchom SkyPlanner równolegle z obecnym planem i porównaj terminy.
- Uruchomienie produkcyjne. Włącz zapis zwrotny, gdy dane będą zgodne.
Co uwzględnić przy integracji z Visma Net
- Brak marszrut technologicznych do zaimportowania. Wszystkie etapy procesu oraz czasy przezbrojenia i wykonania definiuje się w SkyPlanner. Zaplanuj nakład pracy i wyznacz osobę odpowiedzialną.
- Advanced logistics. Kit assembly wymaga grupy Advanced logistics. W przypadku Standard logistics księguj produkcję za pomocą Inventory receipt i Inventory issue.
- Zablokowane rewizje. Używanej już rewizji Kit specification nie można edytować, a do produkcji można wykorzystać tylko najnowszą rewizję.
- Jednostki miary. Dokument Kit assembly ma własną jednostkę miary. Podczas importu zadbaj o jej zgodność z ilościami w SkyPlanner.
- Odpytywanie zamiast zdarzeń. Zestawy nie mają webhooków. Pobieraj przyrostowo zmiany na podstawie
lastModifiedDateTime, zamiast wczytywać wszystkie dane ponownie, aby nie przekroczyć godzinowego limitu zapytań. - Aktualne endpointy. Buduj integrację wyłącznie w oparciu o
api.finance.visma.neti SalesOrder service v3. - Zgoda administratora tenanta. Uwierzytelnianie client credentials nie zadziała, dopóki administrator tenanta nie zatwierdzi aplikacji. Zaplanuj ten krok z wyprzedzeniem.
- Tygodniowe karty czasu pracy. Karty czasu pracy wymagają Advanced financials i obejmują okres tygodnia. Sumuj godziny pracy operatorów tygodniowo lub zapisuj je jako transakcje projektowe.
Kto konfiguruje i wspiera integrację z Visma Net
- Zespół SkyPlanner konfiguruje integrację podczas wdrożenia i zapewnia wsparcie po uruchomieniu produkcyjnym. Obejmuje to konfigurację po stronie SkyPlanner, model produkcji, którego brakuje w Visma Net, oraz uzgodnione wywołania API Visma Net. Każdy zakład korzysta z Visma Net inaczej — tę wiedzę uwzględniamy właśnie na tym etapie.
- Twój partner Visma Net może wziąć udział w projekcie. Visma dostarcza Visma Net we współpracy z certyfikowanymi partnerami, którzy znają Twoją konfigurację i mogą sprawdzić mapowanie oraz aplikację Visma Connect. SkyPlanner udostępnia REST API, dokumentację Swagger/OpenAPI i webhooki.
- Integrację mogą zbudować Twoi programiści, korzystając z tego samego udokumentowanego REST API i tokena API. Do rozpoczęcia wystarczy token API, a zespół SkyPlanner pomaga w razie potrzeby. Publiczna dokumentacja jest dostępna na stronie dokumentacji SkyPlanner.
Po połączeniu systemów silnik Arcturus układa harmonogram na podstawie aktualnych zamówień z Visma Net, a zakończona praca trafia z powrotem do Visma Net jako zatwierdzone dokumenty Kit assemblies. Ceny zaczynają się od 199 € miesięcznie za 5 stanowisk roboczych, przy rozliczeniu miesięcznym. Integrację wyceniamy z góry, zgodnie z Twoim procesem i potrzebami, razem z wybranym planem. Dzięki temu znasz pełny koszt przed rozpoczęciem.
Sprawdź cennik i dowiedz się, dlaczego Visma Net potrzebuje narzędzia do harmonogramowania, z artykułu Visma Net — harmonogramowanie produkcji z uwzględnieniem dostępnych zasobów. Ogólne informacje znajdziesz na stronie Visma Net, a pozostałe systemy ERP — w centrum integracji ERP.
Opinie producentów o SkyPlanner
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 rozdzielcza
Planowanie produkcji pozwala zaoszczędzić 2 godziny pracy tygodniowo, a nowa kolejka operacji 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.
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 · Obróbka 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.
6 miesięcynaprzód — dział sprzedaży widzi wolne moce produkcyjne
„SkyPlanner zapewnia solidną i niezawodną podstawę całego planowania produkcji.”
Anu Järvinen, kierowniczka produkcji
Fredman Operations · Papiery opakowaniowe do kontaktu z żywnością
Dział sprzedaży widzi wolne moce produkcyjne z sześciomiesięcznym wyprzedzeniem, a odpowiedzi na prośby o zmianę harmonogramu, które wcześniej zajmowały godzinę lub dłużej, są teraz gotowe w kilka sekund.
Najczęściej zadawane pytania
Czy API Visma Net udostępnia zlecenia produkcyjne?
Nie. Visma Net nie ma obiektów zleceń produkcyjnych, marszrut technologicznych ani gniazd produkcyjnych, więc nie udostępnia ich również API. Dokumentem produkcyjnym jest Kit assembly pod adresem /v1/kitassembly, a marszruty technologiczne i stanowiska robocze są przechowywane w SkyPlanner.
Z jakiego uwierzytelniania korzysta integracja?
Integracja korzysta z Visma Connect i przepływu OAuth 2.0 client credentials. Jest rejestrowana jako Service Integration w Visma Developer Portal. Zatwierdza ją administrator tenanta, a tokeny są ważne przez jedną godzinę.
Czy Visma Net może wysyłać zmiany w czasie rzeczywistym?
Tak, w przypadku indeksów, zamówień sprzedaży i zamówień zakupu — za pośrednictwem webhooków Visma Developer Portal. Kit assemblies i Kit specifications nie udostępniają zdarzeń, dlatego zmiany w nich są pobierane przez odpytywanie przyrostowe. Własne webhooki SkyPlanner wysyłają zmiany harmonogramu na bieżąco.
Jak zakończona produkcja jest zapisywana z powrotem w Visma Net?
SkyPlanner tworzy dokument Kit assembly dla każdej zaplanowanej operacji, aktualizuje jego datę i wywołuje akcję zatwierdzenia po zakończeniu operacji. Zatwierdzenie księguje wyprodukowaną ilość i zużycie komponentów. Bez zestawów tę samą funkcję pełnią Inventory receipt i Inventory issue.
Czy możemy przetestować SkyPlanner przed zbudowaniem integracji?
Tak. Bezpłatny 30-dniowy okres próbny obsługuje do 20 stanowisk roboczych i import danych z Visma Net w formacie CSV lub Excel. Nie wymaga karty kredytowej. Rozpocznij okres próbny lub porozmawiaj z działem sprzedaży, aby określić zakres integracji.
