↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz
    2. Firmy kurierskie w Elbuz

    GLS Poland w Elbuz: paczki ADE Plus, ParcelShop i statusy

    5 min czytaniaZaktualizowano

    Elbuz tworzy paczkę GLS Poland w Twoim panelu ADE Plus prosto z karty zamówienia, drukuje etykietę, zamawia kuriera i co 10 minut pobiera status. Nie musisz przepisywać adresu odbiorcy do ADE.

    Kiedy to się przyda:

    • Wysyłasz po Polsce na umowie z GLS — odbiorca, adres, waga i pobranie trafiają do listu z zamówienia.
    • Klient odbiera paczkę w punkcie — id punktu GLS ParcelShop wpisuje się w list przewozowy.
    • Nie masz stałego odbioru — kuriera na wybrany dzień zamawiasz z tego samego listu przewozowego.

    Od czego zacząć: poproś GLS o dostęp do WebAPI → wpisz login ADE w rekordzie GLS w Elbuz.

    Co potrafi GLS Poland w Elbuz

    • Paczka z zamówienia — na adres lub do GLS ParcelShop, z pobraniem, pojedynczo lub zbiorczo.
    • Etykieta — PDF, jedna etykieta na arkuszu A4.
    • Zamówienie kuriera — na wybrany dzień, z liczbą paczek.
    • Usuwanie paczki — dopóki jest w „Przygotowalni”.
    • Statusy paczek — z GLS Track&Trace co 10 minut; według tabeli kodów zmienia się stan paczki i status zamówienia.

    Potwierdzenie nadania i zmiana paczki — w ADE Plus.

    Jak podłączyć GLS: ADE Plus i Track&Trace

    Jakie dostępy są potrzebne od GLS

    • Login i hasło ADE Plus z dostępem do WebAPI. GLS włącza WebAPI użytkownikowi osobno. Bez tego logowanie jest odrzucane z przyczyną „Użytkownik nie posiada dostępu do usług WebAPI”.
    • Użytkownik GLS Track&Trace API — do statusów. Wydaje go Twój opiekun w GLS; rejestracji na portalu dla programistów nie ma.

    Adres nadawcy GLS bierze z profilu Twojego panelu ADE Plus: w Elbuz się go nie wpisuje. Opis WebAPI jest w pomocy ADE Plus, Track&Trace — na developer.gls-poland.com.

    Gdzie wpisać dostępy w Elbuz

    Gdzie: „Usługi zewnętrzne i integracje”, grupa „Dostawa” → rekord „GLS (Polska)”.

    Okno ustawień GLS (Polska): użytkownik i hasło, podpowiedź z parametrami GLS, pole loginu Track&Trace API i przełącznik sandboksu
    1Użytkownik i hasło
    2Podpowiedź o adresie nadawcy
    3Login GLS Track&Trace API
    4Środowisko testowe (sandbox)
    1. „Użytkownik” i „Hasło” — login i hasło do konta ADE Plus.
    2. Podpowiedź mówi, że adres nadawcy jest pobierany z profilu konta GLS.
    3. „Login GLS Track&Trace API” — hasło do niego wpisuje się w polu „Token”.
    4. Przełącznik „Środowisko testowe (sandbox)” do trybu testowego.
    PoleCo wpisać
    „Użytkownik”, „Hasło”login i hasło ADE Plus
    „Login GLS Track&Trace API”użytkownik Track&Trace; jego hasło — w polu „Token”
    „Środowisko testowe (sandbox)”włącz dla testowego dostępu GLS; do pracy — wyłącz
    „Aktywność”włącz

    Jeśli użytkownik Track&Trace nie jest wpisany, Elbuz próbuje pobrać statusy z loginem ADE. Pól „Link do serwera API” i „API ver” dla GLS nie wypełniasz.

    Przycisku „Zapisz” nie ma: każda zmiana pola zapisuje się od razu. Hasło i „Token” po zapisaniu są widoczne jako kropki; puste pole ich nie kasuje.

    Blok „Słowniki przewoźnika” pokazuje, ile punktów GLS ParcelShop zna Elbuz. Lista jest wspólna dla wszystkich sklepów i aktualizuje się raz na dobę; przycisk „Aktualizuj słowniki” tylko sprawdza, czy jest aktualna.

    Przy zapisie dostęp nie jest sprawdzany. Błędny login ADE wyjdzie przy pierwszej paczce w treści błędu od GLS.

    Jak nadać paczkę GLS z zamówienia

    Sposób dostawy w zamówieniu musi być „GLS (PL)”. Przy sposobie „GLS” link „Utwórz list przewozowy” się nie pojawia.

    Gdzie: karta zamówienia → „Dostawa” → „Utwórz list przewozowy”. Jeśli formularz był już otwierany, link nazywa się „Edytuj list przewozowy”.

    Co formularz wypełni sam i co sprawdzić

    Okno tworzenia listu przewozowego GLS (PL) wypełnione z zamówienia klienta
    1Ulica i nr domu
    2GLS ParcelShop (id)
    3Opis przesyłki
    4Pobranie: Pieniądze
    1. Ulica z numerem domu trafia do GLS jako jeden wiersz.
    2. „GLS ParcelShop (id)” zostaje puste przy dostawie na adres.
    3. „Opis przesyłki” wypełnia się z pozycji zamówienia.
    4. Pobranie od odbiorcy ustawione na „Pieniądze”.
    PoleCo jest od razuCo sprawdzić
    „Nazwisko”, „Imię”klient z zamówieniado GLS trafi 40 znaków
    „Telefon”, „E-Mail”z zamówieniaprzy dostawie do ParcelShop GLS wymaga telefonu
    „Kod pocztowy”, „Miejscowość”, „Ulica”, „Nr domu”adres dostawy z zamówienia, „Nr domu” jest pustyulica i numer domu idą do GLS w jednym wierszu, do 40 znaków; „Nr mieszkania” nie jest przekazywany do GLS
    „GLS ParcelShop (id)”punkt wybrany przez klienta, jeśli jest w zamówieniuid punktu — paczka pójdzie do ParcelShop; pod polem — podpowiedzi punktów w mieście odbiorcy
    „Waga całkowita, kg”waga produktów × ilośćpuste — w paczce pójdzie 1 kg
    „Opis przesyłki”kategoria produktu, bez niej — lista produktówdo GLS trafi 25 znaków
    „Dostawa zwrotna (odbiorca)”„Pieniądze” na sumę zamówienia, jeśli nie jest opłacone, a płatność to pobranie; w innym razie „Niepotrzebna”klient zapłacił kartą, a płatności nie odnotowano — ustaw „Niepotrzebna”

    Wymiarów ani deklarowanej wartości w formularzu GLS nie ma. Kwoty są w złotych: jeśli zamówienie jest w innej walucie, popraw kwotę pobrania ręcznie. Limit pobrania w GLS każdy klient ma własny.

    Numer zamówienia drukuje się na etykiecie jako referencja, do 25 znaków. Odbiorca jest zawsze w Polsce.

    Podpowiedzi ParcelShop pochodzą ze wspólnej listy punktów. Jeśli jej nie ma, nie ma też podpowiedzi — wpisz id punktu z mapy GLS, paczka i tak powstanie.

    Co się dzieje po „Utwórz list przewozowy”

    • Paczka pojawia się w ADE Plus w „Przygotowalni”. Elbuz od razu prosi o etykietę — wtedy GLS nadaje numer paczki.
    • Numer paczki trafia do pola „Numer listu przewozowego”, pojawia się „Utworzono list przewozowy nr ‹numer›”. Jeśli GLS jeszcze nie nadał numeru, w polu będzie numer przesyłki ADE.
    • Druga paczka do tego samego zamówienia nie powstanie: „List przewozowy już utworzony: ‹numer› — pominięto.”
    • Jeśli GLS odmówił, pojawi się „Error:” z przyczyną; wartości formularza są zapisane w zamówieniu.

    Paczki do dziesiątek zamówień naraz — „Utwórz list przewozowy (dostawa)” na liście zamówień, więcej: listy przewozowe zbiorczo.

    Etykieta i zamówienie kuriera

    Gdzie: karta zamówienia → „Podgląd listu przewozowego”. U góry — „Status:” z tekstem GLS i przycisk drukowania, niżej — „Zamówienie kuriera”. Okno za każdym razem pyta GLS o status.

    Przycisk drukowania otwiera etykietę PDF w nowej karcie, jedna etykieta na arkuszu A4. W „Przesyłkach” etykiety GLS drukuje się pojedynczo: wiersz → „Drukuj list przewozowy”.

    Zamówienie kuriera GLS

    Zamówienie jest potrzebne, jeśli nie masz stałego odbioru w umowie.

    1. W „Podglądzie listu przewozowego” sprawdź „Data odbioru”: jest jutrzejszy dzień, w piątek i weekend — poniedziałek.
    2. Podaj „Liczba paczek, szt.” — ile paczek odbiera kurier.
    3. Kliknij „Zamów kuriera” → „Kurier zamówiony”.

    Godzin odbioru w GLS się nie wybiera — pól „Odbiór od” i „do” w formularzu nie ma. GLS nie zwraca numeru zlecenia; Elbuz prosi GLS o wysłanie potwierdzenia zlecenia e-mailem. GLS przyjmuje jedno zlecenie na dzień, odbiór — najwcześniej w następnym dniu roboczym.

    Usuwanie paczki

    Gdzie: karta zamówienia → „Podgląd listu przewozowego” → „Usuń list przewozowy”; albo „Przesyłki” → wiersz → „Usuń list przewozowy”. Potrzebne jest uprawnienie do tworzenia listów przewozowych.

    1. Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
    2. GLS usuwa paczkę z „Przygotowalni”, z karty znikają numer i link do śledzenia → „List przewozowy usunięty. Zamówienie można wysłać ponownie.”

    Usunąć można tylko paczkę w „Przygotowalni”. Po potwierdzeniu nadania w ADE Plus API GLS nie pozwala na usunięcie: Elbuz pokaże „Przewoźnik nie usunął listu przewozowego:” z odpowiedzią GLS.

    Statusy paczek GLS

    Elbuz pyta GLS Track&Trace o każdą paczkę co 10 minut, do 100 paczek na przebieg. Śledzone są zamówienia z ostatnich 60 dni i zamówienia w zaznaczonych statusach. Wszystkie paczki widać w „Przesyłkach”; tekst statusu GLS jest po polsku.

    Kody statusów GLS

    Stan paczki Elbuz ustala według Twojej tabeli kodów, a kody GLS z tabeli poniżej wpisuje do niej sam. Kod zdarzenia GLS ma postać „3.124”; Elbuz bierze liczbę przed kropką — „3”.

    Gdzie: podłączenie GLS → „Ustawienia powiadomień” → „Statusy dostawy”, kolumna „Kod (nazwa) na stronie (API)”. Kilka kodów — po przecinku.

    Twój status dostawyKod GLSCo oznacza
    „Oczekiwanie od nadawcy”0dane paczki są w GLS, paczka przekazana lub jeszcze nie
    „W drodze”1, 2wyjechała z sortowni, dotarła do oddziału lub do ParcelShop
    „Wydany kurierowi”11zostanie doręczona dziś
    „Dostarczono”3doręczona; Elbuz przestaje pytać GLS
    „Odrzucenie”5zwrócona do nadawcy

    Kod 4 to „niedoręczona” z różnych przyczyn: odbiorcy nie było, odmówił zapłaty pobrania. Nigdzie go nie wpisuj: takie paczki będą miały stan „Nieznany” w filtrze „Problemy” i ich nie przeoczysz.

    Kod 3 GLS ustawia także wtedy, gdy paczka dotarła do ParcelShop (3.124). Elbuz widzi tylko „3”, więc uznaje ją za doręczoną, gdy tylko jest w punkcie. Pełna lista kodów — na developer.gls-poland.com.

    Aby status zamówienia lub płatności zmieniał się sam, tak samo wypełnij „Statusy zamówienia” i „Statusy płatności”. Zaznacz statusy zamówień w bloku „Statusy zamówień, dla których sprawdzać status przesyłki w firmie kurierskiej”. Zmiana zapisuje się w historii zamówienia: „Zmienił się status dostawy: ‹kod› ‹tekst› #‹numer›”.

    Dopóki „3” nie jest wpisane w „Dostarczono”, Elbuz pyta GLS o doręczoną paczkę przez całe 60 dni.

    Co zostaje w ADE Plus

    • Potwierdzenie nadania — lista paczek, które odbiera kurier. Elbuz go nie tworzy: paczki zostają w „Przygotowalni”, a potwierdza się je w ADE Plus. GLS nie pozwala anulować potwierdzenia.
    • Zmiana paczki — w ADE Plus; z Elbuz paczkę można tylko usunąć przed potwierdzeniem nadania i nadać od nowa.
    • Wysyłki za granicę — Elbuz nadaje paczki GLS tylko odbiorcom w Polsce.

    Przycisk „Śledź na stronie przewoźnika” w „Przesyłkach” dla GLS odpowiada „Ten przewoźnik nie ma publicznej strony śledzenia.”

    Scenariusze

    Pierwsze podłączenie

    Sytuacja. Masz umowę z GLS, a paczki do tej pory trafiały do ADE Plus ręcznie.

    Co zrobić. Poproś opiekuna w GLS o włączenie WebAPI dla Twojego loginu ADE i wydanie użytkownika Track&Trace. Wpisz oba dostępy i kody statusów, potem nadaj paczkę z pierwszego zamówienia.

    Efekt. Paczka pojawi się w „Przygotowalni” ADE Plus z numerem, a jej stan — w „Przesyłkach”.

    Klient wybrał GLS ParcelShop

    Sytuacja. Klient chce odebrać paczkę w punkcie blisko domu.

    Co zrobić. W formularzu wybierz punkt z podpowiedzi pod „GLS ParcelShop (id)” albo wpisz id z mapy GLS. Sprawdź telefon odbiorcy.

    Efekt. Paczka pojedzie do ParcelShop, a nie na adres.

    Wysyłka dnia

    Sytuacja. 20 zamówień, kurier na zamówienie.

    Co zrobić. Nadaj paczki zbiorczo i wydrukuj etykiety. Potwierdź nadanie w ADE Plus, a potem zamów kuriera na jutro do 20 paczek.

    Efekt. Kurier odbiera paczki według listy z potwierdzenia, statusy same trafiają do Elbuz.

    Co zrobić, gdy coś pójdzie nie tak

    Najczęstsze problemy
    Co widziszDlaczego tak jestCo zrobić
    „Firma kurierska nie jest podłączona: uzupełnij ustawienia API tej firmy…” w oknie listu przewozowego Nie wpisano hasła ADE albo wyłączono „Aktywność” Wpisz login i hasło ADE Plus, włącz „Aktywność” (gdzie wpisać)
    W karcie zamówienia nie ma ani „Utwórz list przewozowy”, ani „Edytuj list przewozowy” Sposób dostawy to „GLS”, a nie „GLS (PL)” Zmień sposób dostawy na „GLS (PL)”
    „Error: GLS: login/password is not configured” Nie wpisano loginu lub hasła ADE — wypełniono tylko „Token” Wypełnij „Użytkownik” i „Hasło”
    „Error:” z odmową logowania do WebAPI GLS nie włączył WebAPI dla Twojego loginu ADE Poproś opiekuna w GLS o włączenie dostępu do WebAPI (dostępy GLS)
    „Error: postcode is required for recipient” (albo name, city, street) W zamówieniu brakuje adresu lub imienia odbiorcy Wpisz je w formularzu listu przewozowego
    W „Podglądzie listu przewozowego” nie ma statusu, w „Przesyłkach” — „Nieśledzona” Statusy GLS udostępnia użytkownikowi Track&Trace, którego nie wpisano, albo hasło w „Token” jest błędne Uzyskaj użytkownika od opiekuna w GLS i wpisz login i hasło (pola podłączenia)
    Paczki GLS w „Przesyłkach” mają stan „Nieznany” Kod GLS nie jest wpisany w „Statusy dostawy” — albo to kod 4, „niedoręczona” Wpisz kody (kody statusów); kod 4 wyjaśnij z odbiorcą

    Najczęstsze pytania

    Ile kosztuje integracja z GLS?

    Elbuz nie pobiera opłat za paczki, kuriera ani statusy. Za paczki płacisz GLS według swojej umowy.

    Gdzie podać adres nadawcy dla GLS?

    W profilu panelu ADE Plus. GLS bierze go stamtąd dla każdej paczki z Elbuz.

    Dlaczego paczka z Elbuz leży w „Przygotowalni”?

    Tak to działa: Elbuz tworzy paczkę i etykietę, a listę dla kuriera potwierdzasz w ADE Plus (potwierdzenie nadania).

    Po co pole „Token”, skoro wpisuję login i hasło?

    W „Token” wpisuje się hasło użytkownika Track&Trace — osobnego dostępu do statusów. Login i hasło ADE Plus idą do „Użytkownik” i „Hasło”.

    Czy mogę wysłać GLS za granicę?

    Nie: w paczce z Elbuz odbiorca jest zawsze w Polsce. Wysyłki międzynarodowe nadawaj w ADE Plus.

    Dlaczego status w Elbuz jest opóźniony względem GLS?

    Elbuz pyta GLS co 10 minut i bierze do 100 paczek na przebieg. Bieżący status pokazuje „Podgląd listu przewozowego”.

    Gdzie to jest i kto ma dostęp

    Menu
    Panel klienta → Ustawienia systemu → Inne ustawienia → Usługi zewnętrzne i integracje → Dostawa
    Inne wejścia
    Słowniki → Dokumenty → Przesyłki → „Przewoźnicy”; karta zamówienia → sekcja „Dostawa”
    Uprawnienia
    podłączenie — „API i tokeny dostępu”; paczka i kurier — okno „Tworzenie listu przewozowego”; statusy — „Przesyłki”
    Przygotuj
    umowę z GLS Poland, login ADE Plus z dostępem do WebAPI, użytkownika Track&Trace API

    Paczkę i kuriera można zamówić tylko do zamówienia, które użytkownik widzi zgodnie z ustawieniem „Czyje dane”.

    1. Uzyskaj dostęp do WebAPI i Track&TraceOpiekun w GLS
    2. Wpisz login ADE i użytkownika Track&TraceUsługi zewnętrzne i integracje → GLS
    3. Wpisz kody statusów GLSTamże, „Ustawienia powiadomień”
    4. Nadaj paczkęKarta zamówienia, sekcja „Dostawa”
    5. W razie potrzeby usuń paczkę„Podgląd listu przewozowego” lub „Przesyłki”
    6. Potwierdź nadanieADE Plus

    Powiązane tematy

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo