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 хостинга, раз в час.