Dieses How-To-Kapitel erklärt, wie Sie die neue Amazon-Schnittstelle (SP-API = Selling Partner-API) einrichten können. Die ersten Schritte bestehen darin, zunächst einen Schnittstellen-Benutzer anzulegen und pro Marktplatz eine Autorisierung für Ihr Amazon-Verkäuferkonto vorzunehmen. Nach der Marktplatz-Autorisierung können wie gewohnt Amazon-Funktionalitäten wie der Belegimport und den Artikel-Upload in der myfactory genutzt werden.

1. Schnittstellen-Benutzer anlegen
2. Marktplatz für Amazon-Verkäuferkonto autorisieren
3. Artikel-Upload
4. Belegimport
5. Belegupload


Unter "Verkauf / Amazon / Grundlagen / Konfiguration“ (siehe Hilfekapitel Konfiguration) finden sich mit Einführung der SP-API insgesamt drei neue Optionen (für die anderen beiden Optionen siehe unten).

Eine zentrale Rolle spielt hierbei das Erstellen eines Schnittstellen-Benutzers bzw. SP-API-Users. Dieser Schritt ist für die Nutzung der neuen Amazon-Schnittstelle essentiell und muss noch vor der Autorisierung Ihres Marktplatzes erfolgen. Wenden Sie sich daher zunächst der Option "Schnittstellen Benutzer erzeugen" zu.


Mit einem Klick auf die Schaltfläche [ Benutzer anlegen ] wird einmalig Kontakt zu einem myfactory-Server aufgenommen, ein allgemeiner SP-API-Benutzer wird erzeugt und ein User-Token für diesen abgerufen und zurückgeliefert. War die Registrierung eines SP-API-Users erfolgreich, so erhalten Sie darüber eine kurze Hinweismeldung:


Zum Anfang


Im nächsten Schritt muss jeder Marktplatz für die Nutzung der neuen Amazon SP-API autorisiert und für Ihr Amazon-Verkäuferkonto (Amazon Seller Central) freigeschaltet werden. Verwalten Sie mehrere Amazon-Marktplätze in Ihrem System, so muss dieser Vorgang für jeden Marktplatz einzeln erfolgen. Wechseln Sie daher nun zu dem Menüpunkt "Verkauf / Amazon / Stammdaten / Marktplätze" (siehe hierzu auch Hilfekapitel Marktplätze). Dort angekommen betätigen Sie bitte den [ Daten ]-Button in der Schaltflächenleiste. Es klappt sich ein kleines Kontextmenü mit dem Eintrag "Zugangsdaten Amazon" auf. Klicken Sie diesen an.


Es öffnet sich nun ein neues Dialogfenster, in welchem Sie die Freigabe Ihres Marktplatzes für das Amazon-Verkäuferkonto direkt über den [ Autorisieren ]-Button anstoßen können.


Nach einem Klick darauf wird zunächst ein Hinweisfenster eingeblendet:...


...und Sie werden anschließend auf die Login-Seite von Amazon Seller Central weitergeleitet.

Sollten Sie bereits in Ihrem Amazon-Verkäuferkonto eingeloggt sein, werden Sie direkt zur Authentifizierungsseite weitergeleitet. Dort setzen Sie am unteren Ende bitte nur noch die dortige Checkbox und klicken anschließend auf "Bestätigen" bzw. "Confirm". Mit dieser Maßnahme erlauben Sie Amazon über die Schnittstelle Zugriff auf Ihr Verkäuferkonto sowie Ihre damit verknüpften Daten.

Wenn nach der Bestätigung die Meldung "Amazon authorization succeeded" im Browserfenster erscheint, dann wurde die Verbindung zwischen Ihrem Amazon-Verkäuferkonto und dem Amazon-Marktplatz in der myfactory-Software erfolgreich hergestellt. Sie können nun z.B. den myfactory-Belegimport für Amazon-Bestellungen verwenden.

Zum Anfang


Über den Dialog "Verkauf / Amazon / Datenübertragung / Amazon-Transfer" lassen sich bidirektional Daten mit Amazon austauschen. Neben den eigentlichen Artikeldaten können Sie dabei auch Preisinformationen, Lagerbestandsdaten, Bilddaten und Varianteninformationen übertragen. Für den Artikel-Upload zu Amazon ist dabei nur das Register "Amazon-Protokoll" von Bedeutung.


Der Dialog "Amazon Datenaustausch" unterteilt sich in zwei Bereiche:

Im oberen Bereich dieses Dialogs finden sich die Übertragungsmöglichkeiten, die Sie einfach per Mausklick starten können. Im unteren Bereich sehen Sie die Protokoll-Einträge und können sich die Original-Übertragungsdaten bei Bedarf herunterladen (siehe auch Beschreibung des Registers "Amazon-Protokoll").







Dies ist die erste Schaltfläche, die Sie betätigen sollten, wenn Sie über die Amazon-Schnittstelle Artikel bei Amazon verkaufen möchten. Damit stoßen Sie den grundsätzlichen Upload aller als Amazon-fähig gekennzeichneten Artikel über die SP-API an (und den Upload etwaiger Variantenartikel).

Sobald Sie diesen Button betätigt haben, erscheint ein neuer Eintrag im Register "Amazon-Protokoll". Es wird dann ein neuer Feed in Form einer XML-Datei mit dem Namen "_POST_PRODUCT_DATA_" über die API übertragen. Zudem erhalten Sie die Hinweismeldung "Datenübertragung gestartet". War der Upload erfolgreich, so wird dies von der Schnittstelle in Form des Status "_DONE_" bestätigt. Bitte beachten Sie hierbei, dass der Artikel-Upload etwas Zeit in Anspruch nehmen kann. Amazon prüft zunächst einige Kriterien ab, z.B. ob Sie für die dem Artikel zugeordnete Produktkategorie grundsätzlich berechtigt sind.

Übertragen werden dabei alle im Amazon-Artikelstamm als "Amazon-fähig" deklarierten Artikel, welche bisher noch nicht über die Schnittstelle hochgeladen wurden (grüner Status im Amazon-Manager) bzw. welche bereits hochgeladen wurden, aber dann noch einmal geändert worden sind (gelber Status im Amazon-Manager). Weitere Informationen zum Amazon-Artikelstamm und zum Amazon-Manager erhalten Sie in den Hilfekapiteln Artikel bzw. Amazon Manager.








Zum Anfang


Bei Variantenartikeln müssen die eigentlichen Hauptartikel und die Variantenartikel zunächst über den Artikeldaten-Feed hochgeladen werden (siehe vorherigen Punkt). Die Verknüpfung zwischen den verschiedenen Variantenartikeln und dem Hauptartikel wird dann mit dem Übertragen der Variantendaten hergestellt. Sobald Sie diesen Button betätigt haben, erscheint ein neuer Eintrag im Register "Amazon-Protokoll". Es wird dann ein neuer Feed in Form einer XML-Datei mit dem Namen "_POST_PRODUCT_RELATIONSHIP_DATA_" über die API übertragen.

Wenn Sie Artikelvarianten zu Amazon übertragen möchten, dann benötigen Sie das sogenannte VariationTheme bzw. Variationsthema. Hierbei handelt es sich um das Amazon-Äquivalent einer Dimension bzw. Variante. Es findet sich in der Spalte "Variationswert" in den Amazon-Artikeldetails (siehe Hilfekapitel Artikel) und Sie definieren damit, wie miteinander verwandte Produkte sich voneinander unterscheiden, z.B. anhand ihrer Farbe (Color) oder Größe (Size) bzw. anhand einer Kombination aus beidem (SizeColor). Aktuell lassen sich im Übrigen auch nur Größe und Farbe als Varianten mappen und zu Amazon übertragen.


Solche Amazon-Dimensionen sind abhängig von Ihrer jeweils gewählten Produktkategorie, unter der Sie Ihre Artikel bei Amazon listen. Damit die Amazon-Variantendaten korrekt auf die myfactory-Dimensionen abgebildet und somit fehlerfrei zu Amazon übertragen werden, können Sie bei einer geeigneten myfactory-Artikeldimension für dieses Mapping auch eine entsprechende Amazon-Dimension (derzeit mit englischer Bezeichnung) auswählen (zu erreichen über das Artikelstamm-Register "Dimensionen", mit anschließendem Klick auf die Detail-Schaltfläche [ … ] einer Dimension oder über "Stammdaten / Grundlagen / Stammdaten / Artikel / Dimensionen").


Zum Anfang


Mit dieser Schaltfläche werden die Preise für die aktiven Amazon-Artikel auf Basis einer im Marktplätze-Dialog für den jeweiligen Amazon-Marktplatz hinterlegten Preisliste (z.B. "Standard") zu Amazon übertragen. Nach Anstoßen der Preisinformationsübertragung erscheint ein neuer Eintrag im Register "Amazon-Protokoll", ein neuer XML-Datei-Feed mit dem Namen "_POST_PRODUCT_PRICING_DATA_" wird dann über die API übertragen.


Zum Anfang


Hiermit übertragen Sie Produktbildinformationen zu Amazon. Dabei wird ein neuer XML-Datei-Feed namens POST_PRODUCT_IMAGE_DATA gestartet.

Damit die Übertragung korrekt funktioniert, ist es wichtig, dass die gewünschten Produktbilder als öffentliches Dokument unter "Stammdaten / Artikel" auf Ihren Server hochgeladen werden. Den Link zu dem hochgeladenen Dokument finden Sie dann in der ersten Spalte "Artikelbild" innerhalb des Registers "Bilder" im Amazon-Artikelstamm. Dort sollten Sie außerdem unbedingt noch das eine Zuordnung des Produktbildes über den "Produktbildtyp" vornehmen.

Die Informationen zum Produktbildtyp stammen direkt von Amazon. Der Produktbildtyp beschreibt die Art und Weise, wie das Bild bei Amazon angezeigt werden soll. Beispielsweise können Sie dort wählen, dass ein Artikelbild als Hauptbild oder als Suchbild bei Amazon erscheinen soll.


Wenn Sie die Auswahlliste in der Spalte "Produktbildtyp" leer lassen, dann wird in der darauffolgenden "Aktiv"-Spalte eine rote Flagge angezeigt. Diese besagt, dass kein Produktbild zu Amazon übertragen werden kann, da kein entsprechender Produktbildtyp zugewiesen wurde. Sobald Sie einen Produktbildtyp gewählt haben, sehen Sie einen grünen Haken. Dieser signalisiert, dass das Produktbild bereit ist zur Übertragung zu Amazon.


Mit dieser Schaltfläche übermitteln Sie die Artikelmengeninformationen basierend auf Ihrem aktuell vorhandenen myfactory-Lagerbestand. Nach Betätigen dieses Buttons wird ein XML-Datei-Feed namens POST_INVENTORY_AVAILABILITY_DATA gestartet. In Amazon wird nach erfolgreicher Übertragung des Lagerbestands-Feeds die Menge des Amazon-Artikels aktualisiert.




Im unteren Bereich sehen Sie die Protokoll-Einträge und können sich die Original-Übertragungsdaten bei Bedarf herunterladen. In dem Zusammenhang wichtig ist vor allem der (dritte) Button für den Verarbeitungsbericht, den Sie nach erfolgreicher Verarbeitung der übertragenen XML-Dateien von Amazon anfordern können. Dort sehen Sie dann in einem Hinweisfenster, ob bei der Übertragung Fehlermeldungen innerhalb des XML-Feeds aufgetreten sind oder nicht.











Wenn Sie den Amazon-Belegimport verwenden möchten, dann können Sie in der Amazon-Grundlagenkonfiguration auswählen, wie Sie in Ihrem System mit importierten Amazon-Bestellungen umgehen möchten, d.h. Sie haben hier die Möglichkeit, zwischen den Varianten "Versand durch Händler (MFN)" und "Versand durch Amazon (FBA)" zu wählen.


Es wird empfohlen, jeweils nur für MFN oder FBA die jeweilige Checkbox zu aktivieren - also für jene Versandmethode, welche Sie auch letztendlich verwenden möchten. Wenn Sie den Versand Ihrer Waren vollständig über Amazon abwickeln, dann aktivieren Sie also bitte die Checkbox "FBA Bestellungen aktivieren". Übernehmen Sie die Versandabwicklung der eingegangenen Bestellungen komplett selbst, dann haken Sie in diesem Fall bitte nur die Checkbox "MFN Bestellungen aktivieren“ an. Möchten Sie beide Varianten verwenden, dann aktivieren Sie natürlich beide Checkboxen.

Weiterhin gilt es zu beachten, dass Belege bei Verwendung des MFN-Bestellimports in einem maximal möglichen Zeitfenster von 60 Tagen importiert werden können. Dies sollten Sie bei der Datumsangabe im Eingabefeld "Belege ab Anlagedatum importieren“ im Dialog "Amazon Marktplätze" unbedingt beachten. Amazon-Bestellungen, welche länger als 60 Tage zurückliegen und noch nicht in die myfactory eingelesen wurden, werden für den Belegimport folglich nicht berücksichtigt. Wenn keine aktuellen Bestelldaten im Amazon-Verkäuferkonto vorliegen, wird der Status des Belegimport-Abrufs im Dialog "Amazon Datenaustausch" automatisch auf "CANCELLED“ geändert.

Bei Nutzung der FBA-Versandmethode können bis zu 30 Tage zurückliegende Bestellungen eingelesen werden. Amazon zufolge werden Aktualisierungen nach dem FBA-Versand innerhalb von 1-3 Stunden in den von Amazon angeforderten Bestellberichten sichtbar, aus welchen schließlich die Belege erzeugt werden. Auch hier wird der Status in der gleichnamigen Spalte des "Amazon Datenaustausch" bei nicht vorhandenen Berichten auf "CANCELLED" gestellt.





Die SP-API ermöglicht es außerdem, sowohl Rechnungs- als auch Lieferadressen vollständig über den Belegimport zu übertragen. Gleiches gilt für die Umsatzsteuer-ID, welche ebenfalls über die Schnittstelle mitgeliefert wird, falls ein Business-Kunde von Ihnen unter seinem Firmennamen und mit seiner Umsatzsteuer-ID bestellt hat.

Sollten Rechnungsinformationen bei Ihren aus Amazon importierten Belegen fehlen bzw. eine Fehlermeldung auftauchen (z.B. – Spalte „bill_...“ nicht vorhanden), dann ergänzen Sie in Ihrem Seller Central-Verkäuferkonto bitte die Übertragung der Bestellberichte (Die erforderlichen Spalten - wie z.B. die Versandadresse - werden immer übertragen und müssen nicht separat aktiviert werden). Um die Bestellberichte übertragen zu können, gehen Sie bitte wie folgt vor:

1. Loggen Sie sich zunächst in Ihr Seller Central-Verkäuferkonto ein und wählen Sie Ihren Marktplatz aus. Wenn Sie mehrere Marktplätze betreiben (z.B. für Deutschland, Frankreich und Polen), dann führen Sie die nachfolgenden Schritte bitte für jeden Einzelnen Ihrer Marktplätze durch.
   
   
   


2. Wählen Sie nach der Marktplatz-Auswahl im oberen Seller Central-Hauptmenü bitte den Menüpunkt "Bestellungen" und darin den Menüeintrag "Bestellberichte" aus.
   
   
   


3. Unter "Bestellberichte" wählen Sie dann den Link "Spalten im Bestellbericht hinzufügen oder entfernen" aus:
   
   
   


4. Unter "Optionale Spalten" aktivieren Sie per Umschalter (Toggle-Button) bitte zusätzlich die folgenden weiteren Spalten:
   
   
   1. Fakturierung:
      
      
      
      
      
   2. Prime:
   
   
   
   
   
   3. Käufer-Steuerkennungen & Name des Käuferunternehmens:
      
      
      

Zum Anfang


Inzwischen ist der Rechnungsupload zu Amazon ebenso wie die weiteren elementaren Amazon-Features des Artikel-Uploads und des Belegimports auch über die SP-API möglich. Dies gilt für alle Neu- und Bestandskunden. Der Ablauf des Beleguploads in der myfactory-Oberfläche bleibt davon unberührt, er erfolgt genau wie zuvor bei der MWS-API. Den konkreten Ablauf entnehmen Sie daher bitte dem entsprechenden Hilfekapitel Amazon-Transfer. Dort findet sich unter anderem eine Checkliste für den erfolgreichen Amazon-Rechnungsupload.



Weitere Informationen zum Thema "Amazon-Schnittstelle":
Neue Amazon-Schnittstelle: Ein Einrichtungsleitfaden

Zurück zum Anfang