Автозаполнение адреса доставки по КЛАДР

Для чего нужен модуль?

В стандартном оформлении заказа Битрикса свойство заказа, предназначенное для указания адреса, это обычная строка, в которой покупатель может указать свой адрес как угодно, в произвольном формате. Из-за этого покупатели чаще ошибаются в адресах доставки, менеджерам магазина приходится связываться с покупателями для уточнения данных, при использовании интеграции со службами доставки требуется исправлять адрес в заказе, если он написан в формате, "не опознаваемом" интеграционным модулем и т.д.

Модуль позволяет заменить стандартное поле ввода адреса в оформлении заказа на удобную форму с возможностью быстрого ввода адресов Российской Федерации используя сервис автоподсказок Dadata. Форма снабжена картой, на которой маркером будет показан выбранный адрес. Если среди полей оформления заказа имеется поле почтового индекса, оно будет заполняться автоматически по мере выбора желаемого адреса.

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

Также в модуле предусмотрена возможность замены стандартного селектора местоположений Битрикса на поисковую строку с выбором населенных пунктов через автоподсказки Dadata. При этом штатный селектор местоположений будет визуально скрыт, а по выбранному через Dadata населенному пункту будет автоматически подставлено соответствующее местоположение Битрикса, что необходимо для корректного расчета доставок, работы Ограничений и прочего функционала CMS.

Как работает модуль

Модуль это клиент-серверное решение, использующее API и Javascript виджет сервиса Dadata для автоподсказок по населенным пунктам и адресам. Для реализации карты используется API Яндекс.Карт. Важный нюанс, который следует учитывать: данные запрашиваются от сервисов "на лету", а не хранятся локально на сайте, поэтому работать полностью автономно модуль не может.

Если включено скрытие селектора местоположений, через CSS визуально скрывается блок HTML, внутри которого находится штатное поле ввода местоположения. В стандартном компоненте оформления заказа bitrix:sale.order.ajax это компонент bitrix:sale.location.selector.search. В этом же месте страницы оформления заказа добавляется поле для ввода населенного пункта с автоподсказками. Если в классификаторе местоположений Битрикса кроме РФ имеются и другие страны, также будет добавлен чекбокс "Не Россия". Кликом по нему покупатель сможет отключить выбор населенных пунктов через модуль, вернувшись к стандартному выбору местоположений, если потребуется выбрать город не из Российской Федерации.

После того, как покупатель выберет населенный пункт, модуль находит это местоположение в Битриксе, скрытно подставляет в стандартный селектор и обновляет страницу оформления заказа чтобы пересчитались данные заказа, стоимости доставки и т.п. Если по каким-то причинам не удалось найти соответствующее местоположение, например, в классификатор импортированы только города, тогда как покупатель выбрал деревню или село, местоположением будет выбран район (если есть) или регион, а в селекторе модуля останется выбранный покупателем населенный пункт.

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

• libroroom.ru