Lapidio Cases HS Varejos
Case completo · Mini market em franquia

HS Varejos

ERP financeiro com conciliação bancária automática para operação de mini market em franquia. Quatro fontes de dados bancários, zero consolidação manual.

4
Fontes bancárias
1.000+
Vendas/mês
100%
Conciliação automática
3
Perfis de acesso
0
Planilhas manuais
ERP financeiro Conciliação bancária Next.js + TypeScript Supabase Parser PDF Santander
O contexto

O sistema construído para uso próprio.

O HS Varejos é uma operação de mini market em modelo de franquia da rede H&V. O desenvolvedor do sistema é também o responsável pela operação, o que colocou o projeto em uma posição única: o cliente e o construtor são a mesma pessoa.

Em uma operação de mini market em franquia, os dados financeiros chegam de múltiplas fontes que não conversam entre si. O extrato do banco principal vem em PDF e XLS. A conta Stone gera arquivos OFX. Os terminais PDV exportam planilhas XLSX com mais de mil registros mensais. E o empréstimo de capital de giro via Stone Capital faz deduções automáticas diárias sobre a receita, tornando o fluxo de caixa real difícil de visualizar sem consolidação manual.

O resultado sem o sistema era esse: horas por mês de cruzamento manual de planilhas para entender se a operação estava saudável, calcular o saldo devedor do empréstimo e saber quanto poderia ser distribuído.

Segmento
Mini market em modelo de franquia
Rede
Franquia H&V
Bancos integrados
Santander PJ + Stone
Sistema
erp.hsvarejos.com.br
Situação especial
Desenvolvedor é também o operador do negócio
O problema

Quatro fontes. Nenhuma conversa com a outra.

Cada fonte de dado financeiro chegava em um formato diferente, exigindo consolidação manual para qualquer análise.

Santander PJ
PDF + XLS
Extratos mensais disponíveis em PDF e Excel. O PDF exigia parsing manual ou ferramentas externas. Nenhuma integração automática disponível.
Stone
OFX
Conta Stone com limite rotativo de R$ 780, custo de 0,39%/dia, antecipação automática de recebíveis e empréstimo Stone Capital com deduções diárias de 12% da receita.
Terminal PDV
XLSX
Planilhas de vendas geradas pelos terminais PDV com mais de 1.000 registros mensais. Análise por método de pagamento exigia cruzamento manual.
Stone Capital
Deduções
Empréstimo de capital de giro com 48 parcelas de R$ 927,14 e deduções automáticas diárias. Rastrear o saldo devedor real exigia cálculo manual a cada dia.
Diferencial técnico
Parser de extrato Santander em PDF, em TypeScript puro.
O principal obstáculo técnico deste projeto foi a leitura automática dos extratos Santander em PDF. A maioria das soluções de mercado para esse problema usa Python com bibliotecas específicas, ou depende de OCR em imagens. O parser desenvolvido aqui usa pdf-parse em TypeScript puro, rodando server-side no Next.js sem nenhuma dependência externa. O resultado: 33 lançamentos de dezembro de 2025 extraídos e validados na primeira execução. Esse componente é um diferencial técnico real em qualquer sistema para pequeno varejo que opera com Santander.
O que foi construído

Módulos entregues e ativos.

Importação Santander PDF
Parser validado com extração de 33 lançamentos de dez/2025 na primeira execução. TypeScript puro, sem dependências externas.
Importação Santander XLS
Leitura e normalização dos extratos em Excel do Santander PJ, com mapeamento de colunas e tratamento de valores.
Importação Stone OFX
Parser de arquivos OFX da conta Stone com leitura de lançamentos, taxas e deduções automáticas de empréstimo.
Importação Terminal PDV
Leitura de XLSX com bulk upsert em lotes de 200 vendas e 500 itens para evitar timeout no Vercel com volumes acima de 1.000 registros.
Dashboard financeiro
Indicadores em tempo real: saldo consolidado, receita do período, deduções Stone Capital, saldo devedor do empréstimo e distribuição por método de pagamento.
Conciliação bancária
Conciliação automática entre lançamentos bancários e vendas PDV. Janeiro de 2026 conciliado. Status de cada lançamento visível no painel.
DRE mensal
Demonstrativo de Resultado do Exercício consolidado por mês, gerado automaticamente a partir dos dados importados.
Rastreamento Stone Capital
Acompanhamento da parcela vigente, saldo devedor atual e histórico de deduções diárias do empréstimo de 48 parcelas de R$ 927,14.
Gestão de usuários
Três perfis de acesso: Admin, Contábil e Operador. Cada perfil com permissões específicas sobre o que pode visualizar e editar.
Importação retroativa
Em andamento: importação dos dados de 2023, 2024 e 2025 para histórico completo. Estratégia ano a ano para evitar sobreposição.
Arquitetura de dados

Cinco views que entregam os relatórios.

Em vez de relatórios gerados na aplicação, os dados são consolidados diretamente no banco via views SQL, eliminando processamento desnecessário no servidor.

vw_conciliacao_status
Status de conciliação por lançamento bancário: conciliado, pendente ou divergente.
vw_dre_mensal
DRE consolidado por mês com receitas, despesas e resultado operacional calculados automaticamente.
vw_fluxo_caixa
Fluxo de caixa operacional com entradas e saídas por período, considerando as deduções automáticas Stone.
vw_pagamentos_pessoais
Distribuição de lucros e retiradas pessoais separadas do fluxo operacional da empresa.
vw_vendas_por_metodo
Breakdown de vendas por forma de pagamento com taxa por método: débito 1,10%, crédito 2,10%, PIX 0,50%.
Stack técnico
Next.js 16 App Router, Supabase PostgreSQL com RLS, Vercel com maxDuration 60s nas rotas de upload, DM Sans e DM Mono.
O que este projeto prova
Quando o desenvolvedor é também o usuário do sistema, o produto final reflete problemas reais resolvidos de forma real. Nenhum requisito foi inventado em reunião. Cada funcionalidade nasceu de uma hora perdida tentando fechar o caixa em planilha.
Resultados

O que o sistema entrega hoje.

Automação
100%
Conciliação automática
Janeiro de 2026 conciliado sem nenhuma entrada manual. O sistema faz o cruzamento entre extrato bancário e vendas PDV automaticamente.
Volume processado
1.000+
Registros de venda por mês
Importação via XLSX com bulk upsert otimizado em lotes. Sem timeout, sem perda de dados, sem necessidade de dividir arquivos manualmente.
Fontes integradas
4
Origens de dados diferentes
Santander PDF, Santander XLS, Stone OFX e PDV XLSX lidos e consolidados em um único painel, sem cruzamento manual.
Potencial de replicação

Um produto para um mercado de 50.000 lojas.

O sistema nasceu para resolver um problema específico. Mas o problema é de praticamente todo mini mercado que opera com Stone e Santander no Brasil.

50k+
Mini mercados independentes no Brasil
Praticamente todos enfrentam o mesmo problema: dados financeiros fragmentados em fontes incompatíveis que exigem consolidação manual todo mês. O parser Santander PDF é um diferencial técnico que nenhum ERP de pequeno varejo entrega hoje.
SaaS
Arquitetura multi-tenant pronta
O sistema foi construído sobre Supabase com Row Level Security, o que permite isolamento completo de dados por empresa sem alteração na infraestrutura. Cada nova unidade pode ser integrada com custo marginal baixo.
O que este case demonstra

Serviços disponíveis para o seu negócio.

Sua operação tem dados espalhados em fontes diferentes?

Conta de onde vêm os dados financeiros do seu negócio e quanto tempo você perde consolidando tudo. A gente avalia o que é possível automatizar.