Zum Inhalt springen

GLS Spain API

Globe Pickup Points lässt sich mit GLS Spain (GLS Spain y Portugal) verbinden. Mit dieser Integration können Sie:

  • Bestellungen direkt aus Shopify an GLS Spain exportieren
  • Versandlabels direkt in Shopify drucken
  • An GLS ParcelShops und Paketautomaten in Spanien und Portugal oder an die Adresse des Kunden liefern
  • Mit EuroBusinessParcel in die anderen EU-Länder versenden
  • Nachnahmepakete (COD) an Adressen in Spanien und Portugal versenden

Diese Integration richtet sich an Händler mit einem GLS-Spain-Vertrag. GLS-Konten in Mitteleuropa nutzen die Integration MyGLS API.


  1. Öffnen Sie in Ihrer Shopify-Verwaltung Globe Pickup Points und navigieren Sie zu Versandetiketten. Klicken Sie auf Spediteurintegration hinzufügen und wählen Sie GLS Spain.
  2. Geben Sie Ihre UID cliente ein: die 36-stellige UID, die Ihre GLS-Agentur für den Webservice-Zugang ausstellt, im Format 1A2B3C4D-1A2B-1A2B-1A2B-1A2B3C4D5E6F. Fragen Sie Ihre GLS-Spain-Agentur danach.
  3. Die Absenderfelder sind optional: Firmenname des Absenders, Straße des Absenders, PLZ des Absenders, Stadt des Absenders, Telefon des Absenders und E-Mail des Absenders. Bleiben sie leer, druckt GLS die Absenderadresse, die zu Ihrer UID hinterlegt ist. Um eine andere Adresse zu drucken, zum Beispiel die Ihres Lagers, füllen Sie Name, Straße, Postleitzahl und Ort aus. Die Postleitzahl muss spanisch (fünf Ziffern) oder portugiesisch (NNNN-NNN) sein.
  4. Konfigurieren Sie nach Bedarf die Fulfillment- und Tagging-Optionen (Bestellungen automatisch erfüllen, Bestellungen automatisch mit Sendungsverfolgungsnummer markieren, Benutzerdefiniertes Tag nach dem Export). Das Standardgewicht (kg) unter Erweiterte Einstellungen wird für Bestellungen ohne Gewicht verwendet.
  5. Ordnen Sie Ihre Shopify-Versandmethoden den Servicetypen von GLS Spain zu. Für Abholpunkt-Versandmethoden verwenden Sie GLS (ParcelShop if selected, otherwise address) oder GLS ParcelShop.

Sie können Bestellungen direkt aus Shopify an GLS Spain exportieren und Versandlabels drucken, einzeln oder im Stapel. Den allgemeinen Workflow finden Sie unter Versandlabels erstellen.

Jedes Label entspricht einer Sendung bei GLS Spain mit einem Paket bis 40 kg. Der Name der Shopify-Bestellung ist die Sendungsreferenz und wird als Ref.Cli. auf das Label gedruckt. Die Referenz fasst 15 Zeichen. Bei einem längeren Bestellnamen bleiben die letzten 15 Zeichen erhalten.

Kann Globe nicht feststellen, ob GLS Spain eine Sendung erstellt hat, zum Beispiel weil GLS Spain nicht rechtzeitig geantwortet hat, bittet Sie die Fehlermeldung, das Kundenportal von GLS Spain (MyGLS) zu prüfen, bevor Sie das Label erneut erstellen. Globe hält dann vor der nächsten Bestellung des Stapels an. Die Bestellungen, die Globe nicht gesendet hat, können Sie gefahrlos erneut exportieren.


Wählen Sie den Servicetyp beim Export einer Bestellung oder ordnen Sie ihn einer Versandmethode zu:

ServicetypFunktion
GLS (ParcelShop if selected, otherwise address)Liefert an den GLS ParcelShop oder Paketautomaten, den der Kunde gewählt hat. Ohne Punkt liefert er an die Adresse des Kunden: BusinessParcel in Spanien und Portugal, EuroBusinessParcel in die anderen EU-Länder.
GLS (address)Liefert an die Adresse des Kunden, auch wenn die Bestellung einen Abholpunkt hat: BusinessParcel in Spanien und Portugal, EuroBusinessParcel in die anderen EU-Länder.
GLS EconomyParcel (address)EconomyParcel an die Adresse des Kunden, nur in Spanien und Portugal.
GLS Express 14:00 (address)Express 14:00 an die Adresse des Kunden, nur in Spanien und Portugal.
GLS ParcelShopLiefert an den GLS ParcelShop oder Paketautomaten, den der Kunde gewählt hat. Eine Bestellung ohne Punkt wird abgelehnt.

EconomyParcel und Express 14:00 funktionieren nur, wenn Ihr GLS-Vertrag sie enthält. GLS lehnt eine Sendung mit einem Service ab, den Ihre Agentur für Ihre UID cliente nicht freigeschaltet hat.


In Spanien und Portugal zeigt der Abholpunkt-Anbieter GLS im Checkout nur die ParcelShops und Paketautomaten aus der eigenen Liste von GLS Spain, und jeder davon trägt den ParcelShop-Code von GLS Spain.

Wenn eine Bestellung an den GLS ParcelShop oder Paketautomaten geht, den der Kunde gewählt hat:

  • Globe übermittelt den eigenen ParcelShop-Code von GLS Spain und die Adresse des ParcelShops, mit Name, Telefonnummer und E-Mail-Adresse des Kunden.
  • Der ParcelShop muss in Spanien oder Portugal liegen, im selben Land wie die Lieferadresse.
  • Ein Abholpunkt aus einem anderen Netz wird abgelehnt und nie an die Adresse versendet. Wählen Sie mit der Aktion Abholpunkt ändern einen GLS ParcelShop oder wählen Sie GLS (address), um an die Adresse des Kunden zu versenden.
  • Ein ParcelShop, den GLS Spain nicht mehr führt oder als geschlossen führt, wird abgelehnt. Wählen Sie mit der Aktion Abholpunkt ändern einen anderen ParcelShop.

Wenn Sie Labels für GLS Spain in einer anderen App erstellen, braucht diese App den ParcelShop-Code von GLS Spain. Die Abholpunkt-ID eines GLS-Punkts ({{ point.id }}) ist die ParcelShop-ID der GLS Group, die die Systeme von GLS Spain nicht verwenden. Fügen Sie den Code von GLS Spain als Bestellattribut zur Bestellung hinzu:

ParcelShopCode: {{ point.special.glsEsCode }}

Der Code ist bei Punkten des Abholpunkt-Anbieters GLS in Spanien und Portugal gesetzt, nicht bei Punkten von GLS (as used in MyGLS portal). Wie Sie Attribute konfigurieren, lesen Sie unter Bestellattribute.


GLS Spain zieht Nachnahmen an einer Adresse in Spanien oder Portugal ein, nur in EUR. Globe übermittelt den Nachnahmebetrag der Bestellung mit der Sendung.

  • An einem ParcelShop zieht GLS keine Nachnahme ein. Setzen Sie den Nachnahmebetrag auf 0 oder wählen Sie GLS (address), um an die Adresse des Kunden zu versenden.
  • EuroBusinessParcel in die anderen EU-Länder bietet keine Nachnahme. Setzen Sie den Nachnahmebetrag auf 0 oder versenden Sie die Bestellung mit einem anderen Spediteur.
  • Eine Bestellung mit einem Nachnahmebetrag in einer anderen Währung als EUR wird abgelehnt.

In die anderen EU-Länder versendet GLS Spain mit EuroBusinessParcel: Österreich, Belgien, Bulgarien, Kroatien, Zypern, Tschechien, Dänemark, Estland, Finnland, Frankreich, Deutschland, Griechenland, Ungarn, Irland, Italien, Lettland, Litauen, Luxemburg, Malta, die Niederlande, Polen, Rumänien, die Slowakei, Slowenien und Schweden. GLS (address) und GLS (ParcelShop if selected, otherwise address) verwenden beide diesen Dienst für diese Länder.

  • Die Bestellung braucht die E-Mail-Adresse und die Telefonnummer des Kunden.
  • Ein Paket pro Sendung, bis 40 kg.
  • Keine Nachnahme.
  • Keine Zustellung an ParcelShops: Eine Bestellung mit einem GLS ParcelShop außerhalb von Spanien und Portugal wird abgelehnt. Wählen Sie GLS (address), um sie an die Adresse des Kunden zu versenden.
  • EconomyParcel und Express 14:00 gehen nicht ins Ausland.

Ziele außerhalb der EU werden abgelehnt.


GLS Spain liefert jedes Label als PDF-Seite mit 92 × 143 mm. Die folgenden Formate stehen zur Verfügung:

FormatPositionen pro Bogen
Label printer, 10x15 cm (A6)1
A6 on A44

Beim Druck von A6-Labels auf A4 können Sie die Startposition auf dem Bogen wählen (Positionen 1 bis 4), um teilweise verbrauchte Bögen weiterzuverwenden.

Globe ruft das Label bei jedem Druck bei GLS Spain ab. GLS gibt ein Label nur heraus, solange sich das Paket bei GLS befindet, also nicht mehr nach der Zustellung. Gibt GLS das Label einer der ausgewählten Sendungen nicht heraus, druckt Globe keines davon und nennt die fehlende Sendung.


Jede Sendung erhält eine Sendungsnummer und einen Tracking-Link. Ist Bestellungen automatisch erfüllen aktiv, fügt Globe beides dem Shopify-Fulfillment hinzu, mit GLS als Spediteur.

  • Spanien: Die Sendungsnummer ist der 14-stellige Barcode von GLS Spain, und der Link öffnet das Paket auf der Sendungsverfolgungsseite von GLS Spain.
  • Portugal und die anderen EU-Länder: Die Sendungsnummer ist die GLS TrackID, und der Link öffnet die GLS-Sendungsverfolgungsseite (https://gls-group.eu/track/<TrackID>), die auf die GLS-Seite des Ziellands weiterleitet.

ProblemLösung
GLS Spain kennt die UID cliente nichtKlären Sie die UID cliente mit Ihrer GLS-Agentur. Es handelt sich um die 36-stellige UID, die die Agentur für den Webservice-Zugang ausstellt. Globe hält den Stapel an dieser Stelle an. Die übrigen Bestellungen wurden nicht gesendet.
Die Einstellungen von GLS Spain sind unvollständigTragen Sie die UID cliente im Format von GLS ein (36 Zeichen). Wenn Sie den Absender teilweise ausgefüllt haben, ergänzen Sie Name, Straße, Postleitzahl und Ort, oder leeren Sie die Absenderfelder.
Der Abholpunkt ist kein GLS ParcelShop, oder „Wrong carrier for this order“Wählen Sie mit der Aktion Abholpunkt ändern einen GLS ParcelShop oder wählen Sie GLS (address), um an die Adresse des Kunden zu versenden.
GLS Spain führt den ParcelShop nicht oder führt ihn als geschlossenWählen Sie mit der Aktion Abholpunkt ändern einen anderen GLS ParcelShop oder wählen Sie GLS (address), um an die Adresse des Kunden zu versenden.
GLS zieht an einem ParcelShop keine Nachnahme einSetzen Sie den Nachnahmebetrag auf 0 oder wählen Sie GLS (address), um an die Adresse des Kunden zu versenden.
EuroBusinessParcel braucht die E-Mail-Adresse und die Telefonnummer des KundenErgänzen Sie die fehlende E-Mail-Adresse oder Telefonnummer in der Bestellung und erstellen Sie das Label erneut.
GLS braucht die spanische Postleitzahl mit fünf Ziffern oder die portugiesische im Format NNNN-NNNKorrigieren Sie die Postleitzahl in der Lieferadresse. Dieselben Formate gelten für PLZ des Absenders.
GLS nimmt Pakete bis 40 kg anIst das Gewicht der Bestellung falsch, korrigieren Sie es im Label-Panel. Andernfalls versenden Sie die Bestellung mit einem anderen Spediteur.
Ihre GLS-Agentur hat diesen Service für Ihre UID nicht freigeschaltet (Code -53)Bitten Sie Ihre GLS-Agentur, den Service freizuschalten, oder wählen Sie einen Servicetyp, den Ihr Vertrag enthält.
GLS Spain hat das Label nicht herausgegebenVersuchen Sie es in einer Minute erneut oder drucken Sie das Label im Kundenportal von GLS Spain (MyGLS). GLS gibt Labels nur heraus, solange sich das Paket bei GLS befindet.
GLS Spain hat die Sendung nicht bestätigtDie Sendung existiert möglicherweise. Prüfen Sie das Kundenportal von GLS Spain (MyGLS), bevor Sie das Label erneut erstellen.