Elbuz створює посилку GLS Poland у вашому кабінеті ADE Plus прямо з картки замовлення, друкує етикетку, викликає кур'єра і кожні 10 хвилин приносить статус. Переписувати адресу одержувача в ADE не потрібно.
Коли це знадобиться:
- Відправляєте по Польщі за договором з GLS — одержувач, адреса, вага й наложка підставляються із замовлення.
- Покупець забирає посилку в пункті — id пункту GLS ParcelShop вписується в накладну.
- Постійного забору немає — кур'єра на потрібну дату викликають з тієї ж накладної.
З чого почати: попросіть у GLS доступ до WebAPI → впишіть логін ADE в запис GLS в Elbuz.
Що вміє GLS Poland в Elbuz
- Посилка із замовлення — на адресу або в GLS ParcelShop, з наложкою, по одній або пачкою.
- Етикетка — PDF, одна етикетка на аркуші A4.
- Виклик кур'єра — на дату, з кількістю посилок.
- Видалення посилки — поки вона в «Przygotowalnia».
- Статуси посилок — з GLS Track&Trace кожні 10 хвилин; за таблицею кодів міняється стан посилки і статус замовлення.
Підтвердження відправки і зміна посилки — у ADE Plus.
Як підключити GLS: ADE Plus і Track&Trace
Які доступи потрібні від GLS
- Логін і пароль ADE Plus з доступом до WebAPI. GLS вмикає WebAPI користувачу окремо. Без цього вхід відхиляється з причиною «Użytkownik nie posiada dostępu do usług WebAPI».
- Користувач GLS Track&Trace API — для статусів. Його видає ваш представник GLS; реєстрації на порталі розробників немає.
Адресу відправника GLS бере з профілю вашого кабінету ADE Plus: в Elbuz її не вписують. Опис WebAPI — у довідці ADE Plus, Track&Trace — на developer.gls-poland.com.
Куди вписати доступи в Elbuz
Де: «Зовнішні сервіси та інтеграції», група «Доставка» → запис «GLS (Польша)».
1
Користувач і Пароль2
Підказка про адресу відправника3
Логін GLS Track&Trace API4
Тестове середовище (sandbox)- Користувач і Пароль — логін і пароль кабінету ADE Plus.
- Підказка — адреса відправника береться з профілю кабінету GLS, окремого блоку «Відправник» немає.
- Логін GLS Track&Trace API — для відстеження статусів, пароль до нього вводиться в полі «Токен».
- Тестове середовище (sandbox) — перемикач увімкнено для перевірки підключення.
| Поле | Що вписати |
|---|---|
| «Користувач», «Пароль» | логін і пароль ADE Plus |
| «Логін GLS Track&Trace API» | користувач Track&Trace; його пароль — у полі «Токен» |
| «Тестове середовище (sandbox)» | увімкніть для тестового доступу GLS; для роботи — вимкніть |
| «Активність» | увімкніть |
Якщо користувача Track&Trace не вписано, Elbuz пробує статуси з логіном ADE. «Посилання на сервер API» і «API ver» для GLS не заповнюють.
Кнопки «Зберегти» немає: кожна зміна поля зберігається одразу. Пароль і «Токен» після збереження показуються крапками; порожнє поле їх не стирає.
Блок «Довідники служби» показує, скільки пунктів GLS ParcelShop знає Elbuz. Список спільний для всіх магазинів і оновлюється раз на добу; кнопка «Оновити довідники» лише перевіряє його свіжість.
Як виписати посилку GLS із замовлення
Спосіб доставки в замовленні має бути «GLS (PL)». Зі способом «GLS» посилання «Створити накладну» не з'являється.
Де: картка замовлення → «Доставка» → «Створити накладну». Якщо форму вже відкривали, посилання називається «Редагувати накладну».
Що форма заповнить сама і що перевірити
1
Вулиця і Дім2
GLS ParcelShop (id)3
Опис відправлення4
Зворотна доставка (одержувач)- Вулиця і Дім — у GLS передаються одним рядком.
- GLS ParcelShop (id) — ідентифікатор пункту видачі, поле порожнє.
- Опис відправлення — короткий опис вмісту посилки.
- Зворотна доставка (одержувач) — вибрано «Гроші», сума 249 zł.
| Поле | Що стоїть одразу | Що перевірити |
|---|---|---|
| «Прізвище», «Ім'я» | покупець із замовлення | до GLS піде 40 символів |
| «Телефон», «E-Mail» | із замовлення | для доставки в ParcelShop GLS вимагає телефон |
| «Індекс», «Населений пункт», «Вулиця», «Дім» | адреса доставки із замовлення, «Дім» порожній | вулиця й дім ідуть до GLS одним рядком, до 40 символів; «Квартира» в GLS не передається |
| «GLS ParcelShop (id)» | пункт, обраний покупцем, якщо він є в замовленні | id пункту — посилка піде в ParcelShop; під полем — підказки пунктів міста одержувача |
| «Загальна вага, кг» | вага товарів × кількість | порожня — у посилку піде 1 кг |
| «Опис відправлення» | категорія товару, без неї — список товарів | до GLS піде 25 символів |
| «Зворотна доставка (одержувач)» | «Гроші» на суму замовлення, якщо воно не оплачене й оплата — наложений платіж; інакше «Не потрібно» | оплатили карткою, а оплату не відмічено — поставте «Не потрібно» |
Габаритів і оголошеної вартості у формі GLS немає. Суми — у злотих: якщо замовлення в іншій валюті, виправте суму наложки вручну. Ліміт наложки в GLS для кожного клієнта свій.
Номер замовлення друкується на етикетці як референс, до 25 символів. Одержувач — завжди в Польщі.
Підказки ParcelShop беруться зі спільного списку пунктів. Якщо його немає, підказок теж немає — впишіть id пункту з карти GLS, посилка створиться й так.
Що відбувається після «Створити накладну»
- Посилка з'являється в ADE Plus у «Przygotowalnia». Elbuz одразу просить етикетку — так GLS присвоює номер посилки.
- Номер посилки лягає в поле «Сервіс доставки: номер», з'являється «Створено товарно-транспортну накладну №‹номер›». Якщо GLS ще не присвоїв номер, у полі буде номер відправлення ADE.
- Друга посилка на те саме замовлення не створиться: «Накладну вже створено: ‹номер› — пропущено.»
- Якщо GLS відмовив, з'явиться «Error:» з причиною; значення форми збережено в замовленні.
Посилки по десятках замовлень одразу — «Створити ТТН (доставка)» у списку замовлень, детальніше: накладні пачкою.
Етикетка і виклик кур'єра
Де: картка замовлення → «Перегляд накладної». Угорі — «Статус:» з текстом GLS і кнопка друку, нижче — «Виклик курʼєра». Вікно щоразу питає GLS про статус.
Кнопка друку відкриває етикетку PDF у новій вкладці, одна етикетка на аркуші A4. У «Відправленні» етикетки GLS друкуються по одній: рядок → «Друк накладної».
Виклик кур'єра GLS
Виклик потрібен, якщо постійного забору за договором немає.
- У «Перегляді накладної» перевірте «Дата забору»: стоїть завтрашній день, у п'ятницю й вихідні — понеділок.
- Вкажіть «Посилок, шт.» — скільки посилок забирає кур'єр.
- Натисніть «Викликати курʼєра» → «Курʼєра замовлено».
Годин забору в GLS не вибирають — полів «Забрати з» і «до» у формі немає. Номера заявки GLS не повертає; Elbuz просить GLS надіслати підтвердження заявки на e-mail. GLS приймає одну заявку на дату, забір — не раніше наступного робочого дня.
Видалення посилки
Де: картка замовлення → «Перегляд накладної» → «Видалити накладну»; або «Відправлення» → рядок → «Видалити накладну». Потрібне право створювати накладні.
- Підтвердьте «Видалити накладну ‹номер› у службі доставки?».
- GLS прибирає посилку з «Przygotowalnia», у картці зникають номер і посилання відстеження → «Накладну видалено. Замовлення можна оформити знову.»
Видалити можна лише посилку в «Przygotowalnia». Після підтвердження відправки в ADE Plus видалення в API GLS немає: Elbuz покаже «Служба доставки не видалила накладну:» з відповіддю GLS.
Статуси посилок GLS
Elbuz питає GLS Track&Trace про кожну посилку раз на 10 хвилин, до 100 посилок за прохід. Відстежуються замовлення за останні 60 днів і замовлення в позначених статусах. Усі посилки видно у «Відправленні»; текст статусу GLS — польською.
Коди статусів GLS
Стан посилки Elbuz визначає за вашою таблицею кодів і коди GLS з таблиці нижче вписує в неї сам. Код події GLS має вигляд «3.124»; Elbuz бере число до крапки — «3».
Де: підключення GLS → «Налаштування повідомлень» → «Статуси доставки», колонка «Код (назва) на сайті (API)». Кілька кодів — через кому.
| Ваш статус доставки | Код GLS | Що означає |
|---|---|---|
| «Чекання від відправника» | 0 | дані посилки в GLS, посилку передано або ще ні |
| «У дорозі» | 1, 2 | виїхала із сортувального центру, прибула в центр чи в ParcelShop |
| «Видана кур'єру» | 11 | буде доставлена сьогодні |
| «Доставлено» | 3 | доставлено; Elbuz більше не питає GLS |
| «Відмова від отримання» | 5 | повернуто відправнику |
Код 4 — «не доставлено» з різних причин: одержувача не було, відмовився платити наложку. Не вписуйте його нікуди: такі посилки будуть у стані «Невідомо» у фільтрі «Проблеми», і ви їх не пропустите.
Код 3 GLS ставить і тоді, коли посилку доставлено в ParcelShop (3.124). Elbuz бачить лише «3», тож вважає її отриманою, щойно вона в пункті. Повний список кодів — на developer.gls-poland.com.
Щоб сам мінявся статус замовлення чи оплати, так само заповніть «Статуси замовлення» і «Статуси оплати». Позначте статуси замовлень у блоці «Статуси замовлень, за якими перевіряти статус посилки в службі доставки». Зміна пишеться в історію замовлення: «Змінився статус доставки: ‹код› ‹текст› #‹номер›».
Що лишається в ADE Plus
- Підтвердження відправки (potwierdzenie nadania) — список посилок, які забирає кур'єр. Elbuz його не створює: посилки лишаються в «Przygotowalnia», підтверджують їх в ADE Plus. Скасувати підтвердження GLS не дозволяє.
- Зміна посилки — в ADE Plus; з Elbuz посилку можна лише видалити до підтвердження відправки й виписати заново.
- Відправки за кордон — Elbuz виписує посилки GLS лише одержувачам у Польщі.
Кнопка «Відстеження на сайті служби» у «Відправленні» для GLS відповідає «У цієї служби немає публічної сторінки відстеження.»
Сценарії
Перше підключення
Ситуація. Договір з GLS є, посилки досі вносили в ADE Plus вручну.
Що зробити. Попросіть представника GLS увімкнути WebAPI вашому логіну ADE і видати користувача Track&Trace. Впишіть обидва доступи й коди статусів, потім випишіть посилку з першого замовлення.
Що вийде. Посилка з'явиться в «Przygotowalnia» ADE Plus з номером, а її стан — у «Відправленні».
Покупець обрав GLS ParcelShop
Ситуація. Покупець хоче забрати посилку в пункті біля дому.
Що зробити. У формі виберіть пункт із підказок під «GLS ParcelShop (id)» або впишіть id з карти GLS. Перевірте телефон одержувача.
Що вийде. Посилка поїде в ParcelShop, а не на адресу.
Відвантаження дня
Ситуація. 20 замовлень, кур'єр за викликом.
Що зробити. Випишіть посилки пачкою і надрукуйте етикетки. Підтвердіть відправку в ADE Plus, а потім викличте кур'єра на завтра на 20 посилок.
Що вийде. Кур'єр забирає посилки за списком підтвердження, статуси приходять в Elbuz самі.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби…» у вікні накладної | Не вписано пароль ADE або вимкнено «Активність» | Впишіть логін і пароль ADE Plus, увімкніть «Активність» (куди вписати) |
| У картці замовлення немає ні «Створити накладну», ні «Редагувати накладну» | Спосіб доставки — «GLS», а не «GLS (PL)» | Змініть спосіб доставки на «GLS (PL)» |
| «Error: GLS: login/password is not configured» | Не вписано логін чи пароль ADE — заповнено лише «Токен» | Заповніть «Користувач» і «Пароль» |
| «Error:» з відмовою входу до WebAPI | GLS не ввімкнув WebAPI вашому логіну ADE | Попросіть представника GLS увімкнути доступ до WebAPI (доступи GLS) |
| «Error: postcode is required for recipient» (або name, city, street) | У замовленні немає адреси чи імені одержувача | Впишіть їх у формі накладної |
| У «Перегляді накладної» немає статусу, у «Відправленні» — «Не відстежується» | Статуси GLS видає користувачу Track&Trace, а його не вписано або пароль у «Токен» неправильний | Отримайте користувача в представника GLS і впишіть логін і пароль (поля підключення) |
| Посилки GLS у «Відправленні» в стані «Невідомо» | Код GLS не вписаний у «Статуси доставки» — або це код 4, «не доставлено» | Впишіть коди (коди статусів); код 4 розберіть з одержувачем |
Часті запитання
Скільки коштує інтеграція з GLS?
Elbuz за посилки, кур'єра й статуси нічого не списує. Посилки ви оплачуєте GLS за своїм договором.
Де вказати адресу відправника для GLS?
У профілі кабінету ADE Plus. GLS бере її звідти для кожної посилки з Elbuz.
Чому посилка з Elbuz лежить у «Przygotowalnia»?
Так задумано: Elbuz створює посилку й етикетку, а список для кур'єра ви підтверджуєте в ADE Plus (підтвердження відправки).
Навіщо поле «Токен», якщо вписую логін і пароль?
У «Токен» вписують пароль користувача Track&Trace — окремого доступу для статусів. Логін і пароль ADE Plus — у «Користувач» і «Пароль».
Чи можна відправити GLS за кордон?
Ні: в посилці з Elbuz одержувач завжди в Польщі. Міжнародні відправки оформлюйте в ADE Plus.
Чому статус у Elbuz відстає від GLS?
Elbuz питає GLS раз на 10 хвилин і бере до 100 посилок за прохід. Поточний статус показує «Перегляд накладної».
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; посилка і кур'єр — вікно «Створення ТТН служби доставки»; статуси — «Відправлення»
- Підготувати
- договір з GLS Poland, логін ADE Plus з доступом до WebAPI, користувач Track&Trace API
Посилку й кур'єра можна оформити лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».
- Отримати доступ до WebAPI і Track&TraceПредставник GLS
- Вписати логін ADE і користувача Track&TraceЗовнішні сервіси та інтеграції → GLS
- Вписати коди статусів GLSТам само, «Налаштування повідомлень»
- Виписати посилкуКартка замовлення, секція «Доставка»
- Видалити посилку, якщо треба«Перегляд накладної» або «Відправлення»
- Підтвердити відправкуADE Plus
Суміжні теми
- Якщо треба бачити посилки всіх служб в одному списку — Відправлення.
- Якщо посилки треба виписати по десятках замовлень — накладні пачкою.
- Якщо власного договору з GLS немає — Apaczka виписує посилки GLS за своїм.
- Якщо відправляєте іншою службою — як виписати накладну із замовлення.
