Магазинний візок
Як це працює?
Після встановлення модуля та введення даних доступу до API GLS (які ви отримуєте від свого менеджера в GLS Poland), модуль починає працювати негайно. Коли замовлення у вашому магазині досягає статусу «Відправлено», модуль автоматично починає відстеження призначеного номера відправлення. Від цього моменту періодично опитує сервери GLS щодо актуальних подій доставки — приймання посилки, транзит, доставка, проблема з доставкою чи повернення відправнику.
Кожна подія зберігається в історії разом із датою, часом, кодом події, місцезнаходженням і країною. На основі цих подій модуль автоматично змінює статус замовлення у PrestaShop — наприклад, встановлює «Доставлено», коли кур’єр підтвердить отримання посилки клієнтом. Тоді клієнт отримує сповіщення електронною поштою з інформацією про зміну статусу, точно так само, як і при ручній зміні статусу адміністратором.
Повний список функцій
- Автоматичне відстеження відправлень — модуль самостійно починає моніторинг посилки, коли замовлення переходить у статус «Відправлено». Вам не потрібно нічого натискати чи копіювати номери відстеження вручну.
- Пряма інтеграція з API GLS Group — модуль взаємодіє з офіційним програмним інтерфейсом GLS (api.gls-group.eu), використовуючи протокол REST і автентифікацію HTTP Basic Auth. Дані відправлень отримуються у форматі JSON, що забезпечує швидкість і надійність.
- Автоматична зміна статусів замовлень — на основі кодів подій GLS модуль розпізнає п’ять ключових станів відправлення та відповідно оновлює замовлення:
- У транзиті — посилку було прийнято кур’єром і вона в дорозі (коди подій 1.x, 2.x, 11.x, 67.x)
- Доставлено — кур’єр підтвердив вручення посилки одержувачу (код події 3.x)
- Проблема з доставкою — невдала спроба вручення, відсутність одержувача за адресою (коди 4.x, 12.x)
- Повернення відправнику — посилка повертається до вас як до відправника (код 5.x)
- Очікує на перевірку — номер відстеження було додано, але API ще не повернуло жодних подій
- Повна історія подій — кожна подія відправлення зберігається з точною датою та часом, кодом GLS, текстовим описом, місцезнаходженням сортувального центру або кур’єрського відділення, а також кодом країни. Історія доступна як адміністратору магазину, так і клієнту на сторінці деталей замовлення.
- Сповіщення електронною поштою для клієнтів — коли модуль змінює статус замовлення (наприклад, на «Доставлено»), PrestaShop автоматично надсилає клієнту сповіщення електронною поштою з новим статусом. Клієнт постійно отримує актуальну інформацію про долю своєї посилки без жодних зусиль з вашого боку.
- Панель відстеження для клієнта — на сторінці деталей замовлення клієнт бачить зрозумілу шкалу часу (timeline) із послідовними подіями доставки. Він бачить номер відправлення, поточний статус у вигляді кольорової мітки та посилання на відстеження на офіційному сайті GLS.
- Адміністративна панель зі списком відправлень — в адміністративному меню PrestaShop з’являється вкладка «GLS Tracking» з повним списком усіх відстежуваних відправлень. Список містить фільтри, сортування, експорт у CSV, масові дії та пошук за номером відправлення, статусом, кодом події та діапазоном дат.
- Фільтр статусів у вигляді випадаючого списку — у заголовку колонки «Статус» знаходиться випадаючий список (dropdown) з опціями: Доставлено, Повернено, У транзиті, Проблема, Очікує на перевірку. Одне натискання фільтрує список до вибраного стану — ідеально, коли ви хочете швидко побачити, наприклад, усі посилки з проблемами.
- Перегляд історії подій у модальному вікні — натискання іконки «Переглянути події» біля будь-якого відправлення відкриває спливаюче вікно (popup) з повною шкалою часу подій, без виходу зі списку. Швидкий перегляд без перезавантаження сторінки завдяки технології AJAX.
- Масове оновлення статусів — кнопка «Оновити всі відстеження» на панелі інструментів отримує актуальні дані з API GLS для всіх недоставлених і неповернених відправлень одночасно. Ви також можете вибрати окремі відправлення та оновити лише їхні статуси.
- Автоматичний імпорт із модуля GLS Poland — якщо ви користуєтеся офіційним модулем glspoland для генерації транспортних етикеток, модуль GLS Track and Trace Pro вміє автоматично імпортувати номери відправлень з таблиць цього модуля. Вам не потрібно переписувати номери вручну — достатньо вибрати джерело даних «Модуль GLS Poland» у конфігурації.
- Два джерела номерів відправлень — модуль підтримує два режими отримання номерів відстеження:
- Нативний PrestaShop — зчитує номер із поля «Номер відстеження перевізника» в деталях доставки замовлення
- Модуль GLS Poland — зчитує безпосередньо з таблиці
gls_poland_parcel, створеної офіційним модулем glspoland
- Механізм cron із двома фазами — завдання cron складається з двох фаз:
- Фаза 1 — автоматичний імпорт нових номерів відправлень із модуля GLS Poland (запускається при кожному виклику cron)
- Фаза 2 — опитування API GLS щодо актуальних подій для всіх активних відправлень (запускається відповідно до встановленого інтервалу, за замовчуванням кожні 15 хвилин)
- Два способи запуску cron — ви можете налаштувати cron двома способами:
- HTTP — вставляєте надану URL-адресу в панель хостингу як завдання cron (наприклад, у cPanel, DirectAdmin, Plesk)
- CLI — запускаєте команду PHP з командного рядка, що є ефективнішим на VPS і виділених серверах
- Налаштовуваний інтервал опитування — ви самі вирішуєте, як часто модуль має перевіряти статуси відправлень в API GLS. Значення за замовчуванням — 15 хвилин. API GLS кешує відповіді протягом 5 хвилин, тому значення менше 5 хвилин не мають сенсу й не прискорять оновлення.
- Кнопка тестування з’єднання з API — у формі конфігурації ви знайдете кнопку «Тестувати з’єднання API», яка негайно перевіряє, чи правильні вказані дані входу та чи відповідає сервер GLS. Вам не потрібно чекати першого cron, щоб дізнатися, чи конфігурацію налаштовано правильно.
- Тестове та продуктивне середовище — модуль підтримує як продуктивне середовище GLS (api.gls-group.eu), так і тестове (qs1.gls-group.eu). Ви можете безпечно протестувати інтеграцію на сервері розробки перед запуском у робочому магазині.
- Повна підтримка multistore — модуль розроблено з урахуванням багатомагазинних магазинів (multistore) PrestaShop. Кожен магазин у мережі multistore може мати власні дані API GLS, власні налаштування інтервалу cron і власні зіставлення статусів замовлень. Список відправлень в адміністративній панелі автоматично фільтрує результати для поточно вибраного магазину, групи магазинів або всіх магазинів.
- Ручне додавання номерів відстеження — на сторінці замовлення в адміністративній панелі ви знайдете форму для ручного введення номера відправлення GLS. Модуль перевіряє номер (лише літери, цифри та дефіси, максимум 64 символи) і відразу починає відстеження.
- Захист від дублікатів — модуль не дозволяє додати той самий номер відправлення двічі до одного й того самого замовлення. Як інтерфейс користувача, так і механізм бази даних (унікальний ключ) захищають від дубльованих записів навіть у разі одночасних запитів.
- Посилання на відстеження на сайті GLS — біля кожного відправлення відображається посилання, що веде безпосередньо на сторінку відстеження на офіційному порталі GLS. І адміністратор, і клієнт можуть одним натисканням перевірити повну інформацію про відправлення на сайті перевізника.
- Кольорові мітки статусів — статуси відправлень позначені кольоровими мітками (badge) для миттєвої наочності:
- зелений — доставлено
- червоний — повернено відправнику
- синій — у транзиті
- помаранчевий — проблема з доставкою
- сірий — очікує на перевірку
- Сумісність із PrestaShop 1.7.6 до 9.x — модуль сумісний із PrestaShop від версії 1.7.6 через усю серію 8.x аж до найновіших версій 9.x. Підтримує як стару (legacy), так і нову систему перекладів PrestaShop. Використовує механізм bootstrap для коректного відображення в адміністративній панелі.
Для кого цей модуль?
GLS Track and Trace Pro призначений для кожного інтернет-магазину на PrestaShop, який користується кур’єрськими послугами GLS Poland або GLS в іншій європейській країні. Модуль добре підійде як для невеликого магазину, що відправляє кілька посилок на день, так і для великого магазину, який обробляє сотні замовлень — завдяки механізму пакетного опитування API (batch processing, до 20 відправлень в одному запиті) модуль ефективно обслуговує великі обсяги.
Якщо досі ви перевіряли статуси відправлень GLS вручну на сайті перевізника та вручну змінювали статуси замовлень у PrestaShop — цей модуль повністю усуває цю роботу. Клієнти постійно отримують актуальну інформацію, замовлення оновлюються самі, а ви отримуєте час на розвиток бізнесу.
Вимоги
- PrestaShop версії 1.7.6 або новішої (включно з 8.x і 9.x)
- Дані доступу до GLS WebAPI (ім’я користувача та пароль) — ви отримаєте їх від свого торгового менеджера в GLS Poland
- Сервер із підтримкою PHP 7.1+ і розширенням cURL
- Можливість налаштування завдання cron на хостинг-сервері (доступна в більшості хостинг-панелей)
Підтримка та оновлення
Модуль розробляється та підтримується PrestaDev.pl — польською командою, що спеціалізується на створенні модулів і рішень для PrestaShop. У разі запитань, проблем із налаштуванням або потреби адаптації модуля до індивідуальних потреб — зв’яжіться з нами за адресою info@prestadev.pl.