Przejdź do głównej zawartości

GLS Spain API

Globe Pickup Points integruje się z GLS Spain (GLS Spain y Portugal). Dzięki tej integracji możesz:

  • Eksportować zamówienia do GLS Spain bezpośrednio z Shopify
  • Drukować etykiety wysyłkowe w Shopify
  • Wysyłać do punktów GLS ParcelShop i automatów paczkowych w Hiszpanii i Portugalii albo na adres klienta
  • Wysyłać do pozostałych krajów UE usługą EuroBusinessParcel
  • Wysyłać paczki za pobraniem (COD) na adresy w Hiszpanii i Portugalii

Ta integracja jest przeznaczona dla firm z umową z GLS Spain. Konta GLS w Europie Środkowej korzystają z integracji MyGLS API.


  1. W panelu administracyjnym Shopify otwórz Globe Pickup Points i przejdź do sekcji Etykiety wysyłkowe. Kliknij Dodaj integrację przewoźnika i wybierz GLS Spain.
  2. Wprowadź UID cliente: 36-znakowy UID, który Twoja agencja GLS wydaje do dostępu do usług sieciowych, w formacie 1A2B3C4D-1A2B-1A2B-1A2B-1A2B3C4D5E6F. Poproś o niego swoją agencję GLS Spain.
  3. Pola nadawcy są opcjonalne: Nazwa firmy nadawcy, Ulica nadawcy, Kod pocztowy nadawcy, Miasto nadawcy, Telefon nadawcy i Email nadawcy. Jeśli zostawisz je puste, GLS wydrukuje adres nadawcy zapisany dla Twojego UID. Aby wydrukować inny adres, na przykład adres magazynu, wypełnij nazwę, ulicę, kod pocztowy i miasto. Kod pocztowy musi być hiszpański (pięć cyfr) lub portugalski (NNNN-NNN).
  4. Skonfiguruj opcje realizacji i tagowania według potrzeb (Automatycznie realizuj zamówienia, Automatycznie oznaczaj zamówienia numerem śledzenia, Własny tag po eksporcie). Wartość z pola Domyślna waga (kg) (sekcja Ustawienia zaawansowane) Globe stosuje do zamówień bez wagi.
  5. Przypisz metody wysyłki Shopify do typów usług GLS Spain. Dla metod wysyłki z punktem odbioru użyj GLS (ParcelShop if selected, otherwise address) lub GLS ParcelShop.

Możesz eksportować zamówienia do GLS Spain i drukować etykiety wysyłkowe bezpośrednio z Shopify, masowo lub pojedynczo. Cały proces tworzenia etykiet opisujemy w artykule Tworzenie etykiet wysyłkowych.

Każda etykieta to jedna przesyłka GLS Spain z jedną paczką do 40 kg. Numer zamówienia Shopify jest numerem referencyjnym przesyłki i widnieje na etykiecie jako Ref.Cli. Numer referencyjny może mieć do 15 znaków. Z dłuższego numeru zamówienia Globe zostawia ostatnie 15 znaków.

Gdy Globe nie wie, czy przesyłka powstała w GLS Spain, na przykład gdy GLS Spain nie odpowie na czas, komunikat błędu prosi o sprawdzenie portalu klienta GLS Spain (MyGLS) przed ponownym utworzeniem etykiety. Globe zatrzymuje się wtedy przed kolejnym zamówieniem z partii. Zamówienia, których Globe nie wysłał, można bezpiecznie wyeksportować ponownie.


Wybierz typ usługi podczas eksportu zamówienia albo przypisz go do metody wysyłki:

Typ usługiDziałanie
GLS (ParcelShop if selected, otherwise address)Doręcza do punktu GLS ParcelShop lub automatu wybranego przez klienta. Bez punktu doręcza na adres klienta: BusinessParcel w Hiszpanii i Portugalii, EuroBusinessParcel do pozostałych krajów UE.
GLS (address)Doręcza na adres klienta, także gdy zamówienie ma punkt odbioru: BusinessParcel w Hiszpanii i Portugalii, EuroBusinessParcel do pozostałych krajów UE.
GLS EconomyParcel (address)EconomyParcel na adres klienta, tylko w Hiszpanii i Portugalii.
GLS Express 14:00 (address)Express 14:00 na adres klienta, tylko w Hiszpanii i Portugalii.
GLS ParcelShopDoręcza do punktu GLS ParcelShop lub automatu wybranego przez klienta. Zamówienie bez takiego punktu jest odrzucane.

EconomyParcel i Express 14:00 działają tylko wtedy, gdy obejmuje je Twoja umowa z GLS. GLS odrzuca przesyłkę z usługą, której Twoja agencja nie włączyła dla Twojego UID cliente.


W Hiszpanii i Portugalii dostawca punktów odbioru GLS pokazuje w kasie tylko punkty ParcelShop i automaty z własnej listy GLS Spain, a każdy z nich ma kod ParcelShop nadany przez GLS Spain.

Gdy zamówienie trafia do punktu GLS ParcelShop lub automatu wybranego przez klienta:

  • Globe wysyła kod ParcelShop nadany przez GLS Spain i adres punktu, z imieniem i nazwiskiem, telefonem i e-mailem klienta.
  • Punkt ParcelShop musi znajdować się w Hiszpanii lub Portugalii, w tym samym kraju co adres wysyłki.
  • Punkt odbioru z innej sieci jest odrzucany, a Globe nigdy nie wyśle paczki zamiast tego na adres. Wybierz punkt GLS ParcelShop akcją Zmodyfikuj punkt odbioru albo wybierz GLS (address), aby wysłać paczkę na adres klienta.
  • Punkt ParcelShop, którego GLS Spain już nie ma na liście albo oznacza jako zamknięty, jest odrzucany. Wybierz inny punkt ParcelShop akcją Zmodyfikuj punkt odbioru.

Jeśli tworzysz etykiety GLS Spain w innej aplikacji, potrzebuje ona kodu ParcelShop nadanego przez GLS Spain. ID punktu odbioru GLS ({{ point.id }}) to ID ParcelShop grupy GLS, z którego systemy GLS Spain nie korzystają. Dodaj kod GLS Spain do zamówienia jako atrybut zamówienia:

ParcelShopCode: {{ point.special.glsEsCode }}

Kod jest ustawiany dla punktów dostawcy punktów odbioru GLS w Hiszpanii i Portugalii, a nie dla punktów dostawcy GLS (as used in MyGLS portal). Jak skonfigurować atrybuty, opisujemy w artykule Atrybuty zamówienia.


GLS Spain obsługuje płatność za pobraniem przy dostawie na adres w Hiszpanii lub Portugalii, tylko w EUR. Globe wysyła kwotę pobrania z zamówienia razem z przesyłką.

  • W punkcie ParcelShop GLS nie obsługuje płatności za pobraniem. Ustaw pole Kwota pobrania na 0 albo wybierz GLS (address), aby wysłać paczkę na adres klienta.
  • EuroBusinessParcel do pozostałych krajów UE nie obsługuje płatności za pobraniem. Ustaw pole Kwota pobrania na 0 albo wyślij zamówienie innym przewoźnikiem.
  • Zamówienie z kwotą pobrania w walucie innej niż EUR jest odrzucane.

Do pozostałych krajów UE GLS Spain wysyła usługą EuroBusinessParcel: Austria, Belgia, Bułgaria, Chorwacja, Cypr, Czechy, Dania, Estonia, Finlandia, Francja, Niemcy, Grecja, Węgry, Irlandia, Włochy, Łotwa, Litwa, Luksemburg, Malta, Holandia, Polska, Rumunia, Słowacja, Słowenia i Szwecja. Dla tych krajów używają jej typy GLS (address) i GLS (ParcelShop if selected, otherwise address).

  • Zamówienie wymaga adresu e-mail i numeru telefonu klienta.
  • Jedna paczka na przesyłkę, do 40 kg.
  • Bez płatności za pobraniem.
  • Bez dostawy do punktów ParcelShop: zamówienie z punktem GLS ParcelShop poza Hiszpanią i Portugalią jest odrzucane. Wybierz GLS (address), aby wysłać je na adres klienta.
  • EconomyParcel i Express 14:00 nie są dostępne za granicą.

Zamówienia do krajów spoza UE są odrzucane.


GLS Spain zwraca każdą etykietę jako stronę PDF o wymiarach 92 × 143 mm. Dostępne są następujące formaty:

FormatEtykiet na arkuszu
Label printer, 10x15 cm (A6)1
A6 on A44

Podczas drukowania etykiet A6 na A4 możesz wybrać pozycję startową na arkuszu (pozycje 1-4), aby ponownie wykorzystać częściowo zużyte arkusze.

Globe pobiera etykietę z GLS Spain przy każdym drukowaniu. GLS udostępnia etykietę tylko wtedy, gdy paczka jest jeszcze u przewoźnika, a nie po doręczeniu. Jeśli GLS nie udostępni etykiety jednej z wybranych przesyłek, Globe nie drukuje żadnej z nich i podaje brakującą przesyłkę.


Każda przesyłka dostaje numer śledzenia i link do śledzenia. Gdy opcja Automatycznie realizuj zamówienia jest włączona, Globe dodaje oba do realizacji w Shopify, z przewoźnikiem GLS.

  • Hiszpania: numerem śledzenia jest 14-cyfrowy kod kreskowy GLS Spain, a link otwiera paczkę na stronie śledzenia GLS Spain.
  • Portugalia i pozostałe kraje UE: numerem śledzenia jest GLS TrackID, a link otwiera stronę śledzenia GLS (https://gls-group.eu/track/<TrackID>), która przekierowuje na stronę GLS w kraju docelowym.

ProblemRozwiązanie
GLS Spain nie zna UID clienteSprawdź UID cliente ze swoją agencją GLS: to 36-znakowy UID, który agencja wydaje do dostępu do usług sieciowych. Globe zatrzymuje partię w tym miejscu, a pozostałe zamówienia nie zostały wysłane.
Ustawienia GLS Spain są niekompletneWprowadź UID cliente w formacie GLS (36 znaków). Jeśli dane nadawcy są wypełnione tylko częściowo, uzupełnij nazwę, ulicę, kod pocztowy i miasto albo wyczyść pola nadawcy.
Punkt odbioru nie jest punktem GLS ParcelShop albo komunikat „Wrong carrier for this order”Wybierz punkt GLS ParcelShop akcją Zmodyfikuj punkt odbioru albo wybierz GLS (address), aby wysłać paczkę na adres klienta.
GLS Spain nie ma punktu ParcelShop na liście albo oznacza go jako zamkniętyWybierz inny punkt GLS ParcelShop akcją Zmodyfikuj punkt odbioru albo wybierz GLS (address), aby wysłać paczkę na adres klienta.
GLS nie obsługuje płatności za pobraniem w punkcie ParcelShopUstaw pole Kwota pobrania na 0 albo wybierz GLS (address), aby wysłać paczkę na adres klienta.
EuroBusinessParcel wymaga adresu e-mail i numeru telefonu klientaDodaj brakujący adres e-mail lub numer telefonu do zamówienia i utwórz etykietę ponownie.
GLS wymaga hiszpańskiego kodu pocztowego z pięciu cyfr albo portugalskiego w formacie NNNN-NNNPopraw kod pocztowy w adresie wysyłki. Te same formaty obowiązują w polu Kod pocztowy nadawcy.
GLS przyjmuje paczki do 40 kgJeśli waga zamówienia jest błędna, popraw ją w panelu tworzenia etykiety. W przeciwnym razie wyślij zamówienie innym przewoźnikiem.
Twoja agencja GLS nie włączyła tej usługi dla Twojego UID (kod -53)Poproś swoją agencję GLS o włączenie usługi albo wybierz typ usługi, który obejmuje Twoja umowa.
GLS Spain nie udostępnił etykietySpróbuj ponownie za minutę albo wydrukuj etykietę w portalu klienta GLS Spain (MyGLS). GLS udostępnia etykiety tylko wtedy, gdy paczka jest jeszcze u przewoźnika.
GLS Spain nie potwierdził przesyłkiPrzesyłka może istnieć. Sprawdź portal klienta GLS Spain (MyGLS), zanim utworzysz etykietę ponownie.