Integracje

⌘K
  1. Strona główna
  2. Integracje
  3. Kurier – GLS
  4. Konfiguracja integracji kurierskiej GLS

Konfiguracja integracji kurierskiej GLS

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ę?

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.

Kafelek integracji kurierskiej GLS

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.

  1. Uzupełnij pola i wybierz Testuj połączenie.
  2. Jeśli pojawi się błąd, sprawdź dane logowania i komunikat, popraw dane i ponów test.
  3. 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.

Połączenie z kontem GLS w kreatorze integracji

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.

Ustawienia domyślne integracji 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.

Przykładowy status GLS wymagający uwagi

Co sprawdzić po konfiguracji?

  1. W sekcji Ustawienia → Dostawy i płatności → Sposoby dostaw przypisz konto GLS i odpowiednią usługę do sposobu dostawy.
  2. W integracji ze sklepem lub marketplace sprawdź mapowanie dostaw na ten sposób dostawy w xSale.
  3. Sprawdź dane odbiorcy: nazwę, adres, kod pocztowy, miejscowość, kraj, telefon i e-mail, a także dane nadawcy.
  4. Sprawdź wagę i liczbę paczek. Przy wyliczaniu wagi upewnij się, że zamówienie zawiera właściwą łączną wagę.
  5. 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.

Czego brakuje w tym artykule?