Dieser Abschnitt beschreibt die Bereitstellung von Mirakl-Zahlungsabrechnungen (Transaktionshistorie) einschließlich Gebühren für alle angeschlossenen Mirakl-Marktplätze.
Beim Anlegen einer Mirakl-Datenquelle müssen Sie (bzw. der Inhaber des Mirakl-Kontos) dekodi X die Erlaubnis erteilen, Daten von Mirakl abzurufen. Damit wir Ihre Daten von Mirakl abrufen können, benötigen wir die API-URL und einen API-Schlüssel Ihres Mirakl-Seller-Kontos.
•Voraussetzungen
▪ Aktiver Seller Account (für die jeweilige Plattform)
▪ Zugriff auf das Seller-Backend (Admin-Rechte)
•API-Key abrufen
▪ Einloggen im Seller-Portal
▪ Oben rechts auf Ihr Profilbild klicken und Persönliche Einstellungen wählen.
Abb.: Mirakl Seller Portal
▪ Im Bereich Persönliche Einstellungen, Reiter API-Schlüssel öffnen
▪Es ist bereits ein API-Schlüssel vorhanden?
•Dann verwenden Sie bitte diesen vorhandenen Schlüssel und erzeugen Sie keinen neuen.
•Jeder Benutzer hat nur einen gültigen API-Schlüssel. Ein neu erzeugter Schlüssel macht den bisherigen ungültig. Alle Anbindungen, die ihn nutzen (z. B. andere Dienstleister oder Ihr ERP-System), funktionieren dann nicht mehr.
▪Es ist noch kein API-Schlüssel vorhanden?
•Dann generieren Sie unter Aktionen einen neuen API-Schlüssel.
Hinweis: Wenn Sie den API-Schlüssel später neu erzeugen, tragen Sie den neuen Schlüssel bitte auch bei uns ein. Sonst wird der Datenabruf unterbrochen.
Abb.: Mirakl Api Key Erstellen
Unter Einstellungen erfassen Sie anschließend die Parameter und Vorgaben für die Mirakl-Datenquelle:
Abb.: Einstellungen Mirakl-Datenquelle
Gehen Sie anschließend wie folgt vor:
•Öffnen Sie die Einstellungen der Mirakl-Datenquelle und tragen Sie folgende Felder ein.
oName der Datenquelle
oKnowHub: Dokumentation (Link): (z.B. im Kanzlei-internen Wiki)
oAPI URL: Adresse, unter der Ihr Mirakl-Marketplace erreichbar ist z.B.: https://myshop.mirakl.net
oAPI KEY: Funktioniert wie ein Passwort und wird im Mirakl-Marketplace generiert.
•Prüfen Sie mit Verbindung testen, ob die Verbindung erfolgreich eingerichtet wurde.
•Unter Automatisierung erfassen Sie die Einstellungen für den automatischen Datenabruf:
oSetzen Sie den Haken bei Automatischer Datenabruf. Durch Entfernen des Hakens können Sie den Abruf vorübergehend deaktivieren.
oAbruf-Versatz: Wie weit in der Vergangenheit muss das Bereitstellungssdatum von Zahlungsabrechnungen liegen, bevor Sie von dekodi X abgeholt werden
Der Abruf-Versatz muss so gewählt werden, dass sichergestellt ist, dass das Vorsystem ausreichend Zeit hatte, die Zahlungsabrechnungen für den Abrufzeitraum bereit zu stellen.
▪Mirakl stellt Zahlungsabrechnungen nicht zwingend in Echtzeit bereit. Da Verzögerungen möglich sind, empfehlen wir einen Abruf-Versatz von mindestens 2 Stunden.
Es ist ratsam, die diesbezüglichen Erfahrungen der Nexus-Anwender zu berücksichtigen.
oAbrufen ab: Ab welchem Abrechnungsdatum soll der automatische Abruf gestartet werden?
Um im Nexus den Wechsel auf den automatischen Datenabruf zu erleichtern, empfehlen wir mindestens so weit in die Vergangenheit zurück zu gehen, wie die Daten im Nexus jetzt bereits verarbeitet sind, also z.B. Anfang des Vormonats.
•Schließen Sie die Erfassung mit Speichern ab.
dekodi X startet jetzt mit dem automatischen Abruf.
Abhängig davon, wie weit in die Vergangenheit der Abruf-Zeitraum reicht, wie groß Ihr Datenaufkommen ist, wie schnell das Vorsystem ist, und welche Einstellungen Sie gewählt haben, kann es einige Stunden (oder ggf. auch Tage) dauern, bis im Nexus alle Daten verfügbar sind ("Aufholphase").
•Unter Abrufprotokoll können Sie die Ergebnisse der bisherigen Datenabfragen einsehen.
Insbesondere können Sie nach der Ersteinrichtung während der "Aufholphase" prüfen, wie weit der Datenabruf im dekodi X bereits vorangeschritten ist.
Nachfolgend finden Sie eine beispielhaft eingerichtete Datenquelle von Mirakl. Achtung: Bitte aber auf Ihre Gegebenheiten anpassen.
Abb.: Einstellungen Mirakl-Datenquelle ausgefüllt