Qu'est-ce qu'un fichier DEX ? Guide pour opérateurs de distributeurs automatiques

Un fichier DEX est l'enregistrement d'audit qu'un distributeur automatique produit sur lui-même : le nombre de ventes réalisées, la somme encaissée, les ventes et prix de chaque sélection, et les erreurs enregistrées. Le format est DEX/UCS, avec des données conformes à la norme EVA-DTS. Une fois que vous savez le lire, vous n'avez plus besoin de compter une machine à la main pour savoir ce qu'elle a fait depuis votre dernière visite.

D'où vient le nom

DEX signifie Direct Exchange, et UCS pour Uniform Communication Standard. Ce duo a été emprunté à l'industrie alimentaire au début des années 1990, lorsque la National Automatic Merchandising Association cherchait un moyen permettant aux chauffeurs de tournée de relever les chiffres d'une machine sans ouvrir un compteur mécanique. Les données contenues dans le fichier suivent EVA-DTS, la European Vending Association Data Transfer Standard, ce qui explique que vous verrez les deux noms utilisés pour ce qui est, en pratique, la même chose. On dit « fichier DEX », « lecture DEX », « audit DEX » et « fichier EVA-DTS » indifféremment.

Presque tous les distributeurs de snacks, de boissons et de plats construits au cours des vingt-cinq dernières années peuvent en produire un. Les machines plus anciennes le mettent à disposition via un port DEX sur la carte de commande ; les plus récentes, ainsi que la plupart des lecteurs de cartes et appareils de télémétrie, produisent le même fichier et l'envoient par le réseau cellulaire.

Ce que contient un fichier DEX

Ouvrez-en un dans un éditeur de texte et vous verrez un fichier texte brut, un enregistrement par ligne, chaque enregistrement commençant par un code suivi de champs séparés par des astérisques. L'enveloppe commence par DXS et se termine par DXE, et le contenu réel se trouve entre les deux ST et SE Un court ressemble à ceci :

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

Les types d'enregistrements qui comptent pour un exploitant :

Compteurs d'intervalle et cumulés

La plupart des enregistrements de comptage contiennent deux jeux de chiffres : un total depuis l'initialisation de la machine et un total depuis la dernière remise à zéro. Une lecture remet généralement à zéro les compteurs d'intervalle ; les champs « depuis la dernière remise à zéro » vous indiquent donc exactement ce qui s'est passé entre deux visites, et les champs « depuis l'initialisation » permettent de repérer une lecture manquée. Si votre logiciel n'exploite que les compteurs cumulés, il doit calculer la différence entre deux fichiers successifs et traiter une différence négative comme une réinitialisation de la carte ou un contrôleur remplacé, jamais comme des ventes négatives.

Comment un fichier DEX passe de la machine jusqu'à vous

Trois méthodes sont courantes, et la plupart des tournées en utilisent plusieurs.

1. Sur la machine. La méthode la plus ancienne consiste à brancher un terminal portable sur le port DEX pendant la visite. Un équivalent moderne plus courant est un boîtier de télémétrie ou un lecteur de carte qui enregistre la lecture et la transmet à un téléphone via Bluetooth ou Wi-Fi, ou permet de l'exporter sous forme de fichier. Dans les deux cas, vous obtenez un .dex ou .txt fichier par machine et par visite.
2. Sans fil. Les lecteurs de carte de Nayax, Cantaloupe, PayRange et d'autres récupèrent régulièrement une lecture DEX auprès du contrôleur et la transmettent. Votre portail d'exploitation affiche alors le stock par spirale, et certains fournisseurs l'exposent via une API afin que d'autres logiciels puissent la récupérer.
3. Via votre propre API Si vous utilisez un boîtier de télémétrie ou un lecteur avec un flux développeur, la solution la plus propre consiste en un appareil qui envoie le fichier brut vers un point de terminaison dès qu'il est récupéré, afin que personne n'ait à transporter un fichier.

Que faire avec

La valeur d'un fichier DEX ne réside pas dans le fichier lui-même, mais dans les trois questions auxquelles il répond sans comptage.

• Qu'a vendu chaque spirale ? Soustrayez les PA2 ventes depuis la dernière visite du dernier niveau de remplissage, et vous obtenez le stock actuel de chaque sélection, avant même d'ouvrir la porte. C'est la base d'une liste de préparation établie à l'entrepôt plutôt qu'à la machine.
• Combien d'argent liquide devrait se trouver dans le boîtier ? CA3 moins CA4, ou le champ d'argent dans le boîtier lorsque la machine le transmet, est la somme que le chauffeur doit récupérer. Comparez-la à ce qui est réellement compté, et un problème de démarque apparaîtra dès la première visite, et non lors du bilan trimestriel.
• Pourquoi la machine s'est-elle arrêtée ? Les EA les événements sont horodatés. Une machine dont les ventes sont tombées à zéro trois jours avant la visite, avec un bourrage du lecteur de billets enregistré à la même heure, relève d'une réparation, et non d'un emplacement mort.

Ce qui peut dérailler

DEX est un standard qui existe en plusieurs variantes. Attendez-vous aux points suivants, et privilégiez un logiciel qui les traite comme des avertissements plutôt que comme des erreurs :

• Certains contrôleurs omettent ID4, de sorte que le lecteur doit supposer une devise et un nombre de décimales. D'autres l'envoient avec zéro décimale pour une devise qui a clairement des centimes.
• Les fabricants ajoutent leurs propres enregistrements ou placent des champs supplémentaires dans les enregistrements standard. Un analyseur strict rejette tout le fichier ; un analyseur tolérant conserve les champs standard et signale le reste.
• Un fichier récupéré pendant qu'une vente était en cours, ou un envoi cellulaire interrompu, échoue à la G85 somme de contrôle. Jetez-le et récupérez-le à nouveau plutôt que de deviner.
• Les identifiants de sélection ne correspondent pas toujours au numéro imprimé sur la spirale. Établissez la correspondance une fois par machine et conservez-la.
• Le remplacement d'un contrôleur réinitialise tous les compteurs cumulés. Un logiciel qui enregistre silencieusement un grand nombre négatif de ventes n'a pas remarqué le problème.

Autres guides : tous les guides d'Adelyons