AMAZON-Schnittstelle

Aktivieren der Schnittstelle

- der Server muss URL-Fopen auf ON eingestellt sein
- gehen Sie im Admin unter TOOLS zur der Amazon-Schnittstelle
- aktivieren Sie das Amazonmodul mit dem Häkchen und klicken auf speichern

Lagerabgleich

Um Ihre Lagerhaltung abgleichen zu können, müss der Shop etwas vergleichen können. Hierzu haben Sie 2 Möglichkeiten:
SKU: Wählen Sie SKU, dann gleicht der Shop die SKU von Amazon mit Ihrer Artikelnummer ab. D.h. entweder setzen Sie Ihre Artikelnummern in die SKU bei Amazon oder anders herum
ASIN: Wählen Sie ASIN, dann gleicht der Shop die ASIN von Amazon mit Ihrer Artikelnummer ab. D.h. Sie müssen in Ihren Shopartikeln als Artikelnummer die ASIN reinschreiben.

Marktplatz-IDs

https://mws-eu.amazonservices.com
DE: A1PA6795UKMFR9
ES: A1RKKUPIHCS9HS
FR: A13V1IB3VIYZZH
IT: APJ6JRA9NG5V4
UK: A1F83G8C2ARO7P

https://mws.amazonservices.com
CA A2EUQ1WTGCTBG2
MX A1AM78C64UM0Y8
US ATVPDKIKX0DER

https://mws.amazonservices.in
IN A21TJRUUN4KGV

https://mws.amazonservices.jp
JP A1VC38T7YXB528

https://mws.amazonservices.com.cn
CN AAHKV2X7AFYLW

Bei mehreren Marktplätzen geben Sie diese mit Komma getrennt ein. Z.B.: A1PA6795UKMFR9,A1F83G8C2ARO7P,A1RKKUPIHCS9HS

Bestellungen abholen

Status

Status Pending: Bestellung noch nicht bezahlt -> Keine Daten über Kunde verfügbar
Status Pending "einlesen": Die Artikel in der Bestellung wurden noch nicht geladen (z.B. zu viele Downloads zu kurz hintereinander, Amazon schränkt hier ein.) Bestellungen müssen nach 5 Min warten nochmals abgerufen werden. Amazon schreibt die Wartezeit vor, um sich vor Serverüberlastung der Millionen Kunden zu schützen. Warten Sie nicht, kann der Abruf blockiert werden.
Status Pending "Neu": Die Bestellung wurde vollständig geladen.

Wenn nach dem Abholen noch weitere Daten vorhanden sind, liefert Amazon ein Token zurück für den nächsten Abruf. D.h. Sie holen so lange ab (bitte jeweils 5 Min warten), bis alle Daten abgeholt sind, also bis Status Pending auf NEU ist. Erst dann werden neue Bestellungen abgeholt.

Probleme

Probleme von Seiten Amazon

Amazon liefert mehrere Adresszeilen, leider ohne Information, in welcher Zeile was gerade enthalten ist, denn in jeder Bestellung sind diese Daten nochdazu unterschiedlich. Dadurch ist die korrekte Zuordnung im Shop schwer möglich. Hier hat Amazon seine Hausaufgaben nicht gemacht.

Wenn der Bestellungendownload nur 1 Inhalt hat, wird diese in Adresse und Hausnummer aufgeteilt. Sind 2 Adresszeilen gefüllt, wird die 1. zur Firma, die 2. zur Adresse. 3 Adresszeilen haben wir nicht gefunden.
Käufernamen scheinen teilweise keine echten Namen zu sein, sondern Alias-Namen. Manchmal fehlte ein Leerzeichen, sodass im Shop Vor- und Name nicht getrennt werden können.

Probleme in Adressen oder Artikeln

Die Verbindung prüft schon sehr viele mögliche Fehlerursachen und korrigiert Fehler in Adressen oder Artikeln eigenständig. Es kann aber dennoch sein, dass es Fehler gibt, welche nicht erfaßt werden können.
Das könnten Fehler in Adressdaten sein, z.B. fehlende Länderzuordnung. Schauen SIe daher in Ihre letzte Bestellung ob das Land angegeben ist und korrigieren dies, sonst versucht die Schnittstelle immer wieder diese Bestellung zu vervollständigen, klappt aber nicht und so geht der Import nicht weiter. Bei Artikeln bitte Ihre Artikel bei Amazon anschauen, ob dort Sonderzeichen wie Hochkommas oder ähnliche enthalten sind und korrigieren.

Konfigurationsdatei

Um etwas individueller auf den Admin eingehen zu können, gibt es bei der Schnittstelle eine Konfigurationsdatei, mit der man folgendes einstellen kann:
- Anzahl zurückliegender Tage, von denen die Bestellungen abgeholt werden sollen (Diese Tage gelten ab "Speichern" des Amazon-Modul rückwirkend). Eingestellt sind 30 Tage
- Anzahl Bestellungen wieviel gleichzeitig abgeholt werden sollen (Amazon begrenzt auf ca. 30 Bestellungen, alle anderen erscheinen als "pending")
- Wie sollen die Art.-Nr. lauten, wenn keine Zuordnung durch ASIN/SKU stattfindet? Derzeit lautet die Art.-Nr. dann "Amazon"
- Steuersatz (gilt für die gesamte Bestellung) 1 = Steuersatz 19%, 2 = Steuersatz 7%, 3 = steuerfrei 0%
- Importierte Bestellungen sollen welchen Status haben? 1 = neu, 2 = bestätigt, 3 = versandbereit, 4 = versendet | im Standard eingestellt ist 4 = versendet

Unterschiedliche Steuersätze in einer Bestellung

Amazon liefert keine getrennten Steuersätze, d.h. entweder hat eine Betsellung 19% oder 7%. Die FLow® Shopsoftware hat hierfür aber eine Lösung und berechnet wie folgt:
Die Artikel werden aus der xml (Artikel für 1 Rechnung) gelesen, mit Defaultwerten, für nicht vorhandene Angaben seitens Amazon, u.a. USt-Satz, Merkmale und Werte.
Danach wird in der DB anhand SKU/ASIN nach einem Artikel gesucht. Wird einer gefunden, werden die Default-Werte mit den Artikeldaten überschrieben.
Danach wird aus dem Brutto-Betrag anhand de USt-Satzes (1 - 19%, 2 - 7%) Netto und USt ( getrennt nach USt-Satz) berechnet, addiert und der Artikel gespeichert.
Sind alle Artikel durch, werden die Versandkosten in Netto/USt aufgeteilt. Wenn Summe Artikel USt(19%) > 0 mit 19%, sonst 7%.
Die Summen werden dann ebenfalls in der DB gespeichert.
Wenn der Shop als Kleinunternehmen läuft, kann keine USt. berechnet werden.

Sonstiges

Marketplace-Ids sind festgelegt für z.B. amazon.de, amazon.uk, amazon.fr usw. Hiermit wird festgelegt, für welche Länder Bestellungen abgeholt werden.
Die wichtigsten wurden eingetragen.

Sicherheit

Amazon fordert seit Oktober 2020 Protokollierungen und Checks.
shop_log muss daher ab Oktober vorhanden sein: /classes/modules/xdebug/shop_log

1) Anonyme datenschutzkonforme Protokollierung bei jedem Amazonzugriff für Bestellungen-Downloads. Es wird protokolliert: Bestellung, Aktualisierung, Artikellisten.

2) werden Amazon-Schnittstellenzugangsdaten im Shop geändert, wird eine E-Mail an den Shopadmin versendet, dass die Zugangsdaten geändert wurden

3) jeder Shop-Adminlogin wird protokolliert

4) Shop-Adminzugangsdatenänderungen werden protokolliert (wenn shop_log vorhanden) und eine E-Mail an Admin gesendet (grundsätzlich immer verschickt), wenn Zugangsdaten geändert wurden (Login, Passwort, Shop-E-Mail)

5) Wenn Eintrag in der Config vorhanden ist, wird bei jedem falschen Loginversuch eine E-Mail versendet und nach 10 falschen Loginversuchen der Adminzugang gesperrt.
Der Admin kann dann ein neues Passwort via "Passwort-Vergessenfunktion" erstellen. Dabei werden alle Fehlversuche gelöscht. Oder der Admin wartet einen Tag, dann werden die Fehlversuche automatisch wieder zurückgesetzt.

Zurück zu den Schnittstellen