Versand-Zuordnungen

Wenn Sie eine Mirakl-Bestellung aus Shopware versenden, erwartet der Betreiber neben der Tracking-Nummer einen Carrier-Code — “DHL”, “GLS”, “DPD” oder wie auch immer die Betreiber-seitige Liste das nennt. Shopware kennt die Mirakl-Carrier-Liste nicht von Haus aus, also braucht das Plugin eine Zuordnung: diese Shopware-Versandart → dieser Mirakl-Carrier-Code.

Auf dieser Seite definieren Sie diese Zuordnungen.

Wo zu finden

Öffnen Sie im Dashboard die Karte Quick Start und klicken Sie die Kachel Shipping Mappings. Dies öffnet die Seite Versand-Zuordnungen.

Was angezeigt wird

Das Raster listet jede definierte Zuordnung. Spalten:

Spalte	Bedeutung
Versandart	Die Shopware-Versandart, für die diese Zuordnung gilt.
Bereich	Entweder Global (alle Verbindungen) oder Pro Verbindung mit einer ausgewählten Mirakl-Verbindung.
Länder	Wenn die Zuordnung auf bestimmte Länder beschränkt ist, erscheinen sie hier.
Standard	Ob dies der Standard-Fallback für Versandarten ohne spezifische Zuordnung ist.
Erstellt	Wann die Zuordnung hinzugefügt wurde.

Die Seitenleiste hat Filter:

• Versandart — freier Text.
• Standard — nur Standard-Fallbacks anzeigen.
• Bereich — Global vs Pro Verbindung filtern.
• Verbindungen — nach Mirakl-Verbindung filtern.
• Länder — nach Zielland filtern.

Wie die Übereinstimmung funktioniert

Wenn das Plugin einen Versand an Mirakl melden muss, durchläuft es die Zuordnungen in dieser Reihenfolge:

1. Pro Verbindung-Zuordnung, die zu dieser Verbindung, dieser Versandart und dem Zielland der Bestellung passt.
2. Pro Verbindung-Zuordnung, die zu dieser Verbindung und dieser Versandart passt (beliebiges Land).
3. Global-Zuordnung, die zu dieser Versandart passt.
4. Standard-Fallback — die Zuordnung mit gesetztem Standard-Flag.

Die erste Übereinstimmung gewinnt. Wenn nichts passt und kein Fallback definiert ist, kann das Plugin die Versandbestätigung nicht pushen — richten Sie einen Standard-Fallback ein, um das zu vermeiden.

Aktionen pro Zeile

• Bearbeiten — die Zuordnung ändern (Versandart, Bereich, Länder, Carrier-Code).
• Löschen — Bestätigung: “Sind Sie sicher, dass Sie diese Zuordnung löschen möchten?”

Die Symbolleisten-Schaltfläche Erstellen öffnet ein leeres Zuordnungsformular.

Tipps & Fallstricke

Tipp

Legen Sie als Erstes eine Standard-Fallback-Zuordnung an — eine einzige globale Zeile mit der Standard-Markierung und dem Carrier, mit dem Sie am häufigsten versenden. Dann fügen Sie nach Bedarf Overrides für spezifische Versandarten oder Länder hinzu.

Achtung

Die Carrier-Codes müssen exakt der Liste des Betreibers entsprechen. Verschiedene Mirakl-Betreiber veröffentlichen leicht unterschiedliche Listen — prüfen Sie die Dokumentation des Betreibers oder die Referenzdaten Carriers in dessen Panel, bevor Sie eine Zuordnung speichern.

Hinweis

Den Bereich auf Pro Verbindung zu setzen ist nützlich, wenn verschiedene Betreiber auf verschiedenen Mirakl-Verbindungen unterschiedliche Carrier-Codes für dieselbe Shopware-Versandart erwarten (z. B. Betreiber A will “DHL”, Betreiber B will “DHL_EXPRESS”).

Verwandt

• Bestellstatus-Synchronisation — wann Versandbestätigungen den Betreiber erreichen
• Bestellungsimport — Bestellungen kommen mit der vom Betreiber gewählten Versandzone an
• Verbindungen — Einstellungen pro Verbindung