eCommeleon Schnittstelle - Besonderheiten der Schnittstelle für Amazon

Über die eCommeleon Schnittstelle binden wir nun direkt aus der S2 die neue Amazon API an. Diese bringt im vergleich zur alten API Version ein paar Änderungen. Was sich im Vergleich zur alten Schnittstelle ändert und auf welche besonderheiten geachtet werden muss, erklären wir in dieser Anleitung. 

Wichtig: Generell gilt, neue Artikel in den Amazon Produkt-Katalog einzustellen ist ein reiner Fiebertraum. Die Anforderung an Attributen und Angaben, die für die Erstellung eines neues Angebots benötigt werden, sind je nach Amazon Kategorie, enorm umfangreich. Dazu liefert Amazon nur sehr unklare und teils schwer zu interpretierende Fehlermeldungen. Der Amazon Support selbst ist in der Regel auch keine brauchbare Hilfe und Antwortet auf Fragen nur unzureichend. Bis man ein Gefühl für die gängigen Fehlermeldungen und ein gewisses Talent entwickelt hat diese zu interpretieren ist das Einstellen von Amazon Artikeln eine sehr aufwendige und nervige Angelegenheit. Da lässt sich auch nichts beschönigen.

Wir versuchen in dieser Anleitungen die gängisten Probleme zu beleuchten und Tipps zu geben damit die Anlage dennoch gelingt. Wir beginnen mit den wichtigstens Änderungen der neuen Schnittstelle. 

1. Daten Limits (Wie oft werden Artikel und Bestände/Preise übertragen)
Über die alte Schnittstelle haben wir zunächst alle sieben Minuten, dann nur noch alle 15 und später alle 20 Minuten immer alle Artikelinformationen übertragen. Die Bestände wurden ebenfalls alle paar Minuten neu syncronisiert. Amazon hat im laufe der Jahre immer wieder an den sog. "Rate Limits", also der Menge an Anfragen die pro Stunde bzw. pro Tag gesendet werden können herumgeschraubt, was uns zu Anpassungen an diesen Intervallen veranlasst hat. 

Mit der neuen Schnittstelle wurden diese Limits nun nochmal deutlich verkleinert. Dabei ist die Übertragung wie folgt:

Die S2 sendet alle 15 Minuten Preis und Bestandupdates, jede Stunde senden wir einmal alle Angebote die neu erstellt wurden oder bei denen sich etwas geändert hat zu eCommeleon. 

Die konkreten Intervalle wie eCommeleon dann die Artikeldaten bzw. die Bestände an Amazon weiter leitet können Sie direkt in ihrem eCommeleon Profil entnehmen. Klicken Sie dafür oben rechts auf ihren Nutzernamen dann auf Einstellungen, wählen Sie dann links den Eintrag "Integratonen" und wechseln auf die Reiterkarte "Product Date Export". 

Hier sehen Sie dann für Amazon zwei Einträge, einmal für die Übertragung der Artikelinformationen und eine für die aktuallisierung der Bestände und Preise. Klappen Sie den gewünschten Eintrag auf und im Feld "Interval" steht wie oft die Übertragung durchgeführt wird. Dies ist pro Kunde individuell da das Limit mit erhöhter Menge an Artikelinformationen schneller erreicht wird. 

In der Regel werden die Preis und Bestandsupdates aber alle ~10 Minuten an Amazon gesendet. 

Hinweis: Soll eine Übermittlung mal direkt gestartet werden und nicht auf den nächsten Intervall gewartet werden können Sie auf das "Play" Symbol neben dem Eintrag des Connectors klicken um die Übertragung sofort anzustoßen - ist das Ratelimit noch nicht erreicht dauert es zw. 15 - 60 Minuten bis die Aktion durchgeführt wurde. 

Achtung: Diese manuelle Übermittlung dürfen Sie jedoch nicht zu oft anstoßen, da jede manuelle Übermittlung auch das oben angesprochene "Rate-Limit" beansprucht, verwenden Sie diese Funktion zu oft, brauchen Sie Ihr Datenlimit zu schnell auf und legen die Schnittstelle ggf. für eine gewisse Zeit komplett lahm! Somit nur im Notfall verwenden. 

Wichtig: Da Amazon die Rate-Limits so drastisch gesenkt hat und die Daten nicht mehr in den gewohnten Intervallen übermittelt werden können, zusätzlich die Verarbeitung auf Seitens Amazon auch noch eine gewisse Zeit in anspruch nimmt, ist der Intervall von Verkauf bis Anpassung des Bestandes deutlich größer geworden. Dies eröffnet natürlich auch eine erhöhte Gefahr für Doppelverkäufe. 

2. Pflege von Attributen 
Die Pflege von Attributen bei den Angeboten ändert sich vom Ablauf her nicht, im vergleich zur alten Schnittstelle, es gibt jedoch auch hier ein paar Besonderheiten. Dadurch das wir nun nicht mehr direkt für Amazon entwickeln sondern die Schnittstelle auch für andere Plattformen wie Otto u.ä. genutzt werden kann, ist auch ein direktes 1:1 Mapping wie zuvor nicht mehr möglich, erschwert wird das durch die neuen Vorgaben seitens Amazon, die was "gültige" Werte für Attribute angeht, ebenfalls nochmal deutlich eingeschränkt haben. 

Deswegen ist es nötig einige Attribute, die zuvor automatisch gepflegt werden konnten, nun manuell zu pflegen.

Hierbei stehen vor allem folgende Attribute im Vordergrund (das ist jedoch nur eine Auswahl und kann je nach Kategorie noch weitere Attribute enhalten!):

Im folgenden gehen wir auch noch auf ein paar weitere Attribute ein die für die Anlage von Kleidungsartikeln in der Regel verpflichtend sind:

Im Gegensatz zur alten Amazon Schnittstelle bekommen wir bei der neuen die aktuell gültigen Attribute pro Kategorie direkt über Amazon und diese liefern auch für die meisten Attribute schon gültige Vorgaben zur Auswahl, das macht die Bearbeitung zum teil immerhin deutlich einfachher. Einziger Nachteil die Attribute werden Teilweise in englisch, Teilweise in deutsch ausgeliefert. Darüber hinaus sind die werte Teilweise sehr seltsam Angegeben bspw. die Größentabelle 3xl wird zu 3x_l u.ä. 

Viele dieser Attribute lassen sich problemlos direkt vorbelegen, wie z.B. der Artikelzustand "new_new". Hierfür haben wir eine extra Möglichkeit geschaffen Attribute für eine Kategorie, Hauptkategorie oder Verkaufskanal vorzubelegen. Die entsprechende Anleitung finden Sie hier: Wie kann ich Attribute für die eCommeleon Online-Marktplätze vorbelegen lassen?

Ein weiterer Unterschied ist das Amazon nicht mitliefert ob ein Attribut Variantenabhängig ist oder nicht, deswegen haben wir bei der Attributebearbeitung einen Neuen Button Eingebaut mit dem der Anwender ein Attribut selbständig in ein Variantenabhängiges umwandeln kann. 

Hier wäre z.B. die Größe zu nennen die pro Varianten unterschiedlich sein kann. 

Wichtig: Ein Attribut das einmal in ein Variantenattribut umgewandelt wurde kann nicht wieder zurück gewandelt werden und bleibt für immer ein Variantenattribut! 

3. Fehlerbehebung

Es ist im Grunde schon garantiert das ein neues Angebot nicht beim ersten mal sauber im Amazon Katalog angelegt wird, da es an ein wunder gleicht sämtliche geforderten Attribute korrekt im ersten Anlauf anzugeben. Nach dem ersten Synclauf meldet Amazon die Fehler der jeweiligen Artikel-Varianten zurück, diese werden in der S2 dann auch pro Variante angegeben. 

Hier ein Beispiel:

Hier wurde zwar die Einheit für das Gewicht des Paketes angegeben, jedoch kein Wert für den Wert "Gewicht des Paketes" dieser muss nun nachgetragen werden. Leider sind viele der Fehlermeldungen nicht so eindeutig und es ist nicht immer klar auf welches Attribut sich eine Fehlermeldung bezieht. Hier kann es hilfreich sein direkt im Amazon Seller Central bei dem betroffenen Angebot zu schauen, da dort oftmals andere Fehlermeldungen angegeben werden die Hilfreicher sein können. Dennoch bleibt es oft ein Rätselraten und es bleibt nichts anderes übrig als herum zu probieren. Ich zitiere hier gerne einen langjährigen Amazon Kunden:
 

die Frustration mit Amazons Fehlermeldungen kann ich aus jahrelanger Erfahrung sehr gut nachvollziehen. Und da man leider auch nicht erwarten kann, vom Amazon-Support sinnvolle Antworten zu bekommen, bleibt einem nichts anderes übrig, als die Meldungen interpretieren zu lernen.

Hinweis: Wenn Sie versuchen ein Variantenangebot anzulegen und dieses bei Amazon nicht als Variantenangebot dargestellt wird, liegt es oft daran das dass Angebot noch zu viele Fehler enthält. Erst ab einem gewissen Punkt, wenn die Datenqualität gut genug ist legt Amazon das ganze wirklich als Variantenangebot an. 

Wir hoffen das wir mit dieser Anleitung helfen können die gröbsten Fehler zu vermeiden und Lösungsansätze aufzeigen konnten wie man mit den Fehlern umgehen kann.