Attribute

Ein Marktplatz-Produktattribut ist alles, was das Produkt selbst beschreibt: Farbe, Material, Gewicht, Maße, Herkunftsland, Energieklasse und so weiter. Jede Marktplatzkategorie hat ihren eigenen Satz an Attributen — manche sind Pflicht (Mirakl lehnt Produkte ohne sie ab), die meisten sind optional.

Auf der Seite Attribut-Zuordnungen legen Sie für jedes Betreiber-Attribut fest, welcher Wert aus Shopware gesendet werden soll. Sie können ein Attribut einem Standard-Produktfeld zuordnen (z. B. Name oder Gewicht), einem benutzerdefinierten Feld am Produkt, einer Eigenschaftsgruppe, einem festen Text oder einem von mehreren eingebauten Hilfstypen. Jede Zuordnung kann zusätzlich Wertregeln tragen, die den Wert auf dem Weg zum Marktplatz anpassen — zum Beispiel langen Text kürzen, Komma durch Punkt in Zahlen ersetzen oder HTML aus einer formatierten Beschreibung entfernen.

Wo Sie das finden

Öffnen Sie das Mirakl-Admin-Modul und klicken Sie auf dem Dashboard im Bereich Schnellstart auf die Kachel Attributzuordnungen.

Die Liste zeigt alle zugeordneten Betreiber-Attribute mit folgenden Spalten:

Produktattribut — das Attribut des Betreibers (das Ziel der Zuordnung).
Mapping-Typ — Art der Zuordnung in Kurzform.
Pflichtfeld (Mirakl / Export) — zwei Markierungen, durch Schrägstrich getrennt. Erste: ob der Marktplatz das Attribut verlangt. Zweite: ob das Plugin das Attribut beim Export als Pflicht behandelt (siehe Pflichtattribute weiter unten).
Quelltyp — welche Art Shopware-Daten Sie auslesen (Produktfeld, Eigenes Feld, Eigenschaftsgruppe usw.).
Quellwert — das konkrete Feld oder der konkrete Wert hinter dem Quelltyp.
Standardwert — Fallback-Wert, wenn das Produkt keinen Wert hat (siehe Standardwert weiter unten).
Verbindungen — Verbindungen, für die diese Zuordnung gilt.

Die Liste lässt sich nach Verbindung, Quelltyp und Produktattribut filtern. Die Toolbar bietet Aktualisieren, Zuordnung hinzufügen, Auto-Zuordnung, Zuordnungen exportieren und Zuordnungen importieren.

Die Liste der verfügbaren Betreiber-Attribute, aus denen Sie auswählen, stammt aus einer Aktualisierung — öffnen Sie Produktattribute im Schnellstart und nutzen Sie Attribute aktualisieren, oder lassen Sie es den Einrichtungs-Assistenten in Schritt 3 holen.

Auto-Zuordnung — der empfohlene Einstieg

Klicken Sie in der Toolbar auf Auto-Zuordnung. Das Plugin geht die Attributliste des Betreibers durch und legt für alles, was es am Namen oder Code erkennt, eine Zuordnung an. Der Abgleich ist vorsichtig:

Es werden nur neue Zuordnungen angelegt — bereits konfigurierte bleiben unverändert.
Es werden nur Attribute mit bekannten Namensmustern zugeordnet. Attribute, die der Abgleich nicht erkennt, müssen Sie manuell zuordnen.

Was der Abgleich erkennt (Liste häufiger Attributnamen, nicht vollständig):

gtin, ean, product.ean → Produktfeld EAN
short.item.description, product.name, product.title → Name
long.item.description, product.description → Beschreibung
net.mass.weight, product.weight → Gewicht
product.width, product.height, product.length → das passende Maß
supplier.part.number, manufacturer.number, mpn → Herstellernummer
sku, product.number → Produktnummer
category, product.category → der Hilfstyp Produktkategorie
product.image, image.url → Produktbild-URL
tax.rate, vat.rate → Steuersatz

Nach Abschluss erscheint eine Meldung mit der Anzahl der neuen Zuordnungen. Auto-Zuordnung können Sie nach jeder Aktualisierung der Attributliste oder zum Nachziehen neu hinzugekommener Attribute jederzeit erneut ausführen.

Eine Zuordnung manuell anlegen

Klicken Sie in der Toolbar auf Zuordnung hinzufügen (oder öffnen Sie eine vorhandene Zeile und wählen Sie im Kontextmenü Bearbeiten). Der Dialog fragt:

Produktattribut — das Betreiber-Attribut, das Sie zuordnen möchten.
Verbindungen — die Verbindung(en), für die die Zuordnung gilt. Eine Zuordnung darf mehrere Verbindungen gleichzeitig abdecken, aber pro Verbindung darf es nur eine Zuordnung pro Attribut geben.
Quelltyp — welche Art Shopware-Daten gelesen werden. Die Felder im Dialog passen sich Ihrer Auswahl an. Verfügbare Quelltypen sind Produktfeld, Eigenes Feld, Eigenschaftsgruppe, Produktkategorie, Mirakl-Kategorie, Shopware-Kategorie, Produktbild-URL, Steuersatz, EAN mit SKU-Fallback, Auto-Produkt-ID-Typ, Shop SKU (Produktnummer), Produkt-ID-Typ: SHOP_SKU, EAN / GTIN, Produkt-ID-Typ: EAN, Effektiver Bestand, Lieferzeit, Mirakl-Angebotszustand sowie Statischer Wert. Dieselbe Liste von Quelltypen wird auch für Angebotsfelder verwendet — dort steht, was jeder einzelne Typ liefert.
Quellwert — hängt vom Quelltyp ab: ein Produktfeld-Name, ein Schlüssel eines benutzerdefinierten Feldes, eine Referenz auf eine Eigenschaftsgruppe, ein fester Text und so weiter.
Standardwert — Fallback (siehe unten).
Pflichtfeld für Export — Sicherheitsprüfung pro Zuordnung (siehe unten).

Standardwert

Jede Zuordnung hat ein Feld Standardwert mit einem kleinen Schloss-Symbol:

Gesperrt (kein Standardwert) — wenn das Produkt keinen Wert hat, greift die Plugin-Standardlogik. Das ist die richtige Wahl, wenn Sie das eingebaute Verhalten entscheiden lassen wollen.
Entsperrt (expliziter Standardwert) — der eingetragene Text wird unverändert an den Marktplatz gesendet, wenn das Produkt keinen eigenen Wert hat. Ein leeres entsperrtes Feld sendet einen ausdrücklich leeren Wert — das ist manchmal nützlich, etwa um ein zuvor gesetztes Attribut zu leeren.

Pflichtattribute

Die Liste zeigt unter Pflichtfeld (Mirakl / Export) zwei Markierungen nebeneinander:

Pflicht laut Mirakl — kommt aus der Attributdefinition des Betreibers. Ist ein Attribut beim Marktplatz als Pflicht markiert, lehnt der Betreiber Produkte ohne Wert ab.
Pflichtfeld für Export — Sicherheitsprüfung pro Zuordnung auf Ihrer Seite. Wenn aktiv, werden Produkte ohne Wert für dieses Attribut beim Katalogexport übersprungen — sie werden gar nicht erst gesendet. Verwenden Sie das als weiche Bremse für Felder, bei denen Sie lieber überspringen als scheitern.

Wenn Sie Pflichtfeld für Export bei einem vom Marktplatz selbst geforderten Attribut deaktivieren, warnt der Dialog, dass das zu Exportfehlern oder abgelehnten Produkten führen kann.

Wertregeln (Werttransformationen)

Die Daten, die Sie in Shopware speichern, passen selten eins zu eins zum vom Marktplatz erwarteten Format. Jede gespeicherte Zuordnung kann eine Kette von Wertregeln tragen (im Dialog Werttransformationen genannt), die den Wert vor dem Senden anpassen.

Um den Editor zu öffnen, speichern Sie die Zuordnung zuerst, öffnen Sie sie dann erneut über das Kontextmenü → Bearbeiten und klicken Sie in der Fußleiste auf Werttransformationen. Die Schaltfläche zeigt die Anzahl der vorhandenen Regeln.

Wenn Sie Werttransformationen in einer noch nicht gespeicherten Zuordnung anklicken, passiert nichts und es erscheint ein Hinweis: „Speichern Sie zuerst das Mapping — Transformationen können nur zu einem gespeicherten Mapping hinzugefügt werden.” Erst speichern, dann erneut öffnen und Regeln hinzufügen.

Verfügbare Regeltypen:

Typ	Was er macht
Ersetzung	Einfache Suchen-und-Ersetzen-Funktion. Übereinstimmungsmodus Teilstring (jedes Vorkommen) oder Exakte Übereinstimmung (ganzer Wert).
Regulärer Ausdruck	Ein PCRE-Muster im Format `/Muster/Flags` plus Ersetzungstext mit Verweisen auf Erfassungsgruppen über `$0`, `$1`, `$2`. Erlaubte Flags: `i`, `s`, `u`. Ungültige Muster werden mit einer klaren Fehlermeldung abgelehnt.
HTML entfernen	Entfernt alle HTML-Tags.
HTML → Klartext (formatiert)	Wandelt HTML in formatierten Klartext um.
Kleinbuchstaben	Wandelt den Wert in Kleinbuchstaben um.
Großbuchstaben	Wandelt den Wert in Großbuchstaben um.
Erster Buchstabe groß	Macht nur das erste Zeichen groß.
Jedes Wort groß (Title Case)	Schreibt jedes Wort groß.
Maximale Länge	Kürzt auf die angegebene Zeichenzahl.

Regeln laufen in der Reihenfolge der Priorität — kleinere Zahlen zuerst. Beispiel: Regel Priorität 10 HTML entfernen, danach Priorität 20 Kleinbuchstaben, danach Priorität 30 Maximale Länge 200 macht aus einer formatierten Beschreibung sauberen Kleinbuchstabentext, auf 200 Zeichen gekürzt.

Import / Export

Mit den Schaltflächen Zuordnungen exportieren und Zuordnungen importieren lassen sich vollständige Zuordnungs-Konfigurationen (einschließlich Wertregeln) zwischen Verbindungen oder zwischen Shops umziehen:

Zuordnungen exportieren öffnet einen Dialog, in dem Sie die Quellverbindung auswählen. Die heruntergeladene JSON-Datei enthält jede Attribut-Zuordnung, die mit dieser Verbindung verknüpft ist. Attribute werden über ihren Betreiber-Code referenziert, nicht über interne Kennungen, daher ist die Datei zwischen Verbindungen portabel.
Zuordnungen importieren öffnet einen Dialog mit Zielverbindung, Importmodus (Zusammenführen — bestehende Mappings beibehalten, nur neue hinzufügen oder Ersetzen — bestehende Mappings der Zielverbindung zuerst entfernen) und der hochzuladenden JSON-Datei. Die Zusammenfassung am Ende meldet, wie viele Zuordnungen Importiert, Ersetzt, Übersprungen und wie viele Fehlende Attribute (in der JSON enthalten, aber nicht in der Attributliste der Zielverbindung vorhanden) waren.

Der Auto-Map-Schritt im Einrichtungs-Assistenten akzeptiert dasselbe JSON-Format, sodass eine exportierte Datei auch direkt bei der Ersteinrichtung übernommen werden kann.