A meta comercial das cinco unidades saiu da planilha e passou a vir direto da NextFit
A Fitness Academia tem mais de duas décadas de estrada e cinco unidades entre Chapecó e Cunha Porã. Os dados de venda já viviam na NextFit, mas a meta comercial era refeita à mão numa planilha paralela — com critério diferente em cada unidade. A Epicora construiu a plataforma que lê a NextFit a cada cinco minutos e transforma isso em uma leitura só: a da rede, a da unidade e a contribuição de cada consultora.
- Cliente
- Fitness Academia (Chapecó e Cunha Porã/SC)
- Setor
- Esporte & Fitness · Rede de academias
- O que fizemos
- Plataforma de metas comerciais integrada ao ERP NextFit — dashboard da rede, dashboard por unidade e vendas sincronizadas
- Plataforma
- Web responsivo (React · NestJS · MongoDB · AWS + Vercel)
O ponto de partida
A Fitness Academia é uma rede de academias com mais de duas décadas de atuação e cinco unidades entre Chapecó e Cunha Porã. A operação comercial — prospecção, matrícula e renovação — é conduzida por consultoras de venda, e a rede já usava a NextFit como ERP: toda venda, todo plano, todo cancelamento já estava registrado lá.
O problema não era falta de dado. Era que o dado não chegava a quem precisava dele. A meta comercial era acompanhada numa planilha paralela, preenchida à mão a partir da própria NextFit — o mesmo número, digitado duas vezes. O que uma unidade considerava "venda que conta na meta" não era o que a outra considerava, então os números não eram comparáveis. A consultora, que é quem mais precisa saber quanto falta para bater, não tinha tela nenhuma: dependia de perguntar ao gestor ou de abrir uma planilha compartilhada que, de quebra, expunha o desempenho de todas as colegas.
- Meta refeita à mão em planilha, a partir de um dado que já existia na NextFit — retrabalho puro, com erro de digitação e número sempre defasado.
- Critério diferente por unidade: o que contava na meta variava, e os números não fechavam entre si.
- Consultora sem autonomia: para saber quanto falta, dependia do gestor ou da planilha dele.
- Planilha compartilhada não isola ninguém — o desempenho de todas ficava à vista de todas.
- Sem visão de rede: o gestor comparava cinco planilhas em vez de olhar um número.
A virada
A Epicora não construiu um segundo lugar para digitar venda. A decisão de arquitetura foi a oposta: a NextFit continua sendo a única fonte de verdade e a plataforma nunca aceita lançamento manual. Um job lê a API de cada unidade a cada cinco minutos, espelha as vendas no banco da aplicação, e é sobre esse espelho que toda tela trabalha — nenhuma tela consulta o ERP ao vivo. Isso deu duas coisas ao mesmo tempo: leitura instantânea para o usuário e uma integração que não sobrecarrega o ERP do cliente.
Antes de escrever a integração, a Epicora fez um spike técnico contra a API real para descobrir o que a documentação não dizia: o limite de requisições que a NextFit tolera de fato e como cada tipo de venda chega no payload. Foi esse spike que definiu a frequência de sincronização e a regra de classificação — e é por isso que a integração não quebrou quando entrou nas cinco unidades.
A segunda decisão estrutural veio de uma revisão de escopo com o cliente: a meta passou a ser da unidade, não da consultora. Cada unidade tem uma meta mensal, e cada consultora vê a sua contribuição para o número coletivo — não uma cobrança individual. Isso mudou o produto inteiro, e a rede passou a ter um número que significa a mesma coisa nas cinco unidades.
A decisão que destravou
Definir que apenas venda de Plano conta na meta — e que o resto nem aparece. Gympass, TotalPass, convênio, produto avulso e aula avulsa continuam sendo importados para histórico, mas não somam e não poluem tela nenhuma. Foi o fim da divergência: toda venda que aparece na plataforma é, por definição, uma venda que conta. Não existe mais "depende de como você conta".
O que entregamos
O dashboard da rede — cinco unidades em uma tela
Meta da rede, realizado, percentual de atingimento e quantas unidades bateram a meta no mês, com a lista ordenada por atingimento — pior primeiro, porque o gestor não precisa da confirmação de quem vai bem, precisa saber onde entrar. Ao lado, a curva de evolução do mês contra a linha da meta, para ver se o ritmo do dia 10 sustenta o fechamento do dia 31.
O dashboard da unidade — a tela que a consultora não tinha
Anel de progresso da meta da unidade, quanto falta, dias restantes e um bloco "sua contribuição" com o que aquela consultora somou ao total. A consultora enxerga o conjunto da própria unidade — meta, realizado e a contribuição das colegas — e nunca enxerga outra unidade.
Vendas sincronizadas, com correção na mão do gestor
Todas as vendas de Plano vindas da NextFit, com busca, filtro por período, unidade e consultora, detalhe da venda e exportação em CSV e PDF. Venda cancelada no ERP aparece marcada como cancelada, sozinha. E, porque a vida real acontece, o Administrador tem um toggle por venda para forçar se ela conta ou não na meta — o caso do aluno transferido entre unidades ou do lançamento na unidade errada.
Metas, unidades e um log de sincronização que se pode auditar
Cadastro de meta por unidade e mês, com bloqueio estrutural contra duas metas no mesmo período. Cada unidade tem a própria chave de API, com teste de conexão e sincronização manual sob demanda. E cada execução do job fica registrada com duração e resultado — quantos registros lidos, novos e atualizados — de forma que "por que esse número mudou?" é uma pergunta com resposta.
Como garantimos
Isolamento entre unidades, não só entre telas
Dois perfis — Administrador e Colaborador — e o isolamento do Colaborador vale em toda parte: nem por URL manipulada, nem por filtro, nem por exportação um Colaborador alcança dado de outra unidade. O escopo é aplicado no backend, não escondido no frontend. Autenticação com JWT e refresh token, convite por e-mail e política de senha forte validada nas duas pontas.
Uma integração que respeita o ERP do cliente
A chave de API de cada unidade é armazenada criptografada. A sincronização é incremental e paginada, com backoff e throttle adaptativos ao limite real da NextFit — descoberto no spike, não presumido. Como todas as telas leem o banco local, um pico de uso da plataforma não vira pico de requisição no ERP. E o log mostra a rede inteira sincronizada na mesma janela de cinco minutos: cinco de cinco unidades.
QA independente com autoridade para reprovar
A entrega passou por QA próprio da Epicora, conduzido por quem não escreveu o código — e que reprovou três vezes antes de aprovar. A terceira leva pegou o tipo de bug que só aparece em uso real: o filtro por período montava a janela do dia em UTC e, como a operação roda em horário de Brasília, venda do fim da noite caía no dia seguinte. Corrigido no fuso local. Só depois disso o sistema foi apresentado ao cliente.
O resultado
No primeiro mês inteiro com a plataforma no ar, a rede fechou em 104% da meta, com quatro das cinco unidades batendo o número. A plataforma não vende pela equipe — quem vendeu foram as consultoras. O que mudou é que, pela primeira vez, esse percentual saiu do sistema e não de uma planilha: veio de vendas lidas direto da NextFit, sob um critério único, com cada sincronização registrada e auditável.
E a adoção aparece no próprio banco: o cliente cadastrou sozinho os quinze acessos da operação nas semanas seguintes à entrega, e já tem meta lançada até dezembro — planejamento de semestre feito dentro da ferramenta, não numa aba nova de planilha.
Soluções relacionadas
Cases relacionados
O dado que você precisa já está no seu sistema — só não está legível?
A Epicora conecta o que sua operação já usa e transforma isso na leitura que a decisão exige: um número só, atualizado sozinho, igual para todo mundo.