OXID VIA-eBay Plug-In Nutzerdokumentation

OXID VIA-eBay Plug-In
Nutzerdokumentation
Modul Version: 1.1.0
Shopversion: OXID 4.6. – 4.7./5.0
Inhaltsverzeichnis
1
Funktionsumfang .............................................................................................................................. 2
1.1
2
3
Vorteile auf einen Blick ............................................................................................................ 2
Installation ........................................................................................................................................ 3
2.1
Dateien kopieren (alle Versionen) ........................................................................................... 3
2.2
Install.sql und update view ...................................................................................................... 4
2.3
Modul aktivieren ...................................................................................................................... 5
2.4
Schreibrechte für die Logdatei................................................................................................. 5
2.5
tmp-Verzeichnis leeren und Shop aktualisieren ...................................................................... 5
Konfiguration .................................................................................................................................... 6
3.1
Konfiguration in OXID .............................................................................................................. 6
3.2
Statuskontrolle ......................................................................................................................... 7
3.3
Artikelfilter ................................................................................................................................ 7
3.4
Artikel ausschließen ................................................................................................................ 8
3.5
Variantenartikel ........................................................................................................................ 9
3.6
Artikelbilder .............................................................................................................................. 9
3.7
Synchronisieren ..................................................................................................................... 10
3.8
Bestelllungen synchronisieren ............................................................................................... 11
3.9
Bestellung abschließen ......................................................................................................... 11
5
VIA Backend ................................................................................................................................... 12
6
FAQ ................................................................................................................................................ 14
derksen mediaopt gmbh | www.mediaopt.de | [email protected]
elbestrasse 28/29 | 12045 berlin | +49 (30) 34 09 42-77 | fax-66 | ust.-id DE265886017 |
HRB 120935 B | Amtsgericht Charlottenburg | geschäftsführer dipl.-ing. philipp derksen
Seite 1
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
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 ([email protected]).
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
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
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 ShopBackendseite 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
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
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
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
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
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
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
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
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
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