Beim Anlegen einer Mirakl-Datenquelle müssen Sie (bzw. der Inhaber des Mirakl-Kontos) dekodi X die Erlaubnis erteilen, Daten von Mirakl abzurufen. Dazu müssen Sie im Mirakl-Marketplace ein neuen API-Key generieren.
Unter Einstellungen erfassen Sie anschließend die Parameter und Vorgaben für die Mirakl-Datenquelle:
•Voraussetzungen
▪ Aktiver Seller Account (für die jeweilige Plattform)
▪ Zugriff auf das Seller-Backend (Admin-Rechte)
•API-Key erstellen
▪ Einloggen im Seller-Portal
▪ Profil anklicken -> API Key / API Schlüssel -> Neuen API Key erstellen
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 Erstellungsdatum von Daten 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 Dokumente vollständig zu erstellen, und keine weiteren relevanten Informationen (z.B. Liefer-, Zahlinfos) mehr nachträglich dazukommen.
▪Beispiel Mirakl: mindestens 2 Std (so lange kann es lt. Mirakl dauern, bis ein Vorgang in der REST-API sichtbar wird)
Es ist ratsam, die diesbezüglichen Erfahrungen der Nexus-Anwender zu berücksichtigen.
oAbrufen ab: Ab welchem Belegdatum 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