GLS CEE Shipping — модуль доставки для GLS в OpenCart: на адресу і в ParcelShop / ParcelLocker (MyGLS)

GLS CEE Shipping — незалежний модуль доставки для GLS від студії CatCode для магазинів у Хорватії, Чехії, Угорщині, Румунії, Словенії та Словаччині на OpenCart 4, 3 і 2.3. Покупець обирає доставку кур’єром GLS на адресу або в GLS ParcelShop чи ParcelLocker прямо на чекауті, а менеджер створює етикетку, друкує її й бачить статус посилки в картці замовлення через MyGLS API, не відкриваючи кабінет GLS.

Що потрібно від вас. Договір з GLS у вашій країні та доступ до MyGLS: логін (e-mail), пароль і номер клієнта. Чесно про перевірку: тестового доступу до MyGLS у нас немає — GLS видає його лише клієнтам з договором. Модуль написано за офіційною документацією MyGLS API (версія 25.12.11) і перевірено на тестовому сервері, що відповідає як MyGLS за цією документацією. Справжніх етикеток у GLS ми не створювали. Спробуйте на своєму акаунті в 7-денному тріалі Pro — якщо GLS відповість інакше, ніж у документації, виправимо оперативно.

Про торговельну марку. GLS і MyGLS — торговельні марки GLS. GLS CEE Shipping — незалежний модуль CatCode, а не офіційний продукт GLS: GLS його не випускає і не підтримує. Модуль працює з вашим власним акаунтом MyGLS через MyGLS API за документацією GLS.

Магазин на WooCommerce? Для нього є окремий плагін GLS CEE Shipping для WooCommerce: ті самі два методи GLS і вибір ParcelShop / ParcelLocker на класичному й блоковому чекауті, етикетки MyGLS з картки замовлення, трекінг і накладений платіж.

Як це виглядає для покупця

• Два методи GLS у списку доставки: кур’єр на адресу і ParcelShop / ParcelLocker. Метод у точку показується лише для країн, де ви ввімкнули точки й завантажили їх.
• Пошук точки за індексом, містом, вулицею чи назвою, без діакритики. Одразу показано точки з індексу покупця.
• У списку — тип точки, адреса, години роботи і позначка «без накладеного платежу». Точки у відпустці й неактивні не показуються.
• Без точки далі не пройти: сервер відхиляє крок, а блок підтвердження на сторінці притримується з підказкою, що бракує точки.

Що отримує адмін

• Налаштування в шести вкладках: загальні, акаунт MyGLS, точки, відправлення, автоматизація, ліцензія. Країна акаунта визначає, до якого MyGLS (api.mygls.hr, .cz, .hu, .ro, .si, .sk) звертається модуль; є тестовий MyGLS.
• Панель GLS у картці замовлення: обрана точка, власна адреса покупця, створення етикетки з вагою, розбором адреси на вулицю / номер / доповнення й накладеним платежем, PDF, перевидрук, видалення, статус.
• Етикетки й для замовлень з іншим методом доставки — на адресу покупця.
• Лист покупцю з номером посилки і посиланням на трекінг GLS — мовою замовлення, і запис в історії замовлення.
• Список відправлень у меню «Продажі», з масовими діями в Pro.

Як це працює — крок за кроком

1. Ви вводите дані MyGLS, перевіряєте з’єднання і завантажуєте точки потрібних країн — вони лягають у таблицю модуля й оновлюються щодня.
2. Покупець обирає «GLS ParcelShop or ParcelLocker» і точку в панелі під методом. Точка йде в сесію на сервері; поля адреси покупця не змінюються.
3. При оформленні адреса доставки замовлення стає адресою точки, а власна адреса покупця зберігається окремо. Для доставки на адресу — адреса покупця.
4. Менеджер у картці замовлення натискає «Create GLS label»: модуль відправляє дані в MyGLS (PrintLabels; для точки — сервіс PSD з кодом точки), зберігає PDF і номер посилки.
5. Покупець отримує лист з трекінгом; статус посилки оновлюється кнопкою, а в Pro — щогодини, і доставлене замовлення переходить в обраний статус.

Що під капотом

• MyGLS REST API за документацією версії 25.12.11: PrintLabels, GetPrintedLabels, DeleteLabels, GetParcelListStatuses, GetParcelList, GetDeliveryPoints (точки — стиснутий JSON, оновлення лише змінених).
• Точка — лише на сервері. JavaScript пікера не читає і не пише поля адреси покупця. У сесію йде лише ID точки, дані — з таблиці модуля, а в замовлення точка потрапляє лише для методу в точку і лише своєї країни; інакше прив’язка стирається.
• Перевірка без точки в OpenCart 4 стоїть на збереженні способу оплати і на підтвердженні; в OpenCart 3 — на подіях кроків доставки, оплати й підтвердження; в OpenCart 2.3 — ті самі кроки через модифікацію, яку модуль реєструє сам.
• Одна бібліотека на три збірки, код сумісний з PHP 7.0; працює і з драйвером бази pdo в OpenCart 4.1.
• Пароль MyGLS — AES-256-CBC з HMAC, після збереження не показується.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, доставка й етикетки працюють далі.
• Деінсталяція знімає події й завдання крону; таблиці модуля й копія налаштувань лишаються для повторного встановлення.

Як встановити

1. OpenCart 4: Розширення → Інсталятор → завантажте cc_glscee.ocmod.zip (ім’я архіву не змінюйте) і натисніть «Встановити». OpenCart 3: Розширення → Інсталятор → cc_glscee-oc3.ocmod.zip, потім Розширення → Модифікації → «Оновити». OpenCart 2.3: залийте вміст папки upload/ з cc_glscee-oc23.ocmod.zip у корінь магазину (FTP або файловий менеджер хостингу).
2. Розширення → Розширення → Доставка → GLS CEE Shipping (MyGLS) → «Встановити», потім «Редагувати».
3. OpenCart 2.3: Розширення → Модифікації → «Оновити». Модуль реєструє свою модифікацію сам, а сторінка налаштувань нагадує, доки «Оновити» не натиснуто.
4. На вкладці «MyGLS account» оберіть країну акаунта, введіть логін, пароль і номер клієнта, дані відправника і натисніть «Save and test the connection».
5. На вкладці «ParcelShops & Lockers» відмітьте країни і натисніть «Download now»; на вкладці «General» увімкніть методи, поставте ціни, поріг безкоштовної доставки й ліміт ваги.
6. Оформіть тестове замовлення в точку і створіть етикетку з картки замовлення.
7. Для Pro: вставте ліцензійний ключ з листа після оплати або увімкніть тріал на вкладці «Licence». Для OpenCart 3 і 2.3 додайте cron-адресу з вкладки «Automation» у cron хостингу, раз на годину.