EPCIS 2.0: gli eventi di tutti i partner relativi al passaporto di prodotto

EPCIS 2.0: gli eventi di tutti i partner relativi al passaporto di prodotto

In che modo gli eventi della catena di fornitura vengono riportati nel passaporto digitale di prodotto? Tramite EPCIS 2.0: ogni partner effettua la segnalazione accedendo al proprio spazio di lavoro con le proprie credenziali.

Martedì, ore 6.40, rampa 3 del magazzino nei pressi di Basilea. Un camion consegna un pallet con 48 batterie per e-bike provenienti dallo stabilimento di assemblaggio; lo scanner emette un segnale acustico e il sistema di gestione del magazzino registra l’entrata della merce. Queste batterie sono state nel frattempo registrate da tre sistemi: il sistema di controllo della produzione nello stabilimento, il sistema di spedizione del corriere e ora il magazzino. Ciascuno di essi conosce la propria parte del percorso.

Da subito, questi dati confluiscono in Transpareo. Ogni spazio di lavoro dispone di un’interfaccia per EPCIS 2.0, lo standard GS1 per gli eventi nella catena di fornitura. Lo stabilimento, il corriere e il magazzino segnalano i propri eventi proprio dove si trovano i passaporti di prodotto delle batterie, e non è necessario creare un collegamento dedicato per nessuno dei tre partner.

Un unico formato per stabilimento, azienda di trasporti e magazzino

EPCIS è l’acronimo di Electronic Product Code Information Services. Un evento EPCIS risponde a quattro domande: quali prodotti, quando, dove e perché. Il “perché” corrisponde alla fase operativa, ad esempio la produzione, la spedizione o il ricevimento della merce, insieme allo stato in cui si trova il prodotto in seguito a tale fase. Laddove oggi i sistemi si scambiano informazioni sugli eventi della catena di fornitura - come avviene da anni nella logistica farmaceutica - molti di essi utilizzano già lo standard EPCIS. Anche il passaporto di prodotto stesso registra in formato EPCIS ciò che è accaduto a un prodotto, in uno dei suoi tre dizionari.

In assenza di un formato comune, ogni partner deve seguire la propria procedura: una tabella inviata via e-mail dallo stabilimento, un file di esportazione del corriere, un report dal magazzino, ciascuno con le proprie colonne. Con Transpareo, ogni partner riceve un accesso dedicato all’interfaccia del vostro spazio di lavoro e registra i propri eventi in EPCIS. Transpareo Connect collega altri sistemi a Transpareo tramite API, webhook e ora anche EPCIS 2.0. I dati anagrafici delle batterie provenienti dal vostro ERP continuano a essere trasmessi secondo la procedura consueta.

Le informazioni di cui dispone un fornitore riguardo alle batterie, come ad esempio il loro peso o la provenienza delle celle, vi vengono trasmesse tramite un canale dedicato. Con Transpareo Upstream potete richiedere queste informazioni direttamente ai vostri fornitori; un loro addetto le inserirà e voi potrete verificare la risposta prima che venga inserita nel passaporto. Tramite EPCIS, i sistemi dei vostri partner comunicano cosa succede alle batterie: montate, spedite, arrivate.

A un nuovo partner è sufficiente un unico accesso.

Lo stabilimento invia i dati relativi all’assemblaggio di un intero turno in un’unica spedizione, fino a 10’000 eventi alla volta. Transpareo verifica ogni evento rispetto allo schema GS1. Su richiesta del partner, la consegna è considerata valida nella sua interezza o non è valida affatto; in alternativa, Transpareo accetta ogni evento valido e segnala espressamente quelli errati.

Informazioni su GTIN, numero di serie e lotto nel passaporto di prodotto

Nel nostro video tutorial vi mostriamo come per ogni evento registrato su un passaporto venga generata una versione firmata dedicata e come sia possibile aprire e scaricare il documento completo dell’evento secondo lo standard EPCIS.

Un evento identifica i prodotti tramite i loro codici identificativi. Se identifica una batteria tramite il suo GTIN, insieme al numero di serie o al numero di lotto, Transpareo individua in base a ciò il relativo passaporto di prodotto; le batterie per le e-bike . Un evento che indichi solo il pallet non genera alcun passaporto. Sia che lo spedizioniere indichi una batteria tramite codice EPC o tramite GS1 Digital Link, come nel codice QR del passaporto, entrambi rimandano al medesimo passaporto.

Se l’impianto segnala batterie per le quali non è ancora stata creata la scheda, non va perso nulla. Gli eventi rimangono memorizzati e, non appena la scheda sarà disponibile, la ricerca la individuerà.

La stessa query fornisce anche gli eventi pubblici relativi al passaporto stesso, quali la sua emissione, un intervento di riparazione o il riciclaggio. Ciascuno di essi viene riportato così come è stato firmato nel file degli eventi del passaporto, con la relativa firma che il destinatario può verificare.

Una ricerca mostra l’intero percorso di una batteria: ciò che i partner hanno segnalato e ciò che il suo pass ha registrato.

Le informazioni fornite da un partner vengono riportate accanto al passaporto. Un’entrata di merce non compare quindi automaticamente nel pass pubblico, consultabile da clienti, officine e autorità. Sarebbe stato più veloce implementare questa funzione, ma abbiamo deciso di non farlo: un passaporto di prodotto firmato è un documento di cui Lei è responsabile, e la segnalazione di un partner rimane una dichiarazione di tale partner.

Se un partner commette un errore, corregge il proprio evento mediante una dichiarazione di errore, come previsto da EPCIS. L’evento originale rimane invariato, la correzione viene riportata accanto ad esso e chi effettua la consultazione può visualizzare entrambi.

Consultare, salvare, iscriversi

Gli stessi eventi effettuano ricerche nei Suoi sistemi e, nei limiti delle loro autorizzazioni, anche in quelli dei Suoi partner. Una ricerca può essere effettuata in base al prodotto, al numero di serie o al lotto, al periodo, alla fase operativa, alla località o allo stato. In questo modo, il Suo servizio clienti può verificare quando la batteria di una cliente ha lasciato il magazzino, senza dover contattare il corriere.

Una query di cui ha bisogno ripetutamente può salvarla con un nome e iscriversi per riceverla. Transpareo provvederà quindi a inviare i nuovi eventi non appena questi si verificano, oppure secondo una pianificazione prestabilita, ad esempio ogni mattina alla stessa ora. Se il destinatario imposta una password, ogni invio sarà provvisto di una firma che gli consentirà di riconoscere che proviene dal Suo spazio di lavoro.

Il Vostro sistema ERP viene informato dell’arrivo della merce a Basilea senza che nessuno debba inoltrare alcun file.

Chi vede cosa

Ogni accesso dispone di diritti propri, e la lettura degli eventi e la segnalazione degli eventi sono due diritti distinti. È inoltre possibile limitare un accesso a determinati passaporti. L’azienda di spedizioni potrà quindi leggere gli eventi relativi alle batterie di cui le avete reso disponibili i passaporti, nonché quelli da essa stessa segnalati.

Un partner vede esattamente i prodotti che gli consentite di visualizzare.

Gli eventi sono archiviati nell’UE, nel database specifico del Suo spazio di lavoro, così come tutti i Suoi dati presso Transpareo.

Perché lo standard è fondamentale

Un partner il cui sistema sia stato realizzato secondo le specifiche di GS1 dovrebbe essere in grado di comunicare con il Suo spazio di lavoro senza che nessuno debba apportare alcuna modifica. In caso contrario, tra il suo sistema e il Suo sarebbe necessaria una conversione, e ad ogni conversione un valore potrebbe perdere il proprio significato. Per questo motivo, l’interfaccia di collegamento pubblicata da GS1 per EPCIS 2.0 si estende fino ai messaggi di errore.

Uno standard Le sarà utile solo se il Suo partner lo utilizza esattamente come è scritto.

Prima di ogni nuova versione, i test automatici verificano la conformità delle risposte dell’interfaccia rispetto alla descrizione e agli schemi di GS1. In alcuni punti la descrizione è incompleta o in contraddizione con il testo dello standard. In tali casi ci atteniamo allo standard e un test segnala l’anomalia non appena GS1 corregge il punto in questione.

Laddove ci discostiamo intenzionalmente o tralasciamo un’opzione facoltativa, un partner dovrebbe conoscere soprattutto tre punti prima di integrare il proprio sistema:

  • L’interfaccia supporta JSON e JSON-LD, i due formati richiesti dallo standard per questa integrazione. Non supporta invece XML, che lo standard consente facoltativamente.
  • Gli identificativi vengono restituiti come GS1 Digital Link, come previsto dallo standard in assenza di altre indicazioni, oppure, su richiesta, nella forma in cui sono stati comunicati dal partner. L’interfaccia non offre la possibilità di convertire ogni identificativo nel formato EPC.
  • Gli abbonamenti vengono consegnati all’indirizzo da Lei scelto e esclusivamente tramite una connessione crittografata (https). Non offriamo la consegna tramite WebSocket.

Gli sviluppatori possono consultare la guida contenuta nella documentazione API di Transpareo per sapere in che modo il sistema di un partner effettua l’accesso con le proprie credenziali e in quali altri aspetti l’interfaccia si discosta dallo standard.

Ritorno alla rampa

Alle 6:41 il magazzino ha segnalato l’arrivo della merce e, poco dopo, il vostro sistema ERP ne è stato informato tramite il proprio abbonamento. Chiunque richieda il numero di serie di una delle 48 batterie potrà visualizzarne il percorso: assemblata in fabbrica, imballata sul pallet, presa in carico dal corriere, arrivata a Basilea, con accanto gli eventi registrati nel suo «passaporto».

A tal fine, l’azienda di trasporti ha ottenuto un accesso e invia i dati nel formato già supportato dal proprio sistema.

Domande relative a questo articolo

Che cos’è EPCIS 2.0?

EPCIS 2.0 è lo standard GS1 relativo agli eventi nella catena di fornitura, adottato nel 2022. Un evento registra quali prodotti sono stati registrati, quando, dove e in quale fase del processo commerciale, nonché in quale stato si trovano successivamente. Con la versione 2.0 sono stati introdotti i formati JSON e JSON-LD, oltre a un’interfaccia REST tramite la quale i sistemi segnalano e consultano gli eventi.

Che cosa ha a che fare l’EPCIS con il passaporto digitale di prodotto?

Il passaporto digitale di prodotto descrive la natura di un prodotto, mentre l’EPCIS ne registra la storia. Su Transpareo, ogni passaporto pubblica i propri eventi sotto forma di file EPCIS firmato, e gli eventi dei vostri partner vengono associati ad esso tramite il GTIN, il numero di serie o il lotto.

Ho bisogno di un proprio repository EPCIS?

No. Ogni spazio di lavoro in Transpareo ne possiede uno, con un proprio indirizzo. Essa riceve gli eventi, li archivia e risponde alle richieste. I Suoi partner inviano le segnalazioni a tale spazio di lavoro, mentre i Suoi sistemi effettuano le richieste presso di esso.

Un evento segnalato comporta una modifica del mio passaporto di prodotto?

No. Un evento segnalato viene associato al passaporto e viene collegato ad esso tramite il relativo identificativo. La cronologia firmata del passaporto e il passaporto che i Suoi clienti visualizzano rimangono così come li ha pubblicati.

In che modo un partner integra il proprio sistema?

Creerete per lui un accesso ai programmi e gli concederete il diritto di segnalare gli eventi e, se lo desidera, anche quello di leggerli. Utilizzando la chiave e il segreto, il suo sistema otterrà un token di accesso e invierà i propri eventi sotto forma di documento EPCIS all’indirizzo dello spazio di lavoro. Se il suo sistema supporta già lo standard EPCIS 2.0, saranno sufficienti solo l’indirizzo e l’accesso.

In che modo Transpareo verifica che l’interfaccia sia conforme allo standard?

Prima di ogni nuova versione, i test automatici verificano le risposte di ciascuna operazione rispetto alla descrizione OpenAPI e agli schemi JSON pubblicati da GS1 per EPCIS 2.0. Laddove la descrizione risulti incompleta o in contraddizione con il testo dello standard, ci atteniamo allo standard e un test segnala l’anomalia non appena GS1 corregge il punto in questione. Laddove l’interfaccia si discosti dallo standard, la documentazione dell’API indica ogni singolo punto.

Novità da Transpareo Connect, non appena saranno disponibili

Descriviamo ciò che realizziamo e il motivo per cui lo facciamo, utilizzando un linguaggio chiaro e comprensibile.