← Portfólio

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.

TipoProduto próprio
PapelPlanejamento, arquitetura e desenvolvimento
PeríodoOut/2026 · em desenvolvimento
EstadoEm desenvolvimento
TecnologiasTauri 2 · Rust · React · TypeScript · SQLite · Tailwind CSS · API Bling v3 · OAuth 2.0 · Vitest · Playwright

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.

Tela de conferência do Confere Aí em tema escuro: campo de leitura, cartão da última leitura com a localização em destaque, indicadores e tabela de itens com status
Tela de conferência no tema escuro, com dados de demonstração.Ampliar imagem ↗

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.

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.

Tela de exceções com contagem de sobras, parciais e pendentes e a lista dos itens que ainda divergem da nota
Tudo o que ainda diverge da nota, em uma só lista.Ampliar imagem ↗

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.

Tela de precificação com resumo de custos e frete e tabela com custo real, preço atual, preço sugerido e novo preço de cada item
Revisão de preços antes do envio ao Bling, com dados de demonstração.Ampliar imagem ↗

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.

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.

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.

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.

Uma ideia em movimento?

Vamos transformar a próxima pergunta em algo que funciona.

Conversar sobre um projeto ↗