Cos'è un file DEX? Guida per operatori di distributori automatici

Un file DEX è il record di audit che un distributore automatico produce su se stesso: quante vendite ha effettuato, quanto denaro ha incassato, cosa ha venduto ogni selezione e a quale prezzo, e quali errori ha registrato. Il formato è DEX/UCS, con dati scritti secondo lo standard EVA-DTS, e una volta che sapete leggerlo non dovete più contare una macchina a mano per sapere cosa ha fatto dall'ultima visita.

Da dove deriva il nome

DEX sta per Direct Exchange, e UCS for Uniform Communication Standard. The pair was borrowed from the grocery industry in the early 1990s, when the National Automatic Merchandising Association needed a way for route drivers to pull a machine's figures without opening a mechanical counter. The data inside the file follows EVA-DTS, ovvero European Vending Association Data Transfer Standard, per cui vedrete entrambi i nomi usati per quella che, in pratica, è la stessa cosa. Si dice “file DEX”, “lettura DEX”, “audit DEX” e “file EVA-DTS” in modo intercambiabile.

Quasi tutte le macchine per snack, bibite e alimenti costruite negli ultimi venticinque anni possono generarne uno. Le macchine più vecchie lo rendono disponibile tramite una porta DEX sulla scheda di controllo; quelle più recenti e la maggior parte dei lettori di carte e dei dispositivi di telemetria producono lo stesso file e lo inviano via rete cellulare.

Cosa contiene un file DEX

Aprite un file in un editor di testo e vedrete un file di testo semplice, con un record per riga, ogni record un codice seguito da campi separati da asterischi. La busta inizia con DXS e termina con DXE, e il contenuto effettivo si trova tra ST e SE Uno breve appare così:

DXS*1234567890*VA*V0/6*1
ST*001*0001
ID1*VMC12345678*MODEL-X*1234
ID4*2*USD
VA1*1842750*31204*49800*842
CA2*1250300*21855*31200*521
PA1*10*125
PA2*412*51500*8*1000
PA1*12*150
PA2*96*14400*2*300
EA1*EGS*20261014*0812
G85*A1F0
SE*12*0001
DXE*1*1

I tipi di record che contano per un gestore:

Contatori di intervallo e cumulativi

La maggior parte dei record di conteggio include due serie di numeri: un valore dall'inizializzazione della macchina e un valore dall'ultimo azzeramento. Una lettura di solito azzera i contatori di intervallo, quindi i campi « dall'ultimo azzeramento » ti mostrano esattamente cosa è successo tra due visite, mentre i campi « dall'inizializzazione » ti permettono di individuare una lettura mancata. Se il tuo software considera solo i contatori cumulativi, dovrebbe calcolare la differenza tra file consecutivi e trattare una differenza negativa come un reset della scheda o un controller sostituito, mai come vendite negative.

Come un file DEX arriva dalla macchina a te

Tre percorsi sono comuni, e la maggior parte dei giri ne usa più di uno.

1. Sulla macchina. Il metodo più datato è un terminale portatile collegato alla porta DEX durante la visita. Un equivalente moderno più diffuso è un dispositivo di telemetria o un lettore di carte che memorizza la lettura e la invia a un telefono via Bluetooth o Wi-Fi, oppure permette di esportarla come file. In entrambi i casi ottieni un .dex oppure .txt file per macchina per visita.
2. Trasmissione wireless. I lettori di carte di Nayax, Cantaloupe, PayRange e altri recuperano a intervalli programmati una lettura DEX dal controller e la caricano. Il portale operatore mostra poi il livello di scorta per spirale, e alcuni fornitori lo espongono tramite un'API, così altri software possono recuperarlo.
3. Tramite un'API propria Se gestite un box di telemetria o un lettore con un feed per sviluppatori, la soluzione più pulita è un dispositivo che invia il file grezzo a un endpoint non appena viene scaricato, così nessuno deve portare un file da nessuna parte.

Cosa farne

Il valore di un file DEX non sta nel file, ma nelle tre domande a cui risponde senza bisogno di contare.

• Cosa ha venduto ogni spirale? Sottraete le PA2 vendite avvenute dall'ultima visita dal livello di riempimento precedente e avrete la giacenza attuale di ogni selezione, prima ancora di aprire lo sportello. È la base di una lista di prelievo preparata in magazzino anziché sul posto.
• Quanto contante dovrebbe esserci nel box? CA3 meno CA4, o il campo contante nel box quando la macchina lo riporta, è ciò che l'addetto deve ritirare. Confrontatelo con quanto effettivamente contato e un problema di ammanchi emergerà alla prima visita, anziché durante la revisione trimestrale.
• Perché la macchina si è fermata? I EA gli eventi sono datati. Una macchina le cui vendite sono scese a zero tre giorni prima della visita, con un inceppamento del validatore banconote registrato alla stessa ora, richiede una riparazione, non indica una postazione morta.

Ciò che può andare storto

DEX è uno standard con diversi dialetti. Aspettatevi quanto segue e preferite un software che li tratti come avvisi anziché come errori:

• Alcuni controller omettono ID4, quindi il lettore deve presumere una valuta e il numero di decimali. Altri lo inviano con zero decimali in una valuta che chiaramente prevede i centesimi.
• I produttori aggiungono record propri o inseriscono campi extra in quelli standard. Un parser rigoroso rifiuta l'intero file; uno tollerante mantiene i campi standard e segnala il resto.
• Un file scaricato mentre la macchina era in fase di vendita, o un caricamento cellulare interrotto, non supera il G85 checksum. Scartatelo e scaricatelo di nuovo invece di tirare a indovinare.
• Gli ID di selezione non sempre corrispondono al numero stampato sulla spirale. Create la mappatura una volta per macchina e conservatela.
• La sostituzione di un controller azzera tutti i contatori cumulativi. Un software che registra in silenzio un grande numero negativo di vendite non se ne è accorto.

Altre guide: tutte le guide di Adelyons