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

Робот «Очистить и стандартизировать адрес (DaData)» помогает привести адрес к единому и понятному виду, чтобы использовать его в CRM без ручной очистки.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Менеджеру CRM и администратору, который получает адрес в свободной форме и готовит его для документов, поиска или передачи в логистику.

Один адрес записывают с сокращениями и разным порядком частей. Робот отправляет переданную строку в DaData и возвращает стандартизованный адрес, составные части и признаки качества. Эти признаки нужно учитывать перед автоматическим сохранением результата.

Параметры и подготовка

Поле	Как заполнить
Адрес (address)	Обязательное поле
API Ключ DaData (api_key)	Обязательное поле
Secret Ключ DaData (secret_key)	Обязательное поле

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

Как использовать

1. Передайте непустой адрес в address. Используйте строку одного адреса, а не список нескольких получателей.
2. Укажите оба собственных ключа DaData: API и Secret. Для этого робота они обязательны; наличие ключей у другого действия не заполняет их автоматически.
3. После выполнения проверьте статус и код качества qc. Успешный запрос означает получение ответа, а не безусловную точность каждого элемента адреса.
4. Используйте result как стандартизованную строку либо отдельные city, street, house, postal_code для нужных полей. Сохранение адреса настройте отдельным действием.

Учебный пример и ожидаемый результат

Для учебного запроса передайте адрес общедоступного здания и собственные тестовые ключи сервиса. При корректном ответе ожидаются source с исходной строкой, result с предложенным адресом и qc. Точные координаты и полный набор частей зависят от ответа DaData; инструкция не обещает выдуманные значения города и дома.

Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.

Что возвращает и как продолжить процесс

• «Исходный адрес» (source).
• «Стандартизованный адрес» (result).
• «Почтовый индекс» (postal_code).
• «Страна» (country).
• «ISO-код страны» (country_iso_code).
• «Федеральный округ» (federal_district).
• «ФИАС-код региона» (region_fias_id).
• «КЛАДР-код региона» (region_kladr_id).
• «ISO-код региона» (region_iso_code).
• «Регион с типом» (region_with_type).
• «Тип региона (сокр.)» (region_type).
• «Тип региона» (region_type_full).
• «Регион» (region).
• «ФИАС-код района» (area_fias_id).
• «КЛАДР-код района» (area_kladr_id).
• «Район в регионе с типом» (area_with_type).
• «Тип района (сокр.)» (area_type).
• «Тип района» (area_type_full).
• «Район в регионе» (area).
• «ФИАС-код города» (city_fias_id).
• «КЛАДР-код города» (city_kladr_id).
• «Город с типом» (city_with_type).
• «Тип города (сокр.)» (city_type).
• «Тип города» (city_type_full).
• «Город» (city).
• «Административный округ (Москва)» (city_area).
• «ФИАС-код района города» (city_district_fias_id).
• «КЛАДР-код района города» (city_district_kladr_id).
• «Район города с типом» (city_district_with_type).
• «Тип района города (сокр.)» (city_district_type).
• «Тип района города» (city_district_type_full).
• «Район города» (city_district).
• «ФИАС-код населённого пункта» (settlement_fias_id).
• «КЛАДР-код населённого пункта» (settlement_kladr_id).
• «Населённый пункт с типом» (settlement_with_type).
• «Тип населённого пункта (сокр.)» (settlement_type).
• «Тип населённого пункта» (settlement_type_full).
• «Населённый пункт» (settlement).
• «ФИАС-код улицы» (street_fias_id).
• «КЛАДР-код улицы» (street_kladr_id).
• «Улица с типом» (street_with_type).
• «Тип улицы (сокр.)» (street_type).
• «Тип улицы» (street_type_full).
• «Улица» (street).
• «ФИАС-код земельного участка» (stead_fias_id).
• «КЛАДР-код земельного участка» (stead_kladr_id).
• «Кадастровый номер участка» (stead_cadnum).
• «Тип участка (сокр.)» (stead_type).
• «Тип участка» (stead_type_full).
• «Номер участка» (stead).
• «ФИАС-код дома» (house_fias_id).
• «КЛАДР-код дома» (house_kladr_id).
• «Кадастровый номер дома» (house_cadnum).
• «Тип дома (сокр.)» (house_type).
• «Тип дома» (house_type_full).
• «Дом» (house).
• «Количество квартир в доме» (house_flat_count).
• «Тип корпуса (сокр.)» (block_type).
• «Тип корпуса» (block_type_full).
• «Корпус/строение» (block).
• «Подъезд» (entrance).
• «Этаж» (floor).
• «ФИАС-код квартиры» (flat_fias_id).
• «Кадастровый номер квартиры» (flat_cadnum).
• «Тип квартиры (сокр.)» (flat_type).
• «Тип квартиры» (flat_type_full).
• «Квартира» (flat).
• «Площадь квартиры» (flat_area).
• «Стоимость м²» (square_meter_price).
• «Стоимость квартиры» (flat_price).
• «Абонентский ящик» (postal_box).
• «Тип комнаты (сокр.)» (room_type).
• «Тип комнаты» (room_type_full).
• «Комната» (room).
• «ФИАС-идентификатор» (fias_id).
• «ФИАС-код (устаревшее)» (fias_code).
• «Уровень детализации ФИАС» (fias_level).
• «Актуальность в ФИАС» (fias_actuality_state).
• «КЛАДР-код адреса» (kladr_id).
• «GeoNames ID» (geoname_id).
• «Центр региона/района» (capital_marker).
• «Код ОКАТО» (okato).
• «Код ОКТМО» (oktmo).
• «Код ИФНС (физлица)» (tax_office).
• «Код ИФНС (юрлица)» (tax_office_legal).
• «Часовой пояс» (timezone).
• «Широта» (geo_lat).
• «Долгота» (geo_lon).
• «Внутри кольцевой» (beltway_hit).
• «Расстояние до кольцевой (км)» (beltway_distance).
• «Код точности координат» (qc_geo).
• «Пригодность к рассылке» (qc_complete).
• «Наличие дома в ФИАС» (qc_house).
• «Код проверки адреса» (qc).
• «Нераспознанные части» (unparsed_parts).
• «Ближайшее метро» (metro).
• «Административное деление» (divisions).

Помимо строки доступны части региона, города, улицы, дома, квартиры, идентификаторы адресных справочников, координаты и признаки качества. Незаполненные сервисом значения возвращаются пустыми строками; вложенные результаты, например metro, передаются текстом JSON.

Выход «Статус» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Ошибка» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Нужны адрес и оба ключа DaData. Ответ должен содержать исходный адрес и код качества. Доступность отдельных составных полей зависит от ответа сервиса; неизвестные значения пустые, вложенные структуры возвращаются JSON-строками. Запись в CRM отдельно.

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