Технические данные
- Опубликовано:
- 18.02.2015
- Обновлено:
- 30.09.2025
- Версия:
- 3.0.0
- Установлено:
- Более 1000 раз
- Подходящие редакции:
- «Малый бизнес», «Бизнес», «Интернет-магазин + CRM»
- Адаптивность:
- Да
- Поддержка Композита:
- Да
- Совместимо с Сайты24
- Нет
Пользовательское соглашение
Описание
В стандартном оформлении заказа Битрикса свойство заказа, предназначенное для указания адреса, это обычная строка, в которой покупатель может указать свой адрес как угодно, в произвольном формате. Из-за этого покупатели чаще ошибаются в адресах доставки, менеджерам магазина приходится связываться с покупателями для уточнения данных, при использовании интеграции со службами доставки требуется исправлять адрес в заказе, если он написан в формате, "не опознаваемом" интеграционным модулем и т.д.
Модуль позволяет заменить стандартное поле ввода адреса в оформлении заказа на удобную форму с возможностью быстрого ввода адресов Российской Федерации используя сервис автоподсказок Dadata. Форма снабжена картой, на которой маркером будет показан выбранный адрес. Если среди полей оформления заказа имеется поле почтового индекса, оно будет заполняться автоматически по мере выбора желаемого адреса.
Поскольку теперь покупатель не заполняет весь адрес вручную, а выбирает из предлагаемых подсказок, соответствующих актуальным данным базы Федеральной информационной адресной системы, это кардинально уменьшает количество ошибок, а также гарантирует заполнение адреса в строго определенных последовательности и формате, что упрощает его автоматический разбор различными интеграционными решениями.
Также в модуле предусмотрена возможность замены стандартного селектора местоположений Битрикса на поисковую строку с выбором населенных пунктов через автоподсказки Dadata. При этом штатный селектор местоположений будет визуально скрыт, а по выбранному через Dadata населенному пункту будет автоматически подставлено соответствующее местоположение Битрикса, что необходимо для корректного расчета доставок, работы Ограничений и прочего функционала CMS.
Как работает модуль
Модуль это клиент-серверное решение, использующее API и Javascript виджет сервиса Dadata для автоподсказок по населенным пунктам и адресам. Для реализации карты используется API Яндекс.Карт. Важный нюанс, который следует учитывать: данные запрашиваются от сервисов "на лету", а не хранятся локально на сайте, поэтому работать полностью автономно модуль не может.
Если включено скрытие селектора местоположений, через CSS визуально скрывается блок HTML, внутри которого находится штатное поле ввода местоположения. В стандартном компоненте оформления заказа bitrix:sale.order.ajax это компонент bitrix:sale.location.selector.search. В этом же месте страницы оформления заказа добавляется поле для ввода населенного пункта с автоподсказками. Если в классификаторе местоположений Битрикса кроме РФ имеются и другие страны, также будет добавлен чекбокс "Не Россия". Кликом по нему покупатель сможет отключить выбор населенных пунктов через модуль, вернувшись к стандартному выбору местоположений, если потребуется выбрать город не из Российской Федерации.
После того, как покупатель выберет населенный пункт, модуль находит это местоположение в Битриксе, скрытно подставляет в стандартный селектор и обновляет страницу оформления заказа чтобы пересчитались данные заказа, стоимости доставки и т.п. Если по каким-то причинам не удалось найти соответствующее местоположение, например, в классификатор импортированы только города, тогда как покупатель выбрал деревню или село, местоположением будет выбран район (если есть) или регион, а в селекторе модуля останется выбранный покупателем населенный пункт.
Выбор улицы и дома связан с поисковой строкой населенного пункта, если включено скрытие селектора местоположений, либо со стандартным селектором местоположений, если его скрытие выключено. Автоподсказки по адресам предлагаются с учетом выбранного населенного пункта, например, если покупатель выбрал Санкт-Петербург, ему будут предлагаться улицы этого города. Выбор конкретной улицы в свою очередь определяет предлагаемый для выбора список домов. По мере того, как покупатель вводит адрес, модуль автоматически заполняет соответствующее свойство заказа.
Примеры интернет-магазинов- libroroom.ru
| 3.0.0 (30.09.2025) | Модуль переведен на использование сервиса подсказок Dadata. Для дальнейшей работы необходимо получить API-ключ в Личном кабинете сайта Dadata и указать его в настройках модуля. Ввиду обновления практически всех файлов модуля, рекомендуется до установки обновления сделать резервную копию сайта, особенно если модуль ранее был модифицирован сторонними разработчиками. |
| 2.0.6 (30.09.2025) | Техническое обновление. |
| 2.0.5 (10.01.2023) |
|
| 2.0.4 (20.09.2019) |
|
| 2.0.3 (17.07.2019) |
После установки обновления рекомендуется выполнить сброс кеша в Битриксе. |
| 2.0.2 (29.04.2019) |
|
| 2.0.1 (07.09.2018) | Незначительные правки |
| 2.0.0 (30.08.2018) | Добавлена возможность производить замену стандартного поля "Местоположение" на поле выбора города из КЛАДР. Добавлена возможность разделять поля адреса на "Улицу", "Дом", "Квартиру". Исправлены ошибки неверного определения индекса некоторых домов. Исправлена ошибка совместимости со СДЕК в новом шаблоне оформления заказа. Исправлены другие незначительные ошибки. |
| 1.5.20 (10.07.2018) | Исправлены ошибки |
| 1.5.19 (29.06.2018) | „обавлена возможность отключать Api Љарт, если оно загружаетсЯ сторонним скриптом |
| 1.5.18 (06.06.2018) | Ошибка совместимости со Сдек |
| 1.5.17 (04.06.2018) | Исправлены ошибки совместимости с php 7 версии. |
| 1.5.16 (01.02.2018) | Перенос запросов на более стабильный сервер kladr-api. Токен, полученный в системе "Кладр в облаке" теперь не нужен. Исправлена ошибка совместимости для новых шаблонов. |
| 1.5.15 (21.03.2017) | исправлены некоторые ошибки |
| 1.5.14 (09.02.2017) | Исправлены проблемы, возникающие при работе с другими странами. |
| 1.5.13 (23.01.2017) | Переписаны некоторые внутренние функции для повышения стабильности модуля |
| 1.5.12 (10.01.2017) | Внедрена поддержа раздельного поля адреса: для случаев, если поле адрес заменено на поля "улица","дом","квартира" |
| 1.5.11 (09.01.2017) | Исправлена ошибка совместимости для новых шаблонов |
| 1.5.10 (29.11.2016) | Исправлена ошибка в фформирвоании адреса |
| 1.5.9 (05.10.2016) | Добавлены поддержка деревень |
| 1.5.8 (29.09.2016) | Изменен механизм формирования адреса |
| 1.5.7 (18.08.2016) | Исправлена ошибка в старых версиях IE |
| 1.5.6 (12.08.2016) | Решены проблемы с выводом формы в новых шаблонах Изменен способ вывода формы кладр |
| 1.5.4 (28.06.2016) | испрвлены некоторые проблемы совместимости шаблнов |
| 1.5.3 (24.06.2016) | Добавлена возможность отключать модуль |
| 1.5.1 (20.06.2016) | Добавлена поддержка Битрикс 16 Добавлена возможность отслеживать ввод адреса Исправлены некоторые ошибки |
| 1.1.23 (18.02.2016) | Исправлена ошибка отображения некоторых городов на некоторых сайтах |
| 1.1.22 (16.11.2015) | Добавлена проверка работоспособности внешнего сервиса kladr-api Ошибки внешнего сервера теперь не критичны |
| 1.1.20 (16.11.2015) | Добавлена проверка работоспособности внешнего сервиса kladr-api. Исправлена ошибка вылета, связанная с недоступностью kladr-api |
| 1.1.19 (03.11.2015) | Исправлены ошибки с кодировкой Добавлена проверка cUrl |
| 1.1.18 (02.11.2015) | Испрвслена js ошибка |
| 1.1.17 (02.11.2015) | Добавлена возможность отключить вывод карты Исправлена ошибка, связанная с выбором в качестве поля адреса текстового поля (вместо textarea) |
| 1.1.16 (26.10.2015) | Пофиксена проблема с позиционированием карты в случае сёл |
| 1.1.15 (19.10.2015) | Исправлены ошибки поддержки https |
| 1.1.14 (16.07.2015) | Добавлены уведомления о работе модуля Изменена логика работы при неустановленных местоположениях |
| 1.1.12 (03.07.2015) | Обновлен алгоритм выбора города из базы, что ускорит работу и повысит правильность определения города |
| 1.1.11 (23.06.2015) | обновление css формы |
| 1.1.10 (23.06.2015) | Увеличены возможности интеграции с другими модулями |
| 1.1.9 (09.06.2015) | повышение стабильности работы модуля |
| 1.1.7 (09.06.2015) | Исправлена ошибка прои невбранном городе |
| 1.1.6 (26.05.2015) | Исправлена ошибка со свойствами заказа не попадающими в профиль |
| 1.1.5 (25.05.2015) | Повышена стабильность работы. Исправлены языковые ошибки |
После установки модуля необходимо перейти на его страницу настроек: Рабочий стол -> Настройки -> Настройки продукта -> Настройки модулей -> Модуль КЛАДР и заполнить их в соответствии с документацией из раздела FAQ.
Для работы модуля необходимо PHP расширение CURL.
Документация к модулю: https://ipol.ru/spravka/kladr_bitrix/module_about/
support@ipol.ru
Telegram
Вконтакт
Для диагностики нам могут потребоваться доступы к панели управления 1С-Битрикс и FTP доступы.
Другие решения разработчика
.png)
© 2001-2025 «Битрикс», «1С-Битрикс». Работает на 1С-Битрикс: Управление сайтом.