Gambio Schnittstelle - Installation & Einrichtung

Um Gambio in Xentral integrieren zu können benötigt man zwei Schritte. Xentral bindet externe Shops, auch wenn diese extra APIs anbieten immer über einen Xentral Shop-Importer an. Das ist die genormte Schnittstelle für Xentral. In dieser Schnittstelle wird dann oft bei z.B. Shopware oder Gambio auf die echte API vom Shop zugegriffen. Aber die Kommunikation mit Xentral geschieht immer über den Importer.

Features der Schnittstelle

  • Aufträge abholen
  • Auftragsstatus bei Versand umstellen inkl. Meldung Trackingnummer
  • Artikel einzeln von Xentral nach Gambio oder von Gambio nach Xentral übertragen
  • Meldung aktueller Lagerzahlen
Die Rechnung und oder Lieferschein kann durch Xentral mit eigenen Nummernkreisen erstellt werden. Die Belege werden im Versandprozess automatisch erstellt und versendet bzw. am Versanddrucker ausgedruckt.

Installation der Schnittstelle

Neuen Shop anlegen

Unter Administration => Online-Shops => NEU können Sie den Gambio Shop auswählen. :entwickler:gambio_importer_installieren.png

Schnittstellen-Daten eintragen

Unter Details => Schnittstelle können Sie danach die entsprechenden Daten aus dem Gambio-Backend hinterlegen: :entwickler:gambio_importer_details_schnittstelle.png
Einstellungen für Shop oder Martkplatz
Protokollierung im Logfile: Legt beim Arbeiten mit der Shop-Schnittstelle Daten zur Fehlersuche in einem Log ab.
Benutzer: Hier muss der Nutzer eingetragen werden, der Zugriff auf die API hat. Meistens ein Administrator
Passwort: Hier muss das entsprechende Passwort für den API Nutzer eingetragen werden
API Url: ihreshopurl/api.php/v2
Artikel in passende Kategorie verschieben: Relevant für Artikelexport Xentral → Shop. Wenn nicht gesetzt wird eine Sammelkategorie in Gambio verwendet.
ID Steuerklasse Normal: Steuerklassen gemäß Gambio Einstellung
ID Steuerklasse Ermäßigt: Steuerklassen gemäß Gambio Einstellung
ID Steuerklasse Befreit: Steuerklassen gemäß Gambio Einstellung
Statusname Bestellung offen: Der Name des Status im Shop, um offene Bestellungen darzustellen.
ID Bestellung in Bearbeitung: Hier ist die ID einzutragen, auf welche Gambio die Bestellung in den Status „in Bearbeitung“ setzt
ID Bestellung abgeschlossen: Hier ist die ID einzutragen, auf welche Gambio die Bestellung in den Status „abgeschlossen“ setzt

Aufträge zu Xentral übertragen

Das Importieren von Bestellungen aus Online Shops ist hier beschrieben

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

Troubleshooting

Xentral meldet dass keine Aufträge im Shop vorhanden sind, obwohl welche vorhanden sein müssten

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.
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/...

FAQs

War der Artikel hilfreich?
Vielen Dank für Ihr Feedback!

Made with ❤ at zwetschke.de