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)”.
1
Użytkownik i hasło2
Podpowiedź o adresie nadawcy3
Login GLS Track&Trace API4
Środowisko testowe (sandbox)- „Użytkownik” i „Hasło” — login i hasło do konta ADE Plus.
- Podpowiedź mówi, że adres nadawcy jest pobierany z profilu konta GLS.
- „Login GLS Track&Trace API” — hasło do niego wpisuje się w polu „Token”.
- Przełącznik „Środowisko testowe (sandbox)” do trybu testowego.
| Pole | Co 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.
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ć
1
Ulica i nr domu2
GLS ParcelShop (id)3
Opis przesyłki4
Pobranie: Pieniądze- Ulica z numerem domu trafia do GLS jako jeden wiersz.
- „GLS ParcelShop (id)” zostaje puste przy dostawie na adres.
- „Opis przesyłki” wypełnia się z pozycji zamówienia.
- Pobranie od odbiorcy ustawione na „Pieniądze”.
| Pole | Co jest od razu | Co sprawdzić |
|---|---|---|
| „Nazwisko”, „Imię” | klient z zamówienia | do GLS trafi 40 znaków |
| „Telefon”, „E-Mail” | z zamówienia | przy dostawie do ParcelShop GLS wymaga telefonu |
| „Kod pocztowy”, „Miejscowość”, „Ulica”, „Nr domu” | adres dostawy z zamówienia, „Nr domu” jest pusty | ulica 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ówieniu | id 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ów | do 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.
- W „Podglądzie listu przewozowego” sprawdź „Data odbioru”: jest jutrzejszy dzień, w piątek i weekend — poniedziałek.
- Podaj „Liczba paczek, szt.” — ile paczek odbiera kurier.
- 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.
- Potwierdź „Usunąć list przewozowy ‹numer› u przewoźnika?”.
- 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 dostawy | Kod GLS | Co oznacza |
|---|---|---|
| „Oczekiwanie od nadawcy” | 0 | dane paczki są w GLS, paczka przekazana lub jeszcze nie |
| „W drodze” | 1, 2 | wyjechała z sortowni, dotarła do oddziału lub do ParcelShop |
| „Wydany kurierowi” | 11 | zostanie doręczona dziś |
| „Dostarczono” | 3 | doręczona; Elbuz przestaje pytać GLS |
| „Odrzucenie” | 5 | zwró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›”.
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
| Co widzisz | Dlaczego tak jest | Co 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”.
- Uzyskaj dostęp do WebAPI i Track&TraceOpiekun w GLS
- Wpisz login ADE i użytkownika Track&TraceUsługi zewnętrzne i integracje → GLS
- Wpisz kody statusów GLSTamże, „Ustawienia powiadomień”
- Nadaj paczkęKarta zamówienia, sekcja „Dostawa”
- W razie potrzeby usuń paczkę„Podgląd listu przewozowego” lub „Przesyłki”
- Potwierdź nadanieADE Plus
Powiązane tematy
- Jeśli chcesz widzieć paczki wszystkich przewoźników na jednej liście — Przesyłki.
- Jeśli paczki trzeba nadać do dziesiątek zamówień — listy przewozowe zbiorczo.
- Jeśli nie masz własnej umowy z GLS — Apaczka nadaje paczki GLS na swojej.
- Jeśli wysyłasz innym przewoźnikiem — jak wystawić list przewozowy z zamówienia.
