Vorhandene Mirakl-Angebote verknüpfen

Wenn Mirakl-Angebote bereits beim Betreiber existieren — angelegt von einem älteren System, aus einer anderen Plattform migriert oder manuell außerhalb dieses Plugins eingerichtet — müssen Sie dem Plugin mitteilen, zu welchem Shopware-Produkt jedes Angebot gehört. Diese Seite listet diese Angebote auf und erstellt die fehlenden Verknüpfungen in einer Sammelaktion.

Es ist das angebotsseitige Gegenstück zu Vorhandene Produkte verknüpfen (das auf Katalogebene arbeitet).

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 → Angebote. Dies öffnet die Seite Mirakl-Angebote.

Was angezeigt wird

Alle Mirakl-Angebote auf der gewählten Verbindung. Spalten:

Spalte	Bedeutung
Produktbezeichnung	Name, wie Mirakl ihn kennt, mit Angebots-ID und Shop-SKU als Metadaten darunter.
Verknüpfungsstatus	Grünes Verknüpft-Badge oder graues Nicht verknüpft-Badge.
Status	Der Mirakl-seitige Status des Angebots.
Mirakl-Preis	Angebotspreis auf der Mirakl-Seite.
Shopware-Preis	Preis des zugeordneten Shopware-Produkts (mit Währung); ein Strich, wenn keine Zuordnung.
Menge	Menge aus dem Mirakl-Angebot.
Zugeordnetes Produkt	Shopware-Produkt, das das Plugin automatisch zugeordnet hat oder das Sie ausgewählt haben, mit Aktionsschaltflächen pro Zeile.

Die Seitenleiste hat:

• SKU — Volltextsuche.
• Verknüpfungsstatus — Dropdown mit Alle / Verknüpft / Nicht verknüpft.
• Alle zurücksetzen — leert alle Filter auf einmal.
• Aktualisieren.

So funktioniert die automatische Zuordnung

Für jedes Mirakl-Angebot schaut das Plugin auf seine Shop-SKU und sucht ein Shopware-Produkt mit der passenden Produktnummer. Das Ergebnis wird in der Spalte Zugeordnetes Produkt als einer von vier Zuständen angezeigt:

Anzeige	Bedeutung
(Name des verknüpften Produkts, kein Badge)	Bereits verknüpft. Verknüpfung aufheben-Schaltfläche verfügbar.
Auto (grün)	Automatisch zugeordnet, aber noch nicht verknüpft. Ändern- und Entfernen-Schaltflächen.
Manuell (grün)	Sie haben die Zuordnung manuell ausgewählt. Gleiche Schaltflächen wie Auto.
Keine Zuordnung (grau)	Nichts passte zur Shop-SKU. Suchen-Schaltfläche öffnet die Produktauswahl.

Angebote verknüpfen

Die Symbolleiste hat drei Schaltflächen:

• Alle zugeordneten auswählen — markiert jede nicht verknüpfte Zeile, die derzeit eine Zuordnung hat.
• Alle abwählen — hebt die Auswahl auf.
• Ausgewählte verknüpfen ({count}) — erstellt die Shopware↔Mirakl-Angebotszuordnungen für jede ausgewählte Zeile. Zeilen ohne Zuordnung werden übersprungen.

Nach dem Verknüpfen wechselt das Angebot in der Spalte Verknüpfungsstatus auf Verknüpft und verschwindet aus der Nicht verknüpft-Ansicht.

Verknüpfung aufheben

Bereits verknüpfte Zeilen zeigen eine Verknüpfung aufheben-Aktion (rot). Beim Klicken öffnet sich ein Bestätigungsdialog:

Verknüpfung zwischen Mirakl-Angebot {offerId} und Shopware-Produkt {name} entfernen? Das Angebot kann später erneut verknüpft werden.

Das Mirakl-Angebot selbst bleibt — nur die Shopware↔Mirakl-Zuordnung wird entfernt. Sie können dasselbe Angebot später wieder mit demselben (oder einem anderen) Shopware-Produkt verknüpfen.

Zeilen-Kontextmenü

Kontextmenü pro Zeile:

• Produkt anzeigen — öffnet das verknüpfte Shopware-Produkt in einem neuen Tab (nur aktiv, wenn die Zeile verknüpft ist und die Shopware-Zuordnung bekannt ist).

Tipps & Fallstricke

Tipp

Verwenden Sie den Filter Verknüpfungsstatus → Nicht verknüpft, wenn Sie diese Seite regelmäßig durchgehen — er blendet alles aus, was bereits verknüpft ist, damit Sie sich nur auf die Angebote konzentrieren können, die noch Aufmerksamkeit benötigen.

Achtung

Die automatische Zuordnung stützt sich darauf, dass die Mirakl Shop-SKU mit der Shopware Produktnummer übereinstimmt. Wenn Ihre Shopware-Produktnummern von dem abweichen, was Mirakl kennt (Nummernmigration, Präfixänderung), zeigt jede Zeile Keine Zuordnung und Sie müssen Suchen pro Zeile verwenden oder zuerst die Shopware-Produktnummern umbenennen.

Hinweis

Das Aufheben der Verknüpfung wirkt sich nicht auf das Angebot bei Mirakl aus. Es löscht nur die Plugin-Zuordnung, sodass das Angebot nicht mehr aus Shopware synchronisiert wird. Wenn Sie das Angebot tatsächlich aus Mirakl entfernen möchten, tun Sie das aus der Angebotszuordnungs-Liste — siehe Angebotssynchronisation.

Verwandt

• Angebote aus Shopware hinzufügen — die umgekehrte Richtung
• Vorhandene Produkte verknüpfen — katalogseitiges Gegenstück
• Angebotssynchronisation — hält das Angebot aktuell, sobald es verknüpft ist
• Angebotsfelder zuordnen