mirror of
https://github.com/OpenXE-org/OpenXE.git
synced 2024-12-25 22:20:29 +01:00
1 line
14 KiB
Plaintext
1 line
14 KiB
Plaintext
<span style="font-size:28px;"><strong>Gambio Schnittstelle - Installation & Einrichtung</strong></span><br /><br /><span class="wiki-text">Mit dieser Schnittstelle können Sie Xentral mit <span class="highlight" rel="Shopify">Gambio </span>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). </span><br /><br /> <div class="video-box youtube-video"><span class="wiki-text"><iframe allowfullscreen="" frameborder="0" src="https://www.youtube.com/embed/49PICIq3XP8"></iframe><br /> </span><h1><span class="wiki-text">Features der Schnittstelle</span></h1><ul><li><span class="wiki-text">Aufträge aus Gambio abholen</span></li><li><span class="wiki-text">Auftragsstatus bei Versand in Gambio umstellen inkl. Meldung Trackingnummer</span></li><li><span class="wiki-text">Artikel einzeln von Xentral nach Gambio oder von Gambio nach Xentral übertragen</span></li><li><span class="wiki-text">Artikelkategorien sowie Artikeleigenschaften von Xentral nach Gambio übertragen</span></li><li><span class="wiki-text">Lagerzahlen sowie Pseudolagerzahlen zu Gambio übertragen</span><br /> </li></ul><h1><span class="wiki-text">Installation der Schnittstelle</span></h1><h2><span class="wiki-text">Neuen Shop anlegen</span></h2><span class="wiki-text">Unter Administration → Online-Shops → NEU können Sie den Gambio Shop auswählen.<br /><br /> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/gambio_importer_installieren.png" src="https://xentral.com/images/wiki-import/entwickler/gambio_importer_installieren.png" style="cursor: pointer;" /></span></span><h2><br /><span class="wiki-text">Schnittstellen-Daten eintragen</span></h2><span class="wiki-text">Unter Details → Schnittstelle können Sie danach die entsprechenden Daten aus dem Gambio-Backend hinterlegen:<br /><br /> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/gambio_importer_details_schnittstelle.png" src="https://xentral.com/images/wiki-import/entwickler/gambio_importer_details_schnittstelle.png" style="cursor: pointer;" /></span></span><h5 id="einstellungen-f-r-shop-oder-marktplatz"><span class="wiki-text"> </span></h5><h3><span style="font-size:16px;"><strong><span class="wiki-text">Einstellungen für Shop oder Marktplatz</span></strong></span></h3><ul><li><span class="wiki-text"><strong>Protokollierung im Logfile:</strong> Legt beim Arbeiten mit der Shop-Schnittstelle Daten zur Fehlersuche in einem Log ab.</span></li><li><span class="wiki-text"><strong>Benutzer</strong>: Hier muss der Nutzer eingetragen werden, der Zugriff auf die API hat. Meistens ein Administrator</span></li><li><span class="wiki-text"><strong>Passwort</strong>: Hier muss das entsprechende Passwort für den API Nutzer eingetragen werden</span></li><li><span class="wiki-text"><strong>API Url:</strong> <a href="https://ihreshopurl/api.php/v2">https://ihreshopurl/api.php/v2</a> (Bitte achten Sie auf http oder https)</span></li><li><span class="wiki-text"><strong>Artikel in passende Kategorie verschieben:</strong> Relevant für Artikelexport Xentral → Shop. Wenn nicht gesetzt wird eine Sammelkategorie in Gambio verwendet.</span></li><li><span class="wiki-text"><strong>ID Steuerklasse Normal:</strong> Steuerklassen gemäß Gambio Einstellung</span></li><li><span class="wiki-text"><strong>ID Steuerklasse Ermäßigt:</strong> Steuerklassen gemäß Gambio Einstellung</span></li><li><span class="wiki-text"><strong>ID Steuerklasse Befreit:</strong> Steuerklassen gemäß Gambio Einstellung</span></li><li><span class="wiki-text"><strong>Statusname Bestellung offen: </strong>Der Name des Status im Shop, um offene Bestellungen darzustellen.</span></li><li><span class="wiki-text"><strong>ID Bestellung in Bearbeitung: </strong>Hier ist die ID einzutragen, auf welche Gambio die Bestellung in den Status „in Bearbeitung“ setzt</span></li><li><span class="wiki-text"><strong>ID Bestellung abgeschlossen:</strong> Hier ist die ID einzutragen, auf welche Gambio die Bestellung in den Status „abgeschlossen“ setzt</span></li></ul><span class="wiki-text"> </span><h2><strong><span style="font-size:16px;"><span class="wiki-text">Verbindung prüfen</span></span></strong></h2><span class="wiki-text">Bitte beachten Sie, dass die Verbindung nicht klappt, wenn der Shop sich im Wartungsmodus befindet.<br /> </span><h1><span class="wiki-text">Aufträge zu Xentral übertragen</span></h1><span class="wiki-text">Der Import von Aufträgen aus dem Shop zu Xentral ist <a href="https://xentral.com/helpdesk/kurzanleitung-import-von-bestellungen-aus-online-shops">in diesem Artikel</a> beschrieben.<br /> </span><h1><span class="wiki-text">Artikel zu Gambio exportieren</span></h1><p><span class="wiki-text">Folgende Informationen eines Artikels können zu Gambio übertragen werden:</span></p><ul><li><strong>Wesentliche Merkmale </strong>→ Im Artikel in Xentral kann ein Freifeld angelegt werden, dessen Inhalt in das Feld "Wesentliche Merkmale" (checkoutinformation) von Gambio übertragene wird (Anleitung unten).</li><li><strong>Hersteller</strong> → Hersteller des Artikels. Wird im Shop neu angelegt, wenn im Artikel angegeben, aber im Shop noch nicht vorhanden.</li><li><strong>Herstellerlink</strong> → Herstellerlink des Artikels. Für deutsch und englisch wird hier der selbe Link übertragen.</li><li><strong>Artikelbild alternative Beschreibung</strong> → Kommt aus der Bildbeschreibung in Xentral. Für deutsch und englisch wird hier der selbe Text übertragen.<br /> </li></ul><h2>Wesentliche Merkmale übertragen</h2>Gambio verlangt unter Umständen, dass jeder Artikel Informationen im Feld <strong>"Wesentliche Merkmale"</strong> 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 <strong>checkoutinformation</strong> mappen.<br /><br />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.<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_gambio&fileid=3550" style="width: 1200px; height: 200px;" /><br /><br /><br /><br /><br />2. Das Freifeld in der Shopschnittstelle wiefolgt unter "Freifelder" auf das Feld <strong>"checkoutinformation" </strong>von Gambio mappen:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_gambio&fileid=3548" style="width: 1200px; height: 263px;" /><br /><br /><br />3. In Gambio erscheint nun der Inhalt des Freifeldes unter "Wesentliche Merkmale" des Artikels:<br /><br /><img alt="" src="./index.php?module=wiki&action=getfile&workspacefolder=XentralHandbuch&article=shopimporter_gambio&fileid=3549" style="width: 800px; height: 375px;" /><p><br /> </p><h2><span class="wiki-text">Export von Artikel-Eigenschaften</span></h2><span class="wiki-text">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.<br /><br />Der Datenbankpfad muss ohne http: und ohne Port angegeben werden.<br /> <span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/gambio_datenbankzugang.png?" src="https://xentral.com/images/wiki-import/entwickler/gambio_datenbankzugang.png?" style="cursor: pointer;" /></span><br /> </span><br /> <h1><span class="wiki-text">Datenbank-Verbindung zu Gambio herstellen (für Techniker)</span></h1><span class="wiki-text">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.<br /><br />Für folgende Funktionen wird eine Datenbankverbindung benötigt:</span><ul><li><span class="wiki-text">Artikelexport: Eigenschaftenübertragung</span></li><li><span class="wiki-text">Artikelexport: Variantenartikel in korrekter Variantenstruktur übertragen</span></li><li><span class="wiki-text">Auftragsimport: Artikelnummer bei Varianten</span></li><li><span class="wiki-text">Auftragsimport: Customizer Data bei Artikeln</span></li><li><span class="wiki-text">Auftragsimport: Transaktionsnummer</span></li></ul><span class="wiki-text">Um Ihre Shopdatenbank mit Xentral zu verbinden kann auf zwei Arten vorgegangen werden:</span><p><span class="wiki-text"><span style="font-size:16px;"><strong>1. Datenbank nach außen öffnen</strong></span></span></p>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.<p><strong><span style="font-size:16px;"><span class="wiki-text">2. Veschlüsselter Zugriff auf die Datenbank über ODBC</span></span></strong></p><span class="wiki-text">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.<br />Hierfür muss neben den Datenbankzugriffsdaten noch der Pfad zum ODBC-Connector eingetragen werden, der verwendet werden soll.<br /><br /><span class="wiki-text"> </span><span class="wiki-text"><img data-mfp-src="/images/wiki-import/entwickler/gambio_datenbank_verbindung_felder.png" src="https://xentral.com/images/wiki-import/entwickler/gambio_datenbank_verbindung_felder.png" style="cursor: pointer;" /></span><br /><br />Wenn die Daten eingetragen und gespeichert wurden kann durch einen Klick auf "Verbindung prüfen" sichergestellt werden, dass die Datenbankverbindung korrekt hergestellt werden kann.<br /><br />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.<br /><br />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.<br />Hier finden Sie eine Anleitung für ein exemplarisches Vorgehen: <a href="https://putokaz.wordpress.com/2018/02/12/how-to-install-the-mysql-odbc-driver-on-ubuntu-16-04-or-linux-mint-18-x/">https://putokaz.wordpress.com/2018/02/12/how-to-install-the-mysql-odbc-driver-on-ubuntu-16-04-or-linux-mint-18-x/</a><br /><br />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.<br /> </span><h1><span class="wiki-text">Technische Dokumentation</span></h1><h2><span class="wiki-text">Status der Aufträge</span></h2><span class="wiki-text">Ü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: <strong>orders_status</strong></span><br /> <h2><span class="wiki-text">Import von PayPal-Zahlungen</span></h2><p><span class="wiki-text">Werden aus dem Gambio-Shop Aufträge mit der Zahlungsweise PayPal importiert, gilt Folgendes zu beachten:</span></p>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 <strong>"Transaktion"</strong> zu Xentral übernommen werden):<ul><li><strong>PayPal</strong>: Transaktionsnummer (<strong>Transaktions-ID</strong>) -> Normales PayPal Konto ohne PayPalPlus -> es wird die reguläre Transaktionsnummer übergeben, diese wird dann zum Kontoauszug gemapped (im Kontoauszug befindet sich ebenfalls die Transaktionsnummer)</li><li><a href="https://xentral.com/helpdesk/kurzanleitung-paypalplus?"><strong>PayPal Plus</strong></a>: <strong>PAYID</strong> → PayPalPlus Konto → Es wird meist die PAYID (anstelle der regulären Transaktionsnummer) übergeben, diese wird dann zum Kontoauszug gemapped. Im Kontoauszug befindet sich die Transaktionsnummer, Xentral holt parallel die PAYID über die Bankanbindung mit ab, sodass diese Nummer ein erfolgreiches Zahlungsmapping gewährleistet).</li></ul><span class="wiki-text"> </span><h1><span class="wiki-text">Troubleshooting</span></h1><span class="wiki-text">Wenn Xentral meldet, dass keine Aufträge im Shop vorhanden sind, obwohl welche vorhanden sein müssten, können Sie folgenden Punkte prüfen:<br /><br /><strong>1. Anmeldedaten fehlerhaft</strong><br /><br />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.<br /><br /><strong>2. Fehlender logfiles Ordner</strong><br /><br />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/...<br /> </span></div> |