Когда пользователь вручную вводит адрес, название организации или ИНН, даже небольшая ошибка может повлиять на работу всей площадки. Объявление оказывается не в том городе, на карте выбирается неправильная точка, а в счёте появляются неточные реквизиты.
Для решения таких задач Adwos CMS поддерживает интеграцию с DaData. Она помогает получать структурированные адреса и сведения об организациях непосредственно во время заполнения форм.
При этом DaData в Adwos CMS — это не одна отдельная подсказка. Модуль используется сразу в нескольких сценариях: от работы с географией до настройки банковских переводов и регистрации продавцов.
DaData как адресный провайдер и геокодер
После установки и настройки DaData можно выбрать в Adwos CMS в качестве активного адресного провайдера.
В этом режиме интеграция помогает:
- подсказывать адрес по мере ввода;
- исправлять опечатки и неточные названия;
- получать регион, город, район и полный адрес;
- использовать идентификаторы ФИАС/ГАР и КЛАДР;
- получать координаты выбранного адреса;
- определять адрес по точке на карте;
- предварительно определять российский город по IPv4 или IPv6.
Официальный API DaData умеет находить адреса по частичному вводу, историческим названиям и почтовому индексу, а также возвращает структурированные части адреса и координаты. Подробнее это описано в документации по адресным подсказкам и стандартизации адресов.
В Adwos CMS эти данные могут использоваться при создании объявления, выборе местоположения на карте и заполнении адресов доставки. В результате разные пользователи реже создают несколько вариантов одного и того же города или улицы.
Например, вместо отдельных вариантов «СПб», «Санкт Петербург» и «г. Санкт-Петербург» площадка получает единообразные данные, с которыми проще работать в поиске, фильтрах и географических разделах.
Как DaData помогает модулю «Банковский перевод»
В модуле «Банковский перевод» DaData выполняет другую задачу. Здесь интеграция используется не для проведения платежа, а для поиска организации или индивидуального предпринимателя и заполнения реквизитов.
При настройке получателя администратор может начать вводить название компании или ИНН. Adwos CMS предложит найденные варианты и подставит:
- полное и сокращённое наименование;
- ИНН;
- КПП для юридического лица;
- ОГРН или ОГРНИП;
- юридический адрес;
- текущий статус организации, если он доступен.
Похожий сценарий работает и на стороне плательщика. Когда счёт запрашивает организация или ИП, пользователь может найти себя по названию или ИНН, выбрать результат и не перепечатывать основные сведения вручную.
DaData не проводит банковский платёж и не заменяет платёжного провайдера. Банковские счета, БИК и остальные платёжные параметры настраиваются в самом модуле «Банковский перевод». Задача DaData — ускорить ввод юридических данных и уменьшить количество ошибок.
Если сервис временно недоступен или ключ не настроен, реквизиты можно заполнить вручную. Поэтому работа с банковским переводом не зависит полностью от внешней подсказки.
Официальный API DaData поддерживает поиск организаций и ИП по названию, ИНН и ОГРН и возвращает основные сведения из ЕГРЮЛ и ЕГРИП. Подробнее — в документации по подсказкам организаций и поиску по ИНН или ОГРН.
Регистрация продавцов и бизнес-профилей
Ещё один сценарий — оформление продавца на площадке. DaData помогает подсказывать ФИО, искать ИП и организации и заполнять часть регистрационных данных по ИНН. Это сокращает форму и снижает вероятность расхождения между сведениями, введёнными пользователем, и официальными регистрационными данными.
Особенно полезна такая проверка для площадок, где продавцы получают выплаты, выставляют счета или работают от имени бизнеса.
Безопасная работа с ключами
Интеграция реализована на серверной стороне. API-ключи DaData не передаются непосредственно в браузер пользователя.
Для адресных подсказок и поиска организаций используется API-ключ. Отдельный секретный ключ требуется только для стандартизации адресов через API очистки.
Модуль ограничивает размер и частоту запросов, проверяет ответы провайдера и возвращает в интерфейс только необходимые адресные и регистрационные поля. Контактные, финансовые и служебные данные из ответа DaData отфильтровываются.
Владелец сайта подключает собственные ключи DaData, поэтому доступные возможности и лимиты запросов зависят от выбранного тарифа провайдера.
Почему интеграция продолжает дорабатываться
Внешние API и форматы их ответов со временем меняются. Одновременно появляются новые сценарии внутри Adwos CMS: регистрация продавцов, бизнес-профили, счета, адреса доставки и новые типы площадок.
Поэтому интеграция DaData не рассматривается как однажды подключённая и забытая функция.
На момент подготовки материала используется версия модуля 2.3.2. В одном из последних обновлений была улучшена обработка кодов качества в ответах DaData, чтобы корректные результаты поиска организаций не отклонялись из-за различий в формате данных.
Команда Adwos продолжает:
- актуализировать интеграцию при изменениях API;
- расширять использование подсказок в формах CMS;
- улучшать обработку ответов и ошибок;
- сохранять возможность ручного ввода;
- проверять безопасность передачи данных;
- адаптировать модуль к новым сценариям площадок.
Что получает владелец площадки
Использование DaData помогает не просто сделать форму удобнее. Оно улучшает качество данных во всей системе.
Владелец площадки получает:
- меньше ошибок в адресах и реквизитах;
- более единообразную географию объявлений;
- более точную работу поиска, фильтров и карты;
- ускоренную настройку банковских счетов;
- более простой путь регистрации продавца;
- меньше ручных исправлений со стороны администратора.
DaData остаётся дополнительным модулем: владелец проекта сам решает, подключать ли интеграцию и в каких сценариях её использовать. Такой подход позволяет расширять возможности Adwos CMS без жёсткой зависимости от одного внешнего сервиса.
Adwos CMS развивается как модульная платформа, где сторонние технологии подключаются тогда, когда они дают понятную пользу бизнесу и пользователям.
