Flat Files erstellen — wann der Massenweg die UI schlägt.

Ein Flat File ist Amazons Massen-Upload-Format — ein Excel- oder TSV-Template, eines pro Kategorie, mit dem du viele ASINs und SKUs in einer einzigen Einreichung erstellen, aktualisieren oder löschen kannst. Für jeden Katalog mit mehr als etwa zehn Artikeln, für jede Katalogmigration zwischen Accounts oder Regionen und für jedes Update, das mehr als fünf Felder pro SKU berührt, ist der Flat File schneller als die Add-a-Product-UI, weniger fehleranfällig (weil jede Spalte als strukturiertes Feld statt als Freitext-Eingabe validiert wird) und deutlich besser für den Audit-Trail (du behältst den Upload, du behältst den Verarbeitungsreport, du kannst Vorher-Nachher-Vergleiche durchführen). Es ist auch das gefährlichere Werkzeug — ein schlampiger Flat File kann die Lokalisierungen eines gesamten Katalogs in einem Upload löschen.

Wo man das richtige Template findet

Seller Central → Catalog → Add Products via Upload → Download an Inventory File. Der Template-Selektor fragt nach dem Produkttyp — wähle den, der zur Browse-Node-Kategorie aus Episode 08 passt. Das heruntergeladene Template ist kategoriespezifisch: ein Kitchen-Template validiert nicht gegen eine Electronics-ASIN, und das Hochladen gegen die falsche Kategorie führt entweder zu einer harten Ablehnung oder, schlimmer, zu einem stillen Attribut-Mapping, das das Listing korrumpiert. Lade das Template stets frisch für jedes neue Projekt herunter; Amazon aktualisiert Templates vierteljährlich, und alte Templates können veraltete Pflicht-Spalten enthalten.

Die Spalten, die jeden Flat File tragen

• feed_product_type. Amazons interner Produkttyp-Bezeichner. Verschieden vom Browse Node. Im „Product Type Definitions“-Blatt des Templates aufgeführt. Falscher Wert hier = stille Ablehnung der gesamten Zeile.
• item_sku. Deine eigene SKU. Dient als Primärschlüssel der Zeile — Amazon nutzt ihn, um zu entscheiden, ob die Zeile ein Erstellen, ein Aktualisieren oder ein Löschen ist. SKUs müssen innerhalb deines Accounts eindeutig sein, ≤40 Zeichen, ASCII-alphanumerisch plus Bindestrich und Unterstrich. Einmal Inventar zugewiesen, ist eine SKU faktisch permanent (Schließen und Neuanlegen einer SKU hat Fulfillment-Konsequenzen).
• external_product_id + external_product_id_type. Die GTIN (EAN, UPC, ISBN, GCID) und ihr Typ. Leer lassen bei einer GTIN-Ausnahmegenehmigung für diese Marken-/Kategorie-Kombination.
• brand_name. Muss exakt dem Brand-Registry-Eintrag entsprechen. Abweichung ist der häufigste Grund für stille Ablehnungen bei neuen ASIN-Zeilen.
• parent_sku / parent_child / relationship_type / variation_theme. Die vier Spalten, die Variationsfamilien verdrahten. Parent-Zeile hat parent_child = parent, Kind-Zeilen haben parent_child = child und referenzieren die Parent-SKU. Alle Kinder teilen dasselbe Variation Theme. Modul 5 behandelt Variations-Flat-Files ausführlich.
• update_delete. Die Operations-Spalte. Werte: Update (vollständige Zeile ersetzt den Live-Datensatz — nicht angegebene Felder werden auf leer gesetzt), PartialUpdate (nur angegebene nicht leere Felder werden geschrieben; Leerstellen werden ignoriert), Delete (schließt die SKU und entfernt das Angebot; die ASIN überlebt, wenn ein anderer Seller sie anbietet).
• recommended_browse_nodes. Die Browse-Node-ID (numerisch, aus Episode 08). Verankere den primären Node hier; sekundäre Nodes kommen in zusätzliche Browse-Node-Spalten.
• standard_price + currency. Der Angebotspreis. Die Währung muss dem Marktplatz entsprechen.
• quantity. Anfängliche Lagermenge für MFN-Angebote. Leer lassen oder null für FBA — FBA-Inventar wird separat über den FBA-Inbound-Flow verwaltet.

Update vs. PartialUpdate — der Unterschied, der zählt

Der teuerste Flat-File-Fehler ist die Verwendung von Update, wenn PartialUpdate gemeint war. Mit Update wird jede leere Zelle in deiner Zeile interpretiert als „dieses Feld auf leer setzen“ und der Live-Datensatz wird bei diesen Feldern gelöscht. Ein Flat File, der eine Preisspalte auf einen neuen Wert aktualisiert und die Bullets, die Beschreibung und die Keywords leer lässt, löscht die Bullets, die Beschreibung und die Keywords im nächsten Verarbeitungsschritt. PartialUpdate ignoriert leere Zellen und schreibt nur nicht-leere Werte. Die Regel: PartialUpdate als Standard verwenden, und Update nur verwenden, wenn du Felder explizit löschen möchtest und deine Zeile absichtlich vollständig ist.

Der sicherste Flat-File-Workflow

1. Das neueste Template herunterladen für die richtige Kategorie aus Seller Central. Kein altes Template aus einem früheren Projekt wiederverwenden — vierteljährliche Updates ändern Pflicht-Spalten.
2. Die aktuellen Live-Daten exportieren für jede SKU, die du anfassen wirst, über den Reverse-Feed-Flow (Episode 12). Das liefert dir den Live-Datensatz, wie Amazon ihn aktuell speichert, in derselben Spaltenform wie das Template.
3. Änderungen in einer Kopie des Exports vornehmen. Nie die Live-Export-Datei direkt bearbeiten — sie als Rollback-Artefakt aufbewahren.
4. update_delete auf PartialUpdate setzen für jede Zeile, es sei denn, du möchtest ausdrücklich eine vollständige Ersetzungssemantik.
5. Lokal zuerst validieren. Öffne das „Valid Values“-Blatt des Templates und überprüfe jeden Dropdown-Wert (Produkttyp, Variation Theme, Währung, Fulfillment-Kanal) mit dem, was deine Zeile verwendet. Excels Datenvalidierung erkennt die offensichtlichen Fehler vor dem Upload.
6. In die Inventory-File-Warteschlange hochladen über Seller Central → Catalog → Add Products via Upload → Upload your Inventory File. Den passenden Template-Typ aus dem Dropdown wählen — falsche Template-Typauswahl beim Upload-Zeitpunkt parst die Datei still falsch.
7. Auf den Verarbeitungsreport warten (typischerweise 5–30 Minuten, manchmal Stunden in Stoßzeiten). Den Report herunterladen und jede Warnzeile lesen, nicht nur die Fehleranzahl. Warnungen dokumentieren häufig stille Umschreibungen, die erfolgreich waren, aber mit unerwarteten Werten.
8. Live-SKUs in Seller Central stichprobenartig prüfen nach Abschluss der Verarbeitung. Bestätigen, dass die gespeicherten Werte mit dem übereinstimmen, was du hochgeladen hast; jede Abweichung vor dem nächsten Upload untersuchen.

Den Verarbeitungsreport lesen

Der Report kommt als Excel- oder Textdatei zurück mit einer Zeile pro eingereichter Zeile plus Fehler- und Warnspalten. Das Statusfeld verwendet:

• OK — Zeile erfolgreich verarbeitet. Trotzdem prüfen, ob die gespeicherten Werte mit dem übereinstimmen, was du hochgeladen hast; stille Umschreibungen können auch bei OK-Zeilen gelten.
• WARNING — Zeile verarbeitet, aber mit einem markierten Problem. Am häufigsten eine Style-Guide-Umschreibung (Titelgroßschreibung, Entfernung gesperrter Wörter). Jede Warnung lesen.
• ERROR — Zeile abgelehnt. Der Fehlercode verweist auf das fehlgeschlagene Feld; die Fehlermeldung beschreibt den Validierungsfehler. Nur die fehlgeschlagenen Zeilen korrigieren und erneut einreichen, nicht die gesamte Datei.

Häufige Flat-File-Fehlermodi

• Falsche Template-Version. Vierteljährliche Template-Änderungen brechen alte Dateien. Jedes Mal neu herunterladen.
• Update statt PartialUpdate. Löscht Felder, die du nicht anfassen wolltest. Oben behandelt.
• UTF-8-BOM-Probleme. Excel fügt TSV-Exporten manchmal eine Byte-Order-Mark hinzu, die Amazons Parser bricht. Als Excel (.xlsm) oder als einfaches TSV ohne BOM speichern.
• Führende Nullen bei EANs abgeschnitten. Excel schneidet führende Nullen aus numerischen Spalten ab und macht aus 0123456789012 eine 123456789012. Die GTIN-Spalte als Text formatieren, bevor man einfügt.
• Falscher product_type für die Kategorie. Stille Ablehnung oder Attribut-Mapping-Korruption. Den richtigen Produkttyp im „Product Type Definitions“-Blatt des Templates nachschlagen.
• Gleichzeitige Flat-File- und UI-Bearbeitungen. Ein Flat File in der Verarbeitung, während ein Teammitglied dieselbe SKU in der UI bearbeitet, erzeugt ein Last-Write-Wins-Verhalten, das schwer zu debuggen ist. Eine Teamregel „keine UI-Bearbeitungen während Flat-File-Uploads“ einführen.
• Währungskonflikt. USD-Preise an einen EU-Marktplatz einzureichen lehnt die Angebotszeilen still ab.

Flat Files vs. automatisierte SP-API-Feeds

Manuelle Flat-File-Uploads sind das richtige Werkzeug für ad-hoc-Massenoperationen. Für kontinuierliche, automatisierte Feed-Integrationen — Repricer, ERP-Integrationen, Multi-Channel-Inventar-Tools — ist der SP-API-Feeds-Endpunkt der moderne Weg. SP-API-Feeds verwenden dasselbe zugrunde liegende Schema wie Flat Files (das Tab-Delimited Inventory Files-Format oder das neuere JSON-Schema für einige Operationen), aber mit programmatischer Authentifizierung, geplanter Ausführung und zeilenweisen Status-Callbacks. Wenn dein Katalog ~1.000 SKUs übersteigt oder deine Update-Häufigkeit wöchentlich überschreitet, plane für SP-API statt manuelle Flat Files.

Seller vs. Vendor — Flat Files vs. NIS

Seller verwenden die oben beschriebene Flat-File-Pipeline. Vendors nicht — Vendor-Massenoperationen laufen über das NIS-Formular-Template (New Item Setup), das strukturell ähnlich ist (Excel-ähnlich, kategoriespezifisch), aber über Vendor Central eingereicht und von Amazons Katalog-Team überprüft wird, statt automatisch verarbeitet zu werden. NIS-Durchlaufzeiten bei Vendors sind Tage bis Wochen statt der Minuten bis Stunden des Seller-Flat-Files. Die Kategorie von Operationen, die entscheidet, ob ein Vendor NIS oder einen anderen Weg verwendet: jede neue ASIN-Erstellung oder Variationsfamilienänderung verwendet NIS; Attribut-Updates auf bestehenden Live-ASINs laufen über den Katalog-Editor innerhalb von Vendor Central oder über CSV-Updates im Bereich Artikel.

Was in die nächste Episode mitgenommen wird

Mit behandelten Flat Files deckt die nächste Episode die Style Guides ab — die kategoriebezogenen Regeln, die entscheiden, was Titel, Bullets und Bilder tatsächlich enthalten dürfen, und den stillen Validator, der deinen Content umschreibt, wenn du die Grenzen überschreitest.