Zum Inhalt

GLS Shipment Setup

Zentrale Einrichtungsseite für den GLS ShipIT REST API Connector. Hier werden API-Zugangsdaten, Absenderadresse und Standardeinstellungen für den GLS-Versand konfiguriert.

Seite öffnen

  • Über die Suche: GLS Shipment Setup
  • Über das merchantCENTRAL Dashboard → VersanddienstleisterGLS

Felder

API Credentials

Zugangsdaten für die GLS ShipIT REST API v3.2.9.

Feld Beschreibung
API Base URL Basis-URL der GLS ShipIT API
Sandbox Mode Aktiviert den Sandbox-Modus für Testumgebungen
Basic Auth User Benutzername für HTTP Basic Authentication
Basic Auth Password Passwort für HTTP Basic Authentication (maskiert)

GLS-spezifische Header

Die GLS API erwartet einen speziellen Accept-Header: application/glsVersion1+json. Dies wird automatisch vom Connector gesetzt.

Account

Feld Beschreibung
Contact ID GLS Kontakt-ID (wird bei der GLS-Registrierung vergeben)

Shipper Address

Absenderadresse für alle GLS-Sendungen.

Feld Beschreibung
Shipper Name 1 Name des Absenders (Zeile 1)
Shipper Name 2 Zusätzlicher Absendername (Zeile 2)
Shipper Name 3 Zusätzlicher Absendername (Zeile 3)
Shipper Street Straße des Absenders
Shipper Street No. Hausnummer des Absenders
Shipper ZIP Code Postleitzahl des Absenders
Shipper City Stadt des Absenders
Shipper Country Code Ländercode (ISO alpha-2, z.B. DE, AT)
Shipper Contact Person Ansprechpartner beim Absender
Shipper Email E-Mail-Adresse des Absenders
Shipper Phone Telefonnummer des Absenders

Default Settings

Standardwerte für die Label-Erstellung.

Feld Beschreibung
Default Product Standard-GLS-Produkt: PARCEL (BusinessParcel — national/EU/international), EXPRESS (ExpressParcel), FREIGHT (Stückgut)
Default Weight (kg) Standardgewicht in Kilogramm (Dezimalwert)
Default Label Format Label-Format (z.B. PDF, ZPL)
Default Template Set GLS Vorlagensatz für das Label-Design
Incoterm Code Standard-Incoterm für internationale Sendungen (z.B. DAP, DDP)

Tracking

Feld Beschreibung
Tracking URL Template URL-Vorlage für Sendungsverfolgung. Platzhalter wird durch die Track-ID ersetzt

Status

Aktuelle Statusinformationen zur GLS-Integration.

Feld Beschreibung
Last Label Created Datum und Uhrzeit des zuletzt erstellten Labels
Labels Created Today Anzahl der heute erstellten Labels (grün hervorgehoben)
Last Error Message Letzte Fehlermeldung der GLS API (rot bei Fehler)
Last Error DateTime Zeitpunkt des letzten Fehlers

Aktionen

Aktion Beschreibung
Test Connection Testet die Verbindung zur GLS ShipIT API mit den aktuellen Zugangsdaten

Hinweise

GLS Besonderheiten

  • Ländercodes: GLS verwendet ISO alpha-2 (z.B. DE) — anders als DHL, das ISO alpha-3 (z.B. DEU) nutzt
  • Gewicht: GLS erwartet Gewichte in Kilogramm (Dezimal), nicht in Gramm
  • Fehler in HTTP Headers: GLS-Fehlermeldungen werden in HTTP Response Headers zurückgegeben (message, error, args), nicht im JSON Body

Singleton-Seite

Diese Seite hat genau einen Datensatz. Beim ersten Öffnen wird der Datensatz automatisch angelegt.