Software & automação · estudo de caso
Confere Aí
Do leitor de código de barras ao estoque do Bling: conferir a nota, corrigir o cadastro, calcular o custo real e atualizar preços com confirmação.
Visão geral
O projeto em poucas palavras
O Confere Aí acompanha o recebimento de mercadorias de ponta a ponta no Windows. A pessoa importa a nota do fornecedor, bipa cada peça com o leitor de código de barras, corrige o cadastro, calcula o custo real e o preço de venda e só então dá entrada no estoque do Bling ERP. Nada vai para o Bling sem um resumo do antes e do depois.
Ele nasceu da rotina da Motokão Moto Center, uma loja de peças de moto que recebe caixas de vários fornecedores toda semana. Na mesma rotina de compras, ele complementa o Pede Aí: o Pede Aí cuida de pedir a reposição, e o Confere Aí cuida do que chega.

Desafio
O ponto de partida
Conferir uma caixa de peças contra a nota fiscal, item por item, é trabalho de atenção e de repetição. Sobras e faltas passam despercebidas, o cadastro do ERP tem códigos de barras e localizações errados ou vazios, a entrada no estoque é digitada de novo e, em alguns fornecedores, o valor da nota é menor do que o realmente pago, o que distorce o custo e, por consequência, o preço de venda.
O operador passa o dia com um leitor na mão. Por isso o fluxo principal funciona inteiro pelo teclado, e a correção vem antes da velocidade: nenhum item pode ser perdido, contado em dobro ou ficar com preço errado.
Solução
Um fluxo em seis passos
1. Importar
A nota entra pelo XML da NF-e ou por planilha (CSV ou XLSX), e a base de produtos vem de uma planilha exportada do Bling ou da sincronização pela API. O app cruza cada item por código do fornecedor, SKU ou EAN, antes de qualquer conferência, e mostra uma prévia com o que casou e o que não casou.
2. Conferir
Cada leitura atualiza a tabela na hora, com som de confirmação e o status do item: OK, parcial, sobra ou pendente. O cartão da última leitura mostra a localização do produto em letras grandes, para guardar a peça no lugar certo. Dá para desfazer o último bipe, e códigos que não existem na nota vão para uma lista própria.
3. Tratar as exceções
Uma tela reúne sobras, itens parciais, pendentes, produtos sem SKU e códigos não encontrados, com exportação para Excel ou CSV para conversar com o fornecedor.

4. Corrigir o cadastro
Quando o EAN ou a localização de um produto está errado no Bling, a correção é feita ali mesmo, item a item ou em lote, e enviada ao ERP depois de uma revisão.
5. Calcular custo e preço
O app rateia frete e imposto, ajusta a diferença entre o valor da nota e o valor pago, aplica a margem e o arredondamento escolhidos e compara com o preço atual. Itens com margem abaixo do mínimo ou impacto alto ficam sinalizados. A simulação não grava nada, nem no banco local nem no Bling, até haver confirmação, e cada envio fica no histórico de preços.

6. Dar entrada no estoque
Antes de lançar, o app verifica o status da conferência, pede o depósito de destino e avisa sobre itens parciais, sobras e entradas duplicadas. Cada sessão pode virar um relatório com a auditoria de tudo o que foi lido, editado e enviado.
Processo
Decisões de engenharia
Núcleo em Rust, interface em React. O Tauri entrega um instalador pequeno e um app que abre rápido. As regras de negócio ficam em camadas de Rust separadas (domínio, importação, banco, ERP e aplicação), e testes de arquitetura impedem que uma camada dependa de outra fora do combinado.
Dinheiro sem surpresa. Valores usam aritmética decimal com arredondamento comercial de duas casas, nunca ponto flutuante, e o custo original da nota é preservado ao lado do custo corrigido.
Nada vai ao ERP sem confirmação. As escritas passam por um plano com resumo do antes e do depois, rodam em segundo plano, aceitam reenvio só das falhas e deixam resultado exportável.
Dados locais e recuperáveis. O trabalho fica em SQLite, com backup e restauração, e o app retoma a conferência de onde parou depois de um fechamento inesperado.
Integração testável sem tocar em conta real. A autorização com o Bling usa OAuth 2.0, e um servidor falso do Bling simula respostas, limites e falhas para testar o envio.
Do documento ao código. O produto partiu de uma especificação escrita, dividida em tickets com critérios de aceite, e cada regra foi escrita primeiro como teste.
Resultados
Estado atual
O repositório reúne cerca de 42 mil linhas de Rust, incluindo testes, e 12 mil de TypeScript na interface, com 358 testes de interface e cobertura acima de 90% no núcleo. O plano tem 122 tickets, e a maior parte do código está pronta.
O aplicativo ainda não passou por homologação com uma conta real do Bling nem por um piloto na operação. As escritas foram testadas contra o servidor falso, e as telas desta página usam dados de demonstração. Os testes mostram o comportamento automatizado, não a aprovação para uso em produção.
Aprendizados
O que guiou as decisões
Toda ação que mexe num sistema de terceiros precisa de um passo de revisão: simular primeiro, mostrar o antes e o depois, confirmar depois. É isso que permite automatizar o recebimento sem tirar do usuário a decisão final.


