Importar e exportar CSV
Como importar tomadores de uma planilha, entender o relatório da importação e exportar a lista em CSV.
A importação e a exportação ficam no menu Mais ações, o botão de três pontinhos ao lado de Novo Tomador, na tela de Tomadores.
Formato do arquivo
O arquivo segue o formato Zee.lu: um CSV com a primeira linha de cabeçalho e uma linha por tomador.
| Coluna | Obrigatória | Formato | Exemplo |
|---|---|---|---|
nome | Sim | Nome completo ou razão social. | Acme Serviços Ltda |
documento | Sim | CPF (11 dígitos) ou CNPJ (14 dígitos), com ou sem pontuação e com o dígito verificador certo. | 11.222.333/0001-81 |
email | Não | E-mail válido. | financeiro@acme.com.br |
telefone | Não | Com DDD, até 11 dígitos, com ou sem pontuação. | (11) 98765-4321 |
rua | Com o endereço | Nome da rua. | Rua das Flores |
numero | Com o endereço | Número do imóvel. | 123 |
bairro | Com o endereço | Nome do bairro. | Centro |
cep | Com o endereço | 8 dígitos, com ou sem pontuação. | 01001-000 |
complemento | Não | Apartamento, sala ou bloco. | Sala 4 |
Regras do arquivo:
- Cabeçalho. As colunas podem vir em qualquer ordem, e maiúsculas e acentos não importam:
Númeroenumerovalem igual. O nome precisa ser o da tabela, entãoe-mailoulogradouronão são reconhecidos. - Colunas extras. Colunas que não estão na tabela são ignoradas. Planilhas antigas, com a coluna
empresa_documento, continuam importando: os tomadores vão sempre para a empresa da conta ativa. - Separador. Vírgula ou ponto e vírgula, detectado automaticamente.
- Linhas em branco são ignoradas.
- Limite. No máximo 5.000 linhas de tomador por importação. Acima disso, o diálogo recusa o arquivo assim que ele é selecionado, com a mensagem A planilha tem N linhas, e o limite é 5.000 por importação. Divida o arquivo e importe em partes.
Endereço é tudo ou nada
Se qualquer coluna de endereço vier preenchida numa linha, inclusive só o complemento, as colunas rua, numero, bairro e cep passam a ser obrigatórias nessa linha. Para importar um tomador sem endereço, deixe as cinco em branco. Em Atualizar, as cinco em branco mantêm o endereço cadastrado.
Codificação e Excel
A importação lê arquivos em UTF-8 e em Windows-1252. No Excel, tanto CSV UTF-8 (delimitado por vírgulas) quanto CSV (separado por vírgulas), que o Excel no Windows grava em Windows-1252, importam com os acentos corretos.
Quando o arquivo é lido como Windows-1252, o diálogo avisa embaixo da contagem de linhas: Confira os acentos na lista de tomadores depois de importar: o arquivo foi lido como Windows-1252. Se algum nome chegar com acento trocado, salve a planilha como CSV UTF-8 (delimitado por vírgulas) e importe de novo com Atualizar.
CSV-modelo
No diálogo de importação, Baixar CSV-modelo baixa o arquivo modelo-tomadores.csv, só com o cabeçalho na ordem certa. Use-o como ponto de partida.
Importar
- Abra Mais ações e escolha Importar CSV.
- Clique na área de envio e selecione o arquivo
.csv. A plataforma lê o arquivo e mostra quantas linhas encontrou. - Escolha o que fazer quando o tomador já existir, ou seja, quando já houver um tomador com o mesmo documento na empresa.
- Clique em Importar.
Se o cabeçalho estiver sem nome ou documento, o diálogo mostra Problema no formato do arquivo e o botão Importar fica desabilitado até você enviar outro arquivo.
Tomador que já existe
| Opção | O que acontece |
|---|---|
| Ignorar | Padrão. O tomador cadastrado não é alterado, e a linha aparece como ignorada no relatório. |
| Atualizar | O que vier preenchido substitui o cadastro: nome, e-mail, telefone e o endereço, que só entra completo. Célula em branco mantém o valor cadastrado. O documento nunca muda. |
Em Atualizar, célula em branco não apaga dado. E-mail ou telefone em branco mantêm o cadastrado. Com as cinco colunas de endereço em branco, o endereço cadastrado fica; com rua, número, bairro e CEP preenchidos, ele é substituído, e o complemento em branco mantém o atual. Para apagar um dado, edite o tomador.
O documento é comparado só pelos dígitos, então 123.456.789-09 e 12345678909 são o mesmo tomador. Se o mesmo documento aparecer mais de uma vez no arquivo, a primeira linha cria o tomador e as seguintes seguem a opção escolhida. Com Atualizar, cada linha seguinte substitui só o que trouxer preenchido.
Relatório da importação
Ao terminar, o diálogo mostra Importação concluída com quatro totais: Criados, Atualizados, Ignorados e Falhas. Uma linha com problema não impede a importação das outras.
Abaixo dos totais, a tabela Linha, Status e Motivo lista só as linhas ignoradas ou com falha, e a coluna Status mostra Ignorado ou Falha. O número da linha é o da planilha: o cabeçalho é a linha 1, o primeiro tomador é a 2, e linhas em branco contam. Célula com quebra de linha conta como uma linha só.
| Motivo | Como resolver |
|---|---|
| Informe o nome ou razão social | Preencha a coluna nome. |
| CPF deve ter 11 dígitos ou CNPJ 14 dígitos | Confira a coluna documento. |
| CPF 123.456.789-00 inválido: confira os números | O dígito verificador está errado, ou o documento repete um só número. Corrija a coluna documento. Para CNPJ, a mensagem começa com CNPJ. |
| E-mail inválido | Corrija ou deixe a coluna email em branco. |
| CEP deve ter 8 dígitos | Confira a coluna cep. |
| Telefone deve ter no máximo 11 dígitos | Informe DDD e número, sem o código do país. |
| Endereço incompleto: rua, número, bairro e CEP são obrigatórios juntos. | Preencha rua, número, bairro e CEP, ou deixe as cinco colunas de endereço em branco. Vale também em Atualizar, mesmo para tomador que já tem endereço. |
| Já existe um tomador com este documento nesta empresa. | Aparece como ignorado. Para sobrescrever, importe de novo com Atualizar. |
Quando uma linha tem mais de um problema, os motivos aparecem juntos. Corrija as linhas indicadas e importe o arquivo de novo: com Ignorar, os tomadores que já entraram não são duplicados.
Se a conta ainda não tem empresa, a importação é recusada com Cadastre a empresa da conta antes de importar tomadores. Conclua a configuração inicial antes.
Exportar
Abra Mais ações e escolha a exportação:
- Exportar CSV, quando a lista está sem busca e sem filtros. Exporta todos os tomadores.
- Exportar filtrados, quando há busca ou filtro ativos. Exporta só o recorte.
A exportação segue a mesma busca, os mesmos filtros e a mesma ordenação da lista, e traz o recorte inteiro, não só a página que aparece na tela.
Sobre o arquivo:
- Nome no formato
tomadores-AAAA-MM-DD.csv, com a data de Brasília. - As mesmas 9 colunas da importação, na mesma ordem.
- Documento, telefone e CEP saem só com dígitos.
- Codificação UTF-8 com BOM, que abre com acentos corretos no Excel.
O arquivo exportado pode ser importado de volta sem edição. Para corrigir muitos cadastros de uma vez, exporte, edite a planilha e importe com Atualizar.