Vai al contenuto principale

Integrazioni e API · Guida

Invia le letture dei dispositivi ad A-REX

Collega un logger, un tracker o una piattaforma di flotta perché temperatura, umidità, aperture delle porte e altre letture arrivino alle tue consegne tracciate, verificate con un unico insieme di regole.

Le letture dei dispositivi mostrano come ha viaggiato la merce: la temperatura nel rimorchio, l'umidità in un container, quando si è aperta una porta. A-REX le riceve da qualsiasi dispositivo o piattaforma in grado di inviare un messaggio, verifica ognuna con le stesse regole pubblicate e la aggiunge alla consegna tracciata. Non ti serve un accordo con il produttore del dispositivo: la tua azienda o il tuo vettore indirizza la propria piattaforma a un indirizzo che A-REX ti fornisce.

Una lettura non cambia mai una consegna da sola. Alimenta il grafico della consegna, i suoi avvisi e le proposte che una persona approva.

Scegli come arrivano le letture

Hai…Usa
una piattaforma di flotta, di tracciamento o di logger che può inviare un webhookun endpoint In entrata con destinazione Letture dai dispositivi
un tuo software che può accedere come client macchinal'API delle letture, con un client autorizzato a scrivere letture
un logger che leggi dopo il viaggioCarica un file del logger nella consegna

Collega una piattaforma

  1. Apri In entrata e scegli Aggiungi endpoint in entrata. Indica che riceve letture dai dispositivi e scegli il formato inviato dalla tua piattaforma: Letture A-REX JSON oppure Dati dei sensori EPCIS.
  2. Copia l'indirizzo e il segreto nelle impostazioni di inoltro della tua piattaforma. Scegli lo stesso tipo di firma da entrambe le parti.
  3. Se la tua piattaforma invia un JSON diverso, apri l'endpoint e usa Mappa un altro JSON in Mappatura delle letture: indica dove si trovano l'ora, i valori e l'id del dispositivo, incolla un messaggio di esempio e prova la mappatura prima di pubblicarla.
  4. Registra ogni dispositivo in Letture, alla voce Fonti di letture, con l'id che invia e ogni quanto dovrebbe inviare. Vedi Fonti di letture e dispositivi.

Verifica prima di partire

Ogni messaggio riceve un rapporto di convalida: quante letture sono state salvate e, per quelle rifiutate, cosa non va e come correggerlo, campo per campo. Le letture valide vengono conservate anche quando altre dello stesso messaggio sono rifiutate. Vedi Leggere un rapporto di convalida.

Segui il flusso di dati

La scheda della consegna nella pagina del lotto mostra Qualità del flusso di dati con una lettera da A a E. Aprila per vedere il punteggio e i due problemi principali, per esempio un'interruzione lunga. Vedi La qualità del flusso di dati spiegata.

Cosa viene registrato

Ogni lettura conserva chi ne risponde: Dichiarato dalla tua azienda (un file che hai caricato), Segnalato da una piattaforma collegata oppure Misurato e firmato dal dispositivo. Le letture vengono registrate nel registro dal momento in cui arrivano, in periodi fino a quattro ore. Le posizioni sono dati personali dell'autista e vengono trattate a parte; vedi Posizioni e privacy.