Comece por aqui

Início · Proprietário · Gerente · Gestão financeira

Migrar de outro sistema

Como funciona a migração assistida, quais sistemas a OctaGym importa, exatamente quais dados atravessam, o que não vem junto e como é a virada da cobrança.

Onde fica: Início → Primeiros Passos → Migração

Migrar não é subir planilha. Quem já opera tem contratos com vigência correndo, cartões cadastrados, histórico de pagamento e uma data de cobrança para cada aluno — nada disso cabe num CSV. Por isso a migração é assistida: você entrega o acesso ao sistema atual e a equipe da OctaGym espelha a base.

Não cadastre a base à mão antes de falar com a gente

Cadastro manual feito em paralelo com a migração vira duplicidade, e desduplicar depois é o retrabalho mais caro da implantação. Se você já cadastrou alguns alunos, tudo bem — avise, porque a carga reconhece quem já existe e não duplica.

Como funciona, do começo ao fim

  1. Você informa qual sistema usa hoje e envia o acesso por um formulário seguro.
  2. A OctaGym extrai a base do sistema de origem. É a etapa mais demorada e depende da velocidade que o sistema antigo permite.
  3. Revisão do catálogo. Os planos importados chegam para você conferir nome, duração e, principalmente, preço. A carga não roda com plano sem preço.
  4. Piloto. Um lote pequeno entra primeiro, para você conferir na tela antes da base inteira.
  5. Carga completa — alunos, matrículas, histórico, fotos e contatos.
  6. Virada da cobrança (cutover). O momento em que a OctaGym passa a ser quem cobra. É a etapa mais delicada e tem tela própria.

Enquanto o passo 6 não acontece, o sistema antigo continua sendo a fonte da verdade e a base pode ser reatualizada quantas vezes for preciso: quem entrou, renovou, trancou ou cancelou no meio do caminho é reconciliado.

Sistemas de origem suportados

SistemaO que precisamos de você
EVO (W12 / ABC Fitness)Identificador da academia no EVO, usuário e senha com permissão de relatório
Pacto SoluçõesChave de integração (token) e código da empresa (empresaId) — a Pacto não usa usuário e senha na integração
Angular (angulare.app)Identificador do estúdio, e-mail de acesso e senha
VindiChave de API da conta
AsaasChave de API da conta
Outro sistemaEndereço de acesso, credencial e o que mais for preciso para entrar — se houver exportação em planilha, conte isso nas observações

Vindi e Asaas não são sistemas de academia: são contas de cobrança. Elas aparecem na lista porque a carteira de cartões costuma estar lá, e é ela que permite a virada sem pedir o cartão de novo a cada aluno. Uma mesma implantação pode ter vários acessos ao mesmo tempo — o ERP, o gateway de pagamento e uma planilha própria não se substituem, cada um entra como uma linha separada.

Enviar o acesso ao sistema atual

Na tela de Migração você escolhe o sistema e clica para abrir o formulário. O formulário muda conforme o sistema — a Pacto não pede senha nenhuma, e o EVO pede o identificador da academia além do login.

Quem tem a senha não precisa ter login no OctaGym

O formulário funciona por um link próprio, sem login. Se quem guarda o acesso é o contador ou o suporte do fornecedor anterior, mande o link para essa pessoa. O link vence em 14 dias e não é recuperável: pedir o link de novo significa emitir outro, e emitir outro invalida o anterior — é de propósito, para o caso de a URL ter ido parar no grupo errado.

O que você digita é criptografado e usado apenas para importar a base. Cada vez que alguém da OctaGym abre o acesso fica registrado, e o acesso é expurgado quando a migração termina.

Quais dados são importados

Esta é a lista do que a migração faz hoje, por sistema de origem.

DadoEVOPactoAngular
Cadastro do aluno (nome, CPF, nascimento, sexo, e-mail, telefone, endereço)
Foto do aluno
Catálogo de planos
Matrículas vigentes, com plano e vigência
Alunos trancados / congelados
Saldo de créditos de aula (pacotes)
Histórico de pagamentos na ficha do aluno
Vínculos já encerrados (base de churn e LTV)
Visitantes e contatos → funil comercial
Notas fiscais já emitidas
Documento do contrato assinado
Histórico de passagem na catraca

Um traço não quer dizer “impossível”

Quer dizer "ainda não construído para aquele sistema". A CLI da Pacto lê nota fiscal, contrato e catraca porque uma academia pediu; no EVO isso nunca foi pedido. Se algum desses itens é essencial para você, diga na conversa de implantação em vez de assumir que está incluído.

O que cada bloco significa na prática

  • Cadastro. Quando o sistema de origem não devolve um campo obrigatório (endereço e sexo são os que mais faltam), ele fica em branco para revisão — a migração não inventa dado. Onde a origem só devolve o CEP, o endereço é completado pelo CEP.
  • Planos. Entram despublicados e aguardando sua revisão: eles não aparecem no Portal nem na venda até você conferir e publicar. Plano que o sistema antigo já não vendia entra marcado como inativo, preservando o histórico sem poluir a venda nova.
  • Preço do plano. É o ponto que mais exige você. Em boa parte das academias o preço não vive no cadastro do plano do sistema antigo — vive no que foi efetivamente cobrado, aluno a aluno, com desconto negociado. Quando isso acontece, o preço é derivado do histórico de pagamento e volta para você aprovar, com a faixa de valores e a data do último pagamento à vista.
  • Matrículas. A vigência vem da origem. Um aluno com contrato começando em 2022 entra com essa data, não com a data da carga.
  • Histórico de pagamentos. Aparece na aba financeira da ficha do aluno e entra no financeiro com a data de competência original — anos de faturamento não são jogados no mês da migração.
  • Contatos e visitantes. Viram oportunidades no funil comercial. Contato antigo pode entrar arquivado, por uma data de corte que você escolhe: milhares de visitantes de anos atrás no funil ativo tornam o funil inútil no primeiro dia.
  • Fotos. Só fotos reais. Imagem-padrão do sistema antigo (aquele avatar genérico) não é importada como foto do aluno. Foto que já existe no OctaGym nunca é sobrescrita.

O que não é importado

  • Funcionários e permissões. A equipe entra por convite, na tela de Equipe. Espelhar colaboradores criaria uma conta de login para cada pessoa, inclusive para quem não vai usar o sistema. → Convidar funcionário
  • Fichas de treino e prescrições.
  • Vendas do balcão como venda. O histórico de compra chega pelo financeiro; recriar as vendas geraria comissão para funcionários que não venderam nada aqui.
  • Contas a pagar e a receber em aberto. Títulos em aberto são tratados à parte, com o financeiro, e não entram junto com a base de alunos.
  • Produtos e estoque da loja. Entram pelo importador da própria Loja, por planilha ou XML de nota. → Cadastrar produtos
  • Agenda futura de aulas e reservas.
  • Assinatura digital do contrato antigo. O documento é arquivado como anexo histórico do aluno; a assinatura feita no sistema anterior não vira evidência de assinatura da OctaGym.

O que protege a sua operação durante a carga

Essas garantias não são detalhe técnico — são o que impede a migração de virar um incidente com os seus alunos.

  • Nenhum aluno recebe mensagem. As automações da Empresa são conferidas no instante da escrita e a carga é abortada se alguma estiver ativa. O e-mail de boas-vindas é suprimido especificamente, e todo perfil importado entra sem consentimento para disparo. Você liga a comunicação depois, quando quiser.
  • Rodar de novo não duplica. Aluno é reconhecido por CPF, depois e-mail, e a matrícula carrega o identificador do contrato de origem. Uma carga interrompida no meio é retomada, não refeita.
  • Datas de origem são preservadas. Sem isso, a base inteira apareceria no painel como "vendas de hoje" e o relatório comercial mostraria um dia recorde que nunca existiu.
  • Nada de status chutado. Um código de situação desconhecido no sistema antigo trava a carga para análise em vez de virar um valor padrão silencioso.
  • O status do aluno é derivado do contrato, não escrito pela migração. → Ficha do aluno
  • Piloto antes da base inteira, e toda etapa que escreve tem simulação antes.

A virada da cobrança

Migrar a base e passar a cobrar são coisas diferentes, e a segunda é a que dá errado quando é feita no susto.

Se a sua carteira de cartões já está na Vindi (o caso mais comum de quem vem de EVO ou Pacto), o cartão do aluno continua onde está e a virada muda apenas quem dá a ordem de cobrar. São três etapas, cada uma com simulação antes de aplicar: vincular aluno ↔ cliente da carteira, importar a agenda e o valor das cobranças, e ligar. A seção aparece dentro do painel da Vindi, em Configurações → Adquirentes. → Formas de cobrança

O sistema antigo tem que ser desligado antes de ligar o nosso

Enquanto os dois estiverem ativos sobre a mesma conta de cobrança, os dois cobram — e a cobrança do sistema antigo é invisível para as travas do OctaGym. A última etapa exige que você confirme explicitamente que a cobrança do legado foi desligada. Confirme só depois de ter desligado de fato.

Três coisas que surpreendem nesta etapa:

  • O dia da cobrança não sai do contrato importado. O contrato traz a data original; renovação, troca de plano e remanejamento moveram o dia real ao longo dos anos. A agenda é lida da última fatura efetivamente paga de cada aluno — projetar pela data do contrato cobraria a maior parte da base no dia errado.
  • O valor também não. Desconto negociado aluno a aluno é a regra, não a exceção. Adotar o valor realmente praticado costuma reduzir o MRR exibido no painel logo depois da virada. Não é perda de receita: é o número anterior, inflado pelo preço de tabela do catálogo importado, se corrigindo. Avise quem acompanha indicadores antes.
  • Aluno ativo não é aluno cobrável. Parte da base marcada como ativa no sistema antigo está inadimplente há meses ou simplesmente abandonou. Esse grupo é triado e fica fora da virada, em vez de virar uma leva de cobranças recusadas no primeiro ciclo.

Quanto tempo leva

Depende do tamanho da base e, principalmente, do sistema de origem — todos limitam a velocidade de leitura, e forçar só aumenta a taxa de erro. Uma base de alguns milhares de alunos leva horas só na extração das fichas, e é normal a extração rodar em mais de uma sessão.

O que costuma atrasar de verdade não é o volume: é o acesso. Credencial que chega errada, sem permissão de relatório ou com duplo fator ativo para uma extração longa. Resolver isso cedo é a maior economia de prazo da implantação.

Problemas comuns

  • "Mandei o acesso e a equipe diz que não funciona." No EVO, quase sempre é o endereço: algumas redes autenticam num endereço diferente do padrão, e a página de login do endereço errado abre normalmente e simplesmente nunca entra — o sintoma imita senha errada. Informe o endereço que você usa para entrar. No Angular, é o identificador do estúdio faltando.
  • "Meu EVO pede um código de verificação no login." Duplo fator não é automatizável. Avise a equipe: combinamos um horário para acessar junto com você, ou você usa uma conta de integração sem duplo fator.
  • "O link do formulário não abre." Link vencido e Link encerrado pedem um link novo. Link inválido costuma ser URL cortada na hora de colar — confira se veio inteira.
  • "Já enviei o acesso, mas mudei a senha." Abra o formulário de novo pela mesma tela e preencha: o envio novo substitui o anterior.
  • "Importou, mas os planos não aparecem para vender." Eles nascem despublicados de propósito. Revise preço e duração e publique. → Criar plano
  • "O painel mostra LTV e churn zerados." Esses números precisam de contratos encerrados, e nem toda origem entrega esse histórico. Veja a tabela acima.
  • "Faltou endereço e sexo em vários alunos." O sistema de origem não devolveu. Fica em branco para revisão, porque preencher por dedução seria pior.
  • "Os alunos foram avisados da mudança?" Pela migração, não — nenhuma mensagem sai. O aviso é uma decisão sua, e vale fazer antes da virada da cobrança. → Disparos e campanhas

Relacionado

On this page