Zee.lu
Tomadores

Importar e exportar CSV

Como importar tomadores de uma planilha, entender o relatório da importação e exportar a lista em CSV.

app.zee.lu/tomadores

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.

ColunaObrigatóriaFormatoExemplo
nomeSimNome completo ou razão social.Acme Serviços Ltda
documentoSimCPF (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
emailNãoE-mail válido.financeiro@acme.com.br
telefoneNãoCom DDD, até 11 dígitos, com ou sem pontuação.(11) 98765-4321
ruaCom o endereçoNome da rua.Rua das Flores
numeroCom o endereçoNúmero do imóvel.123
bairroCom o endereçoNome do bairro.Centro
cepCom o endereço8 dígitos, com ou sem pontuação.01001-000
complementoNãoApartamento, 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úmero e numero valem igual. O nome precisa ser o da tabela, então e-mail ou logradouro nã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

  1. Abra Mais ações e escolha Importar CSV.
  2. Clique na área de envio e selecione o arquivo .csv. A plataforma lê o arquivo e mostra quantas linhas encontrou.
  3. Escolha o que fazer quando o tomador já existir, ou seja, quando já houver um tomador com o mesmo documento na empresa.
  4. 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çãoO que acontece
IgnorarPadrão. O tomador cadastrado não é alterado, e a linha aparece como ignorada no relatório.
AtualizarO 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ó.

MotivoComo resolver
Informe o nome ou razão socialPreencha a coluna nome.
CPF deve ter 11 dígitos ou CNPJ 14 dígitosConfira a coluna documento.
CPF 123.456.789-00 inválido: confira os númerosO 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álidoCorrija ou deixe a coluna email em branco.
CEP deve ter 8 dígitosConfira a coluna cep.
Telefone deve ter no máximo 11 dígitosInforme 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.

On this page