Mit dieser Schnittstelle können Sie xentral mit dem Online-Marktplatz Manomano verbinden, um Bestellungen von dort in xentral zu importieren.
-
Import von Aufträgen
-
Auftragsstatus zu Manomano zurückmelden
-
Rückmeldung von Lagerzahlen
-
Artikelexport von xentral zu Manomano (via vom Prozessstarter generierter CSV-Datei)
Welche Funktionen im Einzelnen möglich sind, können Sie unter Administration → Shop Schnittstelle → Übersicht → Shopfunktionen überprüfen.
Unter Administration → Shop Schnittstelle → Übersicht → NEU kann man nach Manomano suchen.
Nachdem Sie Manomano ausgewählt haben, können Sie im nächsten Schritt die nötigen Daten für die Verbindung der beiden Systeme eintragen.
So sind die Felder zu befüllen:
-
Login → Benutzername des API-Benutzers aus Manomano
-
Passwort → API-Passwort aus Manomano
-
Pfad Artikelfeed → Pfad des Ortes auf Ihrem Server, wo die vom Prozessstarter erstellte CSV-Datei Ihrer Manomano-Artikel abgelegt werden soll
Anmerkung
API-Benutzer und API-Passwort müssen direkt beim Account Manager bei Manomano erfragt werden.
Voraussetzung für die Anbindung von Xentral Cloud Kunden ist ein externer Webspace der Xentral per FTP zugänglich gemacht werden muss. Hier werden dann die generierten Artikel Feeds abgelegt die dann ManoMano zur Verfügung gestellt werden können. Dieser werden unter dem Punkt 1 eingetragen. Der FTP Passiver Modus muss normalerweise aktiviert werden.
Der lokale Pfad für den Artikelfeedlocal path for the article feed für Cloud Kunden lautet: /home/ubuntu/xentral/userdata/tmp/xentral
Sobald die Daten eingetragen wurden, können Sie die Verbindung zwischen beiden Systemen über folgende Schaltflächen prüfen:
Sobald die Verbindung erfolgreich war, erhalten Sie die Meldung "success". Sollte die Verbindung nicht erfolgreich hergestellt werden, dann wird Ihnen in einer Meldung eine Ursache mitgeteilt.
Weitere Informationen zu den Einstellungen der Schnittstelle gibt es hier: Online-Shops.
Die Manomano-Schnittstelle lässt keinen automatisierten Artikelexport von xentral zum Marktplatz zu.
Stattdessen kann im Feld Pfad Artikelfeed ein Pfad für ein lokales Verzeichnis auf dem Server o.Ä. hinterlegt werden. Der Prozessstarter "Bereitstellung Artikelfeed Manomano" (Parameter: artikelfeed_manomano) generiert in der eingestellten Periode eine CSV-Datei, in der später alle Artikel enthalten sind, die eine Manomano-Verknüpfung unter Artikel → Online Shop Optionen haben, den Lagerzahlensync erlauben und nicht gelöscht oder gesperrt sind.
Manomano muss anschließend von außen auf diesen Pfad zugreifen können, um den Artikelfeed von dort abzuholen.
Damit Artikel an ManoMano über den Artikelfeed exportiert werden, sind folgende Voraussetzungen notwendig:
-
Online-Shop Verknüpfung und Verkaufspreis gepflegt
-
Subshop Mapping im ManoMano Importer.
Über das Subshop Mapping wird der Export für die einzelnen Sprachen aufgebaut. Ich dem Beispiel ist jetzt nur Deutschland eingestellt.
Bei der Kennung unter Punkt 1 könnt ihr die Bezeichnung frei wählen - es könnte z.B. auch nur das Länderkennzeichen DE sein.
Bei Punkt 2 müsst ihr ein Projekt hinterlegen. Das ist aber nicht weiter relevant, weil es weder ausgewertet wird noch später eine Verwendung hat. Man kann nur ohne hinterlegten Projekt nicht speichern.
Bei Punkt 3 stellt ihr die Sprache des Subshops ein.
Man kann sagen, dass der Subshop den jeweiligen Artikelfeed in der eingestellten Sprache darstellt.
-
Damit Dateien exportiert werden müssen diese einmalig über den Export Pfeil an den Shop übertragen werden, was auch entsprechend quittiert wird
-
Danach muss dann der manomano Cronjob durchlaufen, der zuerst die Artikeldatei generiert und danach an den FTP überträgt
-
Auf dem FTP ist dann die Datei, die man ManoMano in welcher Form, die es auch wünschen, zur Verfügung stellen kann.
Um Aufträge zu importieren, führt Xentral die folgenden zwei API-Aufrufe aus:
-
get_orders
Importiert die Aufträge in deine Xentral-Instanz.
-
accept_orders
Nach dem Import setzt dieser API-Aufruf den Status des importierten Auftrags in deinem Shop auf In Vorbereitung. Aufträge mit dem Status In Vorbereitung werden nicht importiert.
Anmerkung
Sollte ein Auftrag nicht richtig importiert werden, dann prüfe bitte den Status des Auftrags in deinem Shop.