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: вставте ліцензійний ключ з листа після оплати або увімкніть тріал у тих самих налаштуваннях.