Was ist eine DEX-Datei? Ein Leitfaden für Automatenbetreiber

Eine DEX-Datei ist der Prüfbericht, den ein Verkaufsautomat über sich selbst erstellt: wie viele Verkäufe er getätigt hat, wie viel Geld er eingenommen hat, was jede Auswahl verkauft hat und zu welchem Preis, und welche Fehler er protokolliert hat. Das Format ist DEX/UCS und enthält Daten nach dem EVA-DTS-Standard. Sobald Sie eine lesen können, müssen Sie einen Automaten nicht mehr von Hand zählen, um zu wissen, was seit dem letzten Besuch passiert ist.

Woher der Name stammt

DEX steht für Direct Exchange, und UCS für Uniform Communication Standard. Das Begriffspaar wurde Anfang der 1990er-Jahre aus der Lebensmittelbranche übernommen, als die National Automatic Merchandising Association einen Weg brauchte, mit dem Routenfahrer die Zählerstände eines Automaten abrufen konnten, ohne ein mechanisches Zählwerk zu öffnen. Die Daten innerhalb der Datei folgen EVA-DTS, dem European Vending Association Data Transfer Standard, weshalb Sie beide Bezeichnungen für dasselbe finden. Menschen sagen „DEX-Datei“, „DEX-Auslesung“, „DEX-Prüfung“ und „EVA-DTS-Datei“ austauschbar.

Fast jeder Snack-, Getränke- und Speiseautomat, der in den letzten 25 Jahren gebaut wurde, kann eine solche Datei erzeugen. Ältere Automaten stellen sie über einen DEX-Anschluss an der Steuerplatine bereit; neuere Automaten sowie die meisten Kartenleser und Telemetriegeräte erzeugen dieselbe Datei und senden sie über das Mobilfunknetz.

Was in einer DEX-Datei steht

Öffnen Sie eine in einem Texteditor, und Sie sehen eine reine Textdatei mit einem Datensatz pro Zeile, jeder Datensatz ein Code gefolgt von durch Sternchen getrennten Feldern. Der Rahmen beginnt mit DXS und endet mit DXE, und der eigentliche Inhalt steht dazwischen ST und SE Ein kurzes sieht so aus:

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

Die Datensatztypen, die für einen Automatenbetreiber wichtig sind:

Intervall- und kumulative Zähler

Die meisten zählenden Datensätze enthalten zwei Zahlensätze: einen Wert seit der Initialisierung des Automaten und einen Wert seit dem letzten Reset. Ein Auslesen setzt die Intervallzähler in der Regel zurück, sodass die Felder „seit letztem Reset“ genau zeigen, was zwischen zwei Besuchen passiert ist, und die Felder „seit Initialisierung“ helfen, einen verpassten Auslesevorgang zu erkennen. Wenn Ihre Software nur die kumulativen Zähler auswertet, sollte sie die Differenz zwischen aufeinanderfolgenden Dateien bilden und eine negative Differenz als Reset der Platine oder als getauschte Steuerung behandeln, niemals als negativen Umsatz.

Wie eine DEX-Datei vom Automaten zu Ihnen gelangt

Drei Wege sind üblich, und die meisten Routen nutzen mehr als einen.

1. Am Automaten. Die älteste Methode ist ein Handgerät, das während des Besuchs an den DEX-Anschluss angeschlossen wird. Ein heute verbreitetes modernes Pendant ist ein Telemetriegerät oder ein Kartenleser, der das Auslesen speichert und über Bluetooth oder WLAN an ein Smartphone übergibt oder als Datei exportieren lässt. In beiden Fällen erhalten Sie eine .dex oder .txt Datei pro Automat und pro Besuch.
2. Drahtlos übertragen. Kartenleser von Nayax, Cantaloupe, PayRange und anderen fragen den Controller nach einem Zeitplan nach einem DEX-Auslesen ab und laden es hoch. Ihr Betreiberportal zeigt dann den Bestand pro Schacht an, und einige Anbieter stellen dies über eine API bereit, damit andere Software die Daten abrufen kann.
3. Über eine eigene API Wenn Sie ein Telemetriegerät oder ein Lesegerät mit Entwickler-Feed betreiben, ist die sauberste Lösung ein Gerät, das die Rohdatei sofort an einen Endpunkt sendet, sobald sie abgerufen wird, sodass niemand eine Datei irgendwohin tragen muss.

Was man damit macht

Der Nutzen einer DEX-Datei liegt nicht in der Datei selbst, sondern in den drei Fragen, die sie ohne Zählung beantwortet.

• Was hat jede Spirale verkauft? Ziehen Sie die PA2 Verkäufe seit dem letzten Besuch vom letzten Füllstand ab, und Sie kennen den aktuellen Bestand jeder Auswahl, noch bevor jemand die Tür öffnet. Das ist die Grundlage für eine Kommissionierliste, die im Lager statt am Automaten erstellt wird.
• Wie viel Bargeld sollte im Kasten sein? CA3 minus CA4, oder das Feld für Bargeld im Kasten, sofern der Automat es meldet, ist das, was der Fahrer abholen sollte. Vergleichen Sie es mit dem tatsächlich gezählten Betrag, dann zeigt sich ein Schwund bereits beim ersten Besuch statt erst bei der Quartalsauswertung.
• Warum ist der Automat stehen geblieben? Die EA Ereignisse tragen Zeitstempel. Ein Automat, dessen Verkäufe drei Tage vor dem Besuch auf null fielen, während zur gleichen Uhrzeit ein Banknotenprüfer-Stau protokolliert wurde, ist ein Reparaturfall, kein toter Standort.

Was schiefgehen kann

DEX ist ein Standard mit Dialekten. Rechnen Sie mit folgenden Abweichungen und bevorzugen Sie Software, die sie als Warnungen statt als Fehler behandelt:

• Manche Steuerungen lassen ID4weg, sodass das Lesegerät eine Währung und die Anzahl der Dezimalstellen annehmen muss. Andere senden sie mit null Dezimalstellen für eine Währung, die eindeutig Cent kennt.
• Hersteller fügen eigene Datensätze hinzu oder ergänzen Standard-Datensätze um zusätzliche Felder. Ein strikter Parser weist die gesamte Datei zurück; ein toleranter behält die Standardfelder und markiert den Rest.
• Eine Datei, die abgerufen wurde, während der Automat gerade einen Verkauf abwickelte, oder ein abgebrochener Mobilfunk-Upload schlägt bei der G85 Prüfsummenkontrolle. Verwerfen Sie sie und rufen Sie die Datei erneut ab, statt zu raten.
• Auswahl-IDs stimmen nicht immer mit der auf der Spirale aufgedruckten Nummer überein. Erstellen Sie die Zuordnung einmal pro Automat und bewahren Sie sie auf.
• Ein Steuerungswechsel setzt alle kumulativen Zähler zurück. Software, die stillschweigend eine große negative Verkaufszahl erfasst, hat das nicht bemerkt.

Weitere Anleitungen: alle Anleitungen von Adelyons