Importação de Associados¶
O que você pode fazer aqui¶
- Importar sua base de associados a partir de um arquivo Excel ou CSV.
- Conferir e ajustar o mapeamento das colunas do seu arquivo para os campos do sistema.
- Ver uma prévia com validações (o que está correto e o que precisa ser corrigido).
- Acompanhar o processamento e ver um resumo do resultado.
Como a tela está organizada (etapas)¶
- Upload do arquivo
- Mapeamento de colunas
- Prévia dos dados
- Processando
- Resultado
No topo da tela, um indicador mostra em qual etapa você está.
Passo a passo¶
1) Prepare seu arquivo - Use um arquivo .xlsx, .xls ou .csv com até 5MB. - Garanta que você tem, pelo menos, estas colunas: - Nome - CPF (ou CNPJ, quando for empresa) - E-mail - Telefone (com DDD) - Endereço - Valor de cobrança mensal - Forma de cobrança: BOLETO, PIX_AUTOMATICO ou DEBITO_CONTA - Dica: se preferir, baixe o Template de Exemplo para seguir o padrão.
2) Faça o upload - Clique em "Escolher Arquivo". - Selecione seu arquivo no computador. - Ao concluir, você será levado para o Mapeamento de Colunas.
3) Faça o mapeamento de colunas - Para cada campo obrigatório (Nome, CPF, E-mail, etc.), escolha a coluna equivalente do seu arquivo. - Exemplo: "Nome" = Coluna A, "E-mail" = Coluna C. - Quando terminar, clique em "Prosseguir para Prévia". - Se quiser recomeçar do zero, clique em "Voltar" (isso cancela o upload atual).
4) Confira a prévia dos dados - Veja um resumo: quantos registros estão válidos, quantos têm erro, total e o valor mensal somado. - Abaixo, confira a lista com: - Status (válido ou com erro). - Nome, Documento, E-mail, Valor e Forma. - Erros encontrados por linha (ex.: "E-mail inválido", "Telefone obrigatório"). - Se precisar ajustar o mapeamento, clique em "Voltar". - Se estiver tudo certo, clique em "Confirmar Importação".
5) Acompanhe o processamento - Aguarde a barra de progresso chegar a 100%. - Não feche a página até terminar.
6) Veja o resultado - A tela mostra quantos associados foram importados e quantos ficaram com erro. - Use essas informações para validar sua importação. - Se houver registros com erro, ajuste seu arquivo e repita a importação quando desejar.
Campos e botões importantes¶
- Escolher Arquivo: abre o seletor para enviar seu Excel/CSV.
- Baixar Template: baixa um modelo de planilha para você preencher.
- Seletores de mapeamento (por campo):
- Nome
- CPF
- Telefone
- Endereço
- Valor Cobrança
- Forma Cobrança (BOLETO, PIX_AUTOMATICO, DEBITO_CONTA)
- Prosseguir para Prévia: avança após mapear as colunas.
- Confirmar Importação: inicia a importação dos registros válidos.
- Voltar:
- Na etapa de Mapeamento: retorna ao início e limpa o arquivo selecionado.
- Na etapa de Prévia: volta ao Mapeamento mantendo o arquivo.
- Indicadores de status:
- Ícone de check: registro válido.
- Ícone de alerta: registro com erro.
- Barra de progresso: mostra o andamento da importação.
Dicas e observações¶
- Formatos aceitos: .xlsx, .xls, .csv. Tamanho máximo: 5MB.
- Campos obrigatórios: todos os listados no mapeamento precisam ser preenchidos.
- Documento:
- Para pessoas físicas: CPF.
- Para empresas: CNPJ (o sistema exibe "Documento" na prévia).
- Valor de cobrança: precisa ser maior que zero.
- E-mail: precisa estar no formato válido (ex.: nome@dominio.com).
- Telefone: inclua DDD.
- Forma de cobrança: use exatamente BOLETO, PIX_AUTOMATICO ou DEBITO_CONTA.
- Apenas os registros válidos são importados; os com erro ficam de fora.
- Se muitos registros aparecerem com erro, baixe o template e reorganize sua planilha para facilitar.
- Durante o processamento, evite fechar a página.
Exemplo prático¶
- Você tem uma planilha com 3 registros: João, Maria e Empresa ABC.
- Na prévia:
- João e Empresa ABC aparecem como válidos.
- Maria aparece com erros: e-mail inválido, telefone ausente, valor zero, forma de cobrança incorreta.
- Ao confirmar, 2 registros são importados. 1 fica com erro para você corrigir depois.
FAQ¶
1) Preciso usar o template? - Não é obrigatório, mas ajuda a evitar erros de formato e mapeamento.
2) O que acontece com registros com erro? - Eles não são importados. Corrija sua planilha (ex.: formato do e-mail, forma de cobrança) e tente novamente.
3) Posso recomeçar a importação? - Sim. Na etapa de Mapeamento, o botão "Voltar" limpa o arquivo e reinicia o processo. Na Prévia, "Voltar" apenas retorna ao mapeamento.
4) Quais formatos e tamanho de arquivo são aceitos? - .xlsx, .xls e .csv, com até 5MB.
5) Como devo preencher a forma de cobrança? - Use exatamente: BOLETO, PIX_AUTOMATICO ou DEBITO_CONTA. Qualquer outra variação (ex.: "PIX") causará erro.