GLS CEE Shipping для WooCommerce — ParcelShop, ParcelLocker и этикетки MyGLS для Хорватии, Чехии, Венгрии, Румынии, Словении и Словакии

GLS CEE Shipping для WooCommerce — независимый плагин доставки GLS от студии CatCode для магазинов в Хорватии, Чехии, Венгрии, Румынии, Словении и Словакии. Покупатель выбирает курьера GLS на адрес или GLS ParcelShop либо ParcelLocker прямо на чекауте WooCommerce — классическом или блочном, а менеджер создаёт этикетку, печатает её и видит статус посылки в карточке заказа через MyGLS API, не открывая кабинет GLS.

Что нужно от вас. Договор с GLS в вашей стране и доступ к MyGLS: логин (e-mail), пароль и номер клиента.

Честно о проверке: проверено на моке MyGLS. Тестового доступа к MyGLS у нас нет — GLS выдаёт его только клиентам с договором, поэтому настоящих этикеток в GLS мы не создавали. Плагин написан по официальной документации MyGLS API (версия 25.12.11) и проверен на моке MyGLS — тестовом сервере, который отвечает как MyGLS по этой документации и так же проверяет запросы (обязательные поля, номер дома только цифрами, код точки, наложенный платёж в постамат, коды ошибок GLS). Плагин обращается к нему по своим обычным адресам api.mygls.* через HTTPS. Перед запуском создайте несколько этикеток в своём MyGLS в 7-дневном триале Pro — если GLS ответит иначе, чем в документации, исправим оперативно.

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

Для OpenCart есть отдельный модуль — GLS CEE Shipping для OpenCart.

Как мы это проверяли

Полный прогон — в чистых магазинах WordPress 7.1 + WooCommerce 11.2 на nginx + php-fpm с HTTPS, в четырёх конфигурациях: PHP 8.3 + MariaDB 11 (HPOS), PHP 8.3 + MySQL 8 (классическое хранилище заказов), PHP 7.4 + MariaDB 11 (HPOS) и PHP 7.4 + MySQL 8 (классическое хранилище) — всего 2 738 автоматических проверок, все прошли, сценарии покупателя повторены два-три раза подряд. Плагин ставился штатно, через «Плагины → Добавить новый → Загрузить». Проверяли в настоящем браузере на ПК и на телефоне (375 и 320 px), с проверкой заказов в базе:

• Покупателя во всех шести странах — на классическом и блочном чекауте, каждая страна в своей валюте (EUR, CZK, HUF, RON): список точек от индекса покупателя, поиск без диакритики («Kosice» находит Košice, «Gyor» — Győr), выбор точки, оформление с наложенным платежом, адрес доставки заказа = точка, строка точки на странице «Спасибо» и в письме покупателю.
• Нетипичные сценарии: оформление без точки — отказ; точка другой страны после смены адреса — отказ с подсказкой; постамат без наложенного платежа при оплате наложенным — отказ, с банковским переводом — проходит; переключение точка → курьер → другой перевозчик → назад (адрес покупателя не меняется, точка не попадает в чужой заказ); доставка на другой адрес в другой стране; покупатель с аккаунтом (сохранённый адрес остаётся его собственным); аккаунт, созданный на странице подтверждения; точка в отпуске; только постаматы; страна без точек; поддельный запрос выбора точки; бесплатно от суммы, купон на бесплатную доставку, лимит веса.
• Админку: настройки и проверку соединения (правильный и неправильный пароль, HTTP 500, ответ не-JSON, MyGLS молчит дольше 30 с), загрузку 4 800 точек шести стран и ежедневное обновление только изменений, этикетки в точку и на адрес, содержимое запроса PrintLabels (код точки, контакты покупателя, отправитель, наложенный платёж и валюта), PDF, повторную печать без обращения к GLS, трекинг, статус, удаление и повторную этикетку, смену точки по коду, двойное нажатие, отказы GLS с их кодом в заметке заказа.
• Pro и лицензию: триал, купленный ключ, цены по весу, две посылки, массовые этикетки и печать одним PDF (и ZIP, когда GLS отказывает в повторной печати), автоэтикетку из реального оформления, ежечасную синхронизацию с переходом в «Выполнен», окончание триала, обновление 1.0.0 → 1.0.1 с catcode.com.ua.
• Языки hrvatski, čeština, slovenčina, magyar, română, slovenščina — на чекауте, в письме и в админке; бесплатную сборку отдельно после удаления Pro, и Pro рядом с бесплатной.

Скриншоты ниже — с этих стендов. Посмотреть Pro на своём магазине до покупки можно в 7-дневном триале: кнопка «Try Pro free for 7 days» в настройках плагина, карта не нужна.

Как это выглядит для покупателя

• Два метода GLS в зонах доставки WooCommerce: курьер на адрес и ParcelShop / ParcelLocker. Метод в точку показывается только для стран, где вы включили точки и загрузили их.
• Поиск точки по индексу, городу, улице или названию, без диакритики. Сразу показаны точки из индекса и города покупателя.
• В списке — тип точки, адрес, часы работы и пометка «без наложенного платежа». Точки в отпуске и неактивные не показываются.
• Без точки заказ не пройдёт — и на классическом, и на блочном чекауте проверяет сервер, а не только браузер.

Что получает админ

• Настройки в меню WooCommerce → GLS CEE Shipping: страна аккаунта определяет, к какому MyGLS (api.mygls.hr, .cz, .hu, .ro, .si, .sk) обращается плагин; есть тестовый MyGLS; проверка соединения; данные отправителя; страны точек и кнопка «Update now».
• Блок GLS в карточке заказа (HPOS и классическое хранилище): выбранная точка с кодом, улица / номер / дополнение адреса, вес, наложенный платёж, «Create GLS label», PDF, удаление до передачи посылки, «Refresh status», смена точки по коду.
• Объявленная ценность для Хорватии, индексы 20xxx. Для этих индексов документация MyGLS требует сервис DPV (объявленная ценность посылки) — плагин добавляет его к этикетке сам, с суммой заказа в валюте заказа. Проверено на моке MyGLS.
• Этикетки и для заказов с другим методом доставки — на адрес доставки.
• Трекинг GLS в карточке заказа, на странице «Спасибо» и в письмах покупателю.
• Ошибки GLS — их текстом и кодом, и заметкой в заказе.

Как это работает — шаг за шагом

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

Что под капотом

• MyGLS REST API по документации версии 25.12.11: PrintLabels, GetPrintedLabels, DeleteLabels, GetParcelListStatuses, GetParcelList, GetDeliveryPoints (точки — сжатый JSON, обновление только изменённых).
• Точка — только на сервере. JavaScript панели не читает и не пишет поля адреса покупателя. В сессию идёт только страна и код точки, данные — из таблицы плагина, а в заказ точка попадает только для метода в точку и только своей страны.
• Блочный чекаут — проверка через Store API (заказ без точки отклоняется с текстом), панель под способами доставки.
• Аккаунт покупателя не получает адрес точки — ни при оформлении, ни когда аккаунт создаётся на странице подтверждения.
• Пароль MyGLS — AES-256-CBC с HMAC, в журнал отладки не попадает.
• Одна этикетка за раз: блокировка в базе не даёт двойному нажатию или автоэтикетке создать две посылки.
• Удаление плагина убирает настройки, таблицу точек, методы в зонах и задания крона; заказы сохраняют точку, номера посылок и этикетки.

Как установить

1. «Плагины → Добавить новый → Загрузить плагин» → zip → «Активировать».
2. WooCommerce → GLS CEE Shipping: выберите страну аккаунта, введите логин, пароль и номер клиента MyGLS, данные отправителя, сохраните и нажмите «Check the connection».
3. Отметьте страны точек, сохраните и нажмите «Update now».
4. WooCommerce → Настройки → Доставка → зона → «Добавить способ доставки»: «GLS ParcelShop or ParcelLocker» и «GLS courier to your address», поставьте цены.
5. Оформите тестовый заказ в точку и создайте этикетку из карточки заказа.
6. Для Pro: вставьте лицензионный ключ из письма после оплаты или включите триал в тех же настройках.