Amazon Flatfile: Listings per Bulk-Upload pflegen 2026
Amazon Flatfile 2026: Vorlagen richtig nutzen, Pflichtfelder und Update-Modi verstehen, Varianten abbilden und Fehlercodes im Verarbeitungsbericht lösen.
Die Kurzfassung: Flatfiles sind kategoriespezifische Tabellendateien, mit denen Sie Listings über Seller Central in Masse anlegen oder aktualisieren. Sie lohnen sich, sobald Sie mehr als eine Handvoll Artikel gleichzeitig ändern — bei Compliance-Angaben, Attributpflege oder Variantenaufbau sind sie oft die einzige praktikable Option. Amazon hat Flatfile-Feeds über die Feeds API im Juli 2025 abgekündigt; der manuelle Upload-Workflow in Seller Central bleibt für tabellenbasierte Massenoperationen aktiv. Die häufigsten Fehlerursachen sind banal: fehlende Pflichtfelder, ungültige Werte, falsche Datumsformate und Parent-Child-Referenzen, die nicht zusammenpassen. Wer eine frische Vorlage lädt, die Update-Modi versteht, jeden Upload im Vier-Augen-Prinzip freigibt und Verarbeitungsberichte archiviert, bekommt den Prozess stabil. Dieser Beitrag zeigt Aufbau, Modi, Fehlercodes und einen belastbaren Ablauf für Ihr Team.
Wann Flatfile die richtige Wahl ist — und wann nicht
Die Einzelbearbeitung in Seller Central ist bequem, solange Sie fünf Artikel ändern. Ab etwa zwanzig Artikeln kippt das Verhältnis: Der Klickaufwand steigt linear, die Fehlerquote ebenfalls, und nachvollziehbar ist am Ende nichts.
Flatfiles drehen dieses Verhältnis um. Sie erzeugen eine dokumentierte, wiederholbare Änderung mit einem einzigen Verarbeitungsbericht als Beleg. Genau das brauchen Sie, wenn mehrere Personen am Katalog arbeiten oder wenn Sie später rekonstruieren müssen, wer wann was geändert hat.
Typische Anwendungsfälle sind der Aufbau neuer Sortimente, die Pflege von Attributen über ganze Kategorien hinweg, das Nachziehen von Compliance-Angaben und der Aufbau oder Umbau von Variantenfamilien. In allen vier Fällen ist die Einzelbearbeitung praktisch nicht durchführbar.
Nicht sinnvoll sind Flatfiles bei einzelnen, inhaltlich anspruchsvollen Änderungen — etwa der Neuformulierung eines einzelnen Titels oder der Korrektur eines Bildes. Dafür ist der Aufwand der Vorlagenpflege zu hoch.
Und sie sind kein Werkzeug für Preis- und Gebotssteuerung. Wer Preise per Flatfile in Wellen ändert, arbeitet mit Momentaufnahmen statt mit Marktlogik. Hier gehören Repricing und prädiktive Gebotssteuerung hin: MarketplAIce passt Preise und Gebote laufend an, statt einen Zustand einzufrieren, der beim nächsten Wettbewerbszug schon falsch ist.
Aufbau der Vorlage: Template, Datendefinitionen, Gültige Werte
Eine Amazon-Flatfile-Vorlage ist kategoriespezifisch. Die Vorlage für Bekleidung enthält andere Pflichtfelder als die für Elektronik, und die Werteauswahl unterscheidet sich ebenfalls. Deshalb gilt die wichtigste Regel gleich zu Beginn: Laden Sie vor jedem neuen Massen-Update eine frische Vorlage aus Seller Central.
Der Grund ist simpel. Amazon aktualisiert Attributfelder und Compliance-Anforderungen regelmäßig. Eine Vorlage aus dem Vorjahr kennt neue Pflichtfelder nicht — und produziert dann Fehler, deren Ursache Sie in der Datei nicht finden, weil die entsprechende Spalte gar nicht existiert.
Die Vorlage besteht typischerweise aus mehreren Registerkarten. Die Datendefinitionen erklären je Feld, was erwartet wird und ob es Pflicht ist. Die Registerkarte mit den gültigen Werten listet die zulässigen Ausprägungen für Auswahlfelder — dort steht, ob "Rot" oder "rot" oder ein englischer Wert erwartet wird.
Diese beiden Registerkarten sind der Unterschied zwischen einem sauberen Upload und drei Fehlerrunden. Wer sie ignoriert und Werte nach Gefühl einträgt, produziert exakt die Ingestion-Fehler, die später mühsam gesucht werden.
Achten Sie zusätzlich auf die Kopfzeilenstruktur. Die ersten Zeilen der Vorlage enthalten technische Feldnamen und Anzeigenamen; sie dürfen nicht gelöscht, verschoben oder umbenannt werden. Ein häufiger Fehler ist das Kopieren der Daten in eine leere Arbeitsmappe — dabei geht genau diese Struktur verloren.
MarketplAIce 14 Tage kostenlos testen — und die Listing-Qualität Ihres Katalogs prüfen, bevor Sie Änderungen in Masse hochladen.
Pflichtfelder, Attribut-Updates und die drei Modi
Ein Großteil fehlgeschlagener Flatfile-Uploads geht auf fehlende Pflichtfelder oder ungültige Werte zurück. Fehlende Pflichtfelder erzeugen Ingestion-Fehler mit konkreten Fehlercodes, etwa 90041. Die gute Nachricht: Diese Fehler sind systematisch und damit vermeidbar.
Entscheidend ist das Verständnis der Verarbeitungsmodi. Im Update-Modus wird der Datensatz vollständig überschrieben — leere Felder in Ihrer Datei können vorhandene Werte löschen. Im PartialUpdate-Modus werden nur die befüllten Felder aktualisiert, alles andere bleibt unberührt. Im Delete-Modus wird der Datensatz entfernt.
Der teuerste Fehler in der Praxis ist die Verwechslung von Update und PartialUpdate. Wer eine Datei mit nur drei befüllten Spalten im vollständigen Update-Modus hochlädt, kann in einem Rutsch Bulletpoints, Beschreibungen und Attribute leeren. Der Katalog sieht danach aus wie neu angelegt — nur schlechter.
Nutzen Sie deshalb PartialUpdate als Standard für laufende Attributpflege und den vollständigen Update-Modus nur, wenn Sie den kompletten Datensatz liefern. Delete gehört ohnehin in eine gesonderte, explizit freigegebene Datei.
Ein weiterer Klassiker sind Formatfehler. Datumsangaben müssen dem Format JJJJ-MM-TT folgen, also 2026-02-09 — nicht 02/09/2026 und nicht 9-Feb-2026. Tabellenkalkulationen formatieren Datumsfelder gern selbstständig um, weshalb Sie Datumsspalten vor dem Speichern als Text prüfen sollten.
Dasselbe gilt für führende Nullen in EAN- und SKU-Feldern sowie für Dezimaltrennzeichen. Ein Preisfeld mit Komma statt Punkt oder eine EAN, aus der die führende Null verschwunden ist, sind die zwei häufigsten stillen Datenfehler.
Varianten richtig abbilden: Parent und Child
Variantenfamilien sind der Bereich, in dem Flatfiles ihre Stärke ausspielen — und gleichzeitig der Bereich mit den meisten Uploadfehlern. Bei Parent-Child-Listings müssen Child-SKUs die Parent-SKU korrekt referenzieren; jede Abweichung löst Upload-Fehler aus.
Die Struktur ist logisch: Der Parent ist ein nicht kaufbarer Container, der die Familie zusammenhält. Die Children sind die tatsächlich kaufbaren Varianten mit eigener SKU, eigenem Bestand und eigenem Preis. Das Variationsthema legt fest, worin sich die Children unterscheiden — etwa Größe, Farbe oder eine Kombination.
Drei Fehler treten immer wieder auf. Erstens: uneinheitliche Schreibweise der Parent-SKU in den Child-Zeilen, oft durch Leerzeichen am Ende. Zweitens: ein Variationsthema, das nicht zu den befüllten Attributspalten passt. Drittens: Children, die Werte im Variationsattribut doppelt belegen.
Für die Werbung ist eine Besonderheit wichtig, die viele erst nach dem ersten Fehlschlag lernen: Kampagnen laufen auf Child-SKUs, nicht auf dem Parent. Der Parent ist nicht bewerbbar, weshalb jede beworbene Variante ihre eigene Struktur braucht. Wer das beim Aufbau der Familie mitdenkt, spart sich später den kompletten Kampagnenumbau.
Genau an dieser Stelle hilft eine Systematik statt Handarbeit: MarketplAIce erzeugt Gebots- und Kampagnenvorschläge je Child-SKU und berücksichtigt dabei prognostizierte Nachfrage über 15 Dimensionen, statt Kampagnen pauschal auf Familienebene zu steuern. Die technischen Grundlagen des Variantenaufbaus vertieft unser Beitrag zu Parent-Child-Varianten auf Amazon.
Flatfile-Upload in 8 Schritten
- Frische Vorlage laden. Ziehen Sie die kategoriespezifische Vorlage unmittelbar vor der Bearbeitung neu aus Seller Central. Verwenden Sie niemals eine gespeicherte Datei aus einem früheren Projekt. Neue Pflichtfelder tauchen sonst nicht auf, und die Fehlersuche beginnt im Blindflug.
- Datendefinitionen und gültige Werte durchgehen. Prüfen Sie für jedes Feld, das Sie befüllen wollen, ob es Pflicht ist und welche Werte zulässig sind. Notieren Sie Abweichungen zu Ihrer internen Datenhaltung. Diese Vorarbeit dauert eine halbe Stunde und spart mehrere Fehlerrunden.
- Daten aus dem Quellsystem exportieren. Ziehen Sie die zu ändernden Felder aus Ihrer Warenwirtschaft oder Ihrem PIM in eine Arbeitsdatei. Arbeiten Sie mit SKU als eindeutigem Schlüssel und vermeiden Sie manuelle Zwischenschritte. Jede händische Kopie ist eine Fehlerquelle.
- In die Vorlage übertragen, nicht umgekehrt. Fügen Sie die Werte in die Original-Vorlage ein und lassen Sie deren Kopfzeilen unverändert. Fügen Sie ausschließlich als Werte ein, damit keine Formatierungen oder Formeln mitwandern. Prüfen Sie danach Datums-, EAN- und Preisspalten stichprobenartig.
- Modus bewusst wählen. Entscheiden Sie je Datei, ob Update, PartialUpdate oder Delete gilt, und schreiben Sie die Entscheidung in den Dateinamen. Mischen Sie niemals Delete-Zeilen in eine Update-Datei. Für die laufende Attributpflege ist PartialUpdate der sichere Standard.
- Testlauf mit kleiner Menge. Laden Sie zuerst fünf bis zehn Zeilen hoch und werten Sie den Verarbeitungsbericht vollständig aus. Erst wenn dieser Testlauf fehlerfrei ist, laden Sie die vollständige Datei. Ein Testlauf kostet zehn Minuten, ein fehlerhafter Massenupload einen Arbeitstag.
- Vollständigen Upload durchführen und Bericht prüfen. Laden Sie die Gesamtdatei hoch und warten Sie den Verarbeitungsbericht ab, bevor Sie weitere Änderungen anstoßen. Prüfen Sie nicht nur die Fehlerzeilen, sondern auch die Zahl der erfolgreich verarbeiteten Datensätze. Abweichungen deuten auf stillschweigend ignorierte Zeilen hin.
- Datei und Bericht archivieren. Legen Sie die hochgeladene Vorlage zusammen mit dem Verarbeitungs- beziehungsweise Fehlerbericht zur Lagerbestandsdatei ab. Diese Berichte enthalten Batch-IDs und konkrete Fehlercodes und sind Ihr einziger Beleg im Streitfall. Ohne Archiv ist eine spätere Rekonstruktion praktisch unmöglich.
Verarbeitungsbericht und Fehlercodes lesen
Der Verarbeitungsbericht ist kein lästiger Anhang, sondern das eigentliche Ergebnis des Uploads. Er nennt die Zahl der verarbeiteten, erfolgreichen und fehlerhaften Datensätze, liefert je Fehlerzeile einen Code und meist einen erklärenden Text.
Arbeiten Sie den Bericht immer von der Fehlerart her ab, nicht Zeile für Zeile. Wenn hundert Zeilen denselben Code zeigen, liegt ein strukturelles Problem vor — eine falsche Spaltenzuordnung, ein ungültiger Wert oder ein fehlendes Pflichtfeld. Eine einzige Korrektur in der Quelldatei löst dann alle hundert Fehler.
Fehlende Pflichtfelder erzeugen Ingestion-Fehler mit eigenen Codes, etwa 90041. Solche Codes lassen sich in Seller Central nachschlagen; wichtiger ist aber, sie intern zu dokumentieren. Führen Sie eine kurze Liste der Fehlercodes, die bei Ihnen aufgetreten sind, samt Ursache und Lösung — nach drei Monaten löst Ihr Team damit die meisten Fälle ohne Recherche.
Beachten Sie außerdem den Unterschied zwischen Fehlern und Warnungen. Warnungen führen zu einer Verarbeitung, weisen aber auf Datenqualitätsprobleme hin. Wer sie ignoriert, hat später Listings mit unvollständigen Attributen und schlechter Auffindbarkeit.
Prüfen Sie zuletzt stichprobenartig im Frontend, ob die Änderung tatsächlich angekommen ist. Ein erfolgreicher Bericht bedeutet, dass Amazon die Datei angenommen hat — nicht zwingend, dass die Anzeige sofort aktualisiert ist. Kontrollieren Sie insbesondere Titel und Attribute, deren Wirkung auf die Auffindbarkeit unser Beitrag zur Optimierung von Amazon-Produkttiteln beschreibt.
Freigabeprozess, Vier-Augen-Prinzip und Versionierung
Ein Flatfile-Upload ist eine Massenoperation, und Massenoperationen brauchen einen Freigabeprozess. Die Regel ist einfach: Niemand lädt eine Datei hoch, die er selbst allein erstellt hat, wenn mehr als eine bestimmte Zahl an Artikeln betroffen ist. Legen Sie diese Schwelle intern fest — 25 Artikel sind ein praktikabler Startwert.
Die Prüfung durch die zweite Person hat drei Punkte: Ist der richtige Modus gewählt? Stimmt die Anzahl der Zeilen mit dem beabsichtigten Umfang überein? Sind Stichproben aus Anfang, Mitte und Ende der Datei inhaltlich korrekt?
Ergänzen Sie das um eine Versionierung Ihrer eigenen Dateien. Ein einheitliches Namensschema aus Datum, Kategorie, Modus und Bearbeiter reicht völlig aus, etwa 2026-08-14_bekleidung_partialupdate_mm.xlsm. Wichtig ist, dass jede hochgeladene Version unverändert erhalten bleibt.
Legen Sie zusätzlich fest, was bei einem fehlerhaften Upload passiert. Ein vorbereiteter Rollback-Datensatz — also ein Export des Ist-Zustands vor der Änderung — ist die günstigste Versicherung, die Sie in diesem Prozess abschließen können. Ziehen Sie ihn immer, bevor Sie im vollständigen Update-Modus arbeiten.
Und dokumentieren Sie den Zweck jeder Änderung in einer Zeile. "GPSR-Angaben für Kategorie X nachgezogen" ist in zwölf Monaten mehr wert als der schönste Dateiname.
Compliance-Massenpflege über Flatfile
Compliance-Anforderungen sind der stärkste Treiber für Flatfile-Arbeit geworden. Angaben zu Herstellern, verantwortlichen Personen in der EU, Sicherheitshinweisen und Warnhinweisen müssen über ganze Sortimente hinweg gepflegt werden — einzeln ist das nicht leistbar.
Der Ablauf unterscheidet sich nicht vom regulären Upload, aber die Vorbereitung ist aufwendiger. Sie brauchen die Angaben in strukturierter Form, sauber je Artikel zugeordnet, und Sie brauchen eine Entscheidung, welche Felder pro Kategorie überhaupt verlangt werden. Genau dafür ist die frische Vorlage unverzichtbar, weil Amazon Compliance-Felder regelmäßig ergänzt.
Planen Sie Compliance-Uploads in Wellen nach Kategorie, nicht nach Lieferant. Die Pflichtfelder hängen an der Kategorie, und eine Datei je Kategorie hält den Fehlerbericht auswertbar.
Rechnen Sie außerdem mit Nacharbeit. Bei Compliance-Angaben führen unvollständige Lieferantendaten regelmäßig zu Lücken, die Sie nur durch Rückfragen schließen. Bauen Sie deshalb eine Wiedervorlage ein, statt den Upload als einmalige Aktion zu behandeln. Welche Dokumente Sie vorhalten sollten, ordnet unser Beitrag zur Amazon-Produktkonformität ein.
Ein letzter Punkt: Trennen Sie Compliance-Pflege und inhaltliche Listing-Optimierung. Wer beides in einer Datei bündelt, kann bei Fehlern nicht mehr unterscheiden, welcher Teil gescheitert ist. MarketplAIce liefert die inhaltliche Seite ohnehin separat — Titel-, Bullet- und Attributvorschläge auf Basis von Suchverhalten und Wettbewerbsumfeld —, sodass die Compliance-Datei schlank bleibt.
Wenn Sie Listing-Optimierung, Repricing und Gebotssteuerung über Amazon hinaus auf weiteren Marktplätzen automatisieren wollen, finden Sie die passenden Pakete auf der Seite Preise — inklusive der Frage, ab welchem Sortimentsumfang sich der Umstieg lohnt.
FAQ
Kann ich Flatfiles 2026 noch über die API einreichen?
Amazon hat Flatfile-Feeds über die Feeds API im Juli 2025 abgekündigt. Der manuelle Upload-Workflow in Seller Central bleibt für tabellenbasierte Massenoperationen aktiv. Für automatisierte Anbindungen sollten Sie auf die aktuellen strukturierten Schnittstellen setzen.
Warum schlägt mein Upload mit Fehlercode 90041 fehl?
Fehlende Pflichtfelder erzeugen Ingestion-Fehler mit Fehlercodes wie 90041. Prüfen Sie in den Datendefinitionen der Vorlage, welche Felder für Ihre Kategorie verpflichtend sind, und ergänzen Sie sie. Häufig fehlt ein Pflichtfeld, das in einer älteren Vorlage noch nicht existierte.
Was ist der Unterschied zwischen Update und PartialUpdate?
Im Update-Modus wird der Datensatz vollständig überschrieben, leere Felder können vorhandene Werte löschen. Im PartialUpdate-Modus werden nur befüllte Felder aktualisiert. Für laufende Attributpflege ist PartialUpdate der sichere Standard.
Wie muss ich Datumsangaben formatieren?
Datumsangaben müssen dem Format JJJJ-MM-TT folgen, also zum Beispiel 2026-02-09. Schreibweisen wie 02/09/2026 oder 9-Feb-2026 führen zu Fehlern. Prüfen Sie Datumsspalten vor dem Speichern, weil Tabellenkalkulationen sie automatisch umformatieren.
Warum scheitern meine Variantenuploads so oft?
Child-SKUs müssen die Parent-SKU exakt referenzieren; jede Abweichung, auch ein Leerzeichen, löst einen Fehler aus. Zusätzlich muss das Variationsthema zu den befüllten Attributspalten passen und darf keine doppelten Wertkombinationen enthalten.
Muss ich wirklich vor jedem Upload eine neue Vorlage laden?
Ja. Amazon aktualisiert Attributfelder und Compliance-Anforderungen regelmäßig, und alte Vorlagen kennen neue Pflichtfelder nicht. Der Download dauert wenige Minuten und verhindert die häufigste Fehlerklasse überhaupt.
Wie lange sollte ich Verarbeitungsberichte aufbewahren?
Archivieren Sie Vorlage und Bericht dauerhaft zusammen, mindestens aber so lange, wie die betroffenen Artikel aktiv sind. Die Berichte enthalten Batch-IDs und Fehlercodes und sind Ihr einziger Nachweis darüber, was wann eingespielt wurde.
Über den Autor
Jorginho Engelmeyer ist Gründer von MarketplAIce und seit über acht Jahren im Amazon- und Marktplatz-Advertising aktiv. Mehr zu seiner Erfahrung und Arbeitsweise: Expertise.