1 Funktionsumfang Vorteile auf einen Blick Installation Dateien kopieren (alle Versionen)... 3

Transkript

1 OXID VIA-eBay Plug-In Nutzerdokumentation Modul Version: Shopversion: OXID /5.0 Inhaltsverzeichnis 1 Funktionsumfang Vorteile auf einen Blick Installation Dateien kopieren (alle Versionen) Install.sql und update view Modul aktivieren Schreibrechte für die Logdatei tmp-verzeichnis leeren und Shop aktualisieren Konfiguration Konfiguration in OXID Statuskontrolle Artikelfilter Artikel ausschließen Variantenartikel Artikelbilder Synchronisieren Bestelllungen synchronisieren Bestellung abschließen VIA Backend FAQ derksen mediaopt gmbh kontakt@mediaopt.de elbestrasse 28/ berlin +49 (30) fax-66 ust.-id DE HRB B Amtsgericht Charlottenburg geschäftsführer dipl.-ing. philipp derksen Seite 1

2 1 Funktionsumfang Das VIA-eBay Modul ermöglicht das Einstellen von Produkten aus Ihrem OXID eshop auf ebay. Dabei werden aus der Produktdatenbank die Produktinformationen an VIA-eBay übergeben. VIA-eBay wandelt diese in ebay-konforme Daten um, die dann bei ebay, nach Ihren Vorgaben, als Produkte eingestellt werden. Wird ein Verkauf über ebay erzielt, gibt VIA-eBay diesen an Ihren Shop zurück. Dort können Sie dann alles in gewohnter Weise abwickeln. Der hohe Automatisierungsgrad von VIA-eBay ermöglicht Ihnen eine effiziente Handhabung. Grundlegende Einstellungen tätigen Sie so, dass Sie keine zusätzliche Arbeit im Tagesgeschäft haben. Und das alles bequem aus dem Backend Ihres Shops heraus. 1.1 Vorteile auf einen Blick Bestückung Ihrer ebay Angebote aus Ihrem OXID Shop-Backend. Intuitiver Einrichtungsassistent und Automatisierung ermöglichen ein nahezu sofortiges Arbeiten mit ebay, ohne Detailkenntnisse zu ebay. Ein Artikelfilter mit 5 Kriterien ermöglicht eine gezielte Auswahl der zu synchronisierenden Produkte. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 2

3 2 Installation Sichern Sie Ihre Shop Daten. Sollten Sie Bedenken bezüglich der Installation des Moduls haben, lassen Sie diese von fachkundigem Personal vornehmen, gerne unterstützen wir Sie dabei. Dieses Modul wurde für die OXID Shop Editionen CE, PE, EE unter den o.g. Versionen entwickelt. Folgen Sie der Anleitung für einen problemlosen Betrieb. Sollte es Unklarheiten in den Installationsanweisungen geben, freuen wir uns über Ihr Feedback 2.1 Dateien kopieren (alle Versionen) Stellen Sie eine Verbindung z.b. via FTP zu Ihrem Webserver her. Kopieren Sie den Inhalt des Verzeichnisses copy_this in Ihr Shop Stammverzeichnis. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 3

4 2.2 Install.sql und update view Führen Sie nun das Datenbank-Update unter Service => Tools durch. Verwenden Sie dafür die install.sql aus. Updaten Sie anschließend die Views. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 4

5 2.3 Modul aktivieren Aktivieren Sie Ihr Modul über das OXID Modulhandling. 2.4 Schreibrechte für die Logdatei Erstellen Sie in Ihrem Shopverzeichnis die Datei /log/mo_viaebay.log und stellen Sie sicher, dass die Datei Schreibrechte hat (z.b. 777). Die Dateiberechtigungen können u.a. mit einem FTP-Tool verwaltet werden. 2.5 tmp-verzeichnis leeren und Shop aktualisieren Im OXID Hauptverzeichnis unter /tmp sämtliche *.php & *.txt Dateien löschen. Leeren Sie nun Ihren Browser Cache, löschen Sie ggfs. Cookies und aktualisieren Sie anschließend Ihre Shop- Backendseite mit F5. Es sollte nun der Menüpunkt VIA ebay aufgeführt sein. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 5

6 3 Konfiguration 3.1 Konfiguration in OXID Richten Sie nun Ihre neue Schnittstelle ein, indem Sie zuerst Ihre VIA-eBay Zugangsdaten eintragen (API Username, API Passwort, Subscription Token). Lagerbestand Legen Sie fest, welche Menge eines zu exportierenden Artikels jeweils an VIA-eBay übertragen werden soll. Beachten Sie dabei, dass Artikel mit einem geringeren Lagerbestand nur mit der tatsächlich vorhanden Artikelmenge an VIA-eBay übertragen werden. Wir empfehlen diesen Wert stets geringer zu halten, als den im Artikelfilter festgelegten Lagerbestand (siehe 3.3). Sprache Durch die Spracheinstellungen definieren Sie, welche Artikeltexte und -beschreibungen an VIA-eBay übertragen werden sollen, falls Sie in Ihrem Shop mehrere Sprachversionen verwenden. Synchronisationsintervalle Die Synchronisationsintervalle für die einzelnen Tasks Pull Orders, Sync Categories und Sync Articles definieren die Abstände, in denen diese durchgeführt werden sollen. Voraussetzung dafür ist, dass der entsprechende Cronjob eingerichtet wurde (siehe 3.6). Für den regelmäßigen Betrieb empfehlen wir ein kurzes Intervall für den Bestell- und Artikelimport. Synchronisations-Skripte im Browser Möchten Sie Ihre Synchronisation manuell unter den Synchronisationseinstellungen und somit Ihre Synchronisations-Skripte im Browser ausführen, dann muss der Haken an dieser Stelle gesetzt sein. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 6

7 Beachten Sie bitte, dass Sie in diesem Fall Ihr Skriptverzeichnis SHOP-URL/modules/mo _viaebay/scripts/ durch htaccess vor unerwünschten Zugriffen schützen sollten. Sandbox-Modus Sofern Sie Ihre VIA-eBay Schnittstelle über einen Sandbox Account testen, sollte die entsprechende Einstellung gewählt werden. Vergessen Sie nicht, den Haken zu entfernen, wenn Sie mit Ihrem System in einer Live-Umgebung arbeiten. 3.2 Statuskontrolle Um einen Überblick über Ihre einzelnen Synchronisationsvorgänge zu behalten, können Sie im Statusbereich einen Auszug der aktuellen Log-Datei auswerten. 3.3 Artikelfilter An dieser Stelle können Sie Ihre zu exportierenden Artikel definieren. Sie haben die Möglichkeit, Ihre Artikel nach Kategorie, Hersteller, Preis, vorhandenem Artikelbild und Mindestlagerbestand zu filtern. Ein Vorschaufenster fasst Ihre Auswahl noch einmal für Sie zusammen. Wir empfehlen, den Lagerbestand größer zu wählen, als den in der Konfiguration festgelegten zu exportierenden Lagerbestand. Es geht hier zunächst darum, die gewünschten Artikel zu erfassen. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 7

8 3.4 Artikel ausschließen Sollten trotz Artikelfilters weiterhin unerwünschte Artikel im Export erscheinen, können Sie auf Artikelebene die Erlaubnis zum Abgleich entziehen. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 8

9 3.5 Variantenartikel Bitte beachten Sie, dass nur Variantenartikel übertragen werden können, sofern die einzelnen Variantenausprägungen auch als tatsächliche Artikel hinterlegt sind. D.h. Ausprägungen, die über Auswahllisten definiert werden, können nicht an VIA-eBay übertragen werden. Die Ausprägungen der verschiedenen Varianten müssen mit (Pipe) voneinander getrennt werden. 3.6 Artikelbilder Die Artikelbilder werden von Oxid an Via ebay, wie folgt übertragen: Bei keinen Thumbnail: OXID #1 = Listenbild (Image.Type = 1) OXID #1 = Angebotsbild (Image.Type = 2) OXID #2 = Galeriebild 1 (Image.Type = 3) OXID #3 = Galeriebild (Image.Type = 4) OXID #4 = Galeriebild (Image.Type = 5) OXID #5 = Galeriebild (Image.Type = 6) Bei einem angebenden Thumbnail: OXID eigenes Thumbnail = Listenbild (Image.Type = 1) OXID #1 = Angebotsbild (Image.Type = 2) OXID #2 = Galeriebild 1 (Image.Type = 3) OXID #3 = Galeriebild (Image.Type = 4), OXID #4 = Galeriebild (Image.Type = 5) OXID #5 = Galeriebild (Image.Type = 6) OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 9

10 Dabei werden eigene Bildversionen nach den Via ebay Größenanforderungen für die definierten Artikelbilder erstellt. Listenbild Das Listenbild (Galeriebild) entspricht dem Bild in der Auflistung der Artikel oder bei einem Suchergebnis. Maximale Bildgröße für ein ebay Listenbild ist: 225px x 225px Angebotsbild Das Angebotsbild (Standardbild) entspricht dem Bild in der Detailsansicht eines ebay Angebotes. Bildgröße für ein ebay Angebotsbild ist: minimal 500px x 500px bzw. maximal 1500px x 1500px. 3.7 Synchronisieren Mit Cronjob Richten Sie auf Ihrem Server einen Cronjob ein, der das angegebene Skript ausführt. Wir empfehlen ein Ausführungsintervall von 5 Minuten zu konfigurieren, jedoch mindestens 24 Stunden abhängig vom Umfang Ihrer ebay-aktivitäten und Serverauslastung. Wenn Sie die Oxid Enterprise Edition nutzen können Sie die Shop-ID als Parameter an das Skript übergeben. Beispiel: SHOP-URL/modules/mo_viaebay/scripts/mo_viaebay sync_all.php Manuell Wenn Sie Ihre Artikel ausgewählt haben, können Sie nun noch eine manuelle Synchronisation anstoßen. Sollten Sie in Ihrem Shop auch die Kategorien angepasst haben, dann achten Sie bitte darauf, zuerst die Kategorien und dann erst die Artikel zu synchronisieren. Bitte beachten OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 10

11 Bei jedem Übertragungsintervall können nur je 20 Artikel übertragen werden. Wenn Sie also bei einer Artikelsynchronisation eine große Artikelmenge übertragen möchten, sollten Sie das Synchronisationsintervall entsprechend klein wählen, damit der Synchronisationsprozess möglichst schnell abläuft. Ein fehlerhafter Artikel wird noch während des Synchronisationsprozesses deaktiviert, um die Synchronisationskette nicht zu gefährden. Diesen müssen Sie selbst wieder aktivieren. 3.8 Bestelllungen synchronisieren Alle Bestellungen die über ebay eingegangen sind, werden in Oxid angelegt. Bei Bestellungen, wo der Kunde nicht bekannt ist, werden die fehlenden Daten durch - ersetzt. 3.9 Bestellung abschließen Sollten Sie, wie gewohnt, an dieser Stelle das Datum für Zahlungseingang bzw. Lieferung festlegen, wird die entsprechende Information auch an VIA ebay übertragen. Sie sollten nach erfolgreicher Übermittlung im VIA ebay Reiter eine entsprechende Rückmeldung einsehen können. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 11

12 4 VIA Backend Beziehen Sie Ihre Zugangsdaten für die VIA-eBay Kommunikation mit Ihrem Onlineshop aus dem Backend Ihrer VIA-eBay Schnittstelle. Nach einem korrekten Export Ihrer Artikeldaten aus Ihrem OXID eshop (manueller, oder Cronjobgesteuerter Synchronisations-Prozess), erscheint im VIA-eBay Backend zuerst die Menge der exportierten Artikel in der Übersicht. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 12

13 Kontrollieren und ergänzen Sie alle Produktbeschreibungen und Kategorienzuordnungen für ebay in den Produktansichten. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 13

14 5 FAQ F: Die Artikel sind nur unvollständig nach VIA ebay übertragen worden. A: Eventuell war die Kategoriensynchronisation noch nicht vollständig abgeschlossen. Starten die diesen Vorgang erneut. A: Achten Sie darauf, dass genügend Artikel auf Lager sind, bevor Sie diese in VIA-eBay exportieren. A: Stellen Sie sicher, dass der zu exportierende Lagerbestand ausgefüllt ist. F: Woran erkenne ich, dass der Export meiner Artikel stattgefunden hat? A: In Ihrem Statusfenster werden alle Logeinträge der Kommunikation zwischen OXID und VIA ebay dokumentiert. OXID VIA-eBay Plug-In Version: 1.1. derksen mediaopt GmbH 2013 Seite 14