O que é um arquivo DEX? Um guia para operadores de vending

Um arquivo DEX é o registro de auditoria que uma máquina de vending produz sobre si mesma: quantas vendas fez, quanto dinheiro recebeu, o que cada seleção vendeu e por qual preço, e quais erros registrou. O formato é DEX/UCS, com dados no padrão EVA-DTS, e, quando você sabe ler um, não precisa mais contar uma máquina à mão para saber o que ela fez desde a última visita.

De onde vem o nome

DEX significa Direct Exchange, e UCS para Uniform Communication Standard. O par foi emprestado da indústria de alimentos no início dos anos 1990, quando a National Automatic Merchandising Association precisava de uma forma para que os motoristas de rota pudessem obter os números de uma máquina sem abrir um contador mecânico. Os dados dentro do arquivo seguem EVA-DTS, o European Vending Association Data Transfer Standard, por isso você verá os dois nomes usados para o que, na prática, é a mesma coisa. As pessoas dizem “arquivo DEX”, “leitura DEX”, “auditoria DEX” e “arquivo EVA-DTS” indistintamente.

Quase toda máquina de snacks, refrigerantes e alimentos fabricada nos últimos vinte e cinco anos consegue gerar um. Máquinas mais antigas expõem o arquivo por uma porta DEX na placa controladora; as mais novas e a maioria dos leitores de cartão e dispositivos de telemetria produzem o mesmo arquivo e o enviam pela rede celular.

O que há em um arquivo DEX

Abra um em um editor de texto e você verá um arquivo de texto simples, um registro por linha, cada registro sendo um código seguido de campos separados por asteriscos. O envelope começa com DXS e termina com DXE, e o conteúdo real fica entre ST e SE Um curto fica assim:

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

Os tipos de registro que importam para um operador:

Contadores de intervalo e acumulados

A maioria dos registros de contagem traz dois conjuntos de números: um valor desde a inicialização da máquina e um valor desde o último reset. Uma leitura normalmente zera os contadores de intervalo, então os campos “desde o último reset” mostram exatamente o que aconteceu entre duas visitas, e os campos “desde a inicialização” permitem identificar uma leitura perdida. Se o seu software só olha para os contadores acumulados, ele deve calcular a diferença entre arquivos consecutivos e tratar uma diferença negativa como reset da placa ou troca do controlador, nunca como vendas negativas.

Como um arquivo DEX chega até você a partir da máquina

Três caminhos são comuns, e a maioria das rotas usa mais de um.

1. Na máquina. A forma mais antiga é um aparelho portátil conectado à porta DEX durante a visita. Um equivalente moderno mais comum é um dispositivo de telemetria ou um leitor de cartão que armazena a leitura e a envia para um celular por Bluetooth ou Wi-Fi, ou permite exportá-la como arquivo. De qualquer forma, você fica com um .dex ou .txt arquivo por máquina por visita.
2. Pelo ar. Leitores de cartão da Nayax, Cantaloupe, PayRange e outras empresas puxam uma leitura DEX do controlador conforme uma programação e a enviam. Seu portal de operador então mostra o nível de estoque por espiral, e alguns fornecedores disponibilizam isso por meio de uma API para que outros softwares possam buscar os dados.
3. Por meio de uma API própria Se você usa uma caixa de telemetria ou um leitor com um feed para desenvolvedores, o arranjo mais simples é um dispositivo que envia o arquivo bruto para um endpoint assim que ele é extraído, para que ninguém precise levar arquivo algum para lugar nenhum.

O que fazer com ele

O valor de um arquivo DEX não está no arquivo; está nas três perguntas que ele responde sem precisar de contagem.

• O que cada espiral vendeu? Subtraia as PA2 vendas desde a última visita do último nível de abastecimento e você terá o estoque atual de cada seleção, antes de alguém abrir a porta. Essa é a base de uma lista de separação montada no depósito, e não na máquina.
• Quanto dinheiro deveria haver na caixa? CA3 menos CA4, ou o campo de dinheiro na caixa quando a máquina o informa, é o que o motorista deve recolher. Compare com o que foi efetivamente contado e um problema de quebra aparece na primeira visita, em vez de na revisão trimestral.
• Por que a máquina parou? Os EA os eventos têm carimbo de data e hora. Uma máquina cujas vendas caíram a zero três dias antes da visita, com um travamento do validador de notas registrado na mesma hora, precisa de conserto, não é um ponto morto.

As partes que dão problema

DEX é um padrão com dialetos. Espere o seguinte e prefira softwares que tratem esses casos como avisos, e não como falhas:

• Alguns controladores omitem ID4, então o leitor precisa assumir uma moeda e a quantidade de casas decimais. Outros enviam com zero casas decimais em uma moeda que claramente tem centavos.
• Os fabricantes adicionam registros próprios ou colocam campos extras nos padrões. Um analisador rigoroso rejeita o arquivo inteiro; um tolerante mantém os campos padrão e sinaliza o restante.
• Um arquivo extraído enquanto a máquina estava no meio de uma venda, ou um upload por celular interrompido, falha na G85 checksum. Descarte-o e extraia novamente em vez de adivinhar.
• Os IDs de seleção nem sempre correspondem ao número impresso na espiral. Monte o mapeamento uma vez por máquina e guarde-o.
• A troca de controlador zera todos os contadores acumulados. Um software que registra silenciosamente uma grande contagem negativa de vendas não percebeu isso.

Mais guias: todos os guias da Adelyons