Jedna integracja, pięć punktów synchronizacji: jak YARDtwin komunikuje się z SAP

Każda rozmowa o integracji z SAP prędzej czy później sprowadza się do tych samych trzech pytań. Dokładnie kiedy każda wiadomość jest wysyłana? Co tak naprawdę zawiera? I co widzi użytkownik SAP, gdy dotrze na miejsce? Listy funkcji nie odpowiadają na te pytania — dlatego stworzyliśmy film, który robi tylko to.

Odtwarza on rzeczywistą dostawę — ładunek masowy, zważony przy wjeździe na 18 500 kg i przy wyjeździe na 13 500 kg — i śledzi ją przez granicę SAP–YARDtwin wymiana po wymianie. Pięć punktów synchronizacji, każdy pokazany na trzy sposoby: moment w placu manewrowym, który go wyzwala, wiadomość przesyłana po sieci oraz widok SAP, w którym się pojawia.

Sync 1 — SAP otwiera rozmowę

Dostawa przychodząca to jedyna wiadomość inicjowana przez SAP. Po jej utworzeniu w S/4HANA middleware — w filmie jest to SAP CPI — przechwytuje ją i wysyła jeden obiekt JSON do webhooka HTTPS systemu YARDtwin, podpisany wspólnym kluczem. Numer dostawy, zakład, materiał, planowane pięć tysięcy kilogramów — wszystko, czego potrzebuje plac, bez ręcznego wprowadzania danych.

Po stronie YARDtwin rezerwacja tworzy się automatycznie. Dostawa trafia do dziennika integracji i pojawia się w harmonogramie z materiałem oraz planowaną ilością już uzupełnionymi. Nikt nie przepisuje dostawy ręcznie, więc nikt nie popełni błędu podczas wprowadzania danych.

Synchronizacje 2 i 3 — plac raportuje zwrotnie, bez udziału człowieka

Od tego momentu kierunek się odwraca: YARDtwin odpowiada z bramy i rampy, a żaden pracownik przy biurku nie wprowadza ręcznie żadnej transakcji.

• Synchronizacja 2 — rejestracja jednostki transportowej. Uruchamiana w momencie autoryzacji wjazdu przez operatora bramy. Czas odprawy, dok, waga brutto z wagi samochodowej — oraz blok natywny SAP, który CPI mapuje w relacji jeden do jednego. SAP potwierdza odbiór referencją jednostki transportowej; użytkownik SAP EWM widzi jednostkę transportową przybyłą na punkt kontrolny z wagą brutto już zapisaną w rekordzie.
• Synchronizacja 3 — potwierdzenie zadania magazynowego. Uruchamiana po zakończeniu rozładunku. Zawiera pola rozpoznawane na pierwszy rzut oka przez konsultanta SAP EWM: numer magazynu, zadanie, zlecenie, docelowy bin. W monitorze magazynowym zadanie zmienia status na potwierdzone — zapas w strefie przyjęcia towarów, dokładnie tak, jak zaraportował plac.

Synchronizacja 4 — przyjęcie towaru czeka na wagę samochodową

To wiadomość, dla której istnieje ta integracja, i ta, którą YARDtwin celowo wstrzymuje. Rozładunek dobiegł końca — i nic nie jest księgowane. Dopiero podpisane ważenie wyjazdowe zwalnia przyjęcie towaru, przekazując masę netto obliczoną na wadze: 5 000,000 kg jako ilość w jednostce wpisu, rodzaj ruchu 101, wraz z pełnym protokołem ważenia jako dowodem. SAP księguje i odpowiada numerem dokumentu materiałowego.

Synchronizacja 5 — zamknięcie pętli

Gdy ciężarówka opuszcza plac, komunikat wyjazdu z placu zawiera czas odjazdu, czas obsługi, zweryfikowaną masę netto oraz skrót podpisu elektronicznego z clearance'u wyjazdowego. SAP rejestruje wyjazd z punktu kontrolnego i dostawa jest zamknięta. Pięć wymian — jeden przejrzysty przepływ dokumentów, a ścieżka audytu podąża razem z ciężarówką.

Wartość tej integracji

• Żadnego ręcznego przepisywania danych — w żadnym kierunku. SAP tworzy rezerwację; plac wysyła potwierdzenia. Oba systemy przestają być uzgadniane przez człowieka siedzącego przed dwoma ekranami.
• SAP pozostaje systemem referencyjnym — i otrzymuje lepsze dane. Zważone ilości, dokładne znaczniki czasu i dowody podpisów są dołączane do dokumentów, które SAP już posiada.
• Zdarzenia, których SAP nigdy nie rejestrował. Przyjazd do bramy, odczyty wagi pomostowej, postęp rozładunku i wyjazd nie istnieją nigdzie w standardowym środowisku SAP. Teraz trafiają jako ustrukturyzowane komunikaty zamiast telefonów.
• Standardowa infrastruktura, nie projekt. Każdy komunikat to JSON po HTTPS, podpisany HMAC, dostarczany do Twojego CPI lub middleware — Twój zespół integracyjny mapuje go na IDoc i BAPI, których już używa. A każda wymiana jest widoczna w dzienniku komunikatów SAP w YARDtwin, więc każda rozmowa z pomocą techniczną zaczyna się od tych samych danych.

3-sync: lżejszy sposób na wdrożenie

Nie każdy zakład korzysta z SAP EWM do zarządzania placem manewrowym — a jeśli SAP nie zarządza Twoim placem, trzy z tych komunikatów nie mają sensownego miejsca docelowego. W takim środowisku YARDtwin uruchamia tę samą integrację w wariancie 3-sync: YARDtwin zarządza całym placem, a przez granicę systemu przechodzą tylko dwa komunikaty — przychodzące dostawy w dół i potwierdzenie przyjęcia towaru z powrotem.

Istotne jest to, że 3-sync nie jest odrębnym produktem ani osobną integracją. To te same pięć przełączników, z których trzy są wyłączone. Zacznij od dostawy przychodzącej i potwierdzenia przyjęcia towaru — pierwszego kroku o najniższym ryzyku — a jeśli później aktywujesz procesy placu EWM, przejście do pełnych pięciu punktów to zmiana konfiguracji, nie reimplementacja.

Skonfigurowane pod Twój biznes, przełącznik po przełączniku

Każdy punkt synchronizacji to niezależny przełącznik na poziomie lokalizacji, domyślnie wyłączony. Administrator lokalizacji wybiera gotowy preset jednym kliknięciem — 3-sync zarządzany przez plac lub 5-sync zintegrowany z EWM — albo ustawia własną kombinację dla każdej lokalizacji. Wdrożenia wielozakładowe kierują każdy zakład SAP do jego własnej lokalizacji YARDtwin, a ponowne wysłanie dostawy jest z założenia bezpieczne: identyczne ponowne przesłanie nie wprowadza żadnych zmian.

To ta sama filozofia co w pozostałych częściach platformy — listy kontrolne bramki, reguły wagi najazdowej, tryby Smart Slots i reguły doków są konfigurowane na poziomie lokalizacji, a nie w kodzie. Aby zapoznać się z szerszym przeglądem tego, co można dostosować bez udziału programisty, zobacz Dostosuj YARDtwin do swojej firmy; szczegółowy opis architektury integracji znajdziesz na naszej stronie integracji SAP.