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.
Voraussetzungen
Du arbeitest als Geschäftskunde mit GLS zusammen.
Du kennst deine GLS Contact-ID. Sie steht in deinen GLS-Vertragsunterlagen.
Zugangsdaten bei GLS anlegen
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!
App im GLS Developer Portal anlegen
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.
Freischaltung bei GLS anfordern
Öffne in My Apps die Details deiner App und notiere die App ID.
Schreibe eine E-Mail an [email protected] 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]
API Key und API Secret abrufen
Öffne nach der Freischaltung in My Apps die Details deiner App.
Kopiere im Bereich API Keys den Key.
Klicke auf Show secret und kopiere das Secret.
Achtung
Behandle API Key und API Secret wie ein Passwort und gib sie nicht an Dritte weiter.
Zugangsdaten in Xentral hinterlegen
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.
GLS installieren und den Assistenten starten
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.
Schritt 1: Zugangsdaten
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. |
Schritt 2: Details
Gib im Feld Name einen eindeutigen Namen ein, unter dem du die Integration in der Übersicht wiederfindest, z. B. „GLS“.
Klicke auf Weiter.
Schritt 3: Überprüfen
Prüfe die Zusammenfassung. Bei Bedarf passt du den Namen per Klick auf Ändern an.
Klicke auf Integration erstellen.
Xentral legt die Integration an und zeigt sie unter Einstellungen > Integrationen an.
Häufige Fragen
Wo finde ich meine Contact-ID?
Wo finde ich meine Contact-ID?
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.
Der Verbindungstest schlägt fehl. Was kann ich tun?
Der Verbindungstest schlägt fehl. Was kann ich tun?
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.
Ich habe API Key und API Secret bei GLS erneuert. Was muss ich in Xentral tun?
Ich habe API Key und API Secret bei GLS erneuert. Was muss ich in Xentral tun?
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.
Wer hilft mir weiter?
Wer hilft mir weiter?
GLS Developer Portal, Registrierung und Freischaltung: Der GLS-IT-Kundensupport unter [email protected].
Einrichtung in Xentral: Der Xentral Support.
