Расширенные данные местоположений

Что умеет решение

Модуль tidx.location предоставляет расширенные данные о местоположениях и является обновлённой версией ранее выпущенного решения hooli.location. Он дополняет стандартную базу местоположений 1С-Битрикс информацией, необходимой для интеграции со службами доставки, обработки адресов и бизнес-логики интернет-магазина. Модуль не формирует отдельный справочник и не дублирует записи, а записывает все данные непосредственно в штатные сущности модуля «Интернет-магазин» (sale).

В состав поставки включены сопоставления для 12 219 кодов местоположений по следующим системам: ФИАС, КЛАДР, ОКАТО, ОКТМО и часовые пояса. Также доступны географические координаты (11 226 записей), короткие русские названия (10 941), почтовые индексы (10 067), идентификаторы СДЭК (6 907), DPD (3 281) и Boxberry (789). Фактическое количество импортированных значений зависит от состава и версии базы местоположений, установленной на сайте.

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

Существующие значения не перезаписываются, поэтому импорт можно запускать повторно: уже заполненные сведения безопасно пропускаются.

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

Импорт можно остановить после завершения текущего пакета без потери сохранённых данных.

Внешние идентификаторы сохраняются штатными средствами 1С-Битрикс. Координаты записываются в стандартные поля широты и долготы местоположения, а короткие названия — в русское представление.

Модуль не создаёт собственных таблиц для хранения импортированных данных.

Новая версия модуля продолжает назначение прежнего модуля hooli.location, но использует обновлённую архитектуру и административный интерфейс с пакетным импортом, отображением прогресса, безопасным повторным запуском и статистикой по каждому набору.

Модуль предоставляет отдельные права доступа для просмотра и импорта данных местоположений. В основе решения используются стандартные компоненты Битрикс: Engine Controller, защита от CSRF-атак и система авторизации. Реализовано автоматическое журналирование непредвиденных ошибок, а также валидация формата загружаемых данных.

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

Для работы модуля требуются:

- версия PHP 8.1 или выше;

- установленный модуль «Интернет-магазин» (sale);

- предварительно загруженная стандартная база местоположений 1С-Битрикс.

При необходимости General iT поможет внедрить «Расширенные данные местоположений», настроить модуль и проверить его работу вместе с текущей конфигурацией сайта.