Principal Locais 📘 Importação, Exportação e Atualização de Locais em Massa

📘 Importação, Exportação e Atualização de Locais em Massa

Última atualização em Jul 15, 2026

A importação e exportação em lote é a maneira mais rápida de alimentar o Contele Teams com a base de clientes do seu ERP ou CRM, permitindo também atualizar informações de milhares de registros de uma única vez.

MODELO: MODELO DE IMPORTACAO CONTELE (Faça uma cópia) - Google Planilhas

Como Importar Locais (Cadastro em Massa)

1. Preenchimento do Modelo Padrão

O primeiro passo é estruturar os seus dados. Acesse a tela de importação e baixe o nosso Modelo Padrão (que pode ser editado no Excel ou Google Planilhas). Para que a importação ocorra com sucesso, preencha ao menos os campos obrigatórios de cada linha:

  • Nome Fantasia

  • Rua (Logradouro)

  • Número

  • Cidade

Atenção: Após preencher os dados, salve ou faça o download da planilha obrigatoriamente no formato CSV separado por vírgulas (.CSV). Os valores do arquivo devem utilizar a vírgula ( , ) como separador, e não ponto e vírgula ( ; ).

2. Requisitos Técnicos do Arquivo

Antes de fazer o upload, faça uma dupla checagem nos seguintes parâmetros técnicos do seu arquivo:

  • Formato: Deve ser rigorosamente .CSV.

  • Codificação: Deve estar configurado em UTF-8 (verifique isso nas opções avançadas ao salvar como .CSV).

  • Volume Máximo: O arquivo pode conter até 10.000 linhas por processo de importação.

  • Caracteres Proibidos: O conteúdo não pode conter aspas simples ou duplas (' ") e nem os seguintes caracteres especiais: # | ~ * ! % $ < > ; ?

3. Passo a Passo da Importação no Sistema

  1. No menu superior, navegue até Locais.

  2. Clique na seta ao lado do botão de cadastro no canto superior esquerdo e selecione Importar Locais.

  3. Clique em Importar Planilha (CSV) e carregue o arquivo do seu computador.

  4. Tela de Validação de Campos: O sistema abrirá uma tela de confirmação para você mapear as colunas da sua planilha com os campos do sistema. Se as colunas não se associarem sozinhas, clique em Selecionar um campo e relacione manualmente (Exemplo: Coluna "Código" da Planilha = Relacionar com ID). Você também pode marcar para ignorar colunas que não queira importar.

  5. Clique em Salvar e Continuar no final da tela para processar o lote.

Boas Práticas do Google Maps para Evitar Erros de Geolocalização

O Contele Teams utiliza a tecnologia do Google Maps Enterprise para geocodificar os seus locais. Para garantir que seus clientes sejam plotados no mapa com precisão milimétrica, siga estas recomendações de preenchimento:

  • Evite preencher a coluna Bairro: O motor do Google Maps frequentemente interpreta nomes de bairros de forma diferente do cadastro do seu ERP (ex: uma rua na Mooca que o Google reconhece como bairro Quarta Parada). Informar o bairro pode confundir o algoritmo e "quebrar" a localização. Preencher apenas Logradouro, Número, Cidade e UF já é mais do que suficiente.

  • Endereço OU Coordenadas, nunca ambos: Se a sua planilha contiver os campos de endereço preenchidos, deixe as colunas de Latitude e Longitude em branco. Se preencher as coordenadas, deixe os campos de rua em branco. Inserir os dois dados simultaneamente na mesma linha gera conflito e erros de posicionamento.

  • Como escrever o Logradouro: Insira o endereço de forma corrida e limpa na coluna de rua: Rua Euclides da Cunha, 11. Informações de bloco, apartamento ou sala devem ficar restritas exclusivamente à coluna de Complemento.

  • Casos de Cidades Especiais (Brasília e Goiânia): Como os endereços nessas regiões utilizam quadras, setores e lotes, o endereço de texto pode falhar. A melhor prática para esses locais é buscar o ponto diretamente no Google Maps, clicar com o botão direito do mouse, copiar as coordenadas geográficas (Latitude e Longitude) e importá-las na planilha em vez do endereço escrito.

Exportação e Atualização em Massa

Se você precisa corrigir telefones, nomes de contatos ou carteiras de múltiplos clientes de uma só vez, utilize o recurso de reimportação por ID:

  1. Acesse o menu superior em Locais.

  2. Clique na seta ao lado do botão de cadastro e selecione Exportar Locais (formatado em .XLSX).

  3. Abra a planilha gerada no seu computador e realize todas as alterações necessárias nas linhas.

  4. Regra de Ouro: Nunca altere ou apague a coluna de ID gerada pelo sistema. É através desse código que o Contele Teams sabe qual cliente existente ele deve atualizar, impedindo a criação de cadastros duplicados.

  5. Salve o arquivo em .CSV (UTF-8) e faça o processo de importação normalmente. O sistema atualizará os cadastros antigos em lote.

Atenção: O sistema possui uma capacidade limite para exportar até 5.000 locais e 5.000 usuários em uma única extração. É altamente recomendável realizar exportações periódicas da sua base para fins de backup e higienização de dados.

Solução de Erros Comuns de Importação

  • Erro de Caracteres Especiais: Se o sistema acusar este erro, abra sua planilha, pressione o comando Ctrl + F (ou Ctrl + L) e busque por símbolos proibidos (como aspas, pontos e vírgulas soltos ou exclamações) para removê-los. Se sua planilha original veio separada por ponto e vírgula ( ; ), importe-a primeiro no Google Planilhas, configure a separação correta por vírgulas e exporte novamente.

  • Erro de Codificação: Caso os nomes dos clientes apareçam com caracteres corrompidos (letras com acento virando símbolos estranhos), certifique-se de mudar a codificação do arquivo para UTF-8 no momento de "Salvar Como" no seu editor de planilhas.

  • Erro de Limite de Linhas: Se sua base passar de 10.000 registros, fragmente o arquivo em duas ou mais planilhas menores e faça os uploads de forma sequencial.

  • Espaços nas Carteiras: Ao digitar nomes de carteiras na planilha, certifique-se de não deixar espaços invisíveis antes ou depois da vírgula de separação. O termo " Carteira A" (com espaço) será interpretado pelo sistema como uma carteira totalmente nova, gerando duplicatas indesejadas.