Amazon-Integration
Verbinde deinen Amazon-Seller-Account mit Flowkom fĂĽr Bestellimport (FBM und FBA getrennt), Listings-Verwaltung, Bestandssynchronisation und VersandrĂĽckmeldung.
Voraussetzungen
- Ein aktiver Amazon Seller Central Account
- Admin-Rechte in Flowkom
- SP-API-Credentials (LWA Refresh Token, Client-ID, Client-Secret, Merchant Token)
- Freigeschaltete Marktplätze (EU oder US Region)
Verbindung einrichten
- Gehe zu Einstellungen → Integrationen
- Klicke auf Integration hinzufügen → Amazon
- Region auswählen (EU oder US)
- SP-API-Credentials eintragen
- Aktive Marktplätze auswählen (z.B. DE, FR, IT, ES, NL)
- Verbindung testen und speichern
Mehrere Regionen: Wenn du sowohl in der EU als auch in den USA verkaufst, lege zwei separate Amazon-Integrationen an – eine pro Region.
Bestellimport — FBM und FBA getrennt
Flowkom trennt die beiden Amazon-Fulfillment-Kanäle bewusst, weil sich Workflow, Statuslogik und Zuständigkeiten grundlegend unterscheiden:
| Aspekt | FBM (Fulfillment by Merchant) | FBA (Fulfillment by Amazon) |
|---|---|---|
| Versand | Du (ĂĽber Flowkom) | Amazon |
| Picking & Packing | In deinem Lager | In Amazon-Logistikzentren |
| Tracking-Nummer liefern | Ja, ĂĽber Flowkom | Nein, Amazon ĂĽbernimmt |
| Versandstatus-Filter | Ja (Versandt / Unversandt / Teilweise) | Nein (Amazon-verwaltet) |
| Bestand-Push nötig | Ja | Nein (Pull von FBA-Inventar) |
Beide Kanäle haben in Flowkom eigene Cards auf der Amazon-Integrationsseite, mit jeweils eigenen Filtern und Buttons.
Import-Flow
Filter pro Kanal
Beide Cards haben getrennte, unabhängig gespeicherte Filter:
| Filter | FBM | FBA | Werte |
|---|---|---|---|
| Bestellstatus | âś“ | âś“ | Alle, Ausstehend, Unversandt, Versandt, Storniert, Nicht erfĂĽllbar |
| Zahlungsstatus | âś“ | âś“ | Alle, Bezahlt, Ausstehend, Erstattet |
| Versandstatus | âś“ | âś— | Alle, Versandt, Teilweise versandt, Nicht versandt |
| Synchronisierungszeitraum | âś“ | âś“ | 7 / 14 / 30 / 60 / 90 Tage |
Hinweis zum Zahlungsstatus: Amazon liefert in der Bestellliste keinen direkten Zahlungsstatus – dieser wird erst beim Import der Bestelldetails ermittelt. Der Zahlungsstatus-Filter wirkt deshalb in der Vorschau nur als Anzeige-Hinweis, nicht als harte Filterung.
Jetzt synchronisieren (Voll-Import)
Klick auf Jetzt synchronisieren in der jeweiligen Card startet einen sofortigen Import aller Bestellungen, die den aktuellen Filtern des Kanals entsprechen. Unterschiede zum Auto-Cron:
- Ignoriert den normalen Cron-Zeitplan
- Nutzt den Synchronisierungszeitraum nur beim allerersten Import; danach läuft der Import inkrementell ab dem letzten importierten Zeitstempel
- Schreibt ein eigenes Sync-Log fĂĽr die Nachverfolgung
Bestellungen laden (Vorschau & selektiver Import)
Klick auf Bestellungen laden öffnet einen Dialog mit einer Vorschau-Tabelle. Hier siehst du:
- Bestellnummer, Datum, Kunde, Betrag
- Bestellstatus und Versandstatus (FBM) / nur Bestellstatus (FBA)
- Badge Bereits importiert bei Bestellungen, die schon in Flowkom liegen
Du kannst einzelne Bestellungen oder alle (nur die nicht bereits importierten) anwählen und gezielt importieren. Das ist nützlich für:
- Einzelnes Nach-Importieren nach manueller Löschung
- Gezielte Tests während der Einrichtung
- Wiederherstellung nach einem fehlgeschlagenen Auto-Import
Limit: Die Vorschau zeigt maximal 250 Bestellungen auf einmal an. Wenn der Hinweis „Maximal 250 Bestellungen angezeigt” erscheint, verkleinere den Synchronisierungszeitraum.
Status-Mapping Amazon → Flowkom
Technische Details zum Status-Mapping
Amazon SP-API liefert folgende OrderStatus-Werte, die Flowkom intern mappt:
| Amazon-Status | Flowkom-Label | Bedeutung |
|---|---|---|
Pending | Ausstehend | Zahlung noch nicht bestätigt |
Unshipped | Unversandt | Bereit fĂĽr Versand (nur FBM) |
PartiallyShipped | Teilweise versandt | Ein Teil versendet |
Shipped | Versandt | Vollständig versendet |
Canceled | Storniert | Vom Käufer oder Verkäufer storniert |
Unfulfillable | Nicht erfĂĽllbar | FBA konnte nicht liefern |
InvoiceUnconfirmed | Rechnung unbestätigt | B2B-Invoice-Pending |
Der Bestellstatus-Filter Unversandt umfasst intern sowohl Unshipped als auch PartiallyShipped, damit auch Teilversand-Bestellungen auftauchen.
Auto-Import und Cron-Zeitplan
Zusätzlich zum manuellen Import läuft ein Cron-Job im Hintergrund:
- FBM: alle 5 Minuten
- FBA: alle 15 Minuten (Amazon begrenzt die FBA-Abfrage-Frequenz stärker)
Die Cron-Jobs nutzen dieselben Filter wie die manuellen Buttons. Wenn du den Auto-Import ausschalten willst, deaktiviere die entsprechenden Toggles unter Toggles → auto_import_fbm / auto_import_fba.
Was wird importiert?
- Amazon Order ID (als externe Bestellnummer)
- Käuferdaten und Versandadresse (über SP-API Restricted Data Token)
- Positionen mit SKU-Mapping zu deinen Flowkom-Artikeln
- Bestellbetrag, Währung, Steuermodus
- Marktplatz und Fulfillment-Kanal (FBM/FBA) als Metadaten
Häufige Fragen
Warum werden keine Bestellungen angezeigt obwohl welche da sind?
Prüfe die Filter im jeweiligen Kanal. Besonders der Bestellstatus-Filter kann zu restriktiv sein. Setze ihn auf Alle, dann sollten die Bestellungen erscheinen. Prüfe außerdem den Synchronisierungszeitraum – ältere Bestellungen liegen außerhalb des Fensters.
Eine Bestellung taucht doppelt auf – was tun?
Das passiert nicht. Flowkom prĂĽft bei jedem Import anhand der amazon_order_id, ob die Bestellung schon existiert. Wenn du trotzdem Duplikate siehst, melde einen Bug.
Ich habe eine FBA-Bestellung gelöscht und will sie neu importieren
Öffne Bestellungen laden in der FBA-Card, finde die Bestellung in der Liste (sie trägt dann nicht das Badge Bereits importiert) und wähle sie für den Import aus.