A importação e a exportação em lote são a forma mais rápida de levar para o Contele Teams a base de clientes do seu ERP ou CRM. Com elas, você também pode atualizar as informações de milhares de locais de uma só vez.
Acessando a Importação de Locais
Para acessar a importação, clique em Locais no menu superior do sistema. Na aba Locais, clique no botão Importar, no canto superior direito, ao lado de Novo local.
A tela Importar locais será aberta. A importação acontece em três etapas, exibidas no topo da tela: Carregar arquivo, Confirmar campos e Concluído.
1. Preenchimento do Modelo Padrão
O primeiro passo é organizar os seus dados na planilha. Para baixar o modelo padrão, clique em Baixar modelo na tela Importar locais. Você pode editar o modelo no Excel ou no Google Planilhas.
Para a importação dar certo, preencha em cada linha pelo menos os campos obrigatórios:
-
Nome Fantasia
-
Rua (Logradouro)
-
Número
-
Cidade
Atenção: depois de preencher os dados, salve a planilha no formato .CSV separado por vírgulas. Os valores precisam ser separados por vírgula ( , ), e não por ponto e vírgula ( ; ).
2. Requisitos Técnicos do Arquivo
Antes de enviar o arquivo, confira se ele atende a estes requisitos:
-
Formato: deve ser
.CSV. -
Codificação: deve ser UTF-8. Você encontra essa opção nas configurações avançadas ao salvar o arquivo como
.CSV. -
Volume máximo: até 10.000 linhas por importação.
-
Caracteres proibidos: o arquivo não pode ter aspas simples ou duplas (' "), nem os caracteres # | ~ * ! % $ < > ; ?
Observação: esses cuidados também aparecem na própria tela de importação, na etapa Carregar arquivo.
3. Passo a Passo da Importação no Sistema
Etapa 1 – Carregar arquivo
Nesta etapa, você prepara e envia a planilha com os dados dos locais:
-
Crie o arquivo de planilha: use um software de planilha, como Excel ou Google Planilhas. Se preferir, clique em Baixar modelo para usar a planilha já padronizada com os campos do Contele Teams.
-
Preencha os dados e salve o arquivo: preencha uma linha para cada local, seguindo os cuidados indicados na tela:
-
Não utilize caracteres especiais.
-
Não utilize aspas simples ou duplas.
-
Respeite o limite máximo de 10 mil linhas.
-
Salve o arquivo no formato
.CSV. -
Use a codificação UTF-8.
-
-
Envie o arquivo: arraste a planilha para a área Arraste o arquivo aqui ou clique em ou selecione no computador para buscá-la.
-
Com o arquivo carregado, clique em Avançar, no canto superior direito.
Observação: ao lado das instruções, a tela também mostra o vídeo Como fazer a importação de Locais e um link para este artigo.
Etapa 2 – Confirmar campos
Aqui você confere se cada coluna da sua planilha corresponde ao campo correto no Contele Teams. A tela exibe as seguintes colunas:
-
Coluna no arquivo: o nome da coluna como está na sua planilha.
-
Dado de exemplo: um valor da primeira linha preenchida, para ajudar na identificação.
-
Campo no Contele Team: o campo do sistema que vai receber essa informação.
-
Importar: a chave que define se a coluna será importada ou não.
Para confirmar os campos:
-
Confira as colunas que o sistema relacionou automaticamente. Elas aparecem com um ✓ ao lado do nome.
-
Nas colunas que mostram apenas Campo, clique no seletor e escolha o campo correspondente do sistema.
-
Se não quiser importar alguma coluna, desligue a chave Importar na linha dela.
-
Acompanhe o progresso pelo contador no canto superior direito (ex.: 5/20 campos confirmados).
-
Quando todas as colunas estiverem relacionadas ou desligadas, clique em Avançar.
Atenção: o botão Avançar fica bloqueado enquanto houver uma coluna sem campo relacionado e com a chave Importar ligada. Para continuar, relacione um campo a essa coluna ou desligue a importação dela.
Observação: para recomeçar o mapeamento, clique em Limpar. Todos os campos relacionados serão removidos e voltarão a mostrar Campo.
Etapa 3 – Concluído
Ao final do processamento, o sistema mostra um resumo com a quantidade de locais importados e os erros encontrados. Se algum local não for importado, uma planilha com esses registros fica disponível. Você pode corrigir os dados nela e fazer uma nova importação.
Para voltar à listagem de locais a qualquer momento, clique na seta ← ao lado de Importar locais.
Boas Práticas do Google Maps para Evitar Erros de Geolocalização
O Contele Teams usa a tecnologia do Google Maps Enterprise para localizar os seus locais no mapa. Para que seus clientes apareçam na posição correta, siga estas recomendações de preenchimento:
-
Evite preencher a coluna Bairro: o Google Maps muitas vezes reconhece os bairros de forma diferente do cadastro do seu ERP. Por exemplo, uma rua que no seu cadastro fica na Mooca pode ser reconhecida pelo Google como bairro Quarta Parada. Informar o bairro pode confundir a busca e prejudicar a localização. Preencher apenas Logradouro, Número, Cidade e UF já é suficiente.
-
Endereço ou coordenadas, nunca os dois: se a linha tiver os campos de endereço preenchidos, deixe as colunas de Latitude e Longitude em branco. Se preencher as coordenadas, deixe os campos de endereço em branco. Informar os dois na mesma linha gera conflito e erros de posicionamento.
-
Como escrever o Logradouro: insira o endereço de forma simples na coluna de rua, como em Rua Euclides da Cunha, 11. Informações de bloco, apartamento ou sala devem ficar apenas na coluna de Complemento.
-
Cidades com endereços especiais (Brasília e Goiânia): como os endereços nessas cidades usam quadras, setores e lotes, a busca pelo endereço escrito pode falhar. Nesses casos, encontre o ponto no Google Maps, clique com o botão direito do mouse, copie as coordenadas (Latitude e Longitude) e use-as na planilha no lugar do endereço.
Exportação e Atualização em Massa
Você pode exportar a sua base de locais para consultar os dados, fazer backup ou corrigir informações de vários clientes de uma vez, como telefones, contatos e carteiras. A exportação pode ser feita de duas formas.
Forma 1 – Exportando pela tela de Locais
Use esta forma quando quiser escolher os locais diretamente na listagem:
-
No menu superior, clique em Locais.
-
Se precisar, use Buscar por locais, o botão Filtrar ou as opções Ativos e Arquivados para encontrar os locais desejados.
-
Selecione os locais usando a caixa de seleção ao lado de cada um.
-
Para selecionar todos os locais da página, marque a caixa de seleção no topo da lista.
-
Para incluir todos os locais da sua base, e não só os da página, clique em Selecionar todos os [quantidade] locais.
-
Para desmarcar tudo, clique em Limpar seleção.
-
-
Na barra de ações que aparece acima da lista, clique em Exportar.
O arquivo é gerado automaticamente e fica disponível em Configurações > Importação/Exportação, na aba Exportações.
Forma 2 – Exportando por filtros em Configurações
Use esta forma quando quiser montar a exportação a partir de filtros, sem selecionar os locais um a um:
-
No menu superior, acesse Configurações > Importação/Exportação.
-
Clique na aba Exportações.
-
Clique no botão Exportar, no canto superior direito.
-
Na tela Nova exportação, selecione Locais no campo Tipo. O Formato é definido automaticamente como
.CSV. -
Aplique os filtros desejados (veja a lista abaixo).
-
Clique em Exportar, no canto superior direito.
Os filtros disponíveis são:
-
Status dos locais: exporta locais ativos ou arquivados.
-
Buscar por locais: busca por nome, razão social, código externo, CNPJ/CPF ou CEP do local.
-
Categorias: filtra pela categoria ou subcategoria do local.
-
Carteiras: filtra pelas carteiras vinculadas ao local.
-
Etiquetas: filtra pelas etiquetas do local.
-
Tipo: filtra pelo tipo do local.
-
Grupo de locais: filtra pelos grupos dos quais o local participa.
-
Origem: filtra pela forma como o local entrou na base.
-
Cidade, Estado e Bairro: trazem os locais que começam com o texto digitado (ex.: São Paulo, SP, Centro).
-
Período: filtra os locais pela data de criação. Clique em Selecionar período para definir as datas.
Observação: se nenhum filtro for aplicado, a exportação inclui todos os locais. A tela mostra quantos locais correspondem aos filtros escolhidos (ex.: 11.989 locais correspondem a este filtro).
Atenção: exportações grandes podem levar alguns minutos para serem processadas.
Baixando o arquivo exportado
Todas as exportações, feitas por qualquer uma das duas formas, ficam reunidas em Configurações > Importação/Exportação, na aba Exportações. A lista mostra:
-
Tipo: o tipo de dado exportado (ex.: Locais), com a data e a hora da solicitação.
-
Solicitado por: o usuário que fez a exportação.
-
Itens: a quantidade de registros exportados.
-
Situação: o andamento da exportação. Quando o arquivo está pronto, aparece Completo.
Para baixar o arquivo, clique no ícone de download ⬇️ no fim da linha.
Para encontrar uma exportação específica, use o filtro de tipo (ex.: Todos) e o campo Buscar por exportação.
Atualizando locais em massa
Para corrigir dados de vários locais de uma só vez, use a reimportação por ID:
-
Exporte os locais que você quer atualizar, por uma das formas acima.
-
Baixe o arquivo em Configurações > Importação/Exportação > Exportações.
-
Abra a planilha e faça as alterações necessárias nas linhas.
-
Salve o arquivo mantendo o formato
.CSVcom codificação UTF-8. -
Faça a importação normalmente, como explicado na seção Passo a Passo da Importação no Sistema. Na etapa Confirmar campos, a coluna de ID é relacionada automaticamente ao campo ID.
O sistema vai atualizar os cadastros existentes em lote, sem criar locais novos.
Atenção: nunca altere nem apague a coluna de ID. É por esse código que o Contele Teams identifica qual local deve ser atualizado. Se o ID for alterado ou removido, o sistema pode criar cadastros duplicados.
Observação: recomendamos fazer exportações periódicas da sua base, como backup e para manter os dados organizados.
Dúvidas sobre a Importação e Exportação de Locais
O sistema acusou erro de caracteres especiais. O que fazer?
Abra a sua planilha, use Ctrl + F (ou Ctrl + L) e procure os caracteres proibidos, como aspas, pontos e vírgulas soltos ou pontos de exclamação. Remova todos e importe o arquivo de novo.
Se a sua planilha original estiver separada por ponto e vírgula ( ; ), abra-a primeiro no Google Planilhas, ajuste a separação para vírgulas e baixe o arquivo novamente em .CSV.
Por que os nomes dos locais aparecem com caracteres estranhos?
Isso é um erro de codificação: letras com acento aparecem como símbolos. Para corrigir, altere a codificação do arquivo para UTF-8 ao usar a opção Salvar como no seu editor de planilhas.
Minha base tem mais de 10.000 locais. Como importar?
Divida o arquivo em duas ou mais planilhas menores, cada uma com até 10.000 linhas, e importe uma de cada vez.
Por que apareceram carteiras duplicadas depois da importação?
Ao digitar os nomes das carteiras na planilha, não deixe espaços antes ou depois da vírgula de separação. Um termo como " Carteira A" (com espaço no início) é entendido pelo sistema como uma carteira nova, o que gera duplicatas.
Como corrigir os locais que não foram importados?
Na etapa Concluído, o sistema disponibiliza uma planilha com os locais que não foram importados. Corrija os dados nessa planilha, seguindo os requisitos técnicos do arquivo, e faça uma nova importação