Vai al contenuto principale
Parla con noi

Integrazioni e API · Guida

Lascia che il sistema di un acquirente legga i tuoi eventi di tracciabilità

I sistemi dei tuoi acquirenti e i tuoi leggono gli eventi dei tuoi lotti tramite l’interfaccia di interrogazione GS1 EPCIS 2.0, invece di aspettare file. Scegli tu quali aziende collegate possono leggerli.

Molti acquirenti usano un sistema di tracciabilità che parla GS1 EPCIS 2.0, lo standard mondiale di "cosa è successo a quale lotto, quando e dove". A-REX risponde direttamente a questo standard: il loro sistema chiede, A-REX risponde con gli eventi dei lotti, in tempo reale, filtrati come definisce GS1. Nessun file da inviare.

Cosa legge l’altro sistema

Ogni evento dice cosa è successo a un lotto: è stato creato, spedito, ricevuto, lavorato, ispezionato o ha ricevuto un certificato. Ogni evento porta un passo di business GS1 (per esempio shipping, spedizione) e, accanto, le tue parole per il passo. Ogni evento dice che è stato dichiarato da la tua azienda: condividere eventi non li rende verificati.

  • Il tuo sistema legge tutti gli eventi della tua azienda.
  • Un’azienda collegata legge gli eventi dei lotti che le hai consegnato, e solo finché condividi con lei gli Eventi di tracciabilità (vedi Cosa condivide ogni azienda). Vede le tue consegne a lei, mai le tue consegne ad altri, e la lavorazione fino alla consegna.

Dai accesso a un sistema

  1. In Integrazioni, crea una chiave API o un client macchina con l’ambito read. Un acquirente la crea nella propria azienda: legge ciò che condividi con lui.
  2. Dai a chi gestisce quel sistema l’indirizzo https://{indirizzo dell’API}/v1/epcis e la chiave.
  3. Il loro sistema chiede, per esempio, le spedizioni di un lotto: GET /v1/epcis/events?EQ_bizStep=shipping&MATCH_epcClass={il Digital Link del lotto}.

A-REX registra ogni lettura di una chiave o di un client. Perché un’azienda collegata smetta di leggere i tuoi eventi, togli la spunta a Eventi di tracciabilità nella pagina del suo collegamento; per fermare una chiave, revocala.

Buono a sapersi

  • L’interfaccia legge soltanto. Nulla può scrivere eventi in A-REX tramite essa: le registrazioni passano sempre dalle tue approvazioni.
  • Gli storici lunghi arrivano una pagina alla volta; un sistema che ha bisogno di molto di più restringe il periodo.
  • L’identificativo del lotto negli eventi è il suo GS1 Digital Link quando il prodotto ha un GTIN e il lotto un codice di lotto; altrimenti un identificativo A-REX.
  • Il tuo team tecnico trova la descrizione completa, con ogni filtro, nella documentazione per sviluppatori (interfaccia di interrogazione EPCIS).