Versandintegration

Ein Versandsystem für alle Carrier

Im klassischen Multi-Channel-Szenario erstellt man Versandlabels über das Portal des jeweiligen Versanddienstleisters – DHL Geschäftskundenportal, DPD MyDPD, GLS ShipIT, UPS Worldship, und so weiter. Bei fünf Carriern sind das fünf verschiedene Logins, fünf verschiedene Oberflächen, und die Tracking-Nummern müssen manuell den Bestellungen zugeordnet werden.

merchantCENTRAL vereinheitlicht dies: Ein Dialog, alle Carrier.

┌──────────────────────────────────────────────────────────┐
│                merchantCENTRAL Hub                        │
│                                                          │
│   ┌──────────────────────────────────────────────────┐   │
│   │         „Label erstellen"-Dialog                  │   │
│   │                                                   │   │
│   │  Verkaufsauftrag:  VA-10042                       │   │
│   │  Dienstleister:    [DHL ▼]                        │   │
│   │  Produkt:          DHL PAKET                      │   │
│   │  Gewicht:          3,50 kg                        │   │
│   │                                                   │   │
│   │           [ Label erstellen ]                      │   │
│   └───────────────────────┬──────────────────────────┘   │
│                           │                              │
│              ┌────────────┼────────────┐                 │
│              ▼            ▼            ▼                 │
│        ┌──────────┐ ┌──────────┐ ┌──────────┐           │
│        │ DHL API  │ │ DPD SOAP │ │ GLS REST │           │
│        └──────────┘ └──────────┘ └──────────┘           │
│              ▼            ▼            ▼                 │
│        ┌──────────┐ ┌──────────┐ ┌──────────┐           │
│        │ UPS REST │ │ Rhenus   │ │ Weitere  │           │
│        │ (OAuth)  │ │ (SFTP)   │ │ ...      │           │
│        └──────────┘ └──────────┘ └──────────┘           │
└──────────────────────────────────────────────────────────┘

Der Label-Erstellungsprozess

Schritt 1: Label anfordern

Aus dem Verkaufsauftrag heraus (oder über die Versandlabel-Liste) wird der Dialog Label erstellen aufgerufen. Der Hub befüllt automatisch:

Lieferadresse aus dem Verkaufsauftrag
Gewicht aus den Artikelstammdaten
Dienstleister basierend auf Konfiguration oder letzter Verwendung

Schritt 2: Hub delegiert an Connector

Der Hub ruft das Event OnCreateShipmentLabel auf. Der zuständige Carrier-Connector reagiert:

Carrier	Connector	Technologie
DHL	ADG MCDHL	REST API v2
DPD	ADG MCDPD	SOAP/XML
GLS	ADG MCGLS	REST API v3
UPS	ADG MCUPS	REST API (OAuth 2.0)
Rhenus	ADG MCRH	BORD512 Flat-File via SFTP

Schritt 3: Label empfangen und speichern

Der Connector ruft die Carrier-API auf und erhält: - Tracking-Nummer (Sendungsnummer) - Label-Daten (PDF oder ZPL als Blob) - Ggf. Retourenlabel, Zolldokumente, Nachnahme-Labels

Alles wird in der zentralen Tabelle ADG MC Shipment Label gespeichert.

Schritt 4: Tracking automatisch verknüpfen

Der Hub erstellt automatisch einen Tracking-Eintrag in der Marketplace-Bestellung. Die Marktplatz-Connectoren erkennen neue Tracking-Einträge und senden die Versandbestätigung zurück an die jeweilige Marktplatz-API.

Label erzeugt
     │
     ▼
Tracking-Nr. gespeichert
     │
     ▼
Tracking-Eintrag in Marketplace Order erstellt
     │
     ▼
Connector sendet Versandbestätigung an Marktplatz
     │
     ├── Amazon: SP-API ConfirmShipment
     ├── Otto: Shipment-Endpoint
     ├── Kaufland: OrderUnit API
     ├── Conrad: Shipping Order
     └── eBay: Fulfillment API

Unterstützte Funktionen pro Carrier

Funktion	DHL	DPD	GLS	UPS	Rhenus
Label erstellen	✓	✓	✓	✓	✓
Bulk-Labels	✓ (bis 30)	–	–	–	–
Label stornieren	✓	–	✓	✓	–
Retourenlabel	✓	–	✓	–	–
Tagesabschluss	✓	–	✓	–	–
PDF-Label	✓	✓	✓	✓	–
ZPL-Label	✓	–	✓	✓	–
Zolldokumente	✓	–	–	–	–
Nachnahme	✓	–	–	–	–
Verbindungstest	✓	✓	✓	✓	✓

Carrier-Produkte

Jeder Carrier bietet verschiedene Versandprodukte an:

DHL

V01PAK – DHL PAKET (national)
V53WPAK – DHL PAKET International
V54EPAK – DHL Europaket
V62KP – DHL Kleinpaket
V66WPI – Warenpost International

DPD

CL – DPD Classic
E830 / E12 / E18 – DPD Express
IE2 – DPD International Express
PL – DPD PaketShop

GLS

PARCEL – BusinessParcel (national/EU/international)
EXPRESS – ExpressParcel

UPS

11 – UPS Standard
07 – UPS Express
65 – UPS Express Saver

Rhenus

Stückgut (LTL) über BORD512-Format
Multiple Packstücke (Colli) pro Sendung

Automatisches Carrier-Mapping

Der Hub erkennt anhand von Tracking-Nummer-Mustern automatisch den zugehörigen Carrier:

Carrier	Tracking-Nr. Muster	Beispiel
DHL	Beginnt mit `00`, 12-20 Stellen	`00340434161094042557`
DPD	14-stellig numerisch	`01234567890123`
GLS	Beginnt mit einer Zahl, 11-12 Stellen	`12345678901`
UPS	Beginnt mit `1Z`	`1Z999AA10123456784`
Hermes	12-16 Stellen, diverse Formate	`H1234567890123456`

Dieses Mapping wird genutzt, wenn eine Tracking-Nummer von extern kommt (z. B. Dropshipping) und der richtige Carrier zugeordnet werden muss.

Print Service (optional)

Falls die optionale App merchantCENTRAL Print Service installiert ist, können Labels automatisch nach der Erstellung gedruckt werden:

Label-Format	Druckweg
PDF	HTTP POST → ECIService → Windows-Drucker
ZPL	HTTP POST → ECIService → Zebra-Thermodrucker (TCP/IP)

Der Print Service reagiert auf das Hub-Event OnAfterCreateShipmentLabel und sendet das Label automatisch an den konfigurierten Drucker.