Verbindungen

Eine Verbindung (Connection) repräsentiert einen einzelnen Mirakl-Marktplatz, auf dem Sie aus Ihrem Shop verkaufen. Alle Daten, die das Plugin verwaltet — Kategorien, Produktattribute, Angebote, Bestellungen, Rechnungen und Logs — gehören zu genau einer Verbindung. Dadurch können Sie aus einem einzigen Shopware-Shop auf mehreren Marktplätzen gleichzeitig verkaufen und die Daten der einzelnen Betreiber sauber getrennt halten.

Welche Informationen eine Verbindung enthält

Beim Anlegen einer Verbindung im Assistenten geben Sie ein:

Verbindungsname — eine Bezeichnung, mit der Sie diesen Betreiber im Plugin wiedererkennen (zum Beispiel Marktplatz EU oder Marktplatz UK).
Instanz-URL — die Web-Adresse der API des Betreibers, vom Betreiber bereitgestellt (zum Beispiel https://marketplace.example.com).
API Key — Ihr Verkäufer-API-Schlüssel, im Verkäufer-Dashboard des Betreibers erzeugt. Behandeln Sie ihn wie ein Passwort.
Shop ID — die numerische Shop-Kennung, die Ihrem Verkäuferkonto vom Betreiber zugewiesen wurde.
Verkaufskanal — der Shopware-Verkaufskanal, in dem importierte Bestellungen erstellt werden. Seine Währung, Sprache und Versandarten werden für diese Bestellungen verwendet, daher muss er zur Region des Betreibers passen.
Standard-Angebotsstatus (optional) — der Angebotsstatus, der beim Synchronisieren eines neuen Angebots verwendet wird, wenn das Produkt selbst keinen Status angibt. Sie können ihn später im Dialog Verbindung bearbeiten ändern oder pro Produkt überschreiben.

Das Plugin speichert pro Verbindung außerdem mehrere Zuordnungen — Bestellstatus-Zuordnung, Dokument-Auto-Upload-Zuordnung, Variantennamen-Format und weitere. Diese konfigurieren Sie nach dem Anlegen über eigene Dialoge aus dem Kontextmenü der Zeile.

Wo Sie Verbindungen verwalten

Öffnen Sie Mirakl → Einstellungen → Verbindungen, um alle konfigurierten Marktplätze zu sehen. Um eine neue Verbindung anzulegen, klicken Sie oben auf der Liste auf Verbindung hinzufügen — damit öffnet sich der 13-stufige Assistent.

Jede Zeile hat ein Kontextmenü (drei Punkte rechts) mit folgenden Aktionen:

Bearbeiten — öffnet den Dialog Verbindung bearbeiten, in dem Sie Zugangsdaten und Grundeinstellungen ändern können. Die Fußleiste des Dialogs enthält zusätzliche Schaltflächen: Setup-Assistent starten, Verbindung testen, Abbrechen und Speichern.
Setup-Assistent starten — öffnet den Assistenten für eine bestehende Verbindung erneut, beginnend mit Schritt 2 (Kategorien). Verwenden Sie das, um Referenzdaten des Betreibers aufzufrischen oder Zuordnungen neu vorzunehmen.
Bestellstatus-Zuordnung — öffnet einen Dialog, in dem Sie konfigurieren, wie jeder Mirakl-Bestellstatus auf Shopware-Bestell-, Versand- und Zahlungsstatus abgebildet wird.
Umgekehrte Status-Zuordnung — öffnet einen Dialog, in dem Sie konfigurieren, welche Shopware-Statuswechsel Aktionen auf Mirakl auslösen (akzeptieren, versenden, ablehnen).
Dokument-Auto-Upload — öffnet einen Dialog, in dem Sie Shopware-Dokumenttypen auf Mirakl-Dokumenttypen für den automatischen Upload abbilden.
Variantennamen-Format — öffnet einen Dialog, in dem Sie einstellen, wie Produktvariantennamen beim Senden an Mirakl zusammengesetzt werden.
Katalog-Export — öffnet die Katalog-Export-Seite für diese Verbindung, auf der Sie eine CSV-Datei mit Ihren Produkten für den Mapping-Assistenten des Betreibers erzeugen können.
Verbindung testen — sendet eine kleine Testanfrage an den Betreiber mit der gespeicherten URL und dem API-Schlüssel. Das Ergebnis aktualisiert den Status der Verbindung (siehe unten).
Löschen — entfernt die Verbindung und alle verknüpften Daten nach einem Bestätigungsdialog.

Status einer Verbindung

Jede Verbindung hat einen von drei Status, sichtbar in der Spalte Status auf der Liste (in der aktuellen Oberfläche werden die Werte unverändert in englischer Kleinschreibung angezeigt — connected, disconnected, error):

connected — die letzte Testanfrage an den Betreiber war erfolgreich. Geplante Hintergrundaufgaben werden für diese Verbindung ausgeführt.
disconnected — die Verbindung wurde noch nicht verifiziert oder bewusst aus der Synchronisierung herausgenommen. Geplante Aufgaben überspringen sie. Eine neue Verbindung startet immer in diesem Zustand.
error — die letzte Testanfrage oder Synchronisation ist fehlgeschlagen. Bewegen Sie den Mauszeiger über den Status (oder öffnen Sie Verbindung bearbeiten), um die Fehlermeldung des Betreibers zu sehen. Korrigieren Sie die Zugangsdaten und klicken Sie auf Verbindung testen, um es erneut zu versuchen.

Nur Verbindungen mit dem Status connected nehmen an geplanten Hintergrundaufgaben teil. Eine Verbindung im Zustand disconnected oder error zu belassen, pausiert sie damit effektiv — alle historischen Daten bleiben erhalten, es laufen keine Synchronisationen.

Der Assistent wartet nicht auf das Testergebnis, bevor Sie weitermachen können. Er speichert die Verbindung im Zustand disconnected, startet einen schnellen Test im Hintergrund und geht direkt zu Schritt 2 (Kategorien). Das Testergebnis erscheint auf der Verbindungsliste, sobald der Test abgeschlossen ist.

Mehrere Verbindungen parallel betreiben

Sie können sich mit so vielen Marktplätzen verbinden, wie Sie Verkäuferkonten haben. Jede Verbindung behält:

Eine eigene Kopie der Referenzdaten des Betreibers — Kategorien, Produktattribute, Angebotsfelder, Angebotsstatus, Grund-Codes. Das Aktualisieren der Daten einer Verbindung beeinflusst keine andere.
Einen eigenen Synchronisationsfortschritt für jede Funktion — Angebote, Bestellungen, Nachrichten, Dokumente, Rechnungen, Transaktionsprotokolle. Das Pausieren einer Verbindung stört die anderen nicht.
Eigene Zuordnungen. Dieselbe Shopware-Kategorie „Schuhe” kann konfliktfrei auf Kategorie 1234 bei Betreiber A und 5678 bei Betreiber B abgebildet werden.

Eine Verbindung löschen

Löschen entfernt die Verbindung und alles, was mit ihr verknüpft ist — Zuordnungen, Referenzdaten des Betreibers, Synchronisationszustand. Die Shopware-Bestellungen selbst bleiben erhalten, ihre Verknüpfung zu Mirakl wird jedoch entfernt: Sie erhalten keine weiteren Statusaktualisierungen mehr vom Betreiber.

Löschen Sie eine Verbindung nur, wenn Sie sicher sind, dass Sie ihre Historie nicht mehr benötigen. Diese Aktion lässt sich nicht rückgängig machen.

Den richtigen Verkaufskanal wählen

Der Verkaufskanal ist vor allem für den Bestellimport entscheidend. Importierte Bestellungen werden im Kontext dieses Verkaufskanals erstellt, daher müssen seine Währung, Sprache und Versandarten zur Region des Marktplatzes passen. Wenn Sie auf einem französischen Betreiber verkaufen, verknüpfen Sie einen französischen Verkaufskanal.

Der Standard-Angebotsstatus ist unabhängig vom Verkaufskanal — es ist der Angebotsstatus, der beim Synchronisieren eines neuen Angebots ohne eigenen Status verwendet wird. Stellen Sie ihn im Dialog Verbindung bearbeiten oder in Schritt 4 des Assistenten ein.

Um ihn für ein einzelnes Produkt zu überschreiben, öffnen Sie das Produkt (Kataloge → Produkte → Produkt auswählen) und wechseln Sie auf den Reiter Spezifikationen. Im Abschnitt Mirakl Marketplace gibt es für jede konfigurierte Verbindung ein eigenes Feld Angebotsstatus (Verbindungsname). Wählen Sie einen Wert, um zu überschreiben; lassen Sie das Feld leer, damit der Standard-Angebotsstatus der Verbindung verwendet wird. Die Überschreibung wird am Produkt gespeichert, nicht an der Verbindung, sodass verschiedene Verbindungen unterschiedliche Überschreibungen für dasselbe Produkt haben können.