Mirakl

Wichtige Informationen

Unsere Schnittstelle zwischen Mirakl Connect und Afterbuy tauscht bidirektional Produktdaten, Bestellungen und Versanddaten aus. Im folgenden gehen wir genauestens auf die Funktionen der Middleware ein, sodass Sie jederzeit alle Infos rund um die Lösung zur Hand haben. Zu Beginn der Integration gehen wir immer unverbindlich und persönlich mit Ihnen ins Detail, um die Integration zu besprechen.

Onboarding Termin buchen

Grundvoraussetzungen für die Schnittstelle:

• Mirakl Connect Account
• Afterbuy Account
• Eine bestellte Afterbuy Schnittstelle (Shop & XML)
• Optional: Registrierung bei mindestens einem Mirakl Marktplatz

Prozess der Integration

1. Accounts vorbereiten
2. Onboarding Meeting buchen und Integration im Detail besprechen
3. AV Vertrag im Sinne der DSGVO & SEPA Mandat mit uns schließen
4. Zugangsdaten ins Dashboard eintragen
5. Gemeinsames Testing der Schnittstelle
6. Erfolgreich auf Mirakl Connect verkaufen!

Mirakl Connect Account

Der Mirakl Connect Account ist Ihre Basis und Schaltzentrale, um von einem Account aus auf allen Mirakl Marktplätzen verkaufen zu können. Unsere Schnittstelle kommuniziert ausschließlich mit Mirakl Connect und nicht separat mit einzelnen Mirakl Marktplätzen. Sie haben die Möglichkeit, zentral in Mirakl Connect alle angebundenen Marktplätze zu verwalten und so mit einer Anbindung an Afterbuy auf allen Mirakl Marktplätzen zu verkaufen. Die Registrierung und Verbindung der Mirakl Marktplätze mit Mirakl Connect sind hierbei selbstverständlich vorausgesetzt.

Mirakl Connect anfragen

Pläne & Funktionen

Die für die Schnittstelle freigegebenen Produkte werden vollumfänglich mit Mirakl Connect synchronisiert. Damit diese auch in dem Marktplatz vollumfänglich und automatisiert angelegt werden, ist jedoch ein bezahlter Plan bei Mirakl Connect notwendig, der die Funktion "Catalog Transformer" enthält. Wird der "Start" Plan verwendet, so muss die Arikelanlage via CSV Import pro Marktplatz mit den jeweils individuellen Attributen durchgeführt werden. Anschließend werden dann die von uns übertragenen Preise & Bestände mit den angelegten Produkten synchronisiert, hierfür muss die ID innerhalb des Marktplatzes und Mirakl Connect identisch sein. Im Standard wird dafür die Afterbuy Produkt ID verwendet. Wenn Sie Unterstützung bei einem CSV Import benötigen, kommen Sie gern jederzeit auf uns zu.

Afterbuy- Account & Schnittstelle

Auf der Afterbuy Seite wird ein Account benötigt, der bereits aktiv ist. Anschließend muss dann eine Schnittstelle bei Afterbuy bestellt werden, damit wir von außen mit dem System kommunizieren können. Wir benötigen in einer bestellten Schnittstelle die Endpunkt „Shop & XML“ zusammengefasst. Es wird eine bestellte Afterbuy Schnittstelle ausschließlich für die Mirakl Connect Anbindung benötigt. Der Name der bestellten Schnittstelle muss "Mirakl" oder "Mirakl Connect" sein. Selbstverständlich unterstützen wir Sie bei Bedarf bei der Einrichtung.

Ihr persönliches Dashboard

Nach erfolgreichem Onboarding und zu Beginn der Integration erhalten Sie Zugang zu Ihrem persönlichen Dashboard. Hier können Sie später einen ausführlichen Log zu Ihrer Schnittstelle einsehen, Zugangsdaten verwalten und die letzten Prozesse und erfolgten Datentransfers einsehen.

Das Dashboard ist Ihr erster Anlaufpunkt, um sämtliche Informationen zu Ihrer persönlichen Integration einzusehen und zu verwalten.

info

Sobald Sie alle Zugangsdaten in dem Dashboard hinterlegt haben, startet die Lösung und mit dem nächsten Intervall werden alle Datentransfers angestoßen und auch alle Produkte, die für uns freigegeben sind, übertragen.

FAQ

Wo ist mein Zugang?

Den Zugang erhalten Sie von uns nach erfolgreichem Onboarding und Anzahlung der Lösung sowie der Unterschrift des AV Vertrags & SEPA Mandats. Mit dieser Einladung können Sie dann Ihr Dashboard aufrufen, Ihr Passwort festlegen und mit den Vorbereitungen starten.

Wie kann ich das Passwort zurücksetzen?

Das Passwort könne Sie bequem zurücksetzen, wenn Sie auf der Login Seite sind. Hier einfach „Passwort vergessen?“ Klicken, die eigene Mailadresse angeben und über die gesendete Mail ein neues Passwort festlegen.

Wie kann ich die Konfiguration durchführen?

Die Konfiguration können Sie mit Klick auf den aktuellen Status nach erfolgreichem Login durchführen. Den Status Ihrer Schnittstelle finden Sie ganz oben, Sie werden hier bei Bedarf auch aufgefordert, die Konfiguration durchzuführen.

Wo sollen die Daten eingetragen werden?

Die Datenfelder sind nach Klick auf die Konfiguration vorgefertigt. Hier ist dann die Afterbuy Schnittstelle relevant, um die Integration auf Seiten von Afterbuy vorzubereiten. Um Mirakl Connect zu verbinden, klicken Sie auf den entsprechenden Button. Anschließend werden Sie dann zu Mirakl Connect weitergeleitet, um sich mit Ihrem Account anzumelden und die Verbindung zu verifizieren.

Wie kann die Verbindung widerrufen werden?

Wenn Sie oben auf Ihre Konfiguration klicken, können Sie in einer Roten Box die Verbindung für bestimmte Endpunkte der Lösung widerrufen. Wenn Sie die Daten widerrufen, stoppt die Schnittstelle sofort und ist nicht mehr aktiv, bis die passende Konfiguration erneut durchgeführt wurde. Kommen Sie für den Fall der Kündigung persönlich auf uns zu. Ein widerrufen der Daten führt nicht zur Kündigung der Schnittstelle!

Produktdaten

In diesem Abschnitt gehen wir detailliert auf die Produktdaten und das standardisierte Wertemapping der Lösung ein. Wir aktualisieren alle 15 Minuten alle Produkte, sowohl Bestände als auch die allgemeinen Produktinformationen.

info

Wir können die Schnittstelle für Sie individualisieren. Bitte kommen Sie bei Bedarf jederzeit auf uns zu, sodass wir Ihre individuellen Anforderungen berücksichtigen und die Integration für Sie anpassen können.

Filter & Level

Als Filter für die zu übertragenden Produkte und verbundene Aktionen nutzen wir das Afterbuy Level Feld.

Wir übertragen bei Variationssets ausschließlich die Kinderprodukte und nicht das Hauptprodukt. Außerdem übertragen wir Einzelprodukte und Produktsets.

Level	Funktion
0 - 10	Das Produkt wird übertragen und vollständig aktualisiert
11	Das Produkt wird aus Mirakl Connect gelöscht
>= 12	Das Produkt wird ignoriert

Wertemapping

Das Wertemapping beschreibt das Matching der Datenfelder von System zu System im Standard. Selbstverständlich können wir jederzeit Anpassungen im Mapping durchführen und Ihre Werte aus anderen Datenfeldern bei Afterbuy Matchen, die Felder bei Mirakl Connect sind jedoch starr vorgegeben. Die hier beschriebenen Mirakl Connect Datenfelder sind alle möglichen Felder, wir können keine weiteren Werte übertragen.

tipp

Um erfolgreich auf den angebundenen Marktplätzen zu listen, prüfen Sie bitte die jeweiligen Anforderungen an Produktdaten und ergänzen Sie alle relevanten Informationen in Ihren Stammdaten, um erfolgreich auf dem Marktplatz listen zu können.

Afterbuy API Feld	Afterbuy Benutzeroberfläche	Mirakl Connect
Name	Produktbeschreibung → Name	Name
ProductID	Produktdaten → Produkt ID → Your ID	ID
Ean	Produktdaten → Hersteller Standard Produkt ID Wert	GTIN
Quantity	Preise u. Bestände → Afterbuy-Shop-Bestand	Quantity
Price oder miraklPrice	Preise und Bestände → Verkaufspreis	Prince in EUR
miraklSalePrice	Preise und Bestände → angelegtes Preisfeld „miraklSalePrice“	Discount Price in EUR
ProductBrand	Produktdaten → Marke/Hersteller	Brand
ProductPictures	Bilder → Bildergalerie → Bildlink Original	Image
Description	Produktbeschreibung → Beschreibung in HTML	Description
Attributes	Produktmerkmale → Angelegte Merkmale beginnend mit „Mirakl“	Attributes

Multilanguage

Mehrsprachigkeit für folgende Datenfelder ist von der Schnittstelle unterstützt:

• Product title
• Description

Wir unterstützen aktuell folgende Sprachen neben dem Standard Deutsch, die bei Afterbuy unter Multilanguage zugewiesen sein müssen:

• Englisch
• Französisch
• Italienisch
• Niederländisch
• Spanisch

Sie wünschen weiteren Sprachen?

Bestellungen

Wir lesen alle 5 Minuten die Verkäufe von allen Marktplätzen bei Mirakl Connect aus. Die Bestellungen werden anschließend mit allen relevanten Informationen übertragen. Wir lesen alle Verkäufe aus, die als Status „Pending acceptance“ haben, aus.

Stock Check

Hat der Verkauf den Status „Pending acceptance“, prüfen wir, ob alle in dem Verkauf enthaltenen Produkte Bestand bei Afterbuy haben. Ist dies der Fall, so akzeptieren wir den Verkauf bei Mirakl Connect und setzen ihn als "Accepted". Diese Prüfung führen wir für alle Bestellungen bei jedem Abgleich durch. Ist der Bestand nicht in Afterbuy vorhanden, so wird der Verkauf nicht akzeptiert und bleibt offen in Mirakl Connect.

Bestellimport

Passen die Parameter und die Bestände sind vorhanden, so Akzeptieren wir die Bestellung und übertragen diese vollumfänglich zu Afterbuy. Relevante Informationen wie Rechnungsadresse, Lieferanschrift, der Verkaufskanal und mehr finden Sie als Informationen im angelegten Verkauf.

info

Wenn Sie hier Anpassungen wünschen oder ein Stock Check bei Ihnen nicht möglich ist, sprechen Sie uns einfach an. Wir finden eine passende Lösung.

Versand

Alle erfolgreich übertragenen Verkäufe werden für 6 Tage rückwirkend und den aktuellen Tag auf Versand geprüft. Ist ein Versanddatum gesetzt, lesen wir die Versandart und Trackingnummer aus Afterbuy aus und übertragen diese zu Mirakl Connect. Der Status der Bestellung wird dann zu „Shipped“ aktualisiert.

warnung

Je nach Marktplatz variieren die Versandarten und die Anforderungen an den Namen der Versandart. Bei Versandupdate ist darauf zu achten, dass die passende Versandart gesetzt wird, damit Mirakl Connect die passenden Versandlinks generieren kann. Die Versandlinks übergeben wir nicht.