Integracja GLS pozwala tworzyć przesyłki i pobierać etykiety dla zamówień obsługiwanych w xSale. Poniżej opisujemy połączenie konta GLS, ustawienia domyślne oraz sprawdzenie konfiguracji przed nadaniem.
W tym artykule znajdziesz
- Gdzie rozpocząć konfigurację
- Jak połączyć konto GLS
- Jak ustawić parametry przesyłek
- Jak skonfigurować pobranie
- Jak zapisać ustawienia i sprawdzić status
- Co sprawdzić po konfiguracji
Gdzie rozpocząć konfigurację?
Przejdź do Integracje. Wśród dostępnych integracji kurierskich odszukaj kafelek GLS i otwórz kreator. Jeśli konto jest już dodane, jego ustawienia otworzysz w sekcji Twoje integracje.

Jak połączyć konto GLS?
Dane wymagane do połączenia
W kroku Połączenie z kontem GLS uzupełnij:
- Nazwa integracji (wewnętrzna) – własna nazwa konta, po której rozpoznasz je w xSale. Wybierz nazwę inną niż dla pozostałych kont tego kuriera.
- Użytkownik – login konta z dostępem do API GLS.
- Hasło – hasło dla tego konta.
Użyj własnych danych dostępowych. Wartości na zrzucie są przykładowe. Jeśli nie masz pewności, czy konto ma dostęp do API, potwierdź to z GLS.
- Uzupełnij pola i wybierz Testuj połączenie.
- Jeśli pojawi się błąd, sprawdź dane logowania i komunikat, popraw dane i ponów test.
- Po poprawnym teście kliknij Dodaj integrację, aby przejść do ustawień przesyłek.
Test sprawdza połączenie z kontem GLS. Nie nadaje przesyłki i nie zastępuje sprawdzenia danych konkretnego zamówienia.

Jak ustawić domyślne parametry przesyłek?
W polu Referencja możesz wpisać ForeignNumber, aby użyć wartości Nr obcy z zamówienia. Zachowaj dokładną pisownię. Możesz połączyć ją z inną wartością, np. DocumentNumber;ForeignNumber, bez spacji przy średniku. Jeżeli numer obcy nie jest uzupełniony, zostanie pominięty; przy samym ForeignNumber referencja będzie pusta. Zobacz zasady używania numeru obcego w referencji przesyłki.
W kroku Ustawienia domyślne dopasuj parametry do swojej obsługi przesyłek:
- Domyślna waga – waga paczki używana, gdy wyliczanie wagi jest wyłączone albo brakuje wagi zamówienia.
- Wyliczaj wagę – po wybraniu Tak xSale korzysta z łącznej wagi przekazanej z zamówienia. Przy kilku paczkach dzieli ją przez liczbę paczek i zaokrągla do dwóch miejsc po przecinku. Przy braku wagi lub wartości zero używa wagi domyślnej.
- Referencja – tekst identyfikujący przesyłkę. Możesz użyć wartości wskazanych w podpowiedzi pola, np. OrderNumber, lub własnego tekstu. Kilka wartości rozdziel średnikiem.
- Typ etykiety – wariant etykiety pobieranej z GLS. Wybierz wariant odpowiedni do sposobu drukowania.
- Dane nadawcy – dane firmy wysyłającej paczki. Do adresu nadawcy w żądaniu GLS przekazywane są nazwa, kraj, kod pocztowy, miasto i pierwsza ulica z danych nadawcy przesyłki. Nie są to dane odbiorcy z zamówienia.
Wyliczanie wagi nie uzupełnia brakujących wag produktów. Parametry konkretnej przesyłki lub procesu automatycznego mogą zmienić wartości przygotowane z ustawień domyślnych, dlatego sprawdź je przed nadaniem.
Formularz zawiera również pole Konto bankowe do paczki za pobraniem. Nie jest ono przekazywane w żądaniu utworzenia przesyłki GLS. Nie traktuj zmiany tego pola jako zmiany rachunku rozliczeniowego u przewoźnika; warunki rozliczenia pobrań ustal z GLS.

Jak skonfigurować płatności COD?
W polu Formy płatności przesyłek COD wpisz nazwy form płatności oznaczających pobranie na Twoich zamówieniach. Kilka nazw rozdziel średnikiem, np. Pobranie;Płatność przy odbiorze.
Zachowaj dokładną nazwę, w tym wielkość liter, i nie dodawaj spacji przed ani po średniku. GLS nie rozpoznaje pobrania po dowolnym fragmencie nazwy: forma płatności musi odpowiadać jednej z wpisanych wartości.
Po dopasowaniu formy płatności xSale przygotowuje przesyłkę pobraniową z kwotą równą wartości zamówienia. Przed nadaniem sprawdź ostateczną kwotę w danych przesyłki. Obsługiwane warunki rozliczenia pobrań wynikają z Twojej umowy z GLS.
Jak zapisać ustawienia i sprawdzić status?
Po uzupełnieniu ustawień domyślnych wybierz Zapisz. Aby później wrócić do konfiguracji, otwórz konto GLS w sekcji Twoje integracje.
Edytor ma zakładki Status integracji, Połączenie z kontem GLS i Ustawienia domyślne. Po zmianie danych logowania zapisz je i ponów test połączenia.
W zakładce statusu sprawdzisz informacje o błędach i ostatniej poprawnie wygenerowanej przesyłce. Poniższy zrzut pokazuje przykład Integracja wymaga uwagi, a nie oczekiwany wynik prawidłowej konfiguracji. Odczytaj komunikat i sprawdź wskazane zamówienie oraz dane przesyłki.

Co sprawdzić po konfiguracji?
- W sekcji Ustawienia → Dostawy i płatności → Sposoby dostaw przypisz konto GLS i odpowiednią usługę do sposobu dostawy.
- W integracji ze sklepem lub marketplace sprawdź mapowanie dostaw na ten sposób dostawy w xSale.
- Sprawdź dane odbiorcy: nazwę, adres, kod pocztowy, miejscowość, kraj, telefon i e-mail, a także dane nadawcy.
- Sprawdź wagę i liczbę paczek. Przy wyliczaniu wagi upewnij się, że zamówienie zawiera właściwą łączną wagę.
- Dla pobrania sprawdź nazwę formy płatności w konfiguracji i kwotę przygotowanej przesyłki.
Jeśli generowanie etykiety zakończy się błędem, odczytaj komunikat, popraw wskazane dane i ponów próbę. Gdy przyczyna nie jest jasna, przekaż do wsparcia xSale numer zamówienia i komunikat błędu, bez hasła do konta GLS.
Instrukcje powiązane: Dodawanie sposobu dostawy i Mapowania dostaw.

EN