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 YMS, który 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 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.

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.