Einstellungen

Die Einstellungen des Plugins liegen auf der Seite Mirakl → Einstellungen mit drei Reitern:

Verbindungen — pro Marktplatz eine Zeile (siehe Verbindungen für die per-Verbindung-Felder). Hier nicht behandelt.
Synchronisierungseinstellungen — Hauptschalter, Intervalle und Chargengrößen, die die Hintergrund-Synchronisationen steuern.
Optionen — Protokoll-Aufbewahrung und -Stufen.

Diese Einstellungen erscheinen auch auf der Shopware-Standardseite Einstellungen → System → Erweiterungen, aber zur Bearbeitung ist die dedizierte Seite Mirakl → Einstellungen der empfohlene Ort.

Reiter Synchronisierungseinstellungen

Der Reiter Synchronisierungseinstellungen ist in drei Karten unterteilt: Synchronisierungseinstellungen, Dokumentensynchronisierung (Mirakl → Shopware) und Rechnungen & Transaktionsprotokolle.

Hauptschalter

Jede Synchronisation hat ihren eigenen Schalter. Wenn ein Schalter aus ist, läuft die geplante Aufgabe weiterhin in ihrem Intervall, der Handler überspringt sie aber — es wird kein Marktplatz-Aufruf gemacht. Schalter beeinflussen aus dem Admin angestoßene On-Demand-Aktionen nicht.

UI-Beschriftung	Einstellungsschlüssel	Standard	Was eingeschaltet wird
Bestandssynchronisierung aktivieren	`stockSyncActive`	An	Die Bestandssynchronisations-Aufgabe schickt Bestandsaktualisierungen.
Bestellimport aktivieren	`orderImportActive`	An	Die Bestellimport-Aufgabe holt neue und aktualisierte Bestellungen.
Produktexport aktivieren	`productExportActive`	An	Die Produktexport-Aufgabe lädt eingereihte Produkte hoch.
Nachrichtensynchronisierung aktivieren	`messageSyncActive`	Aus	Die Nachrichtensynchronisations-Aufgabe holt neue eingehende Nachrichten.
Bestelldokument-Synchronisierung aktivieren (OR72)	`orderDocumentSyncActive`	Aus	Die Bestelldokument-Synchronisations-Aufgabe holt neue eingehende Dokumente.
Dokumentanforderungs-Synchronisierung aktivieren (DR11)	`documentRequestSyncActive`	Aus	Die Dokumentanforderungs-Synchronisations-Aufgabe holt neue Anforderungen vom Marktplatz.
Rechnungssynchronisierung aktivieren (IV01)	`invoiceSyncActive`	Aus	Die Rechnungssynchronisations-Aufgabe holt neue Rechnungen.
Transaktionsprotokoll-Synchronisierung aktivieren (TL02)	`transactionLogSyncActive`	Aus	Die Transaktionsprotokoll-Synchronisations-Aufgabe holt neue Einträge.

Sync-Intervalle

Jede Synchronisation hat ein entsprechendes Intervall. Die Werte sind Sekunden; die UI zeigt sie als voreingestellte Dauern.

UI-Beschriftung	Einstellungsschlüssel	Standard	Voreingestellte Werte
Bestandssync-Intervall	`stockSyncInterval`	15 Minuten	2 Min., 5 Min., 10 Min., 15 Min., 30 Min., 60 Min.
Bestellimport-Intervall	`orderImportInterval`	30 Minuten	2 Min., 5 Min., 10 Min., 15 Min., 30 Min., 60 Min.
Produktexport-Intervall	`productExportInterval`	30 Minuten	2 Min., 5 Min., 10 Min., 15 Min., 30 Min., 60 Min.
Nachrichtensync-Intervall	`messageSyncInterval`	30 Minuten	2 Min., 5 Min., 10 Min., 15 Min., 30 Min., 60 Min.
Dokumentensync-Intervall	`orderDocumentSyncInterval`	30 Minuten	5 Min., 10 Min., 15 Min., 30 Min., 60 Min., 6 Std., 24 Std.
Dokumentanforderungs-Sync-Intervall	`documentRequestSyncInterval`	24 Stunden	1 Std., 6 Std., 12 Std., 24 Std.
Rechnungssync-Intervall	`invoiceSyncInterval`	24 Stunden	6 Std., 12 Std., 24 Std.
Transaktionsprotokoll-Sync-Intervall	`transactionLogSyncInterval`	24 Stunden	6 Std., 12 Std., 24 Std.
Poll-Intervall für Transaktionsprotokoll-Export	`transactionLogExportPollInterval`	1 Minute	30 Sek., 1 Min., 5 Min.

Das konfigurierte Intervall ist ein Minimum — der tatsächliche Abstand hängt zusätzlich davon ab, wie oft der Shopware-Scheduler auf Ihrem Host ausgelöst wird (Cron-Kadenz). Siehe Hintergrundaufgaben.

Chargengrößen

Diese beiden Einstellungen begrenzen die Anzahl Zeilen, die in einer Charge hochgeladen werden. Niedrigere Werte reduzieren Speicherverbrauch und Timeout-Risiko; höhere Werte beschleunigen große Kataloge.

UI-Beschriftung	Einstellungsschlüssel	Standard	Bereich
Produktexport-Batch-Größe	`productExportBatchSize`	100	1–500
Angebotssynchronisation-Batch-Größe	`offerSyncBatchSize`	50	1–500

Die Chargengröße wird zu Beginn eines Laufs festgehalten — eine Änderung mitten im Lauf wirkt sich erst beim nächsten Lauf aus.

Abschnitt für geschlossene Bestellungen

Für Synchronisationen, die Bestellungen durchsuchen, begrenzen diese Einstellungen, wie weit auf bereits geschlossenen Bestellungen zurückgeschaut wird. Das spart Marktplatz-Budget auf Konten mit langer Bestellhistorie.

UI-Beschriftung	Einstellungsschlüssel	Standard	Voreingestellte Werte
Nachrichten für geschlossene Bestellungen synchronisieren (Tage)	`messageSyncClosedOrderDays`	7 Tage	1, 3, 5, 7, 14, 30
Dokumente für geschlossene Bestellungen synchronisieren (Tage)	`orderDocumentSyncClosedOrderDays`	30 Tage	1, 3, 5, 7, 14, 30

Reiter Optionen

Karte Protokolle

UI-Beschriftung	Einstellungsschlüssel	Standard	Wirkung
API-Protokoll-Aufbewahrung (Tage)	`apiLogRetentionDays`	30	Wie lange Zeilen in API Logs behalten werden. Ältere Zeilen werden täglich entfernt.
Synchronisierungsprotokoll-Aufbewahrung (Tage)	`syncLogRetentionDays`	30	Wie lange Zeilen in Sync Logs behalten werden. Ältere Zeilen werden täglich entfernt.
Sync-Protokollstufen	`syncLogLevels`	Info, Erfolg, Warnung, Fehler (Debug aus)	Welche Schweregrade behalten werden. Langlaufende Läufe, die auf eine abgewählte Stufe hochgestuft werden, werden beim Abschluss entfernt; einmalige Ereignisse auf abgewählten Stufen werden nicht geschrieben. Das Abwählen aller Stufen schaltet das Sync-Logging komplett aus.

Praktische Hinweise dazu finden Sie in Synchronisationsprotokolle.

Per-Verbindung-Einstellungen (nicht auf der Einstellungsseite)

Einige Einstellungen werden pro Verbindung gespeichert — sie gehören zur Verbindung, nicht in die globale Systemkonfiguration. Sie bearbeiten sie über den Assistenten oder das Kontextmenü der Zeile in der Liste Verbindungen.

Einstellung	Wo bearbeiten
Anfangsdatum für Bestellimport	Assistentenschritt 12.
Standard-Angebotsstatus	Assistentenschritt 4 oder Dialog Verbindung bearbeiten.
Bestellstatus-Zuordnung	Assistentenschritt 9 oder Kontextmenü → Bestellstatus-Zuordnung.
Umgekehrte Status-Zuordnung	Assistentenschritt 10 oder Kontextmenü → Umgekehrte Status-Zuordnung.
Dokument-Auto-Upload	Assistentenschritt 11 oder Kontextmenü → Dokument-Auto-Upload.
Variantennamen-Format	Kontextmenü → Variantennamen-Format.

Die vollständige Liste der Per-Verbindung-Felder finden Sie unter Verbindungen.

Überschreibungen pro Produkt

Der Standard-Angebotsstatus einer Verbindung kann für einzelne Produkte überschrieben werden. Öffnen Sie das Produkt (Kataloge → Produkte → Produkt auswählen) und wechseln Sie auf den Reiter Spezifikationen. Im Abschnitt Mirakl Marketplace hat jede konfigurierte Verbindung ein eigenes Feld Angebotsstatus (Verbindungsname). Wählen Sie einen Wert zum Überschreiben; lassen Sie es leer, um den Standardwert der Verbindung zu verwenden.