Wat is een DEX-bestand? Een gids voor automaatexploitanten

Een DEX-bestand is het auditrecord dat een automaat over zichzelf produceert: hoeveel verkopen het heeft gedaan, hoeveel geld het heeft ontvangen, wat elke selectie heeft verkocht en tegen welke prijs, en welke fouten het heeft gelogd. Het formaat is DEX/UCS, met gegevens volgens de EVA-DTS-standaard. Als u er één kunt lezen, hoeft u een automaat niet meer met de hand te tellen om te weten wat er sinds het laatste bezoek is gebeurd.

Waar de naam vandaan komt

DEX staat voor Direct Exchange, en 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, de European Vending Association Data Transfer Standard, daarom ziet u beide namen door elkaar gebruikt voor wat in de praktijk hetzelfde is. Mensen zeggen “DEX-bestand”, “DEX-uitlezing”, “DEX-audit” en “EVA-DTS-bestand” door elkaar.

Vrijwel elke snack-, frisdrank- en voedselautomaat die de afgelopen vijfentwintig jaar is gebouwd, kan er een produceren. Oudere automaten tonen het via een DEX-poort op de besturingskaart; nieuwere automaten en de meeste kaartlezers en telemetrieapparaten maken hetzelfde bestand aan en versturen het via het mobiele netwerk.

Wat er in een DEX-bestand staat

Open er een in een teksteditor en u ziet een platte tekstbestand, één record per regel, elk record een code gevolgd door velden die door sterretjes zijn gescheiden. De omhulling begint met DXS en eindigt met DXE, en de eigenlijke inhoud staat ertussen ST en SE Een kort voorbeeld ziet er zo uit:

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

De recordtypen die voor een exploitant belangrijk zijn:

Interval- en cumulatieve tellers

De meeste telrecords bevatten twee sets getallen: een cijfer sinds de initialisatie van de machine en een cijfer sinds de laatste reset. Een uitlezing zet de intervaltellers meestal terug op nul, dus de velden „sinds laatste reset” geven precies weer wat er tussen twee bezoeken is gebeurd, en de velden „sinds initialisatie” laten je een gemiste uitlezing herkennen. Als je software alleen naar de cumulatieve tellers kijkt, moet het het verschil tussen opeenvolgende bestanden berekenen en een negatief verschil behandelen als een reset van het bord of een vervangen controller, nooit als negatieve verkoop.

Hoe een DEX-bestand van de machine bij jou terechtkomt

Drie wegen komen veel voor, en de meeste routes gebruiken er meer dan één.

1. Bij de machine. De oudste manier is een handterminal die tijdens het bezoek op de DEX-poort wordt aangesloten. Een modernere, gangbaardere variant is een telemetrieapparaat of kaartlezer die de uitlezing opslaat en via Bluetooth of wifi naar een telefoon stuurt, of als bestand laat exporteren. In beide gevallen krijg je een .dex of .txt bestand per machine per bezoek.
2. Draadloos. Kaartlezers van Nayax, Cantaloupe, PayRange en andere halen volgens een schema een DEX-uitlezing van de controller op en uploaden die. Je beheerportaal toont dan de voorraad per spiraal, en sommige leveranciers stellen dat via een API beschikbaar, zodat andere software het kan ophalen.
3. Via een eigen API Als u een telemetriebox of een lezer met een ontwikkelaarsfeed gebruikt, is de eenvoudigste opzet een apparaat dat het ruwe bestand direct naar een endpoint stuurt zodra het is opgehaald, zodat niemand een bestand hoeft rond te brengen.

Wat u ermee doet

De waarde van een DEX-bestand zit niet in het bestand zelf, maar in de drie vragen die het beantwoordt zonder dat er geteld hoeft te worden.

• Wat heeft elke spiraal verkocht? Trek de PA2 verkopen sinds het vorige bezoek af van het laatste vulniveau, en u weet de actuele voorraad van elke selectie, nog voordat iemand de deur opent. Dat is de basis voor een picklijst die in het magazijn wordt opgesteld en niet bij de automaat.
• Hoeveel contant geld zou er in de box moeten zitten? CA3 min CA4, of het veld voor contant geld in de box waar de machine dat rapporteert, is wat de chauffeur moet ophalen. Vergelijk dat met wat daadwerkelijk geteld is, en een kasverlies komt al bij het eerste bezoek aan het licht in plaats van bij de kwartaalevaluatie.
• Waarom is de automaat gestopt? De EA gebeurtenissen hebben een tijdstempel. Een automaat waarvan de verkopen drie dagen voor het bezoek op nul vielen, met een bankbiljettenlezer-storing op hetzelfde uur geregistreerd, heeft reparatie nodig en is geen dode locatie.

De onderdelen die misgaan

DEX is een standaard met dialecten. Houd rekening met het volgende, en kies software die deze als waarschuwingen behandelt in plaats van als fouten:

• Sommige controllers laten ID4weg, waardoor de lezer een valuta en een aantal decimalen moet aannemen. Andere sturen het met nul decimalen voor een valuta die duidelijk centen kent.
• Fabrikanten voegen eigen records toe of plaatsen extra velden in standaardrecords. Een strikte parser weigert het hele bestand; een tolerante houdt de standaardvelden en markeert de rest.
• Een bestand dat is opgehaald terwijl de automaat midden in een verkoop zat, of een mobiele upload die werd afgebroken, faalt bij de G85 controlesom. Gooi het weg en haal het opnieuw op in plaats van te gokken.
• Selectie-id's komen niet altijd overeen met het nummer dat op de spiraal staat. Maak de koppeling één keer per automaat en bewaar die.
• Bij het vervangen van een controller worden alle cumulatieve tellers op nul gezet. Software die stilzwijgend een grote negatieve verkoopteller registreert, heeft dit niet opgemerkt.

Meer gidsen: alle gidsen van Adelyons