Gambio Schnittstelle - Installation & Einrichtung

Mit dieser Schnittstelle können Sie Xentral mit Gambio verbinden, um Bestellungen von dort in Xentral zu importieren und Ihre im Shop verkauften Artikel in Xentral zu verwalten. Die Anbindung geschieht über eine API-Schnittstelle (Shopimporter).

 

 

Features der Schnittstelle

Installation der Schnittstelle

Neuen Shop anlegen

Unter Administration → Online-Shops → NEU können Sie den Gambio Shop auswählen.

 


Schnittstellen-Daten eintragen

Unter Details → Schnittstelle können Sie danach die entsprechenden Daten aus dem Gambio-Backend hinterlegen:

 
 

Einstellungen für Shop oder Marktplatz

 

Verbindung prüfen

Bitte beachten Sie, dass die Verbindung nicht klappt, wenn der Shop sich im Wartungsmodus befindet.
 

Aufträge zu Xentral übertragen

Der Import von Aufträgen aus dem Shop zu Xentral ist in diesem Artikel beschrieben.
 

Artikel zu Gambio exportieren

Folgende Informationen eines Artikels können zu Gambio übertragen werden:

Wesentliche Merkmale übertragen

Gambio verlangt unter Umständen, dass jeder Artikel Informationen im Feld "Wesentliche Merkmale" besitzt. Um dieses Feld durch den Artikelexport von Xentral zu Gambio zu füllen, können Sie ein Freifeld im Artikel anlegen und dieses im Freifeldermapping der Shop-Schnittstelle auf das Feld checkoutinformation mappen.

1. Im Artikel ein Freifeld anlegen und es mit den Infos befüllen, die später in den "Wesentlichen Merkmalen" im Gambio stehen sollen. Soll im englischen Shop ein anderer Text gezeigt werden, legen Sie auch eine englische Übersetzung des Freifeldes an.






2. Das Freifeld in der Shopschnittstelle wiefolgt unter "Freifelder" auf das Feld "checkoutinformation" von Gambio mappen:




3. In Gambio erscheint nun der Inhalt des Freifeldes unter "Wesentliche Merkmale" des Artikels:


 

Export von Artikel-Eigenschaften

In Xentral lassen sich Artikeleigenschaften an Gambio übertragen, dazu benötigt Xentral die Datenbankzugangsdaten des Gambio-Shops, da die Gambio-API die Funktion nicht unterstützt.

Der Datenbankpfad muss ohne http: und ohne Port angegeben werden.
 
 
 

Datenbank-Verbindung zu Gambio herstellen (für Techniker)

Für einige Features der Gambio-Schnittstelle wird eine direkte Anbindung an die Datenbank des Shops benötigt, da die REST-API von Gambio diese Funktionen nicht bereitstellt.

Für folgende Funktionen wird eine Datenbankverbindung benötigt:Um Ihre Shopdatenbank mit Xentral zu verbinden kann auf zwei Arten vorgegangen werden:

1. Datenbank nach außen öffnen

Die Datenbank des Gambio-Shops kann für den Außenzugriff geöffnet werden. Sollte die Datenbank des Shops von außen erreichbar sein, bzw. sich im selben Netz befinden wie Xentral, kann der Datenbankzugriff über Boardmittel realisiert werden. Dazu ist es ausreichend die Felder für den Datenbankzugriff entsprechend zu pflegen.

2. Veschlüsselter Zugriff auf die Datenbank über ODBC

Falls die Shopdatenbank nicht direkt vom Xentral-System aus erreichbar ist, oder ein Öffnen der Datenbank nach außen nicht gewollt oder möglich ist, kann stattdessen eine Verbindung über einen ODBC-Connector hergestellt werden.
Hierfür muss neben den Datenbankzugriffsdaten noch der Pfad zum ODBC-Connector eingetragen werden, der verwendet werden soll.

 

Wenn die Daten eingetragen und gespeichert wurden kann durch einen Klick auf "Verbindung prüfen" sichergestellt werden, dass die Datenbankverbindung korrekt hergestellt werden kann.

Falls ihr System auf der Xentral Cloud installiert ist, reicht zur Verwendung des ODBC-Connectors aus die Checkbox "Verbindung über ODBC herstellen" zu aktivieren. Auf der Cloud ist bei allen Installation der Connector bereits hinterlegt.

Ist die Xentral-Installation nicht auf der Cloud gehostet, muss der ODBC-Connector gegebenenfalls manuell installiert werden. Zusätzlich muss dafür auch der lokale Pfad zum Treiber in den Importereinstellungen hinterlegt werden.
Hier finden Sie eine Anleitung für ein exemplarisches Vorgehen: https://putokaz.wordpress.com/2018/02/12/how-to-install-the-mysql-odbc-driver-on-ubuntu-16-04-or-linux-mint-18-x/

Nachdem die Einstellungen gespeichert wurden, kann mit einem Klick auf "Verbindung prüfen" überprüft werden, ob der Connector funktioniert. Etwaige Fehlermeldungen vom Connector werden durch den Importer direkt weitergereicht.
 

Technische Dokumentation

Status der Aufträge

Über die API werden alle Aufträge abgeholt mit Order Status "1" (Im Standard ist das "offen" / Stand 12/2016). Die Tabelle für die Status in Gambio findet sich hier: orders_status
 

Import von PayPal-Zahlungen

Werden aus dem Gambio-Shop Aufträge mit der Zahlungsweise PayPal importiert, gilt Folgendes zu beachten:

Beim Import eines Shop-Auftrags wird folgende Transaktionsnummer mit übergeben (abhängig von der Einstellung des Shops kann eine der beiden Nummerntypen in das Feld "Transaktion" zu Xentral übernommen werden): 

Troubleshooting

Wenn Xentral meldet, dass keine Aufträge im Shop vorhanden sind, obwohl welche vorhanden sein müssten, können Sie folgenden Punkte prüfen:

1. Anmeldedaten fehlerhaft

Der Importer meldet nicht zurück dass die Anmeldedaten fehlerhaft sind. Wenn eine Anmeldung im Gambioshop als Admin möglich ist, ist davon auszugehen dass die Daten korrekt sind.

2. Fehlender logfiles Ordner

Bei der Installation von Gambio wurde aus irgendeinem Grund kein logfiles Ordner angelegt. Dieser kann nachträglich, am Besten mit allen Rechten per FTP angelegt werden. Da Gambio bei der Anmeldung über die API versucht in die Logdatei in diesem Ordner zu schreiben kommt es zu einem Fehler der die Anmeldung scheitern lässt. Die Antwort XML enthält in diesem Fall keine SessionID und den Wortlaut:...ErrorException' with message 'file_put_contents(/var/www/vhosts/webshop.com/httpdocs/logfiles/xml.log): failed to open stream: No such file or directory' in /var/www/vhosts/webshop.com/httpdocs/system/classes/gambio_xml/...