Zum Inhalt

Label erstellen

Hier erfahren Sie, wie Sie Versandlabels mit dem GLS Connector erstellen, in Bulk verarbeiten, stornieren und den Tagesabschluss durchführen.

Einzelnes Label erstellen

Schritt 1: Neues Versandlabel anlegen

  1. Öffnen Sie das merchantCENTRAL Dashboard
  2. Klicken Sie auf Versandlabel erstellen (oder öffnen Sie die Versandlabel-Liste)
  3. Wählen Sie GLS als Versanddienstleister
  4. Das Standard-Produkt und Gewicht aus dem GLS-Setup werden automatisch vorausgefüllt

Schritt 2: Empfängeradresse eingeben

Füllen Sie die Empfängerdaten vollständig aus:

Feld Pflicht Beispiel
Ship-to Name ✅ Max Mustermann
Ship-to Post Code ✅ 80331
Ship-to City ✅ München
Ship-to Country Code ✅ DE
Ship-to Address ✅ Marienplatz 1
Ship-to Email Empfohlen max@example.com
Ship-to Phone Empfohlen +49 89 123456

Straße und Hausnummer

GLS erwartet die Straße inklusive Hausnummer in einem Feld. Der Connector übernimmt die Adresse, wie sie im Versandlabel steht.

Schritt 3: Paketdaten eingeben

Feld Pflicht Beschreibung Beispiel
Weight ✅ Gewicht in Gramm (Hub-Standard) 2500 (= 2,5 kg)
Reference No. Empfohlen Auftragsnummer oder Referenz VK-2024-00123

Gewichtsumrechnung

Der Hub speichert das Gewicht in Gramm. Der GLS Connector rechnet automatisch in Kilogramm um (÷ 1000). Beispiel: 2500 g → 2,500 kg.

Referenznummer

Die Referenznummer wird auf dem GLS-Label gedruckt und erleichtert die Zuordnung von Sendung zu Auftrag. Es wird automatisch die Referenznummer, dann die Verkaufsauftragsnummer, dann die Entry No. als Fallback verwendet.

Schritt 4: Label erstellen

Klicken Sie auf Label erstellen. Der Connector:

  1. Validiert alle Pflichtfelder (lokal, nicht über GLS-API)
  2. Baut den JSON-Request für die GLS ShipIT API
  3. Sendet den Request an POST /shipments
  4. Empfängt das Label (Base64-kodiert) und die Track-ID
  5. Speichert das Label als PDF/PNG/ZPL und die Tracking-Nummer

Schritt 5: Label drucken

Nach der Erstellung ist das Label als PDF, PNG oder ZPL verfügbar. Drucken Sie es und kleben Sie es auf das Paket.

Bulk-Labels erstellen

Sie können mehrere Labels in einem Rutsch verarbeiten.

Ablauf

  1. Wählen Sie mehrere Versandlabels in der Liste aus
  2. Klicken Sie auf Bulk-Label erstellen
  3. Der Connector verarbeitet jedes Label einzeln und sequenziell
  4. Erfolgreiche Labels erhalten den Status Created, fehlerhafte werden mit der Fehlermeldung markiert

Kein Batch-API bei GLS

Anders als z. B. DHL bietet die GLS API keine Batch-Erstellung. Bulk-Labels werden intern als Einzelaufrufe nacheinander verarbeitet. Das bedeutet, die Verarbeitung dauert proportional zur Anzahl der Labels.

Fortschritt

Während der Bulk-Verarbeitung zeigt ein Progress-Dialog den aktuellen Stand:

GLS - Bulk Label Creation
Status:   Processing labels...
Progress: [████████████░░░░░░░░░░░░░] 48%
Records:  12 of 25

Sendung stornieren

Labels können storniert werden, solange GLS das Paket noch nicht übernommen hat.

Ablauf

  1. Öffnen Sie das Versandlabel, das Sie stornieren möchten
  2. Klicken Sie auf Sendung stornieren (oder Void)
  3. Der Connector sendet einen Stornierungsaufruf an POST /shipments/cancel/{trackID}
  4. Bei Erfolg wird der Label-Status auf Cancelled gesetzt

Zeitfenster beachten

Die Stornierung ist nur möglich, bevor GLS das Paket physisch gescannt hat. Nach der Abholung durch den GLS-Fahrer ist keine Stornierung über die API mehr möglich.

Tagesabschluss (Manifest / End of Day)

Der Tagesabschluss ist ein Pflichtschritt bei GLS. Er schließt alle offenen Sendungen eines Tages ab und erzeugt ein Manifest-Dokument (PDF), das dem GLS-Fahrer bei der Abholung übergeben wird.

Ablauf

  1. Stellen Sie sicher, dass alle Sendungen des Tages erstellt sind
  2. Klicken Sie auf Tagesabschluss (oder Manifest)
  3. Der Connector sendet einen Aufruf an POST /shipments/endofday?date=YYYY-MM-DD
  4. GLS liefert ein Manifest-PDF zurück, das automatisch gespeichert wird
  5. Drucken Sie das Manifest und übergeben Sie es dem GLS-Fahrer

Tagesabschluss ist Pflicht

GLS erwartet, dass Sie den Tagesabschluss täglich durchführen, bevor der Fahrer die Pakete abholt. Ohne Tagesabschluss kann es zu Problemen bei der Abholung kommen.

Manifest-Dokument

Das Manifest enthält:

  • Übersicht aller Sendungen des Tages
  • Absender- und Empfängerinformationen
  • Track-IDs und Paketanzahl
  • Barcode für die GLS-Scannung

Sendungsverfolgung (Tracking)

Der GLS Connector unterstützt die Sendungsverfolgung direkt in Business Central.

Tracking-URL

Jedes erstellte Label erhält automatisch eine Tracking-URL im Format:

https://gls-group.eu/DE/de/paketverfolgung?match={TrackID}

Tracking-Status abrufen

Der Connector kann den aktuellen Status einer Sendung über die GLS Tracking API abrufen:

  • Status: Aktueller Sendungstatus (z. B. InProgress, Delivered)
  • History: Chronologische Liste aller Scanereignisse

Validierung

Der GLS Connector validiert alle Pflichtfelder lokal, bevor er den API-Aufruf macht. GLS bietet keinen separaten Validierungs-Endpoint.

Pflichtfeld-Prüfungen

Prüfung Fehlermeldung
Basic Auth fehlt Missing GLS API credentials
Contact ID fehlt Contact ID is required
Absendername fehlt Shipper Name 1 is required
Empfänger Name fehlt Ship-to Name is required
Empfänger PLZ fehlt Ship-to Post Code is required
Empfänger Ort fehlt Ship-to City is required
Empfänger Land fehlt Ship-to Country Code is required
Gewicht ≤ 0 und kein Default Weight must be greater than 0

Service-spezifische Prüfungen

Service Prüfung
ShopDelivery ParcelShop ID muss angegeben sein
Cash on Delivery Cash Amount muss > 0 sein
AddonLiability Liability Amount muss > 0 sein
Customs Items Description und Quantity sind Pflicht pro Position

Allowed Services abfragen

Bevor Sie ein Label erstellen, können Sie prüfen, welche GLS-Services für eine bestimmte Route verfügbar sind:

  1. Füllen Sie die Empfängeradresse aus
  2. Der Connector fragt den AllowedServices-Endpoint ab
  3. Die Antwort zeigt, welche Services (PARCEL, EXPRESS, FREIGHT, VAS) für dieses Zielland verfügbar sind

Verbindungstest

Der AllowedServices-Endpoint wird auch für den Verbindungstest verwendet, da GLS keinen dedizierten Health-Check anbietet.

Häufige Fragen

Kann ich ein Label erneut herunterladen?

Nein. GLS liefert das Label nur einmalig beim CreateParcels-Aufruf. Es kann nach der Erstellung nicht erneut von der GLS API abgerufen werden. Das Label wird jedoch in Business Central gespeichert und kann von dort jederzeit gedruckt werden.

Was passiert bei einem Fehler während der Bulk-Erstellung?

Fehlerhafte Labels erhalten den Status Error mit der GLS-Fehlermeldung. Alle anderen Labels werden normal verarbeitet — ein einzelner Fehler stoppt nicht die gesamte Bulk-Verarbeitung.

Wie viele Labels kann ich pro Tag erstellen?

Es gibt kein technisches Limit seitens des Connectors. Die GLS API hat jedoch Rate Limits, die bei sehr hohem Volumen greifen können. Die Anzahl der heute erstellten Labels wird im Status-Bereich des Setups angezeigt.

Muss ich den Tagesabschluss machen?

Ja, der Tagesabschluss ist bei GLS Standard. Er erzeugt das Manifest-Dokument, das der GLS-Fahrer bei der Abholung benötigt. Wenn Sie den Tagesabschluss vergessen, kann es zu Problemen bei der Abholung kommen.

Was ist der Unterschied zwischen Stornierung und Tagesabschluss?
  • Stornierung = Ein einzelnes Label/Paket wird annulliert
  • Tagesabschluss = Alle offenen Sendungen werden abgeschlossen und als „bereit zur Abholung" markiert