Einführung

P2Lab Mirakl ist ein Shopware-6-Plugin, das Ihren Shop als Verkäuferkonto mit einem Mirakl-Marktplatz verbindet. Mirakl ist die Plattform hinter vielen großen Betreiber-Marktplätzen — die Verkäufer-Seite ist überall gleich aufgebaut, also funktioniert das Plugin gleich, egal auf welchem Marktplatz Sie verkaufen.

Was das Plugin macht

Das Plugin fügt einen einzigen Eintrag Mirakl in die linke Hauptnavigation der Shopware-Administration ein, in der Gruppe Kataloge. Ein Klick darauf öffnet das Dashboard, von dem aus alles Weitere erreichbar ist. Die Karte Schnellstart enthält eine Kachel für jede Unterseite des Plugins:

Einstellungen — drei Reiter: Verbindungen (Marktplätze anlegen und verwalten), Synchronisierungseinstellungen (einzelne Synchronisationen ein- oder ausschalten und ihren Rhythmus anpassen) und Optionen (wie lange Logs aufbewahrt werden und wie ausführlich sie sind).
Kategorien, Produktattribute, Angebotsfelder, Angebotsstatus, Grund-Codes — die Referenzdaten des Marktplatzes, auf Knopfdruck oder über den Einrichtungs-Assistenten abgeholt.
Attributzuordnungen und Angebotsfeld-Zuordnungen — hier sagen Sie dem Plugin, wie Ihre Shopware-Daten die Felder des Marktplatzes füllen sollen. Beide Seiten können Zuordnungen automatisch vorschlagen und erlauben, die Einstellungen als Datei zu exportieren oder zu importieren.
Katalog (auch Produktkatalog) — die Shopware-Produkte, die Sie für den Marktplatz ausgewählt haben, jedes mit seinem eigenen Exportstatus (Ausstehend, In Warteschlange, Verarbeitung, Exportiert, Wiederholung, Fehler).
Angebote — Ihre aktiven Angebote auf den Marktplätzen mit ihrem aktuellen Synchronisationszustand.
Bestellungen — Mirakl-Bestellungen, die zu Shopware-Bestellungen wurden. Jede Bestellung hat ihre eigenen Reiter Übersicht und Kunde; Nachrichten, Dokumente, Rechnungen und Transaktionsprotokolle erreichen Sie über die jeweiligen Unterseiten.
Protokolle und API Logs — was jede geplante Ausführung und jeder Austausch mit dem Marktplatz konkret enthalten hat, inklusive Anfrage- und Antwortdetails.

Im Hintergrund führt das Plugin eine Reihe geplanter Aufgaben aus, die die laufende Arbeit übernehmen: den Produktkatalog hinaussenden, Bestands- und Preisänderungen übertragen, Bestellungen importieren, Nachrichten und Dokumente abholen sowie Rechnungen und Transaktionsprotokolle einsammeln. Welche dieser Aufgaben aktiv sind und wie oft sie laufen, stellen Sie unter Mirakl → Einstellungen → Synchronisierungseinstellungen ein.

Für wen das Plugin gedacht ist

Multichannel-Händler, die Shopware bereits für ihren eigenen Shop nutzen und auf einen Mirakl-Marktplatz expandieren möchten, ohne ihren Katalog erneut hochzuladen.
Operations-Teams, die Bestellungen aus Shopware und einem oder mehreren Marktplätzen verwalten und alles — versenden, ablehnen, mit Kunden schreiben — aus einer Administration heraus erledigen wollen.
Agenturen, die Kunden auf Mirakl-Marktplätze bringen und dafür einen wiederholbaren, geführten Prozess statt einmaliger CSV-Importe suchen.

Das Plugin ist speziell für Mirakl-Marktplätze gebaut — kein universeller Marktplatz-Konnektor — und setzt voraus, dass Sie bereits ein vom jeweiligen Marktplatzbetreiber freigegebenes Verkäuferkonto haben.

Was Sie brauchen

Shopware 6.6 — das Plugin ist für die 6.6-Linie gebaut.
Einen laufenden Hintergrund-Worker — das Plugin nutzt Hintergrundprozesse für alles, was länger als ein paar Sekunden dauert (die Befehle stehen in Installation).
Einen laufenden Scheduled-Task-Runner — ohne ihn starten die wiederkehrenden Synchronisationen (Bestand, Bestellungen usw.) nicht von selbst.
Ein Mirakl-Verkäuferkonto auf mindestens einem Marktplatz, dazu die Internetadresse des Marktplatzes, Ihren Verkäufer-API-Schlüssel und Ihre Shop-ID.

Was Sie ohne weitere Konfiguration bekommen

Lange Aufgaben setzen sich selbst fort. Das Senden eines großen Katalogs oder der Import vieler tausend historischer Bestellungen wird in Pakete aufgeteilt, und das nächste Paket wird automatisch aufgegriffen. Wird eine Aufgabe unterbrochen, läuft sie beim nächsten Mal an der Stelle weiter, an der sie aufgehört hat.
Eingebauter Umgang mit Anfragelimits. Wenn der Marktplatz das Plugin um eine Pause bittet, wartet das Plugin die gewünschte Zeit ab und versucht es danach erneut — Sie müssen nichts an Drosseln einstellen.
Jeder Marktplatz bleibt für sich. Kategorien, Attribute und Zuordnungen werden pro Verbindung gespeichert; dieselbe Shopware-Kategorie kann auf unterschiedlichen Marktplätzen ganz unterschiedlichen Marktplatz-Kategorien zugeordnet werden, ohne dass sich etwas in die Quere kommt.
Vollständige Protokolle für jede Aktion. Jede Synchronisation und jeder Austausch mit dem Marktplatz wird mit Anfrage, Antwort, Status und Dauer protokolliert.