Wichtig
GLS stellt die bisherige Shipments WebAPI zum 31.12.2026 ein. Die Nachfolgerin ist die ShipIT-Farm API, die mehr Stabilität, vollen Service-Support und Sicherheit per OAuth2 bietet. Damit du GLS auch danach aus Xentral heraus nutzen kannst, brauchst du Zugangsdaten für die ShipIT-Farm API.
Anmerkung
Stand: 11/2026
Aktuell kannst du in der GLS-Integration nur deine App-Zugangsdaten von GLS hinterlegen. Weitere Informationen zur Nutzung der Versandart und zur Umstellung folgen.
Mit der GLS-Integration verbindest du Xentral mit der ShipIT-Farm API von GLS. Dafür legst du im GLS Developer Portal eine App an, lässt sie von GLS freischalten und hinterlegst die Zugangsdaten anschließend in Xentral.
-
Du arbeitest als Geschäftskunde mit GLS zusammen.
-
Du kennst deine GLS Contact-ID. Sie steht in deinen GLS-Vertragsunterlagen.
Die Zugangsdaten für die ShipIT-Farm API stellt GLS aus, direkt an dich. Xentral kann sie nicht für dich beantragen. Du legst dafür im GLS Developer Portal eine App an und lässt sie vom GLS-IT-Kundensupport freischalten. Die Oberfläche des Portals ist auf Englisch.
Tipp
Video-Tutorial: Zugangsdaten für die GLS-Integration anlegen
Möchtest du dir innerhalb weniger Minuten einen Überblick über das Anlegen deiner GLS-Zugangsdaten verschaffen? Dann ist unser Video-Tutorial genau das Richtige für dich. Schau es dir gleich an!
-
Rufe das GLS Developer Portal unter dev-portal.gls-group.net auf und registriere dich oder melde dich an.
-
Klicke oben rechts auf deine E-Mail-Adresse und dann auf My Apps.
-
Klicke auf + new app und gib im Formular New App einen Namen ein, z. B. deinen Firmennamen.
-
Klicke bei den folgenden Schnittstellen jeweils auf Enable bzw. Request:
-
Authentication API v2
-
ShipIT-Farm API v1
-
Customs API v3
-
-
Klicke auf Save.
-
Öffne in My Apps die Details deiner App und notiere die App ID.
-
Schreibe eine E-Mail an it-kundensupport@gls-germany.com und bitte um die Freischaltung der ShipIT-Farm API und der Customs API. Gib dabei die E-Mail-Adresse aus dem Portal und die App ID an.
GLS informiert dich, sobald die App freigeschaltet ist.
Du kannst für die E-Mail den folgenden Mustertext verwenden:
Betreff: Freischaltung ShipIT-Farm API und Customs API
Hallo GLS-IT-Kundensupport,
bitte schaltet für meine App im GLS Developer Portal die ShipIT-Farm API und die Customs API frei. Ich möchte damit meine GLS-Versandlabels aus Xentral erstellen.
E-Mail-Adresse im GLS Developer Portal: [deine E-Mail-Adresse]
App ID: [deine App ID]
Firma: [dein Firmenname]Sobald du API Key und API Secret von GLS hast, legst du in Xentral die Integration GLS an. Ein Assistent führt dich in drei Schritten durch die Einrichtung: Zugangsdaten, Details und Überprüfen.
Wichtig
Lege nur eine Integration GLS an. Sie ist aktuell nur für die Zugangsdaten gedacht.
-
Navigiere zu Einstellungen > Integrationen und klicke auf Neue Integration.
-
Gib auf der Seite Integrationen im Feld Suche „GLS“ ein.
-
Je nachdem, ob GLS in deinem System schon installiert ist, hast du zwei Möglichkeiten:
-
GLS ist noch nicht installiert: Klicke auf die Karte GLS (Versanddienstleister, Kostenlos, von Xentral) und dann auf Installieren.
-
GLS ist installiert (Bereich Installiert): Klicke auf die Karte GLS.
Xentral öffnet den Assistenten Neue GLS-Integration erstellen.
-
Allgemeine Informationen zum Katalog und zur Installation findest du im Artikel Neue Integration hinzufügen.
Im ersten Schritt trägst du die Zugangsdaten ein, die du von GLS erhalten hast.
-
Nimm die Einstellungen anhand der folgenden Tabelle vor.
-
Klicke auf Verbindung testen.
-
Sobald Xentral Verbindung erfolgreich. anzeigt, klicke auf Weiter.
Feldbezeichnung |
Beschreibung |
|---|---|
|
Umgebung |
Wähle Produktion. Die Umgebung Sandbox nutzt du nur mit einer Test-App von GLS. |
|
API Key |
Füge den API Key deiner App aus dem GLS Developer Portal ein. |
|
API Secret |
Füge das API Secret deiner App aus dem GLS Developer Portal ein. |
|
Contact-ID |
Gib deine GLS Contact-ID ein. Xentral übergibt sie bei jeder Sendung an GLS. |
-
Gib im Feld Name einen eindeutigen Namen ein, unter dem du die Integration in der Übersicht wiederfindest, z. B. „GLS“.
-
Klicke auf Weiter.
In deinen GLS-Vertragsunterlagen oder bei deinem GLS-Kundenbetreuer. Hast du bisher die Versandart GLS (API) genutzt, ist es in der Regel die dort hinterlegte GLS Contact ID. Trage nur die Contact-ID ein, nicht die GLS Customer ID. Lehnt GLS die Contact-ID ab, frag bei GLS nach, ob sie für deine App freigeschaltet ist.
Prüfe die folgenden Punkte:
-
API Key, API Secret und Contact-ID sind vollständig und ohne Leerzeichen eingefügt.
-
Im Feld Umgebung ist Produktion gewählt.
-
GLS hat deine App freigeschaltet.
Navigiere zu Einstellungen > Integrationen und öffne per Klick auf das Zahnrad deine GLS-Integration. Trage im Bereich Zugangsdaten die neuen Werte ein, klicke auf Verbindung testen und anschließend auf Zugangsdaten speichern.
-
GLS Developer Portal, Registrierung und Freischaltung: Der GLS-IT-Kundensupport unter it-kundensupport@gls-germany.com.
-
Einrichtung in Xentral: Der Xentral Support.