Como o PawnCounter lê qualquer exportação de PDV de casa de penhores
Os dados de uma casa de penhores chegam como arquivo do LeadsOnline, tabela do Visual FoxPro, arquivo XML da Califórnia ou um CSV que ninguém viu antes. Veja como um único leitor processa todos eles.
O mais difícil na análise de casas de penhores não é a análise. É que cada loja entrega um arquivo diferente, e a maioria dos donos não consegue dizer qual é. Por isso, a primeira regra que definimos para o leitor do PawnCounter, foi que ele nunca deve perguntar à loja o que é o arquivo. Ele descobre isso pelos bytes.
Como reconhecer o formato
A detecção é feita nos primeiros 64 KB do arquivo, antes que qualquer coisa seja analisada por completo. Algumas verificações resolvem a maioria dos casos:
- Um cabeçalho DBF indica uma tabela do Visual FoxPro, que é como WinPawn armazena seus dados. O nome da tabela ou, na falta dele, os nomes das colunas indicam qual tabela é: bilhetes de penhor, mercadorias, histórico, pagamentos parcelados.
- Uma raiz XML identifica a CAPSS, o formato de relatório da Califórnia, além do serviço web de bilhetes do LeadsOnline.
- Um CSV cujo cabeçalho traz apenas os nomes das colunas LeadsOnline usa (tipo de bilhete, número do bilhete, campos do nome do cliente, marca do item) é uma exportação do LeadsOnline, independentemente do PDV que a gerou.
- Um arquivo de texto delimitado por pipe com Pawn Trackertem o layout do Pawn Tracker.
- Um livro de armas de fogo, um CSV de aquisição e alienação, tem assinatura e leitor próprios.
Cada uma dessas regras é uma assinatura que verificamos com uma amostra real daquele sistema, então a detecção é determinística e cada ramo tem um teste. Quando nenhuma corresponde, o arquivo vai para o leitor genérico.
O CSV que ninguém viu antes
Pawn Wizard, PawnSnap e uma dúzia de sistemas menores exportam CSV, e nenhum deles usa os mesmos nomes de coluna. Em vez de um adaptador por fornecedor, o leitor genérico associa as colunas pelo significado: uma longa lista de aliases, comparada sem diferenciar maiúsculas de minúsculas e ignorando espaços, sublinhados e hífens, decide qual coluna é o custo, qual o preço pedido, qual a data de entrada e qual a descrição. Um arquivo que descreve itens e custos é um inventário; um que descreve penhores é um registro de transações; alguns são os dois, e nesse caso ambos são gerados. Colunas que ele não consegue posicionar são ignoradas em vez de interromper o processo, e tudo o que precisou adivinhar volta como um aviso que a loja pode ver. Não precisa ter visto o sistema antes, e é por isso que o guia “qualquer outro POS” é um caminho real e não uma recusa educada.
Um modelo de item
Seja qual for a origem, cada registro é normalizado na mesma forma: um item com categoria, descrição, custo, preço pedido, datas de entrada e saída, e o empréstimo ou venda a que pertence. Regras preenchem o que um formato deixa implícito, e uma etapa de recuperação une tabelas que descrevem o mesmo item de formas diferentes. O WinPawn é o motivo de existir essa etapa: a tabela de histórico, a única que traz um preço de venda realizado, registra uma categoria e não uma descrição, então cada item vendido chegaria como “Armas de fogo” ou “Ferramentas”, enquanto o mesmo número de item na tabela de mercadorias diz “Espingarda Remington 870”. Juntar pelo número do item devolve à venda a sua descrição e, com ela, a possibilidade de comparar coisas comparáveis. As análises só enxergam esse modelo, então uma correção na lógica de depreciação vale igualmente para uma loja WinPawn e para uma loja LeadsOnline.
O que ele não consegue ler, dito com clareza
O Bravo, que não tem exportação em massa, é lido a partir dos relatórios que a loja salva das telas Report Preview ou Ad Hoc como CSV ou Excel, usando os cabeçalhos de coluna próprios do Bravo (adicionado em setembro de 2026). O PawnMaster, até hoje, não oferece à loja uma exportação com a qual possamos trabalhar. Em vez de fingir, o guia PawnMaster diz isso, explica o que exportar antes de qualquer migração para o Bravo e guarda esses arquivos para o dia em que existir um leitor.
O resultado é o que o produto promete em sua página aqui: mantenha o POS que você tem, envie o arquivo que ele já gera e receba de volta o Profit X-Ray .