Очистить и стандартизировать адрес (DaData)

Нормализация адреса в Битрикс24

Робот приводит адрес из сделки, контакта, компании или веб-формы к единому виду. Он пригодится, когда в CRM попадают строки вроде «мск тверская 7», «СПб, пушкарская д5» или «г Москва ул Тверская, семь». После обработки менеджер видит нормальный почтовый адрес, а бизнес-процесс получает отдельно индекс, регион, город, улицу, дом, квартиру и координаты.

Проверка и стандартизация идут через DaData на основе ФИАС. Например, «мск тверская 7» превращается в «г Москва, ул Тверская, д 7». Исходная строка не теряется: робот возвращает и распознанные части, и фрагменты, которые сервис не смог определить.

Где используют робота

В отделе продаж адрес часто попадает в CRM до того, как его кто-то проверит. Клиент заполнил форму на сайте, менеджер вставил строку из письма, данные приехали из внешнего сервиса. В карточках одной компании появляются «Питер», «Санкт Петербург» и «СПБ». Робот ставят сразу после создания сделки или перед этапом, где адрес начинают использовать дальше.

Для доставки он готовит индекс и координаты. Курьерская служба получает адрес в одной форме, а менеджеру не нужно вручную разбирать сокращения и опечатки.

Для сегментации базы робот раскладывает географию по полям. После этого можно строить условия: направлять заявки из Свердловской области одной группе, а клиентов внутри КАД другой. Это удобно и при чистке старой базы, где адреса годами заполняли вручную.

Перед договором или счётом робот помогает не пропустить сомнительный юридический адрес. Если дом не подтверждён или часть строки не распознана, процесс создаёт задачу ответственному. Документ не уходит с адресом, который клиент написал «рядом с метро».

Как настроить

В поле «Адрес» подставьте переменную из сделки, компании, контакта или формы. Лучше перед роботом поставить условие: запускать его только для непустой строки. Так процесс не тратит запросы на карточки, где адрес ещё не указан.

Укажите API-ключ и Secret-ключ из личного кабинета DaData. Они работают только парой. У этого робота нет резервного ключа приложения, поэтому без собственных реквизитов DaData он не запустится.

После настройки сохраните результат в отдельные поля CRM, а не только в исходную строку. Обычно нужны хотя бы почтовый индекс, регион, город, улица и дом. Исходный адрес полезно оставить для сверки, если распознавание окажется неполным.

Какие данные возвращаются

Робот отдаёт стандартизованную строку адреса и набор отдельных значений:

• страну, федеральный округ, регион, район, город, населённый пункт, улицу, дом, корпус и квартиру;
• индекс, ОКАТО, ОКТМО, код налоговой инспекции, а также идентификаторы ФИАС и КЛАДР;
• координаты, часовой пояс, признак нахождения внутри МКАД или КАД, ближайшие станции метро;
• коды качества распознавания qc и нераспознанные части исходной строки.

Коды qc нужны для автоматической проверки. По ним можно отличить полностью разобранный адрес от строки, где сервис понял город, но не смог подтвердить дом. Такой результат лучше не записывать поверх проверенного адреса без условия.

Цепочка с другими роботами

Нормализацию адреса удобно поставить в начале сценария, где дальше есть доставка, документы или распределение заявок. Например: заявка с сайта создаёт сделку, робот стандартизирует адрес, условие проверяет qc, затем сделка уходит в нужную очередь по региону. Если адрес сомнительный, менеджер получает задачу уточнить его у клиента.

Если сделка оформляется на юридическое лицо, сначала можно использовать робот «Найти организацию по ИНН (DaData)», а затем привести адрес компании к единому виду. В карточке остаются и реквизиты, и адресные поля, пригодные для фильтров и печатных форм.

При массовой очистке базы запускайте процесс партиями. Сначала обработайте несколько десятков компаний, проверьте, куда записываются поля и как выглядят результаты. Затем расширяйте выборку. Так проще заметить старое поле с нестандартным форматом до того, как оно попадёт во все сделки.

Что проверить перед сохранением

Не каждый адрес должен автоматически заменять данные в CRM. Если адрес неполный, в нём есть опечатка или дом не подтверждён, сохраняйте результат в поле для проверки и ставьте задачу менеджеру. Для почтовых отправлений особенно важен индекс. Для выездных сотрудников важнее координаты и район. Условия в роботе лучше строить под задачу, а не по принципу «всё, что вернулось, записать в карточку».

Полезно заранее решить, какое поле считать главным: исходный адрес клиента или стандартизованную строку. Когда это правило определено, в карточках не появляются две одинаково важные, но разные версии адреса.

Ошибки и частые вопросы

Почему робот сообщает, что не указаны API-ключ или Secret-ключ?

Один из ключей отсутствует, вставлен с лишним пробелом или относится к другому аккаунту DaData. Скопируйте оба значения из личного кабинета и сохраните настройки робота заново.

Почему часть полей пустая?

DaData может распознать город и улицу, но не подтвердить дом или квартиру. Проверьте коды qc и фрагмент нераспознанного текста. Если это новый адрес, которого ещё нет в ФИАС, его лучше подтвердить вручную.

Что делать с пустым адресом?

Проверьте переменную в настройке робота и заполнение поля в карточке. Перед запуском добавьте условие «адрес не пустой». Тогда процесс не будет создавать ошибки на сделках, где адрес появится позже.

Почему появляется ошибка DaData?

В тексте ошибки обычно есть причина: неверные ключи, дневной лимит запросов или временная недоступность сервиса. Для разовой очистки большой базы сначала оцените объём и лимит вашего тарифа DaData.