Angebotsfelder

Attribute beschreiben das Produkt selbst (Material, Farbe, Größe), während Angebotsfelder Ihr Angebot zu diesem Produkt beschreiben: Ihren Preis, Ihren Bestand, Ihre Versandvorlaufzeit, Ihren Barcode, Handling-Gebühren und so weiter. Zwei Verkäufer, die dasselbe Produkt auf demselben Marktplatz anbieten, teilen sich die Produktattribute, haben aber unterschiedliche Angebotsfelder.

Jeder Marktplatz definiert seinen eigenen Satz an Angebotsfeldern. Das Plugin lädt diese Liste pro Verbindung herunter, und auf der Seite Angebotsfeld-Zuordnungen legen Sie für jedes Betreiber-Angebotsfeld fest, welcher Wert aus Shopware gesendet werden soll.

Wo Sie das finden

Öffnen Sie das Mirakl-Admin-Modul und klicken Sie im Bereich Schnellstart auf die Kachel Angebotsfeld-Zuordnungen.

Die Liste zeigt Ihre vorhandenen Zuordnungen mit folgenden Spalten:

Angebotsfeld — das Angebotsfeld des Betreibers (das Ziel der Zuordnung).
Feldtyp — der Datentyp, den der Betreiber erwartet (Text, Zahl, Datum, Liste, …).
Pflicht (Mirakl / Export) — zwei Markierungen, durch Schrägstrich getrennt. Erste: ob der Marktplatz das Feld verlangt. Zweite: ob das Plugin es bei der Synchronisierung als Pflicht behandelt (siehe Pflicht oder optional weiter unten).
Quelltyp — welche Art Shopware-Daten Sie auslesen.
Quellwert — das konkrete Feld oder der Wert hinter dem Quelltyp.
Standardwert — Fallback-Wert, wenn das Produkt keinen eigenen Wert hat (siehe unten).
Verbindungen — Verbindungen, für die die Zuordnung gilt.

Sie können nach Verbindung, Quelltyp und Angebotsfeld filtern. Die Toolbar bietet Aktualisieren, Zuordnung hinzufügen, Zuordnungen exportieren und Zuordnungen importieren.

Angebotsfeldliste des Betreibers laden

Die Liste der verfügbaren Angebotsfelder, aus denen Sie wählen, stammt aus einer Aktualisierung:

Der Einrichtungs-Assistent aktualisiert sie für Sie in Schritt 6 (Angebotsfelder).
Auf der Seite Angebotsfelder (Schnellstart → Angebotsfelder) lädt die Schaltfläche Felder aktualisieren die aktuelle Liste des Betreibers jederzeit neu. Führen Sie das aus, wenn der Betreiber eine Schema-Änderung ankündigt.

Standardwerte anwenden — der empfohlene Einstieg

Für Angebotsfelder gibt es keine Auto-Zuordnung. Das Äquivalent ist Schritt 7 im Einrichtungs-Assistenten mit der Schaltfläche Standardwerte anwenden, die einen Satz sinnvoller Standardzuordnungen anlegt (Preis → Preis, Bestand → Bestand, EAN → EAN usw.). Standardwerte werden nur dort hinzugefügt, wo noch keine Zuordnung existiert, daher entstehen bei mehrfacher Ausführung keine Dubletten.

Im selben Schritt des Assistenten können Sie auch eine JSON-Datei importieren, die aus einer anderen Verbindung exportiert wurde.

Wenn Sie diesen Schritt übersprungen haben oder später weitere Zuordnungen ergänzen wollen, verwenden Sie direkt die Seite Angebotsfeld-Zuordnungen.

Eine Zuordnung anlegen oder bearbeiten

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:

Angebotsfeld — das Betreiberfeld, das Sie zuordnen möchten.
Verbindungen — die Verbindung(en), für die die Zuordnung gilt. Eine Zuordnung darf mehrere Verbindungen abdecken, aber pro Verbindung darf es nur eine Zuordnung pro Angebotsfeld geben.
Quelltyp — welche Art Shopware-Daten gelesen werden. Die Felder im Dialog passen sich Ihrer Auswahl an (siehe Tabelle unten).
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, wenn das Produkt keinen eigenen Wert hat. Das Schloss-Symbol steuert das Verhalten: gesperrt heißt kein Standardwert — Standardlogik verwenden; entsperrt heißt genau diesen Wert senden, auch leer.
Pflichtfeld für Export — Sicherheitsprüfung pro Zuordnung. Wenn aktiv, werden Produkte ohne Wert für dieses Angebotsfeld bei der Angebotssynchronisierung übersprungen — sie werden gar nicht erst Teil des an den Marktplatz gesendeten Pakets.

Quelltypen

Die Liste der verfügbaren Quelltypen ist geschlossen — wählen Sie den, der am besten zu Ihrer Shopware-Speicherung passt.

Quelltyp	Was er liefert
Produktfeld	Eines der Standard-Produktfelder: Name, Beschreibung, EAN, Produktnummer, Bestand, Preis, Gewicht, Breite, Höhe, Länge, Herstellernummer, Einheit (Name), Verkaufseinheit, Referenzeinheit.
Eigenes Feld	Ein benutzerdefiniertes Feld in Shopware. Im Dialog wählen Sie aus einem Feld-Set oder geben den Schlüssel von Hand ein (mit Punktnotation für verschachtelte Werte).
Eigenschaftsgruppe	Der Wert einer Produkteigenschaftsgruppe.
Produktkategorie	Intelligenter Hilfstyp: nutzt die Mirakl-Kategorie, falls eine zugeordnet ist, ansonsten die Shopware-Kategorie.
Mirakl-Kategorie	Nur die zugeordnete Mirakl-Kategorie (ohne Fallback).
Shopware-Kategorie	Die rohe Shopware-Kategorie, ohne Mirakl-Zuordnung.
Produktbild-URL	URL des Cover-Bildes des Produkts.
Steuersatz	Der Steuersatz des Produkts in Prozent.
EAN mit SKU-Fallback	Die EAN, falls vorhanden, sonst die Produktnummer (SKU).
Auto-Produkt-ID-Typ	Der Literaltext `EAN` oder `SHOP_SKU`, passend zu dem Wert, den der EAN/SKU-Hilfstyp ausgewählt hat.
Shop SKU (Produktnummer)	Immer die Produktnummer.
Produkt-ID-Typ: SHOP_SKU	Immer der Literaltext `SHOP_SKU`.
EAN / GTIN	Immer die EAN (leer, wenn das Produkt keine hat).
Produkt-ID-Typ: EAN	Immer der Literaltext `EAN`.
Effektiver Bestand	Physischer Bestand oder verfügbarer Bestand (abzüglich reservierter). Beide liefern 0, wenn das Produkt inaktiv ist.
Lieferzeit	Die Mindest- oder Maximallieferzeit des Produkts in Tagen.
Mirakl-Angebotsstatus	Die produktspezifische Überschreibung oder der Standard-Angebotsstatus der Verbindung.
Statischer Wert	Ein fester Text, der für jedes Produkt unverändert gesendet wird.

Die EAN/SKU-Hilfstypen und die Produkt-ID-Typ-Literale gibt es paarweise, weil Betreiber typischerweise sowohl einen product-id-Wert als auch ein passendes product-id-type-Literal verlangen. Ordnen Sie sie als zwei getrennte Angebotsfelder mit zusammenpassenden Quelltypen zu, damit sie konsistent bleiben.

Pflicht oder optional

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

Pflicht laut Mirakl — kommt aus der Felddefinition des Betreibers. Markiert Mirakl ein Feld als Pflicht, weist der Betreiber Angebote ohne Wert ab.
Pflichtfeld für Export — Sicherheitsprüfung pro Zuordnung auf Ihrer Seite. Wenn aktiv, werden Produkte ohne Wert für dieses Feld bei der Angebotssynchronisierung übersprungen — sie werden einfach nicht gesendet. Nützlich als weiche Bremse, etwa um Produkte ohne EAN zu überspringen, statt die Angebote scheitern zu lassen.

Wenn Sie Pflichtfeld für Export bei einem vom Marktplatz selbst geforderten Feld deaktivieren, warnt der Dialog: das kann zu Synchronisationsfehlern oder abgelehnten Angeboten führen.

Wertregeln (Werttransformationen)

Jede gespeicherte Angebotsfeld-Zuordnung kann eine Kette von Wertregeln tragen (im Dialog Werttransformationen genannt), die den ermittelten Wert vor dem Senden anpassen.

Öffnen Sie die Zuordnung über Bearbeiten und klicken Sie in der Fußleiste auf Werttransformationen (die Schaltfläche zeigt die Anzahl der vorhandenen Regeln). Die verfügbaren Regeltypen sind dieselben wie bei Attributen: Ersetzung, Regulärer Ausdruck, HTML entfernen, HTML → Klartext, Kleinbuchstaben, Großbuchstaben, Erster Buchstabe groß, Title Case, Maximale Länge. Regeln laufen in der Reihenfolge der Priorität, kleinere Zahlen zuerst.

Häufige Einsatzfälle für Angebotsfelder:

Bestand deckeln — eine Regel Maximale Länge oder Regex, die die Menge auf eine bekannte Obergrenze des Betreibers begrenzt.
Währung normalisieren — eine Ersetzungs-Regel, die € durch EUR ersetzt, falls Sie das Symbol speichern.
HTML entfernen — auf product-description, wenn der Betreiber Klartext erwartet.

Wertregeln lassen sich nur an einer gespeicherten Zuordnung anlegen. Reagiert die Schaltfläche Werttransformationen in einer neuen Zuordnung nicht, erscheint ein Hinweis mit der Bitte, zuerst zu speichern. Speichern Sie die Zuordnung mit Speichern, öffnen Sie die Zeile erneut über das Kontextmenü → Bearbeiten und klicken Sie dann erneut.

Import / Export

Mit den Schaltflächen Zuordnungen exportieren und Zuordnungen importieren ziehen Sie eine vollständige Angebotsfeld-Konfiguration zwischen Verbindungen oder zwischen Shops um:

Zuordnungen exportieren öffnet einen Dialog, in dem Sie die Quellverbindung auswählen. Die heruntergeladene JSON-Datei enthält jede Angebotsfeld-Zuordnung, die mit dieser Verbindung verknüpft ist.
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 JSON-Datei. Die Zusammenfassung am Ende meldet, wie viele Zuordnungen Importiert, Ersetzt, Übersprungen und wie viele Fehlende Felder waren (in der JSON enthalten, aber nicht in der Angebotsfeldliste der Zielverbindung).

Der Schritt Angebotsfeld-Zuordnungen im Einrichtungs-Assistenten akzeptiert dasselbe JSON-Format, eine exportierte Datei lässt sich also auch direkt bei der Ersteinrichtung übernehmen.