KabixA importação CSV cobre o caso mais comum: você herdou uma planilha de campanha anterior, ou tem um cadastro consolidado no Excel/Google Sheets e quer migrar pro Kabix. O assistente faz isso em 4 etapas.
1. Prepare o CSV
O Kabix aceita CSV padrão (vírgula como separador, UTF-8). Pra exportar:
- Excel → Arquivo → Salvar como → escolha CSV UTF-8 (delimitado por vírgulas).
- Google Sheets → Arquivo → Fazer download → CSV (.csv, planilha atual).
- Numbers (Mac) → Arquivo → Exportar para → CSV.
O sistema detecta a maioria das codificações automaticamente, mas se aparecer caracteres estranhos (ã, ç, ó), confirme que salvou em UTF-8.
Limite por importação
5.000 linhas por arquivo. Bases maiores: divida em arquivos menores e rode múltiplas importações — o dedup detecta repetidos entre arquivos.
Colunas reconhecidas
Você não precisa colocar nas posições certas — o wizard mapeia. Os campos que ele entende:
- Nome (obrigatório)
- Telefone (recomendado — usado pra dedup)
- CPF
- Data de nascimento (qualquer formato comum: dd/mm/aaaa, aaaa-mm-dd, ISO)
- Endereço (rua, número, bairro, cidade, estado, CEP — pode estar tudo numa coluna ou em separadas)
- Categoria/Liderança (texto livre)
- Observações (texto livre)
2. Faça o upload
Em Eleitores → Importar, arraste o arquivo ou clique pra selecionar. O sistema valida tamanho, codificação e lê o cabeçalho.
3. Mapeie as colunas
O wizard mostra cada coluna da planilha e tenta sugerir o campo Kabix correspondente (ex: "Telefone celular" → "Telefone"). Confira e ajuste o que estiver errado.
Dica: colunas que você não quer importar podem ser deixadas em branco. Não precisa apagar do CSV.
4. Valide e revise
Esta etapa mostra:
- Total de linhas válidas prontas pra importar.
- Duplicatas detectadas (já existe no banco ou no próprio CSV — uma versão é mantida, demais ignoradas).
- Linhas com erros (telefone inválido, data fora de formato, campo obrigatório vazio) — você decide ignorar essas linhas ou voltar e corrigir o CSV.
5. Confirme a importação
Clique em Importar. O processamento acontece em chunks e você acompanha o progresso. Bases de 5k linhas geralmente levam 30-60 segundos.
Após concluído, o sistema redireciona pra Eleitores → Lista já com a base nova carregada.
Problemas comuns
"Codificação não reconhecida" — abra o CSV num editor de texto, salve como UTF-8 e tente de novo.
"Coluna obrigatória ausente" — pelo menos a coluna Nome precisa estar mapeada. Sem nome, a linha não importa.
Datas em formato americano (mm/dd/aaaa) — o wizard tenta detectar pelo conteúdo (se vir "15/01/2026" deduz dd/mm), mas em ambiguidade prefere dd/mm/aaaa (padrão brasileiro). Confira algumas linhas após a importação.
Caracteres especiais virando "?" — sintoma clássico de planilha em Latin-1 importada como UTF-8. Reexporte explicitamente em UTF-8.
Importar Demandas e Financeiro
A mesma mecânica vale pra Demandas → Importar e Financeiro → Importar. Cada módulo tem schema próprio (status, prioridade, tipo de lançamento etc), com parser flexível de data e valor (1.234,56 e 1234.56 ambos aceitos).
Detalhes específicos nos artigos por módulo.