↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Обробка замовлень покупця
    5. Служби доставки в Elbuz

    GLS Poland в Elbuz: посилки ADE Plus, ParcelShop і статуси

    8 хв читанняОновлено

    Elbuz створює посилку GLS Poland у вашому кабінеті ADE Plus прямо з картки замовлення, друкує етикетку, викликає кур'єра і кожні 10 хвилин приносить статус. Переписувати адресу одержувача в ADE не потрібно.

    Коли це знадобиться:

    • Відправляєте по Польщі за договором з GLS — одержувач, адреса, вага й наложка підставляються із замовлення.
    • Покупець забирає посилку в пункті — id пункту GLS ParcelShop вписується в накладну.
    • Постійного забору немає — кур'єра на потрібну дату викликають з тієї ж накладної.

    З чого почати: попросіть у GLS доступ до WebAPI → впишіть логін ADE в запис GLS в Elbuz.

    Що вміє GLS Poland в Elbuz

    Підтвердження відправки і зміна посилки — у 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 (Польша)».

    Форма налаштування доступу GLS (Польща): логін ADE, блок параметрів GLS і тестове середовище
    1Користувач і Пароль
    2Підказка про адресу відправника
    3Логін GLS Track&Trace API
    4Тестове середовище (sandbox)
    1. Користувач і Пароль — логін і пароль кабінету ADE Plus.
    2. Підказка — адреса відправника береться з профілю кабінету GLS, окремого блоку «Відправник» немає.
    3. Логін GLS Track&Trace API — для відстеження статусів, пароль до нього вводиться в полі «Токен».
    4. Тестове середовище (sandbox) — перемикач увімкнено для перевірки підключення.
    ПолеЩо вписати
    «Користувач», «Пароль»логін і пароль ADE Plus
    «Логін GLS Track&Trace API»користувач Track&Trace; його пароль — у полі «Токен»
    «Тестове середовище (sandbox)»увімкніть для тестового доступу GLS; для роботи — вимкніть
    «Активність»увімкніть

    Якщо користувача Track&Trace не вписано, Elbuz пробує статуси з логіном ADE. «Посилання на сервер API» і «API ver» для GLS не заповнюють.

    Кнопки «Зберегти» немає: кожна зміна поля зберігається одразу. Пароль і «Токен» після збереження показуються крапками; порожнє поле їх не стирає.

    Блок «Довідники служби» показує, скільки пунктів GLS ParcelShop знає Elbuz. Список спільний для всіх магазинів і оновлюється раз на добу; кнопка «Оновити довідники» лише перевіряє його свіжість.

    Під час збереження доступ не перевіряється. Помилковий логін ADE проявиться на першій посилці текстом помилки від GLS.

    Як виписати посилку GLS із замовлення

    Спосіб доставки в замовленні має бути «GLS (PL)». Зі способом «GLS» посилання «Створити накладну» не з'являється.

    Де: картка замовлення → «Доставка» → «Створити накладну». Якщо форму вже відкривали, посилання називається «Редагувати накладну».

    Що форма заповнить сама і що перевірити

    Вікно «Створення товарно-транспортної накладної (ТТН) - GLS (PL)» із даними одержувача
    1Вулиця і Дім
    2GLS ParcelShop (id)
    3Опис відправлення
    4Зворотна доставка (одержувач)
    1. Вулиця і Дім — у GLS передаються одним рядком.
    2. GLS ParcelShop (id) — ідентифікатор пункту видачі, поле порожнє.
    3. Опис відправлення — короткий опис вмісту посилки.
    4. Зворотна доставка (одержувач) — вибрано «Гроші», сума 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

    Виклик потрібен, якщо постійного забору за договором немає.

    1. У «Перегляді накладної» перевірте «Дата забору»: стоїть завтрашній день, у п'ятницю й вихідні — понеділок.
    2. Вкажіть «Посилок, шт.» — скільки посилок забирає кур'єр.
    3. Натисніть «Викликати курʼєра» → «Курʼєра замовлено».

    Годин забору в GLS не вибирають — полів «Забрати з» і «до» у формі немає. Номера заявки GLS не повертає; Elbuz просить GLS надіслати підтвердження заявки на e-mail. GLS приймає одну заявку на дату, забір — не раніше наступного робочого дня.

    Видалення посилки

    Де: картка замовлення → «Перегляд накладної» → «Видалити накладну»; або «Відправлення» → рядок → «Видалити накладну». Потрібне право створювати накладні.

    1. Підтвердьте «Видалити накладну ‹номер› у службі доставки?».
    2. 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.

    Щоб сам мінявся статус замовлення чи оплати, так само заповніть «Статуси замовлення» і «Статуси оплати». Позначте статуси замовлень у блоці «Статуси замовлень, за якими перевіряти статус посилки в службі доставки». Зміна пишеться в історію замовлення: «Змінився статус доставки: ‹код› ‹текст› #‹номер›».

    Поки «3» не вписано в «Доставлено», Elbuz питає GLS про доставлену посилку всі 60 днів.

    Що лишається в 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

    Посилку й кур'єра можна оформити лише для замовлення, яке користувач бачить за налаштуванням «Чиї дані».

    1. Отримати доступ до WebAPI і Track&TraceПредставник GLS
    2. Вписати логін ADE і користувача Track&TraceЗовнішні сервіси та інтеграції → GLS
    3. Вписати коди статусів GLSТам само, «Налаштування повідомлень»
    4. Виписати посилкуКартка замовлення, секція «Доставка»
    5. Видалити посилку, якщо треба«Перегляд накладної» або «Відправлення»
    6. Підтвердити відправкуADE Plus

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно