O campo "Endereço" no Bitrix24 funciona de um jeito incomum: em empresas e contatos os endereços ficam vinculados aos dados cadastrais, e a um negócio ou processo inteligente o endereço é adicionado por um campo personalizado. No artigo vamos ver onde procurar os endereços, como obtê-los no processo de negócios numa linha ou por partes e como a geocodificação transforma uma string de endereço arbitrária em coordenadas, CEP, cidade e fuso horário — a base para logística e relatórios por região.

Onde o Bitrix24 armazena os endereços?

A principal particularidade: para empresa e contato, o endereço não é um campo comum do card, e sim parte dos dados cadastrais. Pode haver vários endereços, por tipo — de funcionamento, jurídico e outros; uma empresa também pode ter vários conjuntos de dados cadastrais, por exemplo para diferentes pessoas jurídicas, e cada um com seu próprio conjunto de endereços. Por isso o endereço nem sempre está visível onde se procura por ele, e no processo de negócios não é obtido como um campo simples do card. No negócio não existe campo de endereço nativo nenhum — ali se adiciona um campo personalizado do tipo "Endereço" ou uma string comum. Daí surgem dois problemas típicos de automação, que veremos abaixo: como extrair o endereço dos dados cadastrais da empresa ou do contato e como padronizar os endereços que os vendedores digitaram em formato livre.

Como adicionar o campo "Endereço" a um negócio ou processo inteligente?

Crie um campo personalizado do tipo "Endereço" — ele aparece no card e recebe um código do tipo UF_CRM_ com um número; o código fica visível nas configurações de campos do CRM e será necessário ao configurar robôs e a API. Uma alternativa é o campo de string: mais simples, mas sem a especificidade de endereço. É importante entender a limitação de ambas as opções: o endereço é armazenado como um texto único, e para o filtro "todos os negócios de São Paulo" ou para o roteamento de pedidos por região ele não basta — serão necessários campos separados "Cidade", "Região", "CEP", preenchidos automaticamente a partir do endereço (sobre isso, no tópico de geocodificação). Como funcionam os tipos de campo e por que fragmentar os dados em campos separados está no artigo sobre campos no Bitrix24.

Como obter o endereço da empresa ou do contato no processo de negócios?

Extrair o endereço dos dados cadastrais por uma cadeia de entidades relacionadas, manualmente, é trabalhoso. O robô «Obter endereço da empresa/contato» faz isso em uma única ação: recebe o tipo de entidade (empresa ou contato), o ID dela e o tipo de endereço — de funcionamento (padrão) ou jurídico. Devolve o endereço completo numa única string e, separadamente, cidade, rua, CEP, região, país, mais o indicador "endereço encontrado" S/N. A string completa vai para a notificação ao entregador ou para o modelo de documento, as partes vão para os campos do negócio, para filtros e relatórios. Se o endereço não for encontrado (N), o processo cria para o vendedor a tarefa de solicitá-lo ao cliente — antes que a logística precise dele.

Como transformar o endereço em coordenadas — geocodificação?

O robô «Geocodificação de endereço» recebe o endereço em qualquer formato — até mesmo "av paulista 1" — e, pelo serviço de padronização DaData, devolve latitude e longitude, o endereço normalizado em formato de referência, CEP, região, cidade, fuso horário e uma avaliação de precisão: de "coordenadas exatas" a "coordenadas não determinadas". O indicador "encontrado" é igual a S apenas quando as coordenadas foram de fato obtidas — nele se prende a ramificação de tratamento de endereços não reconhecidos. As coordenadas são usadas para calcular a distância até o depósito e distribuir os pedidos por zonas de entrega, e o fuso horário — para agendar ligações no horário comercial do cliente, e não pelo horário do escritório. (Serviço orientado a dados russos: o DaData geocodifica endereços na Rússia.)

Como organizar os endereços para relatórios?

Uma mesma cidade os vendedores escrevem de formas diferentes: "SP", "Sampa", "São Paulo - SP" — para os filtros, são três valores distintos. A solução é a normalização na entrada: o processo de negócios, ao criar ou alterar um negócio, passa o endereço pela geocodificação e grava de volta a string de referência, e a cidade e a região em campos separados. A partir daí funcionam as ferramentas comuns: filtro por cidade, relatório por região, segmentação da base para disparos. O início da verificação nas etapas necessárias é configurado como um robô comum no designer de processos de negócios — detalhes no artigo sobre configuração de robôs. A normalização configurada uma única vez livra você da limpeza manual da base antes de cada relatório.

Conclusão

Os endereços de empresas e contatos vivem nos dados cadastrais, os endereços de negócios — em campos personalizados. Os robôs extraem o endereço numa única string ou por partes e o transformam em coordenadas, CEP, cidade e fuso horário — dados para logística, relatórios e segmentação. Ambos os robôs estão no catálogo da Roboteka; se para a sua tarefa faltar a ação necessária — descreva a tarefa, criamos o robô de graça.