Amazon-Angebote verwalten

Die Seite Amazon-Angebote verwalten ist die zentrale Arbeitsfläche für die Pflege deines Amazon-Sortiments in Flowkom. Sie ersetzt die alte Einzelzeilen- Zuordnung und bietet stattdessen eine JTL-artige Multi-Select-Tabelle mit Filterleiste, Bulk-Aktionen, konfigurierbaren Spalten und CSV-Export.

Wo finde ich die Seite? Einstellungen → Integrationen → Amazon-Integration auswählen → Button “Alle Angebote verwalten” in der Karte “Amazon-Angebote”.

Der Workflow auf einen Blick

Einmal gelernt, bearbeitest du damit 50, 500 oder 5.000 Angebote in wenigen Sekunden — ohne zig Einzeldialoge.

Filterleiste

Die Toolbar kombiniert alle relevanten Filter frei miteinander. Jeder aktive Filter erscheint als Chip unterhalb der Leiste und kann einzeln entfernt werden. Der Button Alle zurücksetzen setzt sämtliche Filter auf Default.

FBA vs. FBM — was ist der Unterschied?

Selektion & Bulk-Aktionen

Zeilen markieren

• Einzelne Zeile: Checkbox in der Zeile.
• Ganze Page: Checkbox im Tabellen-Header (wirkt nur auf sichtbare 50 Zeilen).
• Alle gefilterten: Sobald Header-Checkbox gesetzt ist und mehr als eine Seite Treffer existiert, erscheint der Link “Alle N gefilterten Angebote auswählen”. Der Bulk-Request arbeitet dann gegen den kompletten Filter, nicht nur gegen die sichtbare Page.

Die Auswahl überlebt Page-Wechsel. Wechselst du hingegen die Filter, fragt Flowkom einmal nach, ob du die Auswahl verwerfen willst — damit niemand aus Versehen an Zeilen schreibt, die er gerade nicht im Blick hatte.

Die drei Bulk-Aktionen

Jede Bulk-Aktion schreibt einen einzigen Eintrag ins amazon_sync_log mit Typ listings_bulk_edit, sodass die Aktionen später nachvollziehbar sind.

Beispiel-Workflow: 50 unzugeordnete FBA-DE-Angebote auf einmal mappen

Klassisches Szenario nach einem SKU-Rebrand:

1. Filter setzen
   • Marktplatz: DE
   • Fulfillment: FBA
   • Toggle Nur nicht zugeordnet: an
2. Die Tabelle zeigt nur die betroffenen Zeilen.
3. Header-Checkbox klicken → 50 Zeilen markiert.
4. Button Zuordnen → Produkt-Picker öffnet sich.
5. Im Picker den neuen Flowkom-Artikel suchen, auswählen, Zuordnen klicken.
6. Toast: “50 Angebote zugeordnet (+12 über Marktplätze propagiert)”.

Die +12-Propagation bedeutet: weitere 12 Zwillings-SKUs auf FR/IT/ES wurden automatisch auf denselben Flowkom-Artikel mitgezogen, ohne dass du dort erneut filtern musstest.

Spalten konfigurieren

Oben rechts: Button Spalten. Dort kannst du pro Benutzer:

• Spalten ein- und ausblenden
• Reihenfolge per Drag & Drop festlegen
• Mit Zurücksetzen auf die Defaults zurückfallen

Die Konfiguration wird im Browser gespeichert (localStorage). Default-Spalten sind: Bild, Titel, SKU, ASIN, Marktplatz, Kanal, Status, FBA-Bestand, Flowkom-Artikel, Zuletzt synchronisiert.

FBA-Bestand

Die Spalte FBA-Bestand zeigt für jedes FBA-Angebot die Anzahl der Einheiten, die Amazon aktuell in seinen Lagern lieferbar führt — aggregiert über alle Fulfillment-Center des Marktplatzes. FBM-Angebote zeigen hier —, weil der Bestand dort vom Flowkom-WMS geführt wird und nicht aus Amazon zurückgespiegelt werden muss.

SELECT COALESCE(SUM(quantity_available), 0)
  FROM amazon_fba_inventory
 WHERE amazon_listing_id = <target>;

FBM-Bestandssync — separate Richtung

Wichtig: Für FBM-Angebote läuft der Bestand in die andere Richtung — vom Flowkom-WMS zu Amazon. Der FBA-Inventory-Pull berührt FBM-Angebote nicht. Wenn du bei einem FBM-Listing einen falschen Amazon-Bestand vermutest, schau stattdessen in den FBM-Bestandssync-Log (Modul amazon-inventory-push).

CSV-Export

Der Button Exportieren in der Toolbar lädt die aktuell gefilterte Liste als CSV herunter:

• Semikolon-Separator (Excel-DE kompatibel)
• UTF-8 mit BOM → Umlaute werden korrekt dargestellt
• Hard-Cap: 50.000 Zeilen pro Export (bei Überschreitung: Fehlermeldung, bitte Filter enger ziehen)

Der Export ist als Analyse-Werkzeug gedacht, nicht als JTL-Ameise- Import-Format. Spalten: SKU, ASIN, Titel, Marktplatz, Fulfillment, Status, Bestand, Flowkom-Artikel-Nr., Flowkom-Artikel-Name, Zuletzt synchronisiert.

Leere Zustände

• Keine Treffer für die aktuellen Filter → Button “Filter zurücksetzen”.
• Gar keine Angebote synchronisiert → Hinweis, zuerst einen Listings-Sync im Integration-Dashboard anzustoßen.

Tipps & Best Practices

• Nutze Deep-Links: Bookmark für “Nicht zugeordnete FBA-DE-Angebote” — der erste tägliche Reiniger-Workflow erledigt sich in einer Minute.
• Soft-Delete statt Hard-Delete: Aus Sortiment entfernen ist der einzig sinnvolle Weg, Angebote aus der Ansicht zu bekommen. Ein echtes Delete würde der nächste Sync sofort wiederherstellen.
• Cross-Marketplace-Propagation nutzen: Bei Zwillings-SKUs reicht es, auf dem Primärmarktplatz (z.B. DE) zu mappen — FR/IT/ES folgen automatisch.

Nächtlicher automatischer Refresh

Damit der Listings-State nicht davon abhängt, dass jemand tagsüber den Listings aktualisieren-Button drückt, läuft seit v1.37.000 (PROJ-172) ein nächtlicher Cron-Job, der alle aktiven Amazon-Integrationen inkrementell synchronisiert — komplett ohne Browser-Tab, komplett ohne manuellen Klick.

Wann läuft was?

Die Reihenfolge ist bewusst so gewählt: Neue oder gerade erst in Amazon freigeschaltete Angebote werden zuerst als Listings erfasst, und eine Stunde später zieht der FBA-Inventory-Pull dafür die Bestände — alles in derselben Nacht.

Der Ablauf im Detail

Wichtige Verhaltensweisen

• Opt-Out pro Integration. In der Integration-Settings-Card gibt es einen Schalter Nächtlicher Listings-Refresh. Standard: an. Wer eine Test-Integration hat oder die API-Budget-Rechnung nicht belasten will, kann ihn ausschalten.
• Per-Marketplace-Fehler-Isolation. Wirft ein Marktplatz 503 oder hat ein Auth-Problem, läuft der Job für die übrigen Marktplätze trotzdem durch. Der Fehler landet im amazon_sync_log.details.per_marketplace[mp].error und der Final-Status des Jobs wird als partial markiert.
• Time-Budget 20 Minuten pro Integration. Läuft ein Sync gegen die Wand (ungewöhnlich lange Ketten, Provider-Outage), wird der Job als partial mit finished_reason='time_budget_exceeded' beendet, damit die nächste Integration nicht blockiert wird. In der Praxis braucht ein inkrementeller Sync Minuten, nicht Stunden.
• Kein Resume zwischen Nächten. Partial-Jobs werden abgeschlossen; die nächste Nacht startet einen frischen Log. Es gibt bewusst kein „dort weiter machen, wo gestern aufgehört wurde” — die Komplexität würde nichts lösen, weil der inkrementelle Sync selbst nach mehrtägigem Ausfall über lastUpdatedAfter zuverlässig alle Änderungen nachzieht.
• Inkrementell by default, Force-Full nur manuell. Der Nightly-Job nutzt lastUpdatedAfter = letzter Erfolg − 1 h Safety. Ein vollständiger Katalog-Refresh wird nie nächtlich gefahren — das würde unnötig API-Budget verbrennen. Wer einmal einen vollständigen Refresh braucht, triggert ihn manuell über den Jetzt starten-Button und wählt dort im Admin-Endpoint force_full: true.

Manuell testen

Es gibt zwei Wege, den Cron-Pfad manuell zu triggern — ohne auf 02:00 UTC zu warten:

1. Für alle Integrationen gleichzeitig: Settings → Cron-Jobs → Amazon Listings Nightly Refresh → Jetzt ausführen. Läuft über den gleichen Endpoint wie der echte Nightly-Run.
2. Für eine einzelne Integration: In der Amazon-Integration-Settings-Card unten den Jetzt starten-Button. Der ruft den Admin-Run-Endpoint (POST /api/integrations/[id]/amazon/listings/nightly-run) auf und zeigt eine Toast-Summary mit Items + Laufzeit.

Nach dem Lauf sollte in der Cron-Health-Übersicht ein frischer Eintrag erscheinen (Job-ID amazon-listings-nightly-refresh) und im amazon_sync_log ein neuer Eintrag mit job_type='listings_refresh'.