# DataFirefly Amazon Connector: PrestaShop mit Amazon Seller Central verbinden

> Installation Installieren Sie das Modul über Module > Modulmanager > Modul hochladen, indem Sie die ZIP-Datei senden. Die PHP-Erweiterung cURL ist erforderlich. Bei der Installation legt das Modul seine Tabellen…

- Seite: <https://www.datafirefly.com/de/documentation/dfamazonconnector/>
- Sprache: de
- Aktualisiert am: 2026-10-07
- Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfamazonconnector/index.md), [en](https://www.datafirefly.com/en/documentation/dfamazonconnector/index.md), [es](https://www.datafirefly.com/es/documentation/dfamazonconnector/index.md), [it](https://www.datafirefly.com/it/documentation/dfamazonconnector/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfamazonconnector/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfamazonconnector/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfamazonconnector/index.md)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

## Installation

Installieren Sie das Modul über **Module > Modulmanager > Modul hochladen**, indem Sie die ZIP-Datei senden. Die PHP-Erweiterung cURL ist erforderlich.

Bei der Installation legt das Modul seine Tabellen an, einen Tab **Amazon Connector** im Menü Verkaufen, einen Versanddienstleister „Amazon“ nur für importierte Bestellungen (Kunden sehen ihn nie) und zwei Bestellstatus: „Amazon: Versand ausstehend“ und „Amazon FBA: versandt“.

## Amazon-Konto vorbereiten

Das Modul verbindet sich mit Ihrem Verkäuferkonto über Ihre eigene private Selling-Partner-API-Anwendung. Sie benötigen ein professionelles Seller-Central-Konto.

1. Öffnen Sie in Seller Central **Apps und Services > Apps entwickeln** und registrieren Sie sich als privater Entwickler, falls noch nicht geschehen.
2. Legen Sie eine Anwendung an und beantragen Sie die Rollen für die Funktionen, die Sie nutzen: Product Listing und Pricing für den Katalog, Inventory and Order Tracking für Bestellungen, Direct-to-Consumer Shipping (Restricted) für Lieferadresse und Käufer-E-Mail, Amazon Fulfillment für den FBA-Bestand, Finance and Accounting für Erstattungen, Tax Invoicing für den Rechnungsupload.
3. Autorisieren Sie die Anwendung selbst für Ihr Konto, um ein **Refresh Token** zu erhalten, und notieren Sie **LWA-Client-ID** und **Client Secret**.
4. Kopieren Sie Ihr **Merchant Token** unter **Einstellungen > Kontoinformationen**.

Ohne die Rolle Direct-to-Consumer Shipping werden Bestellungen ohne Lieferadresse importiert. Das Modul legt dann eine Ersatzadresse an und kennzeichnet sie in der Bestelladresse.

## Verbindung und Marktplätze

Wählen Sie unter **Amazon Connector > Einstellungen** die Region (Europa, Nordamerika oder Ferner Osten), tragen Sie LWA-Client, Secret, Refresh Token und Merchant Token ein und speichern Sie. Die Geheimnisse werden verschlüsselt gespeichert; lassen Sie die Felder leer, um die gespeicherten Werte zu behalten.

Klicken Sie im Dashboard auf **Verbindung testen**. Die Marktplätze Ihres Kontos erscheinen im Tab **Marktplätze**, standardmäßig deaktiviert. Legen Sie für jeden fest:

- die Aktivierung;
- die Sprache der gesendeten Inhalte (Titel, Beschreibung);
- Preise brutto oder netto, je nach Land;
- die Preissynchronisierung, die Sie bei einem Amazon-Repricer deaktivieren;
- den prozentualen Aufschlag, den festen Betrag und die Rundung (keine, x,99, x,90, ganze Zahl).

## Cron-Aufgabe

Die Synchronisierung läuft über eine Cron-Aufgabe, idealerweise alle 5 bis 15 Minuten. Das Dashboard zeigt die per Token gesicherte URL und den Kommandozeilenbefehl:

```
php /pfad/zu/modules/dfamazonconnector/cron.php --shop=1
```

Bei jedem Lauf importiert das Modul Bestellungen, bestätigt Versendungen, sendet Rechnungen und Stornierungen, liest Erstattungen und FBA-Bestand und sendet anschließend offene Listings, Bestände und Preise als gebündelte Feeds. Ein roter Hinweis erscheint im Modul, wenn die Aufgabe länger als eine Stunde nicht gelaufen ist. Die Schaltfläche **Neues Token** macht die alte URL ungültig.

## Kategorie-Zuordnung

Die Zuordnung wird nur zum Anlegen neuer Listings auf Amazon benötigt. Ein Produkt auf einer bestehenden ASIN oder per EAN angehängt braucht nur ein Angebot.

Wählen Sie im Tab **Kategorie-Zuordnung** eine PrestaShop-Kategorie und einen Amazon-Produkttyp (Stichwortsuche integriert). Ein Produkt nutzt die Zuordnung seiner Standardkategorie oder, falls keine besteht, der nächsten zugeordneten übergeordneten Kategorie.

- **Browse Node**: der Amazon-Katalogknoten, je nach Produkttyp optional.
- **Variationsthema**: zum Beispiel `SIZE_NAME/COLOR_NAME`. Ist es gesetzt, werden Kombinationen als Eltern-Kind-Familie gruppiert; ist es leer, wird jede Kombination als eigenständiges Produkt veröffentlicht.
- **Kombinationsattribute** und **Merkmale**: verknüpfen ein Amazon-Attribut mit einer PrestaShop-Attributgruppe oder einem Merkmal.
- **Feste Attribute**: Werte, die unverändert im Listings-Items-Format gesendet werden. Verfügbare Variablen: `{marketplace_id}`, `{language_tag}`, `{currency}`, `{reference}`, `{ean13}`, `{mpn}`, `{brand}`.

Die Schaltfläche **Pflichtattribute** liest das Schema des Produkttyps bei Amazon und listet die Attribute auf, die das Modul nicht selbst ausfüllt. Wählen Sie für jedes eine Quelle (fester Wert, Merkmal, Kombinationsattribut) und dann **Anwenden**: Die JSON-Felder werden automatisch ausgefüllt.

## Produkte veröffentlichen

### Im Produkt

Der Tab Module der Produktseite enthält einen Amazon-Block:

- **Auf Amazon verkaufen** aktiviert das Produkt.
- **Veröffentlichungsmodus**: automatisch, Angebot auf einem bestehenden Produkt (ASIN oder EAN) oder vollständiges Listing.
- **Versand**: durch Sie (FBM) oder durch Amazon (FBA).
- **ASIN**, **Produkttyp**, **Zustand** und **fester Amazon-Preis** ersetzen die Standardwerte für dieses Produkt.
- **Zusätzliche Attribute**: JSON, das nach den festen Attributen der Kategorie zusammengeführt wird; der Wert `null` entfernt ein Attribut.
- **Marktplätze**: Wählen Sie ein Land ab, um das Produkt von diesem Marktplatz zu entfernen.

Die Tabelle „Was an Amazon gesendet wird“ zeigt je Kombination und Land Preis, Angebotspreis mit Daten, Mindestpreis, Business-Preis und Menge. Vier Aktionen stehen bereit: **Mit Amazon prüfen** (Prüfung ohne Veröffentlichung, Fehler je Attribut), **Jetzt senden**, **Zur nächsten Synchronisierung hinzufügen** und **Status aktualisieren**.

### In großen Mengen

Der Tab **Produkte** listet den Katalog mit dem Status jedes Produkts pro Land (aktiv, in Bearbeitung, inaktiv, Fehler). Filtern Sie nach Name, Kategorie oder Zustand, markieren Sie Produkte oder die Option „Alle Produkte, die dem Filter entsprechen“ und wenden Sie eine Aktion an: aktivieren und veröffentlichen, erneut veröffentlichen, Preise senden, Mengen senden, deaktivieren (Menge 0) oder von Amazon löschen.

### Bereits vorhandene Amazon-Angebote

Die Schaltfläche **Bestehende Amazon-Angebote verknüpfen** im Dashboard fordert den Angebotsbericht bei Amazon an. Beim nächsten Cron-Lauf wird jede SKU mit dem PrestaShop-Produkt verknüpft, das dieselbe SKU, Referenz oder EAN trägt. Nicht gefundene SKUs stehen im Protokoll.

### Amazon-SKU

Die SKU wird bei der ersten Veröffentlichung nach der gewählten Einstellung angelegt: Referenz, EAN13 oder Muster (Standard `PS{id_product}-{id_product_attribute}`). Eine bestehende SKU ändert sich nie, auch wenn sich die Referenz ändert.

## Preise

Der Preis wird in der Marktplatzwährung mit der gewählten Preisgruppe berechnet, dann werden Aufschlag, fester Betrag und Rundung des Landes angewendet. Optionen im Tab Einstellungen:

- **Shop-Rabatte anwenden**: spezifische Preise und Katalogregeln fließen in den Amazon-Preis ein.
- **Shop-Rabatte als Amazon-Angebotspreise senden**: Der reguläre Preis bleibt der Referenzpreis, der Rabatt wird zum Angebotspreis mit den Daten des PrestaShop-Rabatts. Ein angelegter, geänderter oder gelöschter Rabatt aktualisiert Amazon sofort; datierte Angebote und Katalogregeln werden jede Nacht erneut geprüft.
- **Mindestmarge auf den Einkaufspreis**: sendet einen Mindestpreis (umgerechneter Einkaufspreis plus Marge, inklusive Mehrwertsteuer des Landes), unter dem ein Repricer nicht verkaufen kann.
- **Amazon-Business-Preise**: Der Preis der gewählten Kundengruppe wird zum Business-Preis, ihre Mengenrabatte werden zu Staffeln (maximal 5). Nur für bei Amazon Business registrierte Verkäufer.

Preisaktualisierungen betreffen nur die vom Modul verwalteten Angebote: Ein in Seller Central von Hand angelegtes Angebot für eine andere Zielgruppe bleibt erhalten.

## Bestand und FBA

Jede Bestandsbewegung in PrestaShop reiht die SKU zum Senden ein. Verfügbare Einstellungen: Sicherheitsbestand (Einheiten, die nicht auf Amazon angeboten werden), Höchstmenge, Bearbeitungszeit, Menge 0 für deaktivierte Produkte und vollständige Neusynchronisierung jede Nacht nach 3 Uhr.

FBA-Produkte erhalten keine Menge aus PrestaShop. Die Option **FBA-Bestand lesen** ruft stündlich den verfügbaren Bestand der Amazon-Lager ab und zeigt ihn im Produkt an; **FBA-Bestand in PrestaShop übernehmen** überträgt ihn auf den Shop-Bestand der FBA-Produkte.

## Bestellungen

Bestellungen werden mit der Orders API v2026-01-01 ab dem eingestellten Startdatum gelesen. Eine Bestellung mit ausstehender Zahlung wird gespeichert, aber nicht angelegt; sie wird importiert, sobald Amazon sie zum Versand freigibt.

Jede importierte Bestellung legt einen Gastkunden an oder verwendet ihn erneut (einer pro Käufer oder ein gemeinsamer Kunde, nach Wahl), eine Adresse „Amazon + Bestellnummer“ und eine PrestaShop-Bestellung mit dem Amazon-Versanddienstleister, Amazon-Preisen und -Versandkosten, der Amazon-Bestellnummer als Transaktions-ID und optional dem Amazon-Kaufdatum. Der Bestand wird wie bei einem Shop-Verkauf reduziert.

FBA-Bestellungen werden nach dem Versand mit dem Status „Amazon FBA: versandt“ importiert. Die Option „FBA-Bestellungen ändern den Shop-Bestand nicht“ bucht die Mengen nach dem Anlegen zurück.

Amazon untersagt Kontakt mit dem Käufer außerhalb seines Nachrichtendienstes. Lassen Sie die Option „Shop-E-Mails an Amazon-Käufer blockieren“ aktiviert: E-Mails an Amazon-Adressen werden blockiert, Ihre eigenen Bestellbenachrichtigungen kommen weiter an.

Der Tab **Bestellungen** listet alle Amazon-Bestellungen mit den Filtern „Zu versenden“, „Stornierungsanfragen“, „Erstattet“ und „Nicht importiert“. Eine nicht importierte Bestellung (unbekannte SKU, Währung oder Land nicht eingerichtet) zeigt die Ursache und eine Schaltfläche **Erneut versuchen**.

## Versand

Wählen Sie in den Einstellungen die Status, die den Versand bestätigen (zum Beispiel Versandt). Wechselt eine Amazon-Bestellung in einen dieser Status, sendet das Modul Versanddienstleistercode, Sendungsnummer und Versanddatum an Amazon. Ist die Sendungsnummer noch nicht erfasst, wartet es bis zu einer Stunde, bevor es ohne Sendungsnummer bestätigt.

Die Tabelle der Versanddienstleister-Zuordnung verknüpft jeden PrestaShop-Versanddienstleister mit einem Amazon-Code. Importierte Bestellungen nutzen den Amazon-Versanddienstleister: Ändern Sie ihn vor dem Versand, damit der richtige Code übermittelt wird. Der Amazon-Block der Bestellseite bietet zusätzlich die Schaltfläche **Versand jetzt bestätigen**.

## Rechnungen

Sind Sie beim Umsatzsteuer-Berechnungsservice von Amazon mit der Option zum Hochladen eigener Rechnungen registriert, aktivieren Sie **PrestaShop-Rechnungen zu Amazon hochladen**. Nach der Versandbestätigung wird die PDF-Rechnung der Bestellung mit Nummer, Gesamtbetrag und Mehrwertsteuerbetrag gesendet. Der Status (gesendet, ausstehend, abgelehnt) erscheint in der Liste und auf der Bestellseite.

Amazon lehnt den Upload ab, wenn die automatische Erstellung eigener Rechnungen in Seller Central aktiv ist. Deaktivieren Sie sie in den Einstellungen des Umsatzsteuer-Berechnungsservice.

## Stornierungen

Fragt ein Käufer die Stornierung einer nicht versandten Bestellung an, wird die Bestellung in der Liste und auf ihrer Seite rot markiert, mit dem vom Käufer angegebenen Grund. Nicht versenden: Stornieren Sie die Bestellung im Amazon-Block mit dem passenden Grund oder aktivieren Sie **Bei Amazon stornieren, wenn die Bestellung in PrestaShop storniert wird**. Eine vom Käufer angefragte Stornierung wird mit dem Grund BuyerCanceled gesendet und belastet Ihre Stornorate nicht.

Umgekehrt wechselt eine bei Amazon stornierte Bestellung in PrestaShop in den gewählten Stornierungsstatus, ohne E-Mail an den Kunden.

## Erstattungen

Mit der Option **Amazon-Erstattungen lesen** werden in Seller Central durchgeführte Erstattungen über die Finances API gelesen. Jede wird in der privaten Notiz der Bestellung mit Datum, Artikeln und Nettobetrag vermerkt. Sind alle Einheiten erstattet, wechselt die Bestellung in den gewählten Status (standardmäßig Erstattet). Der angezeigte Betrag ist der auf Ihrem Amazon-Konto gebuchte Nettobetrag nach den erstatteten Gebühren.

## Dashboard, Benachrichtigungen und Protokoll

Das Dashboard zeigt aktive und fehlerhafte Angebote, Bestellungen der letzten 24 Stunden und 30 Tage, offene Aufgaben, die letzte Synchronisierung, die häufigsten Amazon-Fehler nach Code gruppiert und die zuletzt gesendeten Feeds.

Die tägliche Benachrichtigungs-E-Mail geht nach 8 Uhr an die gewählten Empfänger, nur bei Handlungsbedarf: Stornierungsanfragen, Bestellungen mehr als 2 Tage nach dem Kauf nicht als versandt bestätigt, nicht importierte Bestellungen, abgelehnte Rechnungen, fehlerhafte Angebote, abgelehnte Feeds, angehaltener Cron. Die Schaltfläche **Test-E-Mail senden** prüft die Einrichtung.

Der Tab **Protokolle** speichert jeden Vorgang (Feeds, Bestellungen, Versand, Erstattungen, FBA, Fehler) mit technischen Details, filterbar nach Stufe und Kanal. Die Aufbewahrungsdauer wird in den Einstellungen festgelegt.

## Fehlerbehebung

### Der Verbindungstest schlägt fehl

Prüfen Sie Region, LWA-Client, Secret und Refresh Token. Ein Refresh Token gehört zu einer Anwendung und einem Konto: Erzeugen Sie es nach einer Änderung der Anwendungsrollen neu.

### Ein Angebot hat einen Fehler

Öffnen Sie das Produkt: Die Amazon-Fehler stehen unter jedem Angebot. Code 90220 bedeutet, dass ein Pflichtattribut fehlt; ergänzen Sie es in der Kategorie-Zuordnung oder in den zusätzlichen Attributen des Produkts. Nutzen Sie **Mit Amazon prüfen**, um die Korrektur vor dem Senden zu bestätigen.

### Eine Bestellung wird nicht importiert

Der Grund steht im Tab Bestellungen. Am häufigsten ist es eine Amazon-SKU ohne passendes Produkt: Verknüpfen Sie bestehende Angebote oder korrigieren Sie die Referenz und klicken Sie dann auf Erneut versuchen. Prüfen Sie auch, ob Währung und Lieferland in PrestaShop aktiv sind.

### Bestand oder Preise werden nicht aktualisiert

Prüfen Sie die letzte Synchronisierung im Dashboard und im Protokoll. Aktualisierungen gehen beim nächsten Cron-Lauf raus und Amazon verarbeitet sie innerhalb weniger Minuten. Für einen vollständigen Versand nutzen Sie **Alle Mengen erneut senden**.

## Kompatibilität

- PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei deckt beide Versionszweige ab.
- Multishop und mehrsprachig.
- Amazon-Regionen Europa, Nordamerika und Ferner Osten.
- Architektur ModuleAdminController, ohne Composer-Abhängigkeit.
- Oberfläche auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.