Radar por CSV: o guia completo pra conectar qualquer ERP por planilha

Sua academia usa Pacto, Tecnofit, Next Fit, outro sistema — ou controla tudo em planilha? O Radar aceita a sua operação por CSV: você exporta dois arquivos do seu sistema, sobe no painel e a plataforma deriva ativos, mix de agregador, ticket, churn, ocupação e retenção sozinha. Este guia mostra o que coletar, o formato exato, os modelos pra baixar e de quanto em quanto tempo atualizar.

Os dois arquivos

• Cadastro/contratos (obrigatório). Uma linha por aluno, com as datas de contrato. É dele que saem os ativos, o mix direto×agregador, o ticket e o churn.
• Check-ins (opcional, recomendado). Uma linha por acesso à academia. É dele que saem o mapa de horários, a frequência semanal e as coortes de retenção. Sem ele, o painel funciona — mas sem a parte de ocupação.

Que colunas coletar

No arquivo de cadastro:

• nome — nome do aluno (usado só durante o processamento).
• cpf — identificador que cruza o cadastro com os check-ins. Pode vir com ou sem pontuação.
• inicio contrato — data de início do contrato/matrícula vigente.
• data cancelamento — data da rescisão. Vazio = aluno ativo. É esse par de datas que define quem conta como ativo hoje.
• mensalidade — valor mensal do plano (pode ficar vazio pra alunos de agregador).
• origem — de onde vem o aluno: Direto, Wellhub (Gympass) ou TotalPass. Qualquer outro texto conta como direto.
• celular — opcional; só é usado se você ativar a reativação de alunos inativos (recurso opt-in).

No arquivo de check-ins: só duas colunas — cpf e check-in (data e hora do acesso). A hora importa: é ela que monta o mapa de ocupação por horário.

Formato aceito

• Arquivo .csv de até 15 MB, com a primeira linha de cabeçalho.
• Separador ponto-e-vírgula ou vírgula — detectado automaticamente. Exportou do Excel? Funciona direto.
• Codificação UTF-8 ou Latin-1 (a do Excel brasileiro) — também detectada automaticamente; acentos não quebram nada.
• Datas em dd/mm/aaaa ou aaaa-mm-dd, com hora opcional (ex. 15/07/2026 19:05).
• Valores como 149,90 ou 149.90 — os dois funcionam.

Baixe os modelos

Os dois arquivos abaixo já vêm com os cabeçalhos e o formato certos — preencha com o export do seu sistema (as linhas de exemplo são fictícias):

• Modelo de cadastro/contratos (.csv)
• Modelo de check-ins (.csv)

Não precisa renomear as colunas do seu ERP na mão: o assistente de importação detecta os cabeçalhos e sugere o de-para — você só confirma. O mapeamento fica salvo por sistema, então o segundo upload em diante é subir e pronto. Usando os nomes dos modelos, o reconhecimento é automático.

De quanto em quanto tempo atualizar

• Cadastro: mensal. O CSV é uma fotografia da operação — suba um export novo todo início de mês (quinzenal, se a operação é intensa). O painel mostra há quantos dias está o último upload.
• Check-ins: sempre com histórico. Exporte os últimos 4 a 6 meses a cada envio (mínimo de ~4 meses pra liberar as safras de entrada e o mapa completo). Pode repetir período já enviado: o Radar recalcula tudo a partir do arquivo mais recente, sem duplicar nada.

Há ainda uma trava de segurança: se um arquivo não tiver nenhum aluno ativo reconhecível (arquivo errado, coluna de data não mapeada), a importação é recusada antes de tocar nos seus dados — o painel nunca é sobrescrito com lixo.

LGPD: o arquivo não fica guardado

• Processa e descarta. O CSV é lido em memória, as métricas agregadas são calculadas e o arquivo bruto é descartado — as linhas por aluno nunca são gravadas nos nossos servidores.
• CPF só pra cruzar. O CPF vira um código embaralhado usado apenas pra casar cadastro com check-ins durante o processamento — e morre com ele. Nome de aluno não persiste.
• O que fica são números da unidade: totais, percentuais, medianas, mapas de horário. Nada identificável.
• Reativação é opt-in. Só se você ativar o recurso de reativação de inativos guardamos primeiro nome + celular, com identificador irreversível e opção de exclusão a qualquer momento. Detalhes na Política de Privacidade.

Onde importar

No Radar: Conectar dados → Importar CSV. O assistente mostra a prévia, o de-para das colunas e um relatório de qualidade (linhas lidas × ignoradas) a cada upload. Qualquer dúvida no export do seu sistema, fale com a gente em contato@eyeonfit.com — já temos o de-para pronto pros ERPs mais comuns.