Ersteinrichtung

Diese Anleitung führt Sie Schritt für Schritt durch die Einrichtung des GLS Connectors in Business Central.

Voraussetzungen

Bevor Sie beginnen, benötigen Sie:

[ ] GLS Geschäftskunden-Vertrag mit API-Zugang (ShipIT)
[ ] Username und Passwort für die GLS ShipIT API
[ ] Contact ID (wird bei der GLS-Registrierung vergeben)
[ ] Absenderadresse für die Versandlabels

GLS ShipIT API-Zugang

Den API-Zugang erhalten Sie über Ihren GLS-Ansprechpartner. Die Zugangsdaten bestehen aus einem Benutzernamen und einem Passwort für HTTP Basic Authentication — kein API-Key oder OAuth.

Schritt 1: Setup-Seite öffnen

Es gibt zwei Wege:

Weg A — Über die Suche:

Drücken Sie ++alt+q++ oder klicken Sie auf die Lupe in der Menüleiste
Suchen Sie nach „GLS Shipment Setup"
Öffnen Sie die Einrichtungsseite

Weg B — Über das Dashboard:

Öffnen Sie das merchantCENTRAL Dashboard
Navigieren Sie zu Versanddienstleister → GLS

Schritt 2: API-Zugangsdaten eingeben

API Base URL

Die URL wird automatisch gesetzt:

Modus	URL
Sandbox	`https://shipit-wbm-sandbox01.gls-group.eu:443/backend/rs`
Produktiv	Wird von GLS nach Freischaltung mitgeteilt

Mit Sandbox starten

Aktivieren Sie zunächst den Sandbox Mode, um die Einrichtung gefahrlos zu testen. Die Sandbox-URL wird automatisch eingetragen.

Credentials eingeben

Feld	Eingabe	Beispiel
Sandbox Mode	✅ aktivieren (für Tests)	✅
Basic Auth User	GLS API-Benutzername	`2761234567_API`
Basic Auth Password	GLS API-Passwort	`********`

Sichere Speicherung

Username und Passwort werden verschlüsselt in IsolatedStorage gespeichert — nicht als Klartext in der Datenbank. Nach der Eingabe sehen Sie nur noch ***.

Schritt 3: Contact ID eingeben

Feld	Eingabe	Beispiel
Contact ID	Ihre GLS Shipper-ID	`2761234567`

Die Contact ID ist Ihre GLS-Kundennummer und wird bei der Registrierung vergeben. Sie identifiziert Sie als Absender gegenüber GLS.

Schritt 4: Verbindung testen

Klicken Sie auf die Aktion Test Connection (oben in der Menüleiste)
Der Connector sendet eine Testanfrage an den GLS AllowedServices-Endpoint
Bei Erfolg erscheint eine Erfolgsmeldung
Bei Fehler erscheint eine Fehlermeldung mit Details

Kein Health-Endpoint

GLS bietet keinen dedizierten Health-Check-Endpoint. Der Verbindungstest nutzt stattdessen den AllowedServices-Endpoint als Proxy. Wenn dieser antwortet, ist die Verbindung aktiv.

Schritt 5: Absenderadresse konfigurieren

Füllen Sie die Absenderadresse vollständig aus. Diese wird auf jedem Label als Absender gedruckt.

Feld	Pflicht	Beispiel
Shipper Name 1	✅	`ALTENBRAND Datentechnik GmbH`
Shipper Name 2	Optional	`Abt. Versand`
Shipper Name 3	Optional
Shipper Street	✅	`Industriestraße`
Shipper Street No.	✅	`5`
Shipper ZIP Code	✅	`91126`
Shipper City	✅	`Schwabach`
Shipper Country Code	✅	`DE`
Shipper Contact Person	Empfohlen	`Max Mustermann`
Shipper Email	Empfohlen	`versand@example.com`
Shipper Phone	Empfohlen	`+49 9122 123456`

ISO-2 Ländercodes

GLS verwendet ISO alpha-2 Ländercodes (z. B. DE, AT, FR). Das ist der Standard in Business Central — Sie müssen nichts umrechnen. Aber beachten Sie: DHL verwendet ISO alpha-3 (z. B. DEU).

Schritt 6: Standardeinstellungen festlegen

Produkt

Wählen Sie das Standard-Produkt, das beim Erstellen neuer Labels vorausgewählt wird:

Produkt	Beschreibung	Max. Gewicht
GLS Parcel	BusinessParcel – der Standard für Pakete	31,5 kg
GLS Express	ExpressParcel – schnelle Zustellung	31,5 kg
GLS Freight	Stückgut – schwere/sperrige Güter	Variabel

Empfehlung

Für die meisten Anwendungsfälle ist GLS Parcel die richtige Wahl.

Gewicht

Feld	Beschreibung	Beispiel
Default Weight (kg)	Standardgewicht in Kilogramm	`1,000`

Das Standardgewicht wird verwendet, wenn beim Erstellen eines Labels kein Gewicht angegeben wird. GLS erwartet das Gewicht als Dezimalzahl in Kilogramm (z. B. 0,500 für 500 g).

Maximalgewicht

Das Maximum beträgt 31,5 kg pro Paket. Schwerere Sendungen müssen als GLS Freight (Stückgut) versendet werden.

Label-Format

Format	Beschreibung	Wann verwenden?
PDF	PDF-Datei	Standard für PC-Drucker
PNG	Bilddatei	Alternative zu PDF
Zebra (ZPL)	Zebra Programming Language	Für Zebra-Thermodrucker

Template Set (nur für ZPL)

Template	Beschreibung
None	Standard (PDF/PNG) — kein Template nötig
ZPL 200 dpi	Zebra-Template für 200 dpi Drucker
ZPL 300 dpi	Zebra-Template für 300 dpi Drucker

Template Set nur für Zebra

Das Template Set ist nur relevant, wenn Sie das Label-Format Zebra (ZPL) gewählt haben. Für PDF und PNG wird dieses Feld ignoriert.

Incoterm Code

Legen Sie den Standard-Incoterm für internationale Sendungen fest:

Code	Bedeutung
`10`	DDP — Delivered Duty Paid (Verkäufer zahlt Zoll)
`20`	DAP — Delivered at Place (Käufer zahlt Zoll)
`30`	EXW — Ex Works (Käufer trägt alle Kosten)

Schritt 7: Zoll-Einstellungen (optional)

Wenn Sie international versenden, konfigurieren Sie den Standard-Exporttyp:

Export-Typ	Code	Beschreibung
Permanent/Sale	`P`	Regulärer Warenverkauf (Standard)
Temporary	`T`	Temporäre Ausfuhr
Return	`R`	Rücksendung

Schritt 8: Tracking-URL (optional)

Die Tracking-URL-Vorlage wird automatisch eingetragen:

https://gls-group.eu/DE/de/paketverfolgung?match=%1

Das %1 wird automatisch durch die Track-ID der jeweiligen Sendung ersetzt. Sie können die URL anpassen, wenn GLS eine andere Tracking-Seite bereitstellt.

Einrichtung abgeschlossen

Ihre Setup-Seite sollte nun so aussehen:

┌─────────────────────────────────────────┐
│  GLS Shipment Setup                     │
│                                         │
│  API Credentials:                       │
│    API Base URL:      https://shipit... │
│    Sandbox Mode:      ✅                │
│    Basic Auth User:   ***               │
│    Basic Auth Pwd:    ***               │
│                                         │
│  Account:                               │
│    Contact ID:        2761234567        │
│                                         │
│  Shipper Address:                       │
│    Name 1:            ALTENBRAND D...   │
│    Street:            Industriestraße   │
│    Street No.:        5                 │
│    ZIP Code:          91126             │
│    City:              Schwabach         │
│    Country Code:      DE                │
│                                         │
│  Default Settings:                      │
│    Product:           GLS Parcel        │
│    Weight (kg):       1,000             │
│    Label Format:      PDF               │
│    Template Set:      None              │
│    Incoterm Code:     10                │
│                                         │
│  Status:                                │
│    Labels Today:      0                 │
│    Last Error:        (leer)            │
│                                         │
│  [Test Connection]                      │
└─────────────────────────────────────────┘

Checkliste

[x] API-Zugangsdaten eingegeben (Username + Passwort)
[x] Contact ID eingetragen
[x] Verbindungstest erfolgreich
[x] Absenderadresse vollständig
[x] Standard-Produkt gewählt (GLS Parcel)
[x] Standard-Gewicht gesetzt
[x] Label-Format gewählt (PDF/PNG/ZPL)
[x] Incoterm Code festgelegt (für internationale Sendungen)
[ ] Bereit für das erste Label! → Label erstellen