Courier Kyiv — адресна доставка по Києву для OpenCart

Courier Kyiv — адресна доставка кур’єром по Києву з довідником вулиць і будинків для OpenCart

Courier Kyiv — модуль кур’єрської доставки для OpenCart та ocStore, який дозволяє покупцеві не вводити адресу довільним текстом, а вибрати вулицю та будинок із синхронізованого адресного довідника Києва.

Адреси завантажуються з адресного реєстру КМДА та зберігаються в локальній базі даних магазину. Завдяки цьому підказки вулиць і будинків працюють швидко та не залежать від доступності зовнішнього API під час оформлення кожного замовлення.

Основні можливості

• Окремий спосіб кур’єрської доставки по Києву
• Вибір вулиці з випадаючого списку
• Вибір номера будинку з випадаючого списку
• Окреме поле для номера квартири
• Завантаження адрес із реєстру КМДА
• Зберігання довідника у власних таблицях бази даних магазину
• Ручна синхронізація з адміністративної частини
• Автоматична повна синхронізація через cron
• Пошук вулиць за окремими словами незалежно від їх порядку
• Пошук за частиною назви вулиці
• Базове зіставлення поширених українських і російських варіантів написання
• Налаштовуваний ліміт підказок для вулиць і будинків
• Фіксована вартість кур’єрської доставки
• Підтримка географічних зон OpenCart
• Налаштування порядку сортування
• Підтримка покупців-гостей і зареєстрованих покупців
• Локалізація інтерфейсу українською, російською та англійською мовами

Вибір адреси покупцем

Після вибору кур’єрської доставки покупець послідовно заповнює адресу:

1. Місто — Київ, установлюється автоматично
2. Вулиця — вибирається з підказок адресного довідника
3. Будинок — вибирається зі списку будинків обраної вулиці
4. Квартира — вводиться покупцем вручну

Номер квартири вводиться окремо, оскільки квартир у відкритому адресному реєстрі немає. Вулицю та будинок необхідно саме вибрати зі списку — це захищає замовлення від випадкових помилок і неіснуючих адрес.

Пошук вулиць

Пошук виконується за окремими словами, тому порядок слів у запиті не має значення. Наприклад, запит Володимира Висоцького може знайти назву, записану в реєстрі як бульвар Висоцького Володимира.

Також підтримується пошук за частиною назви та базове зіставлення поширених російських і українських варіантів. Це допомагає знайти, наприклад, проспект Берестейський за скороченим або альтернативним написанням.

Адресний довідник КМДА

Модуль отримує міські адреси з API адресного реєстру КМДА. Під час синхронізації обробляється повний набір доступних киянам вулиць і будинків, після чого дані записуються в окремі таблиці OpenCart.

• Місто, вулиці та будинки зберігаються окремо
• Повторна синхронізація оновлює наявні записи
• Нові адреси автоматично додаються
• Застарілі записи видаляються після успішного завершення синхронізації
• Дублікати міста, вулиць і будинків об’єднуються
• Одночасний запуск кількох процесів синхронізації блокується

Ручна синхронізація

У налаштуваннях модуля доступна кнопка Синхронізувати адреси. Після завершення відображаються:

• стан синхронізації
• кількість міст
• кількість вулиць
• кількість будинків
• дата й час останнього успішного завершення
• текст помилки, якщо оновлення не завершилося

Автоматичне оновлення через cron

Для регулярного оновлення довідника модуль формує готовий cron URL. Доступ до нього захищено секретним ключем довжиною від 16 до 128 символів.

URL можна додати до планувальника хостингу або сервера. Кожен запуск повністю звіряє локальний довідник із поточними даними API.

Збереження адреси в замовленні

Після перевірки вибраної вулиці та будинку модуль формує повну адресу доставки та передає її стандартній логіці створення замовлення OpenCart.

Вулиця, номер будинку, корпус і квартира записуються в основне поле адреси доставки shipping_address_1. Модуль не створює замовлення окремо та не порушує стандартну логіку збереження замовлень OpenCart.

Мультимовність

Адміністративна частина та інтерфейс покупця локалізовані українською, російською та англійською мовами.

Якщо API повертає назви кількома мовами, модуль може зберігати локалізовані варіанти окремо. Якщо для поточної мови переклад у джерелі відсутній, використовується основна назва з реєстру.

Робота через OCMOD

Інтеграція з оформленням замовлення виконується через OCMOD. Модуль не потребує ручного редагування системних файлів OpenCart.

Сумісність

• OpenCart 3.x
• ocStore 3.x
• PHP 7.3–8.3
• Стандартне оформлення замовлення OpenCart 3.x
• Українська, російська та англійська локалізації

Системні вимоги

• Установлений OpenCart або ocStore 3.x
• PHP 7.3–8.3
• MySQL або MariaDB
• PHP-розширення cURL або дозвіл на HTTPS-запити через allow_url_fopen
• Доступ сервера до API КМДА через HTTPS
• Можливість налаштувати cron для автоматичного оновлення довідника

Важливі обмеження

• Модуль призначений тільки для адресної доставки по Києву
• Повнота та актуальність адрес залежать від даних, які повертає реєстр КМДА
• Назви вулиць відображаються у форматі, у якому вони надані джерелом
• Для деяких адрес у джерелі може бути відсутній поштовий індекс або корпус
• Номер квартири покупець вводить вручну
• Перша синхронізація обробляє весь адресний довідник і може тривати кілька хвилин
• Для автоматичного оновлення сервер повинен мати стабільний доступ до зовнішнього API
• Під час видалення модуля створені ним таблиці адресного довідника також видаляються

Встановлення

1. Завантажте архів courier_kyiv_v_1_0_oc3.ocmod.zip через розділ Розширення → Встановлення розширень
2. Перейдіть до розділу Розширення → Модифікатори та оновіть кеш модифікаторів
3. Перейдіть до розділу Розширення → Розширення
4. У типі розширень виберіть Доставка
5. Установіть модуль Кур’єрська адресна доставка по Києву
6. Відкрийте налаштування модуля
7. Виберіть географічну зону, задайте вартість доставки, порядок сортування та ліміт підказок
8. Збережіть надійний ключ cron довжиною не менше 16 символів
9. Увімкніть модуль і збережіть налаштування
10. Запустіть повну синхронізацію адрес із адміністративної частини
11. За потреби додайте сформований URL до cron-планувальника
12. Перевірте вибір вулиці та будинку під час оформлення тестового замовлення

Ліцензія

Одна ліцензія поширюється на один домен і його піддомени.