Integracja systemu awizacji VSS.net z SAP to dwukierunkowy interfejs: SAP przekazuje zamówienia przyjęcia (Inbound Delivery), a VSS.net odsyła potwierdzenie awizacji i status pojazdu. Połączenie obsługuje SAP EWM oraz SAP TM, działa przez REST API, IDoc lub flat file (SFTP) i nie wymaga głębokiego customizingu SAP.
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.
| Kierunek | Co jest przesyłane | Cel operacyjny |
|---|---|---|
| SAP → VSS.net | Zamówienie przyjęcia towaru (Inbound Delivery) lub zlecenie transportowe z danymi dostawcy, asortymentu i wolumenu. | Zasilenie awizacji danymi planowanej dostawy bez ręcznego przepisywania. |
| VSS.net → SAP | Potwierdzenie awizacji po rezerwacji okna oraz status pojazdu (wjazd na plac, podstawienie pod rampę, koniec rozładunku). | Bieżąca widoczność transportu w ERP i sprawne księgowanie dokumentów. |

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.

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.
| Protokół | Charakterystyka | Typowe zastosowanie |
|---|---|---|
| REST API | Lekka wymiana komunikatów JSON lub XML przez HTTPS. | Środowiska SAP S/4HANA i integracje w czasie rzeczywistym. |
| IDoc | Standard SAP do asynchronicznej wymiany dokumentów biznesowych. | Sprawdzona wymiana dokumentów między systemami SAP. |
| Flat file (SFTP) | Pliki CSV lub XML przesyłane przez bezpieczny serwer SFTP. | Starsze architektury infrastrukturalne. |
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.

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.
| Pole w SAP | Odpowiednik w VSS.net | Rola operacyjna |
|---|---|---|
| MBLNR (Material Document) | Numer dokumentu przyjęcia | Jednoznaczny identyfikator operacji magazynowej po stronie ERP. |
| LIFNR (Vendor Account) | Identyfikator dostawcy | Przypisanie awizacji do konkretnego kontrahenta w bazie. |
| LGPLA (Storage Bin) | Numer rampy lub doku | Wskazanie fizycznego miejsca obsługi i podstawienia pojazdu. |
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.