Amazon Flat File Templates: Jak je používat bez zbytečné bolesti

Amazon flat file templates v roce 2026: co se změnilo a co funguje dál

Amazon flat file templates zůstávají jedním z hlavních způsobů, jak prodejci hromadně vytvářejí a aktualizují listingy přes Seller Central. Zásadní posun ale přišel v polovině roku 2025, kdy Amazon ukončil podporu legacy flat file a XML feedů v rámci Feeds API. Vývojáři museli přejít na JSON-based Listings Items API.

Co to znamená v praxi? Pokud šablony nahráváte ručně přes Seller Central, nic se pro vás nemění. Pokud je ale vaše systémy odesílaly programaticky přes SP-API Feeds endpoint, tato cesta od 31. července 2025 neexistuje. To, do které skupiny patříte, určuje, jak k flat file šablonám přistupovat.

V obou případech ale zůstává stejný problém: požadavky na listing se liší podle kategorie, mění se bez varování a nekvalitní data vedou k zamítnutým uploadům, potlačeným listingům nebo špatné viditelnosti. Disciplinovaný přístup k práci se šablonami ušetří hodiny oprav při každém upload cyklu.

Než se ponoříme do Amazon specifik, vyplatí se mít solidní základ. Náš průvodce optimalizací produktových feedů pokrývá cross-channel principy, na kterých platformová práce stojí.

Required fields a Product Type Definitions

Required fields v Amazon flat file šablonách nejsou statický seznam. Liší se podle product type, marketplace a kontextu listingu, tedy například zda vytváříte nový ASIN nebo aktualizujete existující.

Amazon staví katalogovou architekturu na Product Type Definitions. Každý product type má vlastní JSON schéma, které definuje, které atributy jsou required, conditionally required nebo recommended. Když si stáhnete šablonu ze Seller Central, sloupce a povolené hodnoty odpovídají definicím pro zvolenou kategorii.

Pole se prakticky dělí do tří úrovní:

Must-pass pole zablokují ingest při chybějící nebo neplatné hodnotě. Typicky jde o SKU, identifikátory produktu (UPC, EAN nebo GTIN), title, cenu a klíčové kategoriové atributy. Od ledna 2025 nesmí title přesáhnout 200 znaků pro většinu kategorií a 125 znaků pro některé oděvní podkategorie. Speciální znaky jako !, $, ? nebo { jsou zakázané, pokud nejsou součástí registrované značky.

Podmíněně povinná pole se stanou mandatory na základě jiných hodnot. Výběr variation theme spouští požadavky na parent-child relationship pole. V technických kategoriích mohou být povinné atributy materiálu nebo kompatibility jen pro konkrétní podkategorie.

Doporučená pole neblokují upload, ale přímo ovlivňují kvalitu listingu a viditelnost ve vyhledávání. Chybějící bullet points, nekompletní popisy nebo prázdné backend keywords znamenají listing, který projde, ale neprodává.

Pro systematickou správu všech tří úrovní pomůže náš checklist kvality produktových dat.

Struktura šablony: jak ji číst a nepřehlédnout důležité

Každá Amazon flat file šablona stažená ze Seller Central obsahuje sedm listů. Pochopení každého z nich zamezí zbytečnému trial-and-error při uploadech.

• Instructions: Přehled upload procesu a základních pravidel pro kategorii.
• Data Definitions: Popis každého sloupce, datový typ, znakový limit a informace zda je pole required, conditionally required nebo optional.
• Valid Values: Výčtové seznamy pro kontrolované atributy jako barva, velikost, materiál a další pole, která přijímají jen předem definované hodnoty.
• Template: Samotný datový list, kam zadáváte informace o produktech. Pouze tento list se uploaduje.
• Example: Ukázkové řádky se správně formátovanými hodnotami pro danou kategorii.
• Images: Specifikace požadavků na produktové obrázky.
• Browse Data: Mapování kategoriových uzlů a browse tree informace.

Nejčastější chyba je ignorování listů Data Definitions a Valid Values. Když zadáte barvu, která vypadá správně, ale neodpovídá přesně Amazon enumeraci, upload selže nebo se atribut tiše zahodí. Vždy kontrolujte data proti Valid Values před uploadem.

Pro týmy, které spravují title šablony napříč kategoriemi, je Data Definitions list klíčový zdroj znakových limitů a formátovacích pravidel specifických pro jednotlivé product types.

Mapovací pipeline místo ručního vyplňování

Většina flat file chyb vzniká upstream, nikoliv v samotné šabloně. Kořenovou příčinou bývá slabé nebo neexistující mapování mezi zdrojovými daty (dodavatelské feedy, ERP exporty, PIM systémy) a Amazon atributy.

Místo ručního kopírování hodnot do tabulkových sloupců postavte mapovací pipeline s jasnými transformačními pravidly:

Identifikace zdrojů: Zdokumentujte každý název pole z každého zdrojového systému. Dodavatelé pojmenovávají stejné atributy různě. Jeden má Colour, druhý Color_Primary a váš interní systém třeba product_color.

Kanonická normalizace: Namapujte všechny zdrojové varianty na jeden interní název pole. Tato kanonická vrstva funguje jako překladový hub. Když přibude nový dodavatel, mapujete ho jen do kanonického modelu, ne zvlášť na každý cílový kanál.

Amazon-specific transformace: Z kanonického modelu definujte, jak se každé pole mapuje na přesný Amazon atribut, aplikujte formátovací pravidla (konverze jednotek, znakové limity, enum matching) a specifikujte fallback logiku pro chybějící hodnoty.

Validační brány: Před tím, než se data dostanou do flat file, spusťte kontroly proti Amazon povoleným hodnotám, znakovým limitům a cross-field závislostem.

Díky tomuto přístupu se flat file stává výstupním formátem, ne pracovním prostředím. Když Amazon změní požadavek nebo expandujete do nové kategorie, upravíte mapovací pravidla jednou místo přeškolování týmu na tabulkové konvence.

Lasso features jsou navržené přesně pro tento workflow: import nejednotných zdrojových feedů, normalizace atributů podle standardizovaných pravidel a výstup channel-ready dat s vestavěnou validací. Pro týmy s nekonzistentními dodavatelskými daty náš článek o standardizaci supplier dat pomocí AI pokrývá čištění na vstupní straně.

Nejčastější chyby a jak se jim vyhnout

Určité chybové vzorce se opakují téměř v každém Amazon flat file workflow. Znalost předem ušetří hodiny debuggingu.

Error 90041 (Missing Product Information): Spouští se při prázdných nebo neplatných povinných polích pro daný product type. Prevence: vždy stahujte čerstvou šablonu pro konkrétní kategorii a zkontrolujte každý required sloupec v Data Definitions listu.

Error 8541 (Attribute Mismatch): Nastane, když odeslaná data kolidují s existujícími katalogovými informacemi pro ASIN. Typicky se to děje při aktualizaci listingů, kde Amazon zamkl určité atributy. Řešení: odešlete partial update soubor obsahující pouze atributy, které potřebujete změnit.

Chyby variation theme: Nesprávný variation theme pro danou kategorii rozbije parent-child vztahy. Každá Amazon kategorie má schválené themes (Size/Color, Size, Flavor atd.) a nepodporovaný theme způsobí zamítnutí. Prevence: zkontrolujte Valid Values list pro schválené themes.

Konflikty duplicitních SKU: Upload souboru se SKU, která už existují pod jiným ASIN nebo s konfliktními identifikátory, vyvolá řetězové chyby. Udržujte čistý validační framework katalogu, který tyto problémy zachytí předem.

Překročení znakových limitů: Od lednové aktualizace 2025 Amazon striktněji vynucuje limit 200 znaků a po 14denní lhůtě automaticky upraví titulky, které ho překračují. Kontrolujte všechna textová pole proti limitům v Data Definitions listu.

Enum nesoulad: Zadání "Dark Blue" když Amazon Valid Values přijímá pouze "Navy" způsobí tiché zahození atributu nebo zamítnutí. Řešením je udržovat kontrolovaný slovník, který mapuje vaše interní hodnoty na přesné Amazon enumerace.

Pro týmy pracující na enrichmentu atributů pro prodejné listingy by pre-upload validace proti Amazon enumeracím měla být automatizovaným krokem, ne ruční kontrolou.

Praktický checklist validace před uploadem

Strategie "nahrát a pak opravit" je nejdražší pattern v katalogové správě. Každý zamítnutý soubor znamená další kolo parsování chyb, oprav dat, re-uploadu a čekání. Spusťte tyto validační vrstvy před tím, než soubor vůbec pošlete do Seller Central:

1. Kontrola verze šablony: Ověřte, že používáte nejnovější template pro svůj product type. Amazon aktualizuje šablony bez oznámení a staré hlavičky nebo chybějící sloupce způsobí okamžité zamítnutí.

2. Kompletnost povinných polí: Zkontrolujte, že každé must-pass a conditionally required pole obsahuje platnou hodnotu. Referujte se na Data Definitions list, ne na paměť.

3. Validace datových typů a formátů: Číselná pole musí odpovídat Amazon formátu (žádné symboly měny v polích ceny, správné oddělovače desetinných míst). Datumy musí mít očekávaný formát. Jednotky musí používat Amazon akceptované zkratky.

4. Kontrola enumerací: Zkontrolujte každý kontrolovaný atribut proti Valid Values listu. Označte jakoukoliv hodnotu, která neodpovídá přesně.

5. Cross-field dependency kontroly: Validujte parent-child vztahy, konzistenci variation theme a logiku identifikátorů. Pokud parent SKU odkazuje na child SKU, které v souboru nejsou, upload selže.

6. Business pravidla: Označte cenové anomálie, chybějící obrázky nebo nekompletní popisy, které projdou ingestem, ale poškodí výkon listingu.

Spusťte dry upload s malým vzorkem SKU. Projděte processing report, opravte problémy a teprve pak pokračujte s plným batchem. Tento postupný přístup je obzvlášť důležitý při listování produktů napříč kanály, kde jedna datová chyba může kaskádovat.

Lasso umí většinu těchto validačních kroků automatizovat a zachytit chyby v datové pipeline dříve, než vůbec vygenerujete flat file. V kombinaci s kvalitním product data enrichment workflow se pre-upload validace stane rutinním automatizovaným krokem místo manuálního bottlenecku.

Kdy přejít od flat file šablon k API integraci

Flat file šablony nahrávané přes Seller Central zůstávají platným nástrojem, zejména pro týmy spravující řádově stovky až nízké tisíce SKU nebo potřebující občasné bulk aktualizace. Existují ale jasné signály, že je čas přejít na automatizovanější přístup:

• Frekvence uploadů: Pokud tým nahrává soubory každý týden nebo častěji, ruční správa šablon se stává časovou zátěží.
• Chybovost: Když více než pět procent řádků selže při každém uploadu, datová pipeline potřebuje strukturální vylepšení, ne další debugging tabulky.
• Šíře kategorií: Správa šablon pro deset a více product types znamená deset různých sad požadavků na pole, které je třeba ručně sledovat.
• Multi-marketplace přítomnost: Prodej na Amazon US, EU a dalších regionech násobí složitost šablon, protože požadavky a povolené hodnoty se liší podle marketplace.

Posun Amazonu k JSON-based Listings Items API a Product Type Definitions API jasně ukazuje směr platformy. I když Seller Central flat file upload stále funguje, API cesta nabízí programatický přístup k aktuálním product type schématům, synchronní validační zpětnou vazbu a workflow integrovaný do vaší katalogové automatizace.

Pro týmy, které nejsou připravené na plnou API integraci, existuje střední cesta: automatizujte přípravu dat. Držte zdrojová data v řízeném katalogovém modelu, používejte transformační pravidla pro Amazon-ready výstup, validujte automaticky a flat file používejte jen jako finální delivery formát. Tím investujete do datové pipeline, která přežije jakýkoliv jednotlivý upload mechanismus.

Pokud váš tým plánuje tento druh operačního posunu, na stránce s cenami Lasso najdete, jak se platforma hodí do katalogových workflow v různých měřítcích. Pro rozbor konkrétních kategorií a procesů se ozvěte našemu týmu.