Locais

Locais
Douglas Vichi
Por Douglas Vichi
• 4 artigos

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

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: 1. 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. 2. 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. 3. Envie o arquivo: arraste a planilha para a área Arraste o arquivo aqui ou clique em ou selecione no computador para buscá-la. 4. 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: 1. Confira as colunas que o sistema relacionou automaticamente. Elas aparecem com um ✓ ao lado do nome. 2. Nas colunas que mostram apenas Campo, clique no seletor e escolha o campo correspondente do sistema. 3. Se não quiser importar alguma coluna, desligue a chave Importar na linha dela. 4. Acompanhe o progresso pelo contador no canto superior direito (ex.: 5/20 campos confirmados). 5. 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: 1. No menu superior, clique em Locais. 2. Se precisar, use Buscar por locais, o botão Filtrar ou as opções Ativos e Arquivados para encontrar os locais desejados. 3. 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. 4. 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: 1. No menu superior, acesse Configurações > Importação/Exportação. 2. Clique na aba Exportações. 3. Clique no botão Exportar, no canto superior direito. 4. Na tela Nova exportação, selecione Locais no campo Tipo. O Formato é definido automaticamente como .CSV. 5. Aplique os filtros desejados (veja a lista abaixo). 6. 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: 1. Exporte os locais que você quer atualizar, por uma das formas acima. 2. Baixe o arquivo em Configurações > Importação/Exportação > Exportações. 3. Abra a planilha e faça as alterações necessárias nas linhas. 4. Salve o arquivo mantendo o formato .CSV com codificação UTF-8. 5. 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.

Última atualização em Nov 04, 2026

📘 Cadastro, Edição e Exclusão de Locais (Web e Aplicativo)

Manter a base de clientes atualizada é essencial para o sucesso da operação de campo. O Contele Teams permite que tanto os gestores no escritório quanto os colaboradores em campo realizem cadastros e edições de locais de forma manual e ágil. Cadastro Manual pelo Sistema Web (Computador) Para cadastrar um cliente individual diretamente pelo painel administrativo, siga o passo a passo: 1. No menu superior, navegue até Locais. 2. Clique no botão de cadastro manual para abrir o formulário. 3. Preencha os dados da empresa: Nome Fantasia, Razão Social, CNPJ/CPF, Nome do Contato, Telefone, E-mail e vincule as Carteiras correspondentes. 4. No campo de Endereço, digite o endereço completo e pressione a tecla Enter para que o mapa localize o ponto geográfico exato. Dicas Operacionais na Web: - Pesquisa por CEP: Se preferir, clique na opção Pesquisar pelo CEP logo abaixo do campo de endereço, digite os números e o sistema autocompletará os dados de rua, cidade e estado. - Links Úteis nas Observações: O campo de Observações do cadastro reconhece URLs dinâmicas. Você pode colar links de pastas na nuvem (Google Drive, Dropbox), sites da empresa ou prontuários técnicos que ficarão clicáveis para a equipe. - Atenção para Supervisores: Quando um Supervisor cadastrar um novo local, ele deve obrigatoriamente vinculá-lo a uma Carteira de Clientes. Caso contrário, nem ele e nem os seus colaboradores conseguirão localizar o cliente no sistema ou no aplicativo para agendamentos. Cadastro de Locais pelo Aplicativo de Campo Se a sua equipe de rua identificar uma oportunidade de prospecção ou um novo cliente durante a rota, ela pode realizar o cadastro na hora pelo aplicativo, mesmo que esteja em uma área sem cobertura de internet (Offline). Método 1: Estando Fisicamente no Local (Uso de GPS) 1. No menu do aplicativo, toque na aba Locais e clique no botão +. 2. Preencha os dados de identificação do cliente. 3. No bloco de Endereço, toque no ícone de precisão/alvo 🧿 dentro do campo de texto. 4. O mapa abrirá mostrando a sua posição de GPS atual. Ajuste o pino manualmente sobre o teto do estabelecimento se necessário, confirme e digite o número correto da fachada. Salve o cadastro. Método 2: À Distância (Pesquisa de Endereço) 1. Na aba Locais do app, clique em +. 2. No campo de endereço, digite o nome da rua ou o CEP do cliente distante. 3. Abra o mapa integrado para conferir visualmente se o pino está no local correto e confirme o salvamento. Funcionamento Offline (Sem Internet) Se o smartphone do colaborador estiver sem sinal de dados móveis (3G/4G/5G), o aplicativo salvará todas as informações localmente no aparelho. O check-in e o atendimento técnico podem ser realizados normalmente. Importante: Enquanto estiver offline, o aplicativo não conseguirá realizar a geocodificação do mapa automaticamente. Assim que o aparelho recuperar o acesso à internet, o usuário deve acessar a lista de visitas, pressionar o dedo na tela e arrastar para baixo para forçar a sincronização de dados com a Web. Isso enviará o novo local para o painel do gestor e validará o endereço no mapa. Permissões de Perfil (Quem pode criar e editar?) O nível de autonomia da equipe de rua é determinado pelo Administrador através das configurações de perfil de uso: - Permissão para Criar: Acesse Usuários, selecione o colaborador desejado e clique em editar. Role a tela até a seção de regras e ative ou desative o botão Usuário pode cadastrar novos Locais. - Permissão para Editar: Acesse o menu superior em Configurações > Sua Empresa. Na seção de Permissões, gerencie a opção Permitir a edição de Locais no APP e WEB. - Se ativada, o Usuário Padrão poderá alterar dados de qualquer cliente da base. - Se desativada, o colaborador de campo só terá permissão para editar os locais que ele mesmo cadastrou pelo aplicativo. Caso tente editar um cliente corporativo fixo, o ícone de caneta/lápis não aparecerá na tela do celular dele. Como Editar um Local Cadastrado - Pelo Computador (Web): Acesse Locais, localize o cliente na tabela e clique no ícone de lápis (Editar) localizado na extremidade direita da linha. Altere as informações necessárias e clique em Salvar. - Pelo Aplicativo (Mobile): Acesse a aba Locais, toque sobre o cliente desejado para abrir sua ficha técnica e toque no ícone de lápis no canto superior direito para liberar os campos de edição de texto ou reposicionamento de mapa. Exclusão de Locais do Sistema Atenção: A exclusão de um ponto de atendimento da base de dados é uma ação permanente, irreversível e restrita exclusivamente aos perfis de gestão através do ambiente Web. No entanto, fique tranquilo: excluir um local não apaga o histórico de visitas antigas realizadas nele; todos os relatórios passados e checklists preenchidos continuam salvos no banco de dados para auditoria da empresa. 1. Exclusão Individual de Local 1. Acesse Locais. 2. Localize o cliente e clique no ícone de lixeira vermelha. 3. Uma caixa de segurança será aberta. Leia o alerta, digite textualmente a frase de confirmação Apagar Local no campo indicado e confirme o clique em Excluir. 2. Exclusão em Massa (Limpeza de Base) Se você importou uma planilha incorreta ou precisa limpar um lote grande de clientes desativados: 1. Utilize as ferramentas de pesquisa da tela de locais para filtrar e manter visíveis na listagem apenas os registros que deseja deletar. 2. Clique na seta ao lado do botão de cadastro e selecione Apagar Locais. 3. Atenção Máxima: Se você aplicar essa função sem realizar nenhum filtro prévio na tela, o sistema entenderá que você deseja zerar a base e apagará todos os locais cadastrados na empresa. Certifique-se de refinar a busca por palavras-chave ou categorias antes de prosseguir. 4. O processamento da exclusão em lote correrá em segundo plano. O tempo de conclusão dependerá do volume de linhas apagadas. Dica de Reversão: Se você cometeu um erro grave durante uma importação de planilha de locais, acesse o menu de histórico de importações em Locais > Importar Locais e Histórico. Localize o lote do erro e delete a importação por completo; isso removerá automaticamente todos os locais que faziam parte daquele arquivo específico de uma só vez.

Última atualização em Jul 03, 2026

📘 Status de Locais, Validação e Categorias Comerciais

Para garantir a precisão do reembolso de quilometragem e auditar se as visitas de campo estão ocorrendo no endereço correto, o Contele Teams classifica os locais cadastrados por meio de status operacionais e categorias de atendimento. Entendendo os Status dos Locais no Sistema Cada cliente cadastrado ou importado recebe um indicador de status que reflete a qualidade e a confiabilidade de sua localização geográfica frente ao Google Maps: - 📍 Geoposicionado: Significa que o endereço possui uma coordenada de Latitude e Longitude gerada pelo sistema. No entanto, ele ainda não foi testado em campo. Assim que um funcionário realizar o primeiro check-in físico correto neste endereço, o status mudará automaticamente para Validado. - ⚠️ Não Geoposicionado: Indica que o motor do Google Maps não conseguiu encontrar o endereço digitado na base de dados dele. Isso ocorre por erros de digitação, nomes de ruas antigos ou falta do número do imóvel. É obrigatório corrigir o endereço textualmente para que o cliente apareça no mapa e fique disponível para agendamento de visitas. - 🟢 Validado: É o status ideal de segurança. Significa que um colaborador esteve fisicamente no local do cliente e executou um check-in válido, confirmando que a coordenada do sistema condiz perfeitamente com o endereço real da estrutura do cliente. - 🔄 Reposicionado: Indica que o endereço geográfico (pino do mapa) sofreu uma alteração manual de coordenadas feita pelo Administrador na Web ou pelo colaborador em campo para corrigir uma distorção de posicionamento original. - ⏳ Importando: Status temporário exibido enquanto o sistema está processando e geocodificando um lote de planilhas de locais carregado pelo gestor. Como Filtrar Locais pelo Status: 1. No menu superior, vá em Locais. 2. Clique no botão de Pesquisa Avançada, selecione o campo Status e marque a opção desejada (como "Não Geoposicionados") para isolar e corrigir os cadastros inválidos. Status Específicos de Locais Importados Ao analisar o histórico de um lote de planilhas enviado para o sistema, você encontrará um painel com métricas específicas de importação: - Importado: Quantidade de cadastros inseridos com sucesso na base de dados. - Não Importado: Registros rejeitados pelo sistema por erros de formatação ou dados corrompidos. - Geolocalizado: Quantidade de locais da planilha que o Google Maps encontrou e marcou no mapa com sucesso. - Não Geolocalizado: Endereços do arquivo que falharam na busca do mapa e precisam de correção manual de texto. Para auditar esse painel, acesse o menu superior em Locais, clique na seta de cadastro e vá em Importar Locais e Histórico. Identificação e Correção de Check-in Longe do Local O Contele Teams possui uma trava de segurança que alerta o gestor sempre que um colaborador de campo realiza o check-in de início de visita estando a uma distância considerável do endereço real configurado para o cliente. Como Identificar o Alerta: Navegue pelo menu superior até Visitas > Lista. Na tabela de registros, observe a coluna de horários de check-in. Caso o funcionário tenha burlado ou realizado o início do atendimento longe do perímetro do cliente, o sistema exibirá um informativo de alerta em amarelo chamando a atenção do gestor. Como Reposicionar o Local pelo Check-in (Ajuste de Base): Muitas vezes, o alerta amarelo ocorre porque o endereço cadastrado originalmente na base da empresa estava com o pino do mapa marcado no quarteirão errado. Se você confirmar que o funcionário de campo estava no local correto e o mapa do sistema é que estava desatualizado, você pode corrigir a base usando a posição do funcionário como referência: 1. Na lista de Visitas, clique sobre o ícone de alerta amarelo localizado ao lado do horário do check-in. 2. O sistema abrirá um mapa comparativo, mostrando o pino original do cliente (vermelho) e o ponto exato onde o celular do funcionário realizou o check-in (azul). 3. Se o ponto do funcionário estiver correto, clique no botão Reposicionar Local ao Check-in e confirme o salvamento. Observação Financeira: Assim que o gestor confirma o reposicionamento do local na Web, o sistema altera de forma definitiva as coordenadas do cliente e recalcula automaticamente o Relatório de Gastos (reembolso por KM) das visitas seguintes, garantindo que os cálculos financeiros de deslocamento passem a considerar o endereço corrigido. Organização por Categorias Comerciais As Categorias são utilizadas para segmentar a sua base de clientes de acordo com a regra de negócio da sua empresa, automatizando a aplicação de parâmetros operacionais. Ao aplicar uma categoria a um Local, todos os Checklists obrigatórios, tabelas de preço e configurações de Gastos vinculados àquela categoria são aplicados ao cliente instantaneamente. Exemplos Práticos de Organização de Categorias: 1. Para Equipes de Serviços Técnicos: As categorias devem ditar o comportamento do técnico em campo de acordo com o modelo de contrato do cliente atendido: - Contrato-de-Manutenção (Vincula checklists de rotina e preventivas). - Chamado-Avulso (Vincula checklists de orçamento e vistoria). - Atendimento-em-Garantia (Vincula checklists de auditoria de peças). 2. Para Equipes de Vendas e Trade Marketing: As categorias funcionam como as etapas do ciclo de conversão comercial ou status de relacionamento: - Cliente-Ativo - Cliente-Inativo - Prospect (Clientes em fase de prospecção). Como Alterar a Categoria de um Local: 1. Acesse Locais e clique em Editar no cliente desejado. 2. No campo de categoria, selecione a nova opção na lista e salve. Atenção: Mudar a categoria de um cliente na ficha cadastral altera de forma automática o comportamento e os checklists de todas as visitas que estiverem com o status de pendentes para ele. Visitas passadas que já foram concluídas não sofrem alteração, preservando o histórico de auditoria. Atenção: A exclusão de uma categoria nas configurações do sistema é uma ação irreversível. Certifique-se de que nenhum cliente utilize o marcador antes de apagá-lo. Como Localizar Clientes no Aplicativo (Regras de Hierarquia) Se a sua equipe de campo relatar dificuldades para encontrar um cliente na busca do aplicativo durante um agendamento manual, verifique as regras de bloqueio de hierarquia de Carteiras de Clientes: - Perfil Administrador: Possui acesso livre global. Consegue buscar, visualizar e agendar visitas para todos os locais cadastrados no sistema da empresa. - Perfil Supervisor: Possui acesso regional. Só consegue visualizar e agendar atendimentos para os locais que fazem parte da sua própria carteira ou das carteiras associadas aos seus funcionários subordinados. - Perfil Usuário Padrão: Possui acesso restrito. Só consegue visualizar e agendar visitas para os clientes contidos estritamente dentro da sua carteira individual de trabalho, e apenas se a opção "Permitir o agendamento de visitas pelo app" estiver ativada em seu perfil de usuário. Se o cliente pertencer à carteira de outro colega, ele não aparecerá na busca do smartphone.

Última atualização em Jul 03, 2026

Importação e Exportação de Locais

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: 1. 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. 2. 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. 3. Envie o arquivo: arraste a planilha para a área Arraste o arquivo aqui ou clique em ou selecione no computador para buscá-la. 4. 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: 1. Confira as colunas que o sistema relacionou automaticamente. Elas aparecem com um ✓ ao lado do nome. 2. Nas colunas que mostram apenas Campo, clique no seletor e escolha o campo correspondente do sistema. 3. Se não quiser importar alguma coluna, desligue a chave Importar na linha dela. 4. Acompanhe o progresso pelo contador no canto superior direito (ex.: 5/20 campos confirmados). 5. 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: 1. No menu superior, clique em Locais. 2. Se precisar, use Buscar por locais, o botão Filtrar ou as opções Ativos e Arquivados para encontrar os locais desejados. 3. 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. 4. 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: 1. No menu superior, acesse Configurações > Importação/Exportação. 2. Clique na aba Exportações. 3. Clique no botão Exportar, no canto superior direito. 4. Na tela Nova exportação, selecione Locais no campo Tipo. O Formato é definido automaticamente como .CSV. 5. Aplique os filtros desejados (veja a lista abaixo). 6. 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: 1. Exporte os locais que você quer atualizar, por uma das formas acima. 2. Baixe o arquivo em Configurações > Importação/Exportação > Exportações. 3. Abra a planilha e faça as alterações necessárias nas linhas. 4. Salve o arquivo mantendo o formato .CSV com codificação UTF-8. 5. 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

Última atualização em Nov 04, 2026