Courier Kyiv — адресная доставка по Киеву
Courier Kyiv — адресная доставка по Киеву
Модуль курьерской доставки по Киеву для OpenCart 3.x. Покупатель выбирает улицу и дом из официального адресного реестра КГГА. Поддерживаются фиксированная стоимость, геозоны, ручное обновление и CRON.
Промокод применится автоматически при добавлении товара в корзину
Введите домен без www, http, https (например: example.com)
Описание
Courier Kyiv — адресная доставка курьером по Киеву с справочником улиц и домов для OpenCart
Courier Kyiv — модуль курьерской доставки для OpenCart и ocStore, который позволяет покупателю не вводить адрес произвольным текстом, а выбрать улицу и дом из синхронизированного адресного справочника Киева.
Адреса загружаются из адресного реестра КМГА и сохраняются в локальной базе данных магазина. Благодаря этому подсказки улиц и домов работают быстро и не зависят от доступности внешнего API при оформлении каждого заказа.
Основные возможности
- Отдельный способ курьерской доставки по Киеву
- Выбор улицы из выпадающего списка
- Выбор номера дома из выпадающего списка
- Отдельное поле для номера квартиры
- Загрузка адресов из реестра КМГА
- Хранение справочника в собственных таблицах базы данных магазина
- Ручная синхронизация из административной части
- Автоматическая полная синхронизация через cron
- Поиск улиц по отдельным словам независимо от их порядка
- Поиск по части названия улицы
- Базовое сопоставление распространённых украинских и русских вариантов написания
- Настраиваемый лимит подсказок для улиц и домов
- Фиксированная стоимость курьерской доставки
- Поддержка географических зон OpenCart
- Настройка порядка сортировки
- Поддержка покупателей-гостей и зарегистрированных покупателей
- Локализация интерфейса на украинском, русском и английском языках
Выбор адреса покупателем
После выбора курьерской доставки покупатель последовательно заполняет адрес:
- Город — Киев, устанавливается автоматически
- Улица — выбирается из подсказок адресного справочника
- Дом — выбирается из списка домов выбранной улицы
- Квартира — вводится покупателем вручную
Номер квартиры вводится отдельно, поскольку квартир в открытом адресном реестре нет. Улицу и дом необходимо именно выбрать из списка — это защищает заказ от случайных ошибок и несуществующих адресов.
Поиск улиц
Поиск выполняется по отдельным словам, поэтому порядок слов в запросе не имеет значения. Например, запрос Владимира Высоцкого может найти название, записанное в реестре как бульвар Высоцкого Владимира.
Также поддерживается поиск по части названия и базовое сопоставление распространённых русских и украинских вариантов. Это помогает найти, например, проспект Берестейский по сокращённому или альтернативному написанию.
Адресный справочник КМГА
Модуль получает городские адреса из API адресного реестра КМГА. Во время синхронизации обрабатывается полный набор доступных киевлянам улиц и домов, после чего данные записываются в отдельные таблицы OpenCart.
- Город, улицы и дома хранятся отдельно
- Повторная синхронизация обновляет имеющиеся записи
- Новые адреса автоматически добавляются
- Устаревшие записи удаляются после успешного завершения синхронизации
- Дубликаты города, улиц и домов объединяются
- Одновременный запуск нескольких процессов синхронизации блокируется
Ручная синхронизация
В настройках модуля доступна кнопка Синхронизировать адреса. После завершения отображаются:
- состояние синхронизации
- количество городов
- количество улиц
- количество домов
- дата и время последнего успешного завершения
- текст ошибки, если обновление не завершилось
Автоматическое обновление через cron
Для регулярного обновления справочника модуль формирует готовый cron URL. Доступ к нему защищён секретным ключом длиной от 16 до 128 символов.
URL можно добавить в планировщик хостинга или сервера. Каждый запуск полностью сверяет локальный справочник с текущими данными API.
Сохранение адреса в заказе
После проверки выбранной улицы и дома модуль формирует полный адрес доставки и передаёт его стандартной логике создания заказа OpenCart.
Улица, номер дома, корпус и квартира записываются в основное поле адреса доставки shipping_address_1. Модуль не создаёт заказ отдельно и не нарушает стандартную логику сохранения заказов OpenCart.
Мультиязычность
Административная часть и интерфейс покупателя локализованы на украинском, русском и английском языках.
Если API возвращает названия на нескольких языках, модуль может сохранять локализованные варианты отдельно. Если для текущего языка перевод в источнике отсутствует, используется основное название из реестра.
Работа через OCMOD
Интеграция с оформлением заказа выполняется через OCMOD. Модуль не требует ручного редактирования системных файлов OpenCart.
Совместимость
- Стандартное оформление заказа OpenCart 3.x
- Украинская, русская и английская локализации
Системные требования
- PHP-расширение cURL или разрешение на HTTPS-запросы через allow_url_fopen
- Доступ сервера к API КМГА через HTTPS
- Возможность настроить cron для автоматического обновления справочника
Важные ограничения
- Модуль предназначен только для адресной доставки по Киеву
- Полнота и актуальность адресов зависят от данных, которые возвращает реестр КМГА
- Названия улиц отображаются в формате, в котором они предоставлены источником
- Для некоторых адресов в источнике может отсутствовать почтовый индекс или корпус
- Номер квартиры покупатель вводит вручную
- Первая синхронизация обрабатывает весь адресный справочник и может длиться несколько минут
- Для автоматического обновления сервер должен иметь стабильный доступ к внешнему API
- При удалении модуля созданные им таблицы адресного справочника также удаляются
Установка
- Загрузите архив courier_kyiv_v_1_1_oc3.ocmod.zip через раздел Расширения → Установка расширений
- Перейдите в раздел Расширения → Модификаторы и обновите кеш модификаторов
- Перейдите в раздел Расширения → Расширения
- В типе расширений выберите Доставка
- Установите модуль Курьерская адресная доставка по Киеву
- Откройте настройки модуля
- Выберите географическую зону, задайте стоимость доставки, порядок сортировки и лимит подсказок
- Сохраните надёжный ключ cron длиной не менее 16 символов
- Включите модуль и сохраните настройки
- Запустите полную синхронизацию адресов из административной части
- При необходимости добавьте сформированный URL в cron-планировщик
- Проверьте выбор улицы и дома при оформлении тестового заказа
Лицензия
Одна лицензия распространяется на один домен и его поддомены.
Характеристики
- Версия OpenCart
- 3.0.0 3.0.1 3.0.2 3.0.3 3.0.4 3.0.5
- Локализация модуля
- Украинский, Английский, Русский
- Язык поддержки
- Украинский, Английский, Русский
- Метод активации
- Автоматическая активация
- Ioncube Loader
- Нет (не нужен)
- Обращение к серверу разработчика
- Нет
- Если сервер разработчика недоступен
- Дополнение работает
- Версия PHP
- 7.3 7.4 8.0 8.1 8.2 8.3 8.4 8.5
- Совместимо с шаблонами
- Default
Вопросы (0)
Войдите, чтобы задать вопрос.
ВойтиВопросов пока нет
Задайте первый вопрос об этом товаре!
История изменений
- Усилена проверка адресных запросов и защита служебных маршрутов.
- Добавлена проверка длины готового адреса, ограничены поисковые запросы и убран обход проверки HTTPS-сертификата.
- Сокращены повторные обращения к справочникам.