Hier findest du Antworten auf häufige Fragen zur Integration Mirakl und Tipps aus der Praxis.
Ich verkaufe auf mehreren Mirakl-Marktplätzen. Brauche ich mehrere Integrationen? Ja. Jeder Marktplatz hat ein eigenes Verkäuferkonto mit eigener URL und eigenem API-Key. Lege für jeden Marktplatz eine eigene Integration an. Gibt es für den Marktplatz eine eigene Integration im Katalog, z. B. Conrad oder Hornbach, nutze diese.
Mein Marktplatz steht nicht in der Liste. Kann ich ihn trotzdem anbinden? Ja, wenn er auf Mirakl läuft. Verwende die allgemeine Integration Mirakl und trage URL und API-Key deines Marktplatzes ein.
Ich verkaufe auf einem Marktplatz in mehreren Ländern. Wie trenne ich die Shops? Lege je Shop eine eigene Integration an und trage in den Grundeinstellungen die passende Shop-Id ein. So kannst du je Land eigene Projekte, Lager und Einstellungen verwenden.
Es werden gar keine Daten übertragen. Prüfe, ob in den Grundeinstellungen der Modus auf Produktiv steht und Kanal aktiv eingeschaltet ist und ob im Tab Workflows der betroffene Unter-Tab auf Aktiv steht.
Ich möchte nur Preise und Bestände übertragen. Brauche ich das Kategorienmapping? Nein. Das Kategorienmapping und das Feature Produkte brauchst du nur, wenn du Produktdaten aus Xentral an den Marktplatz lieferst. Für Preise und Bestände reicht das Feature Angebote, vorausgesetzt der Marktplatz kennt deine Produkte bereits.
Muss ich die Produktdatei bei jeder Änderung neu hochladen? Nein. Die initiale Datei brauchst du nur einmal für das Kategorienmapping. Danach überträgt Xentral neue und geänderte Artikelstammdaten automatisch.
Ich pflege Preise direkt im Marktplatz. Wie verhindere ich, dass Xentral sie überschreibt? Lass im Workflow Angebote den Bereich Preise inaktiv und schalte nur den Bestand aktiv. Beachte: Dann muss das Angebot im Marktplatz bereits existieren, damit Xentral den Bestand aktualisiert.
Xentral legt keine Angebote an.
-
Ein neues Angebot braucht Preis und Bestand. Prüfe, ob beide Bereiche aktiv sind.
-
Prüfe die Artikelzuordnung: Das gewählte Merkmal (Marktplatz-Artikelnummer, GTIN, EAN oder Fremdnummer) muss in Xentral und im Marktplatz übereinstimmen.
-
Prüfe, ob der Artikel in der Artikelzuordnung enthalten ist.
Der Marktplatz verwendet eigene Artikelnummern (SKU). Wie ordne ich meine Angebote zu? Pflege die SKU des Marktplatzes als Fremdnummer an deinen Artikeln und wähle im Workflow Angebote bei Artikelzuordnung die Option SKU über Fremdnummer. Trage darunter die Fremdnummern Bezeichnung ein.
Wie nehme ich einen Artikel aus dem Verkauf? Ein Artikel, den du aus der Artikelzuordnung entfernst, bleibt im Marktplatz bestehen und erhält nur keine Aktualisierungen mehr. Deaktiviere das Angebot deshalb im Mirakl-Backoffice.
Xentral holt keine Aufträge ab.
-
Prüfe, ob der Workflow Aufträge auf Aktiv steht.
-
Prüfe, ob die Aufträge im Mirakl-Backoffice angenommen sind. Xentral holt nur angenommene Aufträge ab. Mit Aufträge automatisch akzeptieren nimmt Xentral sie selbst an.
Beim Auftragsimport erscheint die Fehlermeldung „Fehlende Zahlungsart“. Ergänze die Zahlungsart aus der Fehlermeldung unter Zahlungsarten Zuordnung. Schreibe sie exakt so, wie der Marktplatz sie übergibt. Stoße den Auftrag danach im Journal erneut an.
Beim Auftragsimport erscheint „Customer could not be created“. Mirakl gibt die Lieferadresse erst nach der Annahme des Auftrags heraus. Nimm den Auftrag im Mirakl-Backoffice an und importiere ihn im Journal erneut.
Warum ordnet Xentral Marktplatzkunden nicht über die E-Mail-Adresse zu? Bei Mirakl steht für die Kundenzuordnung nur Name & Adresse zur Verfügung.
Die Trackingnummer kommt im Marktplatz nicht an. Prüfe im Unter-Tab Auftragsstatus & Tracking die Versanddienstleister-Zuordnung. Jede Xentral-Versandart, mit der du Marktplatzaufträge versendest, braucht einen zugeordneten Versanddienstleister aus Mirakl.
Kann ich Lieferscheine an den Marktplatz übertragen? Nein. Das Feature Belege überträgt nur Rechnungen. Bei Hornbach und voelkner gibt es das Feature nicht.
-
Klein anfangen: Teste mit einem Artikel und einem Auftrag, bevor du den Filter erweiterst.
-
Nur gelistete Artikel zuordnen: Nimm nur Artikel in die Artikelzuordnung, die auf dem Marktplatz verkauft werden sollen.
-
Porto-Artikel ohne Preis: Sollen Versandkosten aus dem Marktplatz kommen, gib dem Porto-Artikel keinen Verkaufspreis.
-
Versand aufsplitten: Verkaufst du Artikel mit ermäßigtem Steuersatz, aktiviere das Modul Versand Aufsplitten.
-
Kundengruppe prüfen: Überträgst du Preise einer Kundengruppe, braucht jeder Artikel im Filter einen Preis für diese Gruppe.
-
Besonderheiten des Marktplatzes klären: Frag vor dem Start beim Betreiber nach Pflichtattributen und Besonderheiten, z. B. dem Dokumententyp für Rechnungen.