Versandlabel erstellen
Überblick
Der Hermes Connector erstellt Versandlabels über die merchantCENTRAL-Plattform. Die Label-Erstellung wird zentral über den Hub ausgelöst — entweder manuell über die Sendungsliste oder automatisch über Job Queue Entries.
Ablauf
flowchart LR
A[Verkaufslieferung] --> B[Hub: Label anfordern]
B --> C[Hermes API: Sendung erstellen]
C --> D[Routing-Code ermitteln]
D --> E[Label-PDF/ZPL empfangen]
E --> F[Label drucken]
- Eine Verkaufslieferung (Sales Shipment) wird erstellt
- Der Hub löst die Label-Erstellung über den Shipment Provider aus
- Der Hermes Connector ruft die Hermes API auf (Order-Endpoint)
- Hermes ermittelt automatisch den Routing-Code für das Ziel
- Das Label wird als PDF oder ZPL zurückgeliefert
- Das Label kann direkt gedruckt werden
Label manuell erstellen
Über die Sendungsliste
- Öffnen Sie die merchantCENTRAL Sendungsliste
- Wählen Sie die gewünschte Lieferung aus
- Klicken Sie auf Label erstellen
- Der Hub wählt automatisch den konfigurierten Shipment Provider (Hermes)
- Das Label wird erstellt und ist zum Druck bereit
Über die Verkaufslieferung
- Öffnen Sie eine Gebuchte Verkaufslieferung
- Klicken Sie auf Versandlabel erstellen (Aktion im Menüband)
- Das Label wird über den zugewiesenen Shipment Provider erstellt
Pflichtangaben für die Label-Erstellung
| Angabe | Quelle | Beschreibung |
|---|---|---|
| Empfängername | Lieferadresse | Name des Empfängers |
| Straße + Hausnummer | Lieferadresse | Zustelladresse |
| PLZ + Ort | Lieferadresse | Zielort |
| Ländercode | Lieferadresse | Muss DE sein (nur nationaler Versand) |
| Paketklasse | Setup / Sendung | S, M, L, XL oder XXL |
| Produkt | Setup / Sendung | PARCEL, PARCELSHOPDELIVERY oder PROFIPAKET |
| Absenderadresse | Setup Card | Wird aus dem Hermes Setup übernommen |
Paketklassen
Wählen Sie die Paketklasse passend zur Paketgröße:
| Klasse | Typisches Gewicht | Verwendung |
|---|---|---|
| S | bis 5 kg | Kleine Waren, Bücher |
| M | bis 10 kg | Standard-Pakete |
| L | bis 20 kg | Größere Bestellungen |
| XL | bis 25 kg | Schwere Pakete |
| XXL | bis 31,5 kg | Maximalgröße |
Standardwert
Wenn keine Paketklasse explizit angegeben wird, verwendet das System den Standardwert aus dem Hermes Setup.
PaketShop-Zustellung
Für die Zustellung an einen Hermes-PaketShop:
- Wählen Sie das Produkt PARCELSHOPDELIVERY
- Geben Sie die PaketShop-ID an (ermittelbar über die PaketShop-Suche)
- Das Label wird mit der PaketShop-Adresse als Ziel erstellt
PaketShop finden
Die PaketShop-Suche ermittelt nahegelegene Hermes-PaketShops basierend auf PLZ oder Koordinaten.
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
| 401 Unauthorized | Ungültige Credentials | Client ID / Secret prüfen |
| 400 Bad Request | Ungültige Adresse oder fehlende Pflichtfelder | Lieferadresse prüfen, PLZ validieren |
| 422 Unprocessable | Ungültige Kombination (z. B. PaketShop ohne Shop-ID) | Produkt und Zusatzangaben prüfen |
| 500 Server Error | Hermes-seitiges Problem | Später erneut versuchen |
Alle Fehler werden mit strukturierter Fehlermeldung angezeigt (Titel, Details, Kontext, Lösungshinweise).
Ergebnis
Nach erfolgreicher Label-Erstellung:
- Die Tracking-Nummer wird auf der Sendung gespeichert
- Das Label ist als PDF/ZPL zum Druck verfügbar
- Der Routing-Code wird gespeichert (für interne Logistik)
- Der Sendungsstatus wechselt auf „Label erstellt"