Un'integrazione, cinque punti di sincronizzazione: come YARDtwin comunica con SAP

Ogni conversazione sull'integrazione con SAP porta inevitabilmente alle stesse tre domande. Quando viene inviato esattamente ogni messaggio? Cosa contiene effettivamente? E cosa vede il nostro utente SAP quando arriva? Gli elenchi di funzionalità non rispondono a queste domande — per questo abbiamo realizzato un video che si concentra esclusivamente su di esse.

Ripercorre una consegna reale — un carico sfuso, pesato in entrata a 18.500 kg e in uscita a 13.500 kg — e la segue attraverso il confine SAP–YARDtwin, uno scambio alla volta. Cinque punti di sincronizzazione, ciascuno mostrato in tre modi: il momento nello yard che lo attiva, il messaggio sul canale e la vista SAP in cui si manifesta.

Sincronizzazione 1 — SAP apre la conversazione

La consegna in entrata è l'unico messaggio inviato per primo da SAP. Quando viene creata in S/4HANA, il middleware — SAP CPI nel video — lo intercetta e invia un corpo JSON all'webhook HTTPS di YARDtwin, firmato con un segreto condiviso. Numero di consegna, stabilimento, materiale, cinquemila chili pianificati: tutto ciò di cui lo yard ha bisogno, senza alcun inserimento manuale.

Sul lato YARDtwin la prenotazione si costruisce automaticamente. La consegna compare nel log di integrazione e appare nel planning con il materiale e la quantità pianificata già inseriti. Nessuno reinserisce una consegna, quindi nessuno la inserisce in modo errato.

Sincronizzazioni 2 e 3 — lo yard risponde automaticamente, senza intervento manuale

Da questo punto la direzione si inverte: YARDtwin risponde dal cancello e dalla banchina, e nessuno a una scrivania deve inserire una transazione.

• Sincronizzazione 2 — registrazione dell'unità di trasporto. Viene inviata nel momento in cui l'operatore del cancello autorizza l'ingresso. Orario di check-in, banchina, peso lordo al ponte di pesatura — e un blocco nativo SAP che il CPI mappa uno a uno. SAP conferma con il riferimento TU; l'utente EWM vede un'unità di trasporto arrivata al checkpoint, con il peso lordo già registrato.
• Sincronizzazione 3 — conferma del warehouse task. Viene inviata al completamento dello scarico. Contiene campi che un consulente EWM riconosce immediatamente: numero di magazzino, task, ordine, bin di destinazione. Nel monitor di magazzino il task passa allo stato confermato — merce nella zona di entrata merci, esattamente come riportato dallo yard.

Sincronizzazione 4 — l'entrata merci attende il ponte di pesatura

Questo è il messaggio per cui esiste l'integrazione, e quello che YARDtwin trattiene deliberatamente. Lo scarico termina — e nulla viene registrato. Solo la pesata di uscita firmata sblocca l'entrata merci, riportando il netto calcolato al ponte: 5.000,000 kg come quantità nell'unità d'ordine, tipo di movimento 101, con il registro completo del ponte di pesatura allegato come evidenza. SAP registra il documento e risponde con il numero del documento materiale.

Sincronizzazione 5 — chiusura del ciclo

All'uscita del camion, il messaggio di uscita dallo yard riporta l'orario di partenza, il tempo di ciclo, il netto verificato e l'hash della firma elettronica rilasciata al momento del via libera alla partenza. SAP registra la partenza dal checkpoint e la consegna risulta completata. Cinque scambi — un flusso documentale pulito, con la traccia di audit che viaggia insieme al camion.

Il valore di tutto questo

• Nessun reinserimento manuale, in nessuna direzione. SAP crea la prenotazione; lo yard invia le conferme. I due sistemi non vengono più riconciliati manualmente da una persona con due schermi.
• SAP rimane il sistema di riferimento — e riceve dati di qualità superiore. Quantità pesate, timestamp contestuali ed evidenze di firma si allegano ai documenti già gestiti da SAP.
• Eventi che SAP non aveva mai avuto. Arrivo al cancello, letture del ponte di pesatura, avanzamento dello scarico e partenza non esistono in nessun ambiente SAP standard. Ora arrivano come messaggi strutturati anziché come telefonate.
• Infrastruttura standard, non un progetto. Ogni messaggio è JSON su HTTPS, con firma HMAC, consegnato al CPI o al middleware — il team di integrazione lo mappa sugli IDoc e sui BAPI già in uso. Ogni scambio è inoltre visibile nel log messaggi SAP di YARDtwin, così qualsiasi conversazione di supporto parte dalla stessa evidenza.

3 sincronizzazioni: l'approccio più leggero

Non tutti i siti utilizzano SAP EWM per la gestione del piazzale — e se SAP non gestisce il tuo piazzale, tre di quei messaggi non hanno una destinazione utile. Per questo tipo di scenario YARDtwin esegue la stessa integrazione in una configurazione a 3 sincronizzazioni: YARDtwin gestisce l'intero piazzale e solo due messaggi attraversano il confine — la consegna in entrata e la conferma di entrata merci.

L'aspetto fondamentale è che la modalità a 3 sincronizzazioni non è un secondo prodotto né un'integrazione separata. È la stessa combinazione di cinque interruttori con tre disattivati. Inizia con la consegna in entrata e la conferma di entrata merci — il primo passo a rischio minimo — e se in seguito attivi i processi di piazzale EWM, passare alla configurazione completa a cinque è una modifica della configurazione, non una reimplementazione.

Configurato per il tuo business, interruttore per interruttore

Ogni punto di sincronizzazione è un interruttore indipendente per sito, disattivato per impostazione predefinita. Un amministratore di sito sceglie un preset con un clic — 3 sincronizzazioni con piazzale autonomo o 5 sincronizzazioni con integrazione EWM — oppure imposta una combinazione personalizzata per sito. I rollout multi-stabilimento indirizzano ogni impianto SAP al proprio sito YARDtwin e il reinvio di una consegna è sicuro per design: un re-invio identico non modifica nulla.

Questa è la stessa filosofia del resto della piattaforma — le checklist di accesso, le regole della pesa, le modalità Smart Slots e le regole delle banchine sono tutte configurazioni per sito anziché codice. Per una panoramica completa di ciò che puoi personalizzare senza un sviluppatore, consulta Personalizza YARDtwin per il tuo business; per l'architettura di integrazione nel dettaglio, visita la nostra pagina di integrazione SAP.