Dokumenttyp: Benutzerdokumentation Beschreibt die Funktionalität des Interfaces ab Version Datum: November 2017

Transkript

1 1 Amazon Interface Amazon Interface Dokumenttyp: Benutzerdokumentation Beschreibt die Funktionalität des Interfaces ab Version Datum: November 2017 Bearbeiter: egate media GmbH

2 2 Amazon Interface INHALTSVERZEICHNIS Inhaltsverzeichnis Einleitung Amazon allgemein egate media Amazon Modul Shop Admin Bereich Login Modul Einstellungen Versandkostenregeln Fehlermeldungen Update Artikeldaten Kategorien Einstellungen Artikel Einstellungen Alle Artikel eines Herstellers aktivieren bzw. deaktivieren Versandarten... 18

3 3 Amazon Interface 1 EINLEITUNG 1.1 AMAZON ALLGEMEIN Die Amazon.com, Inc. ist ein börsennotierter US-amerikanischer Online-Versandhändler mit einer breit gefächerten Produktpalette. Nach eigenen Angaben hat Amazon als Marktführer des Handels im Internet die weltweit größte Auswahl für Bücher, CDs und Videos. Über die integrierten Verkaufsplattformen 'Marketplace' und 'z-shops' können auch Privatpersonen oder andere Unternehmen im Rahmen des Online-Handels neue und gebrauchte Produkte anbieten. 1.2 EGATEMEDIA AMAZON MODUL Das egatemedia Amazon Modul ist eine Schnittstelle zwischen Ihrem OXID eshop und Ihrem Seller Amazon Konto. Die Schnittstelle unterstützt das automatische Hochladen der Shop-Artikel zu Amazon (ggf. inkl. Varianten). Die Artikeldaten werden aktuell gehalten und der Lagerbestand aktualisiert. Bestellungen werden von Amazon in Ihren Shop importiert.

4 4 Amazon Interface 2 SHOP ADMIN BEREICH 2.1 LOGIN Melden Sie sich im Admin Bereich des Shops an. 2.2 MODUL EINSTELLUNGEN Die allgemeinen Einstellungen des Interfaces werden unter egate-media -> Amazon -> Einstellungen vorgenommen. Diese Einstellungen gliedern sich in folgende Sektionen: Grundeinstellungen Marktplätze Artikel-Updates Verkaufsbereich Kategorien Preisgestaltung Preismanager Standarddaten Bestellimport Cronjob System-Info

5 5 Amazon Interface Die Sektion Grundeinstellungen im Detail: Aktivieren: Aktivierung des Moduls Logging aktivieren: Aktivierung des Loggings. In der Datenbank Tabelle emamazon_logging werden die Details zur Cronjob Ausführung vermerkt. Folgende Felder werden von Amazon bereitgestellt. Bitte tragen Sie diese ein: Händler ID AWS Zugangsschlüssel-ID Geheimer Schlüssel In der Sektion Marktplätze wird der Artikel-Export für die einzelnen Amazon Marktplätze aktiviert. Es ist folgendes zu beachten: Die Service-URL und die Marktplatz-ID sind bereits auf die entsprechenden Werte gesetzt und sollten nicht geändert werden. Aktivieren: Aktivierung des Marktplatzes. Sprache: Bestimmt die Shop-Sprache, in der die Daten an Amazon übertragen werden. Beim Bestellimport wird diese Sprache auch im entsprechenden Feld der Bestell-Datenbanktabelle des Shops gesetzt. Währung: Bestimmt die Währung, in der die Preise an Amazon übertragen werden. Beim Bestellimport wird diese Währung auch im entsprechenden Feld der Bestell-Datenbanktabelle des Shops gesetzt.

6 6 Amazon Interface In der Sektion Artikel-Updates sind folgende Einstellungen möglich: Preis direkt übernehmen: Der Preis für Ihre Artikel in Amazon wird direkt aus dem Shop übernommen (falls bei den Amazon Artikel-Einstellungen nicht anders definiert, siehe auch Kapitel 2.7). Ist das Häkchen nicht gesetzt, und der Preis auch bei den Amazon Artikel- Einstellungen wie in Kapitel 2.7 beschrieben nicht definiert, wird der Artikel nicht zu Amazon übertragen. Titel direkt übernehmen: Der Titel für Ihre Artikel in Amazon wird direkt aus dem Shop übernommen (falls es bei den Amazon Artikel-Einstellungen nicht anders definiert, siehe auch Kapitel 2.7). Ist das Häkchen nicht gesetzt, und der Titel auch bei den Amazon Artikel- Einstellungen wie in Kapitel 2.7 beschrieben nicht definiert, wird der Artikel nicht zu Amazon übertragen. Beschreibung direkt übernehmen: Die Beschreibung für Ihre Artikel in Amazon wird direkt aus dem Shop übernommen (falls bei den Amazon Artikel-Einstellungen nicht anders definiert, siehe auch Kapitel 2.7). Ist das Häkchen nicht gesetzt, und die Beschreibung auch bei den Amazon Artikel-Einstellungen wie in Kapitel 2.7 beschrieben nicht definiert, wird der Artikel nicht zu Amazon übertragen. Allgemeine Schlüsselwörter direkt übernehmen: Die Allgemeinen Schlüsselwörter werden für Ihre Artikel in Amazon direkt von den Suchbegriffen des Shops übernommen (falls bei den Amazon Artikel-Einstellungen nicht anders definiert, siehe auch Kapitel 2.7). Bullet Points direkt übernehmen: Die Bullet Points werden für Ihre Artikel in Amazon direkt von den Stichwörtern des Shops übernommen (falls bei den Amazon Artikel-Einstellungen nicht anders definiert, siehe auch Kapitel 2.7). Artikelnummer als MfrPartNumber setzen: Wenn das Häkchen nicht gesetzt ist, wird als MfrPartNumber die EAN verwendet, ansonsten die Artikelnummer. Die Wahl dieser Option wird bei der Amazon Markenregistrierung angegeben. Das Feld ist nur relevant, wenn eine Markenregistrierung durchgeführt wurde. Als StandardProductID EAN verwenden (sonst die Hersteller EAN): Die Artikel müssen über die EAN (oder die ASIN) übertragen werden. Dabei wird das Feld EAN oder Hersteller EAN verwendet, abhängig davon was hier gesetzt ist. Immer mit EAN übertragen: Wenn das Häkchen gesetzt ist, werden die Artikel immer über die EAN hochgeladen, außer es ist eine ASIN beim Artikel im Amazon-Reiter hinterlegt, siehe Kapitel 2.7. Wenn das Häkchen nicht gesetzt ist, wird der Artikel nur beim ersten Mal über die EAN hochgeladen. Danach wird von Amazon die ASIN angefordert, und die Artikel werden danach über die ASIN hochgeladen. Separator der Varianten: Setzen Sie hier das Trennzeichen, welches auch im Shop als Trennzeichen für Varianten verwendet wird. Im Normalfall ist dies das Zeichen. Separator der Schlüsselwörter: Setzen Sie hier das Trennzeichen, welches auch im Shop als Trennzeichen für Suchbegriffe bzw. Schlüsselwörter verwendet wird. Im Normalfall ist dies das Komma. Separator der Bullet Points: Setzen Sie hier das Trennzeichen, welches auch im Shop als Trennzeichen für Bullet Points bzw. Stichwörter verwendet wird.

7 7 Amazon Interface Hauptbild, Bild Nummer: Die hier eingetragene Bildnummer definiert, welches Artikelbild als Hauptbild in Amazon angezeigt wird. Andere Bilder, Bilder von - bis (bitte mit - trennen): Die hier eingetragenen Bildnummern definieren, welche Artikelbilder als Zusatzbilder bei Amazon angezeigt werden. Master Bilder hochladen: Ist das Häkchen gesetzt, werden die Master-Bilder (also die Bilder, welche Sie in voller Auflösung auf den Shop hochgeladen haben) statt der normalen vom Shop genierten Bilder an Amazon übertragen. Dies ist von Vorteil, wenn die für den Shop definierten Bilder-Dimensionen niedriger sind, als was an Amazon übermittelt werden soll. Lagerbestand berücksichtigen bei Übertragung der Artikel: Wenn Häkchen gesetzt, werden nur die Artikel mit einem Lagerbestand höher als dem angegeben Wert 'Lagerbestand' an Amazon übertragen. Wurde der Artikel bereits an Amazon übertragen, und der Lagerbestand fällt unter diesen Wert, wird der Artikel beim nächsten Update gelöscht oder deaktiviert, abhängig davon, ob in der Sektion 'Cronjob', Zeile 'Artikel', in der Dropbox 'löschen' oder 'deaktivieren' eingestellt ist. In der Sektion Verkaufsbereich wird der Amazon-Verkaufsbereich gesetzt. Die Einstellungen Verkaufsbereich, Produktbereich und Variantenart dieser Sektion sind nur dann relevant, wenn bei den Artikeln bzw. Kategorien nicht explizit gesetzt, siehe auch Kapitel 2.6 und 2.7.

8 8 Amazon Interface In der Sektion Kategorien wird die Amazon-Kategorie gesetzt. Auch diese Einstellung ist nur relevant, wenn bei den Artikeln bzw. Kategorien nicht explizit gesetzt, siehe auch Kapitel 2.6 und 2.7. In der Sektion Preisgestaltung wird definiert, welcher Artikelpreis an Amazon übermittelt wird. Es sind sowohl die ABC-Artikelpreise, als auch prozentuale oder absolute Preisaufschläge bzw. Preisabschläge möglich. In der Sektion Preismanager kann konfiguriert werden, wie Amazon die Preise Ihrer Artikel automatisch in Abhängigkeit der Preise anderer Amazon-Anbieter anpasst. Die Preise werden mit dem niedrigsten Preis in Amazon verglichen. Pro Cronjob-Lauf werden 20 Artikel (Maximalwert auf Amazon- Seite) verglichen und ggf. angepasst.

9 9 Amazon Interface Es sind folgende Einstellungen möglich: Preismanager aktivieren: Aktivierung des Preismanagers. Preis immer anpassen: Der Preis wird auch angepasst, wenn Ihr Preis bereits der Niedrigste ist. Ihr Preis wird in diesem Fall mit dem zweitniedrigsten Preis verglichen und entsprechend modifiziert. Der Preis wird nur mir den Preisen derjenigen Artikel verglichen, welche die Bedingungen der Einstellungen für 'Zustand', 'Verkauf durch', 'Positives Feedback (%)' und 'Anzahl der Bewertungen' erfüllen. Preisabschlag vom niedrigsten Preis: Der neue Preis wird um diesen Wert niedriger sein, als der niedrigste Preis in Amazon. Unterste Grenze für Ihren Preis: Der neue Preis wird nicht niedriger gesetzt werden, als wie hier definiert. In der Sektion Standarddaten werden Werte wie Marke und Hersteller definiert. Diese werden nur für den Fall verwendet, dass sie bei den Artikeln nicht explizit gesetzt sind. Weitere Einstellungen dieser Sektion im Detail: Versanddienstleiter: Dieser optionale Wert gibt die an Amazon übertragene Versandinformation an, z.b. 'DHL'. Von dem Variantenwert abziehen (mit trennen): Falls die Variantenwerte in Ihrem Shop Zusatzwerte enthalten, wie z.b. 'Gr. 38', sollte dieser Wert ohne den Zusatz zu Amazon übertragen werden. Diese Zusatzwerte (z.b. 'Gr.') können hier eingetragen werden. Mehrere Zusatzwerte sind mit einem zu trennen. Name der Versandvorlage Prime durch Händler: Es muss der Name wie im Seller Central unter Einstellungen -> Versandeinstellungen angezeigt eingetragen werden, vorausgesetzt natürlich sie bieten 'Prime durch Händler' an. Name der Standard Versandvorlage: Es muss der Name wie im Seller Central unter Einstellungen -> Versandeinstellungen angezeigt eingetragen werden. Versand durch Amazon Bestellungen importieren: Ein gesetztes Häkchen bewirkt, dass auch Bestellungen importiert werden, welche durch Amazon versandt werden. Transaktion ID setzen: Falls definiert, wird dieser Wert in der Datenbanktabelle oxorder im Feld oxtransid gesetzt. Dies ist nützlich, wenn (durch eine Anpassung des OXID Shops) die Transaktions-IDs allgemein in der Bestellübersicht angezeigt werden. Bestellnummer zu Amazon übertragen: Die Bestellnummer aus Ihrem OXID Shop wird an Amazon übertragen. Dies bedeutet, wenn eine Bestellung aus Amazon in Ihren Shop importiert

10 10 Amazon Interface wird, wird die Bestellnummer, welche der Bestellung von Ihrem Shop zugeordnet wurde, in Ihrem Amazon Konto gesetzt, um eine spätere Zuordnung zu Ihren Bestellungen im Shop zu erleichtern. Die Übertragung der Bestellnummern erfolgt während der Cronjob Bearbeitung direkt nach Abruf der Bestellungen. Importierte Bestellungen als bezahlt setzen: Wenn gesetzt, wird die Bestellung in der Bestell- Datenbanktabelle oxorder als bezahlt markiert. Das Bezahldatum in der Datenbanktabelle wird auf den Timestamp der Bestellung gesetzt (da Amazon kein explizites Bezahldatum liefert). Der Bestell-Import ist eine eigene Sektion, da für jeden Amazon Länder-Marktplatz getrennte Cronjobs für den Bestell-Import ausgeführt werden: Es ist möglich Bestellungen für Amazon Länder-Marktplätze zu importieren, ohne die eigentlichen Produktdaten in der entsprechenden Sprache an Amazon zu übertragen (siehe Sektion Marktplätze oben). Aus diesem Grund können die Bestellimporte für die Länder hier getrennt konfiguriert werden. Aktivieren: Aktivierung des Bestellimports für diesen Marktplatz. Marktplatz-ID: Die IDs sind bereits auf die entsprechenden Werte gesetzt und sollten nicht geändert werden. MwSt. %: Dieser Wert wird für die entsprechenden Felder der Bestell-Datenbanktabelle des Shops benötigt. Er wird ignoriert, falls bei einem Artikel explizit ein abweichender Wert definiert ist. In der Sektion Cronjob werden die zur Synchronisation mit Amazon erforderlichen Cronjobs inkl. der Ausführungsintervalle definiert. Es existieren folgende Cronjobs: Artikel hochladen, Lagerbestand aktualisieren, Preis aktualisieren, Varianten verknüpfen, Versandinformationen hochladen, Bilder hochladen: Ist verantwortlich für das Hochladen der Artikeldaten, Lagerbestände, Preise, Varianten, Versandinformationen und Bilder.

11 11 Amazon Interface Artikel löschen: Ist der Artikel im Amazon Reiter deaktiviert, wird der Artikel im Seller Central gelöscht/deaktiviert, abhängig von der Einstellung der Select-Box, siehe auch Kapitel 2.7. Lagerbestand von Amazon herunterladen und mit Shop vergleichen: Durch Aktivierung dieses Feldes wird der Lagerbestand Ihrer Artikel von Amazon heruntergeladen. Der Cronjob 'Lagerbestand aktualisieren' lädt in diesem Fall nur den Lagerbestand der Artikel hoch, die einen anderen Lagerbestand haben als im Amazon. So werden Ihre Artikel schneller aktualisiert. Wenn das Feld nicht aktiviert ist, werden jedes Mal alle Lagerbestände hochgeladen, egal ob sie sich verändert haben oder nicht. Da Amazon nur eine begrenzte Anzahl Datensätze auf einmal verarbeiten kann, sollte das Feld 'Anzahl Zeilen, die gleichzeitig hochgeladen werden' für jeden Cronjob definiert werden. Dies bedeutet, dass pro Cronjob-Ausführung z.b. 100 Artikel bearbeitet und zu Amazon hochgeladen bzw. aktualisiert werden. Typische Werte sind voreingestellt. Ein übliches Intervall für die Cronjob-Ausführung, welches Sie auf Ihrem Server einstellen, sind 60 Sekunden. In der Dropbox 'Ausführen' wird definiert, wie häufig der entsprechende Cronjob ausgeführt wird. Nachdem alle Artikel aus Ihrem Shop hochgeladen bzw. aktualisiert wurden, wird dieser Cronjob für die verbleibende Zeit der eingestellten x Stunden nicht mehr ausgeführt. Dies bedeutet, dass alle Artikel jede x Stunden vollständig hochgeladen bzw. aktualisiert werden. Der Wert 'immer' bedeutet hierbei, dass nach dem Hochladen der letzten Artikel beim nächsten Cronjob-Aufruf wieder sofort mit dem ersten Artikel begonnen, und nicht geprüft wird, ob die x Stunden verstrichen sind. 'Fehlermeldungen importieren' sollte nur während der Test-Phase aktiv geschaltet werden. Bei Aktivierung wird nach jeder Amazon Query für die den entsprechenden Job (Artikel hochladen, Lagerbestand aktualisieren, etc) eine getrennte Abfrage an Amazon gesendet, welche für diesen Job mögliche Fehler bei Amazon abfragt. Da auch hier die Karenzzeit von 120 Sekunden eingehalten werden muss, 'verdoppelt' sich die Gesamt-Abfragezeit sämtlicher Jobs leider unvermeidlich. Aus Sicherheitsgründen sollte ein Passwort gesetzt werden. Die unter diesem Feld angezeigte URL ist im Control-Panel Ihres Hosting-Accounts einzutragen. In der Sektion System-Info wird die Versions-Nummer der installierten, sowie der neuesten Version der Extension angezeigt. Zudem können Sie sich das Change-Log anzeigen lassen und so entscheiden, ob ein Update für Sie interessant ist.

12 12 Amazon Interface

13 13 Amazon Interface 2.3 VERSANDKOSTENREGELN Bei Amazon gibt es verschieden Versandvorlagen, von Amazon vordefiniert oder selber erstellte. Ein Artikel hat immer eine dieser Vorlagen zugeordnet. Wenn nichts angegeben ist wird automatisch die Vorlage 'Standardvorlage Amazon ' von Amazon zugeordnet. Unter egate-media -> Amazon -> Versandkostenregeln kann man den Artikeln eine der Vorlagen zuordnen. Bei den Versandkostengruppen definiert man die Gruppen mit den Artikeln für die die gleiche Versandvorlage gelten soll. Unter Versandkostenregeln nennt man die Vorlage (wichtig, der Name der Vorlage muss identisch mit der Vorlage aus Amazon sein) und wählt die Gruppe aus für welche diese Vorlage gelten soll. 2.4 FEHLERMELDUNGEN Unter egate-media -> Amazon -> Fehlermeldungen können Sie sehen, ob Amazon während der Synchronisation durch die Cronjobs Fehler generiert hat. Bei Fragen ist Ihnen der egatemedia Support gerne behilflich.

14 14 Amazon Interface 2.5 UPDATE ARTIKELDATEN In dem Kapitel 2.7 werden im Detail die Artikel Einstellungen beschrieben. Wenn Sie mehrere Amazon Marktplätze nutzen, können Sie in diesem Bereich 'Update Artikeldaten' die Einstellungen und Daten von einem Marktplatz in einen anderen kopieren. Wählen Sie in der Sektion 'Artikelfelder ' die Daten aus, welche kopiert werden sollen. In der Sektion 'Artikeldaten Übertrag' bestimmen Sie, von welchem in welchen Marktplatz der Kopiervorgang ausgeführt wird. Der Übertrag wird nur vorgenommen, wenn zumindest ein Häkchen gesetzt wurde, und beide Marktplätze definiert sind. 2.6 KATEGORIEN EINSTELLUNGEN Unter Artikel verwalten -> Kategorien, Reiter Amazon können für jede Kategorie individuelle Werte für die Amazon Einstellungen Verkaufsbereich und Kategorien gewählt werden. Die hier gewählte Einstellung gilt für alle Artikel dieser Kategorie, ausgenommen der Artikel mit explizit individueller Einstellung, siehe auch Kapitel 2.7.

15 15 Amazon Interface 2.7 ARTIKEL EINSTELLUNGEN Unter Artikel verwalten -> Artikel, Reiter Amazon werden die Einstellungen für die Artikel vorgenommen. Diese Einstellungen gliedern sich in folgende Sektionen: Artikeleinstellungen Artikeldaten Verkaufsbereich Kategorien In der Sektion Artikeleinstellungen wird über 'Aktiv' festgelegt, ob der Artikel zu Amazon hochgeladen werden soll. Zudem können optional abweichende Werte für Titel, Preis und Lagerbestand eingegeben werden. Prime durch Händler bedeutet, dass der Artikel im Amazon Seller Central als Prime markiert, d.h. die Prime Versandvorlage diesem Artikel zugewiesen wird. In der Sektion Artikeldaten sind folgende Einstellungen möglich: Es können von den Standard Shop-Einstellungen abweichende Werte für Preis, Hersteller, Marke, Hauptbild und Beschreibung definiert werden. Zusätzlich können Sie folgende Felder für Amazon definieren: Angebotspreis, Anfangstermin für den Angebotspreis, Endtermin für den Angebotspreis, Bearbeitungszeit, Zustand und Anmerkung zum Zustand. Die Bullet Points entsprechen den Stichwörtern des Reiters Stamm, und können hier überschrieben werden. Achten Sie auf das Trennzeichen, welches Sie in den Amazon Einstellungen gewählt haben, und darauf, dass Amazon nur bis zu 5 Bullet Points akzeptiert. Die Allgemeinen Schlüsselwörter entsprechen den Suchbegriffen des Reiters Stamm, und können hier überschrieben werden. Achten Sie auf das Trennzeichen, welches Sie in den Amazon Einstellungen gewählt haben, und darauf, dass Amazon nur bis zu 5 Allgemeine Schlüsselwörter akzeptiert.

16 16 Amazon Interface Die in Amazon zusätzlich bestehenden Platinum Schlüsselwörter können hier optional definiert werden. Das Trennzeichen ist dasselbe wie für die Allgemeinen Schlüsselwörter. Auch hierfür werden maximal 5 Schlüsselwörter akzeptiert. In den Sektionen Verkaufsbereich und Kategorien können für jeden Artikel individuelle Werte für die Amazon Einstellungen Verkaufsbereich und Kategorien gewählt werden. Nach der Auswahl eines Verkaufsbereiches und eines Produktbereiches werden die dazugehörigen Attribute angezeigt. Die Pflege dieser Attribute ist optional.

17 17 Amazon Interface Hinweis: Ein Artikel wird über die EAN oder die ASIN hochgeladen. Eins von beiden muss eingetragen sein, da der Artikel sonst nicht von Amazon akzeptiert wird. Ausnahmen sind Artikel einer eigenen Marke, für die Sie bei Amazon eine Markenregistrierung durchgeführt haben. 2.8 ALLE ARTIKEL EINES HERSTELLERS AKTIVIEREN BZW. DEAKTIVIEREN Unter Stammdaten -> Hersteller, Reiter Stamm können unter 'Alle Artikel für Amazon' sämtliche Artikel eines Herstellers aktiviert bzw. deaktiviert werden.

18 18 Amazon Interface 2.9 VERSANDARTEN Unter Shopeinstellungen -> Versandarten, Reiter Amazon können den Amazon-Versandarten Shop- Versandarten zugeordnet werden. Diese Einstellung wirkt sich nur beim Bestellimport aus. Ist beispielsweise eine Amazon-Bestellung mit der Amazon-Versandart 'Standardsendung Europe 1' eingegangen, und das Häkchen für diese Amazon-Versandart ist hier gesetzt, dann wird das Feld oxdeltype der Bestell-Datenbanktabelle des Shops auf den Wert der hier ausgewählten Shop- Versandart (also einer Shop-Versandart für den europäischen Versand) gesetzt. In den meisten Fällen wird das Feld oxdeltype der Bestell-Datenbanktabelle des Shops nicht ausgewertet, und Sie müssen hier überhaupt keine Einstellungen vornehmen. In diesem Fall wird für oxdeltype immer der Standartwert oxidstandard gesetzt.