A carteira tem trezentos clientes espalhados por três estados, e a equipe comercial quer saber quais ficam perto de quais, para montar rotas de visita ou repassar oportunidades a quem atende aquela região. O endereço está cadastrado, mas endereço é texto: o sistema não sabe que duas lojas ficam a cinco quadras uma da outra.
A geolocalização converte o endereço do contato em coordenadas de latitude e longitude. Com as coordenadas gravadas, o sistema passa a saber onde cada contato está, e os recursos que dependem de distância, como a atribuição de oportunidades a parceiros da região, passam a funcionar.
Ativando
Em Configurações › Definições gerais, na seção Integrações, marque Geolocalização. O serviço usado para converter os endereços aparece no campo API. O padrão é o Open Street Map, gratuito e sem necessidade de conta; a outra opção usa o Google e exige uma chave de API paga, criada pela própria empresa.
Geolocalização com o serviço gratuito · dados ilustrativos.
No cadastro do contato
As coordenadas ficam no cadastro do contato, na aba Atribuição de parceiro, grupo Geolocalização. O botão Atualizar consulta o serviço com o endereço atual e grava a latitude, a longitude e a data da consulta.
Coordenadas calculadas a partir do endereço em Belo Horizonte · dados ilustrativos.
A precisão depende do endereço. Rua, número, cidade, estado, CEP e país completos dão um ponto exato; um endereço só com cidade devolve o centro da cidade. Se o contato mudou de endereço, clique em Atualizar de novo para recalcular.
| Serviço | Custo | Quando usar |
| Open Street Map | Gratuito | A maioria dos casos. Atende bem endereços urbanos brasileiros. |
| Pago por consulta, na conta Google da empresa | Quando muitos endereços rurais ou incompletos não são encontrados pelo serviço gratuito. |
O que o sistema não faz
A geolocalização não valida o endereço nem corrige erros de digitação: se a rua estiver errada, o ponto também estará. Endereços que o serviço não encontra ficam sem coordenadas, sem aviso na tela. Por isso vale conferir as coordenadas dos contatos mais importantes depois de atualizar.
Perguntas frequentes
Preciso atualizar os contatos um a um?
O botão Atualizar fica no cadastro de cada contato. Para uma carteira grande, fale com o Odoo sobre uma atualização em lote.
A geolocalização aparece para o cliente?
Não. As coordenadas são internas e servem aos recursos do próprio sistema.
O endereço da NF-e muda com isso?
Não. A nota enviada à SEFAZ usa o endereço cadastrado, com o código do município. As coordenadas não entram no documento fiscal.
Ficou com alguma dúvida? Abra um chamado na central de atendimento do Odoo ou escreva para [email protected].