Vorhandene Mirakl-Produkte verknüpfen

Wenn Produkte bereits im Mirakl-Katalog existieren (außerhalb dieses Plugins angelegt, durch den Ablauf eines anderen Händlers importiert oder aus einem früheren System migriert), muss das Plugin wissen, welches Shopware-Produkt zu welchem Mirakl-Produkt gehört, bevor es sie synchron halten kann. Diese Seite erstellt diese Verknüpfungen in einer Sammelaktion, sodass Sie nicht jede einzeln eintragen müssen.

Dies ist das produktseitige Gegenstück zu Vorhandene Angebote verknüpfen. Verwenden Sie es, wenn ein Produkt im Mirakl-Katalog bereits existiert, aber noch keine Shopware-Verknüpfung eingerichtet wurde.

Wo zu finden

Klicken Sie unter Mirakl → Angebotszuordnungen auf die Schaltfläche Angebote hinzufügen in der Symbolleiste und wählen Sie Bestehende verknüpfen → Produkte. Dies öffnet die Seite Bestehende Mirakl-Produkte verknüpfen.

Was angezeigt wird

Das Raster zeigt jedes Mirakl-Katalogprodukt, das auf der gewählten Verbindung noch nicht mit einem Shopware-Produkt verknüpft ist. Spalten:

Spalte	Bedeutung
Produkt-SKU	Die Mirakl-seitige Kennung des Katalogprodukts.
Produktbezeichnung	Der Produktname, wie Mirakl ihn kennt.
Shop-SKUs	Alle betreiberseitigen Codes, die diesem Produkt bei Mirakl bereits zugeordnet sind (komma-getrennt).
Zugeordnetes Produkt	Das Shopware-Produkt, das das Plugin automatisch geraten hat, oder Keine Zuordnung, wenn nichts passt.

Die Seitenleiste enthält nur eine Aktualisieren-Aktion — es gibt keine Filter, weil die Liste bereits auf “nicht verknüpft, eindeutige Produkte” eingeschränkt ist.

Was herausgefiltert wird

Die Liste ist bewusst eng gefasst. Das Plugin blendet aus:

• Mirakl-Katalogprodukte, die bereits mindestens eine Shopware-Verknüpfung haben.
• Mirakl-Produkte, deren vorgeschlagenes Shopware-Produkt anderweitig bereits verknüpft ist — damit Sie nicht versehentlich dasselbe Shopware-Produkt zweimal verknüpfen können.
• Doppelte Mirakl-Produkteinträge — mehrere Angebote unter demselben Katalogprodukt werden zu einer Zeile zusammengefasst, ihre Codes in der Spalte Shop-SKUs gesammelt.

Wenn die Seite leer ist, wurden alle Katalogprodukte auf dieser Verbindung bereits verknüpft. Die Meldung lautet “Keine unverknüpften Produkte auf Mirakl gefunden.”

So funktioniert die automatische Zuordnung

Für jede Zeile nimmt das Plugin den ersten Code aus Shop-SKUs und sucht nach einem Shopware-Produkt mit der passenden Produktnummer. Wird eines gefunden, zeigt Zugeordnetes Produkt den Shopware-Produktnamen mit einem grünen Auto-Etikett.

Sie können die automatische Zuordnung pro Zeile überschreiben:

• Suchen — erscheint nur, wenn keine Zuordnung gefunden wurde. Öffnet den Produktauswahldialog, in dem Sie das richtige Shopware-Produkt manuell auswählen können.
• Ändern — erscheint, wenn eine Zuordnung vorliegt. Öffnet denselben Dialog, um zu einem anderen Shopware-Produkt zu wechseln. Das Etikett wechselt dann von Auto zu Manuell.
• Entfernen — löscht die Zuordnung für diese Zeile (die Zeile fällt zurück auf Keine Zuordnung).

Produkte verknüpfen

Die Symbolleiste hat drei Schaltflächen:

• Alle zugeordneten auswählen — markiert jede Zeile, die derzeit eine Zuordnung hat (Auto oder Manuell). Zeilen ohne Zuordnung bleiben unmarkiert, weil Sie ein Mirakl-Produkt nicht mit nichts verknüpfen können.
• Alle abwählen — hebt die Auswahl auf.
• Ausgewählte verknüpfen ({count}) — primäre Aktion. Erstellt die Shopware↔Mirakl-Produktverknüpfungen für jede ausgewählte Zeile in einem Aufruf.

Nach dem Verknüpfen wird jedes verknüpfte Mirakl-Produkt für die angebotsseitigen Abläufe verfügbar (Angebotssynchronisation, Angebotserstellung) — das Plugin weiß jetzt, welchem Shopware-Produkt das Mirakl-Produkt entspricht.

Tipps & Fallstricke

Tipp

Die automatische Zuordnung stützt sich darauf, dass die Shopware-Produktnummer mit dem Code des Betreibers übereinstimmt. Wenn Ihre Shopware-Produktnummern von dem abweichen, was Mirakl kennt (zum Beispiel nach einer Nummernmigration), zeigen alle Zeilen Keine Zuordnung — verwenden Sie die Suchen-Schaltfläche pro Zeile oder korrigieren Sie zuerst die Shopware-Produktnummern.

Achtung

Jedes Shopware-Produkt kann pro Verbindung nur einmal verknüpft werden. Die Liste blendet bereits Zeilen aus, deren automatische Zuordnung mit einer bestehenden Verknüpfung kollidieren würde, aber wenn Sie manuell dasselbe Shopware-Produkt in zwei Zeilen auswählen, behält die Aktion Ausgewählte verknüpfen nur die erste.

Hinweis

Das Verknüpfen eines Mirakl-Produkts hier erstellt keine Angebote — es registriert nur die katalogseitige Beziehung. Damit Preise und Bestände an Mirakl gesendet werden, benötigen Sie weiterhin eine Angebotszuordnung (automatisch beim ersten Lauf der Angebotssynchronisation erstellt, oder manuell über Angebote aus Shopware hinzufügen).

Verwandt

• Vorhandene Angebote verknüpfen — das angebotsseitige Äquivalent
• Angebote aus Shopware hinzufügen — neue Shopware-Produkte in Mirakl einbringen
• Katalog-Export — Sammel-Push von Shopware-Produkten in den Mirakl-Katalog
• Angebotssynchronisation — hält Preis, Bestand und Angebotsfelder aktuell, sobald eine Verknüpfung besteht