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

Наведите порядок в адресах — автоматическая нормализация через DaData

Робот «Очистить и стандартизировать адрес (ДаДата)» решает извечную проблему CRM — адресный хаос. Когда клиенты и менеджеры вводят адреса в свободной форме («г. Москва, Ленина 1», «Мск, ул Ленина д1», «москва ленина 1»), поиск и сегментация становятся невозможными. Робот приводит любой адресный ввод к единому стандарту, раскладывает на компоненты и дополняет геоданными.

Что делает

Робот принимает на вход адресную строку в произвольном формате, отправляет её в API DaData и получает обратно строго стандартизированный адрес с разбивкой по компонентам: индекс, регион, город, улица, дом, корпус, квартира. Попутно возвращаются геокоординаты, код КЛАДР/ФИАС, качество распознавания и признаки недостоверности. Робот умеет исправлять опечатки, дописывать сокращения и подсказывать более точный адрес.

Сценарии использования

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

Валидация адреса при создании сделки. Менеджер вводит адрес объекта в сделку. Робот моментально проверяет его через DaData: если адрес не распознан или содержит признаки недостоверности — менеджер получает предупреждение и предложение исправленного варианта.

Подготовка данных для службы доставки. При передаче заказа в логистику робот автоматически раскладывает адрес на индекс, регион, город, улицу, дом — именно в том формате, который требует транспортная компания. Никакой ручной перебивки адресов диспетчером.

Геокодирование для карты. Робот возвращает координаты (широту и долготу) для каждого адреса. Их можно использовать для построения карты объектов, расчёта зон доставки или назначения ближайшего монтажника.

Настройка

Роботу требуются два параметра: адресная строка (в любом формате) и API-ключ сервиса DaData. Ключ настраивается централизованно на уровне приложения. Адрес может быть передан из любого текстового поля CRM: поля сделки, лида, контакта, компании или переменной бизнес-процесса.

Результат

Робот возвращает целый набор нормализованных данных: полный стандартизированный адрес одной строкой, почтовый индекс, регион, город, улицу, номер дома, корпус, квартиру, географические координаты (широта и долгота), код КЛАДР, код ФИАС, признак качества распознавания (0–10) и булев статус операции. Все поля готовы к прямой записи в соответствующие поля CRM.

Интеграция

Выходные поля робота полностью соответствуют стандартным полям адреса в CRM Битрикс24. Робот органично встраивается в цепочку: лид → проверка адреса → создание сделки → передача в доставку. Можно комбинировать с роботом поиска организации: сначала получить компанию по ИНН, затем нормализовать её адрес.

Возможные ошибки

• Неверный API-ключ DaData — ключ отсутствует, истёк или превышен суточный лимит.
• Адрес не распознан — DaData не смогла интерпретировать строку как адрес; робот вернёт нулевое качество и пустые поля компонентов.
• Пустая адресная строка — на вход не передан адрес, робот возвращает статус N.
• Недостоверный адрес — адрес распознан, но содержит признаки ошибки: несуществующий дом, несоответствие города и индекса; робот всё равно возвращает результат, но с низким качеством.
• Таймаут сети — сервис DaData недоступен, робот логирует ошибку соединения.