Integracja systemu awizacji z SAP - VSS.net, SAP EWM i SAP TM

Autor: Adam Siemiątkowski, SoftwareStudio Group Sp. z o.o.

Wprowadzenie systemu klasy YMS (Yard Management System) w firmie korzystającej z ekosystemu SAP wymaga niezawodnego pomostu informacyjnego. Sprawna integracja systemu awizacji z SAP eliminuje ręczne przepisywanie danych, redukuje błędy i daje widoczność łańcucha dostaw w czasie rzeczywistym. Platforma VSS.net udostępnia interfejs, dzięki któremu system YMS do awizacji dostaw i zarządzania placem współpracuje zarówno z klasycznym ERP, jak i z architekturą SAP S/4HANA.

Kierunek przepływu informacji w architekturze logistycznej

Wymiana danych między systemami odbywa się dwukierunkowo, co automatyzuje obsługę transportu od planowania dostawy aż po wyjazd auta z zakładu. SAP zasila awizację danymi zamówienia, a VSS.net zwraca potwierdzenie i kolejne statusy pojazdu.

Studio VSS.net

Kartoteka kontrahenta - dane awizacji

Kartoteka kontrahenta przechowuje identyfikator dostawcy powiązany z polem LIFNR z SAP. Dzięki temu zamówienie przyjęcia z ERP automatycznie trafia do właściwej awizacji, bez ręcznego dopasowywania danych.

Połączenie z modułami SAP EWM oraz SAP TM

W środowiskach klasy enterprise istotne znaczenie ma ścisła współpraca z wyspecjalizowanymi modułami logistycznymi SAP. VSS.net łączy się z dwoma podstawowymi obszarami.

Integracja z SAP EWM (rozszerzone zarządzanie magazynem) pozwala automatycznie przydzielać okna czasowe na rozładunek na podstawie realnej dostępności personelu i obłożenia stref przyjęć. Połączenie z SAP TM (zarządzanie transportem) synchronizuje plany tras i harmonogramy przewoźników z fizyczną przepustowością punktów rozładunkowych.

Studio VSS.net

Informacje o oknach czasowych w YMS

Moduł YMS pokazuje obłożenie okien czasowych, które VSS.net uzgadnia z dostępnością stref przyjęć w SAP EWM. Plan transportów z SAP TM zostaje dopasowany do realnej przepustowości ramp.

Protokoły komunikacyjne i standardy przesyłu danych

Architektura VSS.net wspiera różne standardy technologiczne, dzięki czemu interfejs można dopasować do wewnętrznych wymagań i polityki bezpieczeństwa działu IT klienta. Poza natywnymi mechanizmami SAP obsługujemy komunikaty standardu EDI GS1, w tym awizo wysyłki DESADV, które przenosi skład transportu w formacie uzgodnionym z kontrahentami zewnętrznymi.

Częstotliwość synchronizacji danych a wydajność operacyjna

W zależności od charakteru informacji system wykorzystuje dwa tryby synchronizacji. Zdarzenia na placu manewrowym i portierni obsługiwane są w czasie rzeczywistym - informacja o tym, że kierowca minął szlaban lub zakończył rozładunek, trafia do SAP natychmiast, umożliwiając sprawne księgowanie dokumentów i zwolnienie zasobów.

Dane podstawowe, takie jak kartoteki stałych dostawców czy słowniki indeksów towarowych, aktualizowane są w trybie wsadowym (batch) w określonych interwałach (np. co 15-30 minut), co zapobiega obciążaniu sieci. Status pojazdu na placu rejestruje m.in. moduł kontroli wjazdów i wyjazdów.

Studio VSS.net

Auta na terenie obiektu - status w czasie rzeczywistym

Lista aut na terenie obiektu odzwierciedla bieżący status pojazdów, który VSS.net przekazuje do SAP w czasie rzeczywistym. Zmiana statusu - wjazd, rampa, wyjazd - aktualizuje dokumenty po stronie ERP bez opóźnień.

Mapowanie pól dokumentów i obiektów magazynowych

Prawidłowe działanie interfejsu zapewnia precyzyjne powiązanie obiektów biznesowych SAP z rekordami w bazie danych VSS.net. Przykładowe mapowanie struktur obejmuje poniższe parametry. Pełen zakres integracji opisuje też strona integracje ze Studio VSS.net.

Przykład struktury danych w integracji z SAP

Nowoczesna architektura systemu VSS.net pozwala na płynną wymianę komunikatów za pośrednictwem bezpiecznego REST API. Poniższy przykład przedstawia strukturę dokumentu JSON (payload) przesyłanego z systemu SAP S/4HANA do VSS.net, inicjującego proces planowania awizacji dla dostawy przychodzącej (Inbound Delivery).

{
  "inboundDelivery": {
    "mblnr": "8000471293",
    "lifnr": "VEND004912",
    "vendorName": "Logistics & Transport Sp. z o.o.",
    "creationDate": "2026-06-03",
    "deliveryDate": "2026-06-05",
    "targetStorageLocation": "LGPLA-DOCK-04",
    "items": [
      {
        "posnr": "000010",
        "matnr": "MAT-CHILL-092",
        "quantity": 24,
        "meins": "PAL"
      }
    ]
  }
}

W odpowiedzi zwrotnej VSS.net odsyła do systemu SAP unikalny identyfikator zarezerwowanego okna czasowego oraz statusy operacyjne pojazdu w czasie rzeczywistym. Platforma nie wymaga głębokich modyfikacji w kodzie źródłowym SAP po stronie klienta - integracja opiera się na standardowych punktach końcowych (endpoints), co wydatnie skraca czas startu projektu.

Korzyści biznesowe integracji systemu awizacji z SAP

Połączenie systemu awizacji z SAP przynosi wymierne korzyści biznesowe, które wykraczają poza samą automatyzację wymiany dokumentów. Poniżej zestawiamy efekty najczęściej wskazywane przez klientów po uruchomieniu integracji.

• Eliminacja podwójnego wprowadzania danych - dane zamówienia trafiają do awizacji automatycznie z SAP, co ogranicza błędy wynikające z ręcznego przepisywania numerów dokumentów i ilości towaru.
• Szybsze księgowanie przyjęć - status pojazdu przekazywany do SAP w czasie rzeczywistym pozwala księgować dokumenty przyjęcia bez oczekiwania na papierowe potwierdzenie z rampy.
• Spójna widoczność łańcucha dostaw - dział zakupów i logistyki widzi w jednym systemie ERP status transportu od momentu awizacji aż po zakończenie rozładunku.
• Niższe ryzyko błędów w rozliczeniach z dostawcami - powiązanie awizacji z numerem zamówienia (Inbound Delivery) i dostawcą (LIFNR) ułatwia weryfikację zgodności dostawy z zamówieniem jeszcze przed rozładunkiem.
• Skrócenie czasu wdrożenia dzięki gotowym punktom integracji - standardowe interfejsy REST API i IDoc ograniczają zaangażowanie zespołu programistów SAP po stronie klienta, co obniża koszt projektu.
• Ułatwione audyty i kontrole zgodności - pełna historia awizacji powiązana z dokumentami SAP upraszcza przygotowanie dokumentacji na potrzeby audytów wewnętrznych oraz kontroli jakości dostaw.

W środowiskach korzystających z wielu modułów SAP korzyści te kumulują się najsilniej tam, gdzie liczba awizowanych dostaw dziennie jest wysoka, a każdy błąd ręcznego wprowadzania danych generuje realny koszt operacyjny. Skalę tych oszczędności pomaga oszacować kalkulacja ROI z wdrożenia systemu awizacji.

Scenariusz obsługi awizacji zintegrowanej z SAP krok po kroku

Aby zobrazować praktyczne działanie integracji, prześledźmy typowy przebieg obsługi jednej dostawy od momentu wystawienia zamówienia w SAP aż po zaksięgowanie przyjęcia.

Planista zakupów wystawia w SAP zamówienie zakupu, a system generuje dokument dostawy przychodzącej (Inbound Delivery) z danymi dostawcy, asortymentu i planowanego terminu. Dokument trafia automatycznie do VSS.net przez interfejs REST API lub IDoc, zasilając formularz nowej awizacji gotowymi danymi - bez potrzeby ręcznego wprowadzania numeru zamówienia czy ilości towaru.

Przewoźnik loguje się do portalu przewoźnika, odnajduje przygotowaną awizację i wybiera dla siebie wolny termin, który widzi w module o nazwie kalendarz awizacji dostaw, uwzględniający dostępność ramp i stref przyjęć zsynchronizowaną z danymi z SAP EWM. Po potwierdzeniu rezerwacji VSS.net odsyła do SAP status awizacji wraz z przydzielonym terminem.

W dniu dostawy kierowca melduje się na portierni, gdzie system odczytuje numer rejestracyjny i automatycznie kieruje pojazd pod właściwą rampę. Każda zmiana statusu - wjazd, podstawienie pod rampę, rozpoczęcie i zakończenie rozładunku - trafia do SAP w czasie rzeczywistym. Po zakończeniu rozładunku magazynier potwierdza ilości przyjętego towaru, a dokument w SAP zostaje automatycznie zaksięgowany jako przyjęcie zewnętrzne, zamykając cały proces bez potrzeby ręcznej synchronizacji między systemami.

Etapy wdrożenia integracji z SAP

Uruchomienie integracji z SAP przebiega według sprawdzonego schematu projektowego, który ogranicza ryzyko przestojów w bieżącej pracy działu logistyki podczas wdrożenia.

1. Analiza przedwdrożeniowa - inwentaryzacja istniejących interfejsów SAP (Web Services, IDoc), ustalenie zakresu wymienianych danych oraz wybór protokołu komunikacyjnego.
2. Mapowanie pól i obiektów biznesowych - powiązanie pól SAP (m.in. MBLNR, LIFNR, LGPLA) z odpowiadającymi im rekordami w bazie VSS.net.
3. Konfiguracja środowiska testowego - uruchomienie integracji na środowisku niedotykającym produkcji SAP, z symulowanym ruchem dokumentów.
4. Testy akceptacyjne z udziałem użytkowników - weryfikacja poprawności przepływu danych przez dział logistyki i zakupów przed przejściem na produkcję.
5. Uruchomienie produkcyjne i monitoring - przełączenie na środowisko produkcyjne SAP z bieżącym nadzorem nad pierwszymi transakcjami.

Standardowy czas realizacji takiego projektu, licząc od analizy do produkcyjnego uruchomienia integracji, mieści się zwykle w przedziale od 6 do 10 tygodni, w zależności od liczby modułów SAP objętych integracją oraz złożoności mapowania danych. Zakres prac po stronie magazynu porządkuje checklista wdrożenia systemu awizacji.

Skalowalność integracji przy wielu obiektach i oddziałach

Firmy działające na wielu lokalizacjach - centrach dystrybucyjnych, zakładach produkcyjnych czy magazynach regionalnych - potrzebują integracji, która obsłuży rosnącą liczbę obiektów bez konieczności budowania odrębnego połączenia dla każdego z nich.

Architektura VSS.net pozwala podłączyć wiele instancji obiektów do jednego wspólnego interfejsu z systemem SAP, zachowując przy tym rozdzielność danych operacyjnych między lokalizacjami. Każdy obiekt zachowuje własny kalendarz awizacji, własne rampy i strefy przyjęć, natomiast wymiana danych z centralnym systemem SAP odbywa się przez wspólny, jednorazowo skonfigurowany kanał komunikacyjny.

Takie podejście istotnie skraca czas uruchomienia integracji przy rozwoju sieci obiektów - kolejna lokalizacja nie wymaga budowania nowego interfejsu od podstaw, a jedynie konfiguracji parametrów właściwych dla danego magazynu (m.in. numeru zakładu SAP, przypisanych ramp i stref składowania). Rozwiązanie sprawdza się także w grupach kapitałowych korzystających z jednej globalnej instancji SAP S/4HANA obsługującej wiele niezależnych magazynów.

Dla działów IT oznacza to również jeden spójny punkt odpowiedzialności za utrzymanie integracji, zamiast odrębnych połączeń point-to-point dla każdego magazynu. Upraszcza to zarządzanie wersjami interfejsu oraz wdrażanie aktualizacji bez ryzyka niespójności danych między lokalizacjami.