API napojení dodavatelů: výhody oproti XML feedu

Většina dodavatelů posílá data jako XML feed. Jeden soubor, celý katalog, stažený jednou za hodinu nebo za den. Funguje to, je to levné a rozumí tomu každá e-shopová platforma. Jenže mezi dvěma staženími se sklad mění a vy o tom nevíte. Zákazník si objedná zboží, které dodavatel před půl hodinou vyprodal.

Čím dál víc velkoobchodů proto nabízí i API. V článku porovnáváme oba přístupy z pohledu e-shopu: co API přináší navíc, na co si dát pozor a kdy dává smysl kombinace obou.

Jak se liší XML feed a API

XML feed je snímek stavu. Dodavatel v určitý okamžik vygeneruje soubor se všemi produkty, cenami a skladem. Vy si ho stáhnete, porovnáte s e-shopem a změny zapíšete. Mezi dvěma snímky nevíte nic.

REST API je rozhraní na dotazy. Místo celého katalogu se zeptáte jen na to, co potřebujete: sklad konkrétních produktů, změny od posledního dotazu, stav vaší objednávky. Některá API umí i opačný směr, tedy webhooky: dodavatel vám sám pošle zprávu, když se něco změní.

Rozdíl je hlavně v tom, jak čerstvá data máte a kolik práce stojí je získat.

Co API přináší navíc

Čerstvější sklad a ceny. Dotaz na sklad jde pustit každých pár minut, u webhooků prakticky okamžitě. U XML feedu jste vázaní na to, jak často ho dodavatel generuje. Když ho přegeneruje jednou za hodinu, častější stahování vám nepomůže.

Jen změny místo celého katalogu. Dobře navržené API umí vrátit jen produkty změněné od určitého času. Místo stahování a porovnávání desítek tisíc položek zpracujete stovky. Import je rychlejší a méně zatěžuje e-shop.

Objednávky zpět k dodavateli. Tohle XML feed neumí vůbec. Přes API můžete objednávku rovnou založit u dodavatele, vyzvednout si číslo zásilky a stav vyřízení. U dropshippingu nebo u zboží objednávaného na zakázku to ušetří nejvíc ruční práce.

Přesnější chybové stavy. Když XML feed nepřijde nebo je useknutý, poznáte to často až podle nesmyslů v e-shopu. API vrací stavové kódy, takže integrace ví, že dotaz selhal, a může ho zopakovat.

Ceny a dostupnost pro vás. Někteří dodavatelé přes API vrací vaši smluvní cenu a rezervovatelné množství, zatímco veřejný feed obsahuje jen obecné údaje.

Co API stojí a kde bolí

API není zadarmo ani technicky, ani provozně:

• Vývoj. Každé API je jiné. Autentizace, stránkování, formát chyb, názvy polí. Napojení na API je obvykle pracnější než na XML feed ve známém formátu.
• Limity. API omezují počet nebo souběh požadavků. Když je integrace překročí, dostane chybu (typicky HTTP 429) a musí počkat. S limity je potřeba počítat už při návrhu.
• Verze a změny. Dodavatel API aktualizuje, přidá povinné pole nebo vypne starou verzi. XML feed se mění méně často.
• Dokumentace. U menších dodavatelů bývá neúplná. Chování v krajních případech zjistíte až testováním.
• Závislost na dostupnosti. Když API dodavatele neodpovídá, potřebujete záložní postup. Typicky ponechat poslední známý stav a upozornit na výpadek.

Limity na straně e-shopu

API dodavatele je jen polovina cesty. Data musí taky do e-shopu a i tam platí pravidla. Příklady z platforem, se kterými pracujeme (k 9/2026):

Z tabulky plyne praktický závěr. Rychlé API dodavatele nepomůže, když e-shop umí data přijímat jen v hodinových importech. A obráceně: realtime synchronizace skladu u velkého katalogu může narazit na limity e-shopu, pokud se neposílají jen skutečné změny.

Hybridní model: XML pro katalog, API pro sklad

V praxi nejčastěji stavíme kombinaci. Každý kanál dělá to, co umí nejlépe:

1. Katalog z XML feedu jednou denně. Názvy, popisy, parametry, obrázky, kategorie. Tato data se mění pomalu a feed je spolehlivý zdroj.
2. Sklad a ceny přes API častěji. Podle možností dodavatele a limitů e-shopu třeba každých 15 minut, jen pro změněné produkty.
3. Objednávky přes API v reálném čase. Po zaplacení nebo potvrzení se objednávka odešle dodavateli, zpět přijde potvrzení a číslo zásilky.
4. Noční kontrola konzistence. Plný feed jednou denně slouží jako pojistka. Pokud se stav v e-shopu liší od feedu, integrace to opraví a zaloguje.

Mezi dodavatelem a e-shopem obvykle stojí middleware, tedy vlastní vrstva, která data stahuje, normalizuje, hlídá limity a zapisuje. Díky ní se změna API dodavatele neprojeví výpadkem e-shopu, jen úpravou jednoho konektoru.

Modelový výpočet: kolik dat přenášíte

Ilustrační příklad, ne data konkrétního klienta. E-shop má od dodavatele 20 000 produktů. Sklad se během dne změní řádově u stovek z nich.

• Plný XML feed každou hodinu: 24 stažení denně, pokaždé porovnání 20 000 položek. Tedy 480 000 porovnání denně, z toho naprostá většina beze změny.
• API s dotazem na změny každých 15 minut: 96 dotazů denně, zpracovávají se jen změněné položky. Pokud jich je denně 500, zapíšete do e-shopu 500 aktualizací a sklad je stár nejvýš 15 minut.

Druhá varianta přenáší zlomek dat a sklad má čerstvější. Počítá ale s tím, že API dodavatele umí vrátit změny od určitého času. Když to neumí, musíte se ptát produkt po produktu a výhoda se rychle ztrácí.

Kdy zůstat u XML

API nemusí být cíl za každou cenu. XML feed dává smysl, když:

• dodavatel API nemá nebo je nestabilní,
• sortiment je menší a sklad se mění pomalu,
• zboží držíte i na vlastním skladě a výpadek u dodavatele vás hned neohrozí,
• objednávky dodavateli posíláte hromadně, například jednou denně.

Pokud dodavatel posílá feed na FTP místo na URL, popisujeme nastavení v článku FTP/SFTP feedy. Proč na čerstvosti skladu tolik záleží, rozebíráme v článku Realtime skladová synchronizace.

Jak na to prakticky

Než se pro API rozhodnete, projděte tento checklist:

1. Zjistěte, co API dodavatele umí: sklad, ceny, dotaz na změny, objednávky, webhooky.
2. Vyžádejte si dokumentaci, testovací přístup a informaci o limitech.
3. Ověřte, jak data přijímá váš e-shop a jaké limity má jeho API.
4. Rozhodněte, která data půjdou přes API a která zůstanou v XML feedu.
5. Navrhněte záložní postup pro výpadek API a upozornění na chyby.
6. Po spuštění sledujte počet chyb, odmítnutých požadavků a stáří dat.

Napojení dodavatelů přes XML i API řešíme v rámci služby napojení dodavatelů a feedů. Jednorázová implementace začíná od 3 000 Kč za dodavatele, správa běží měsíčním paušálem. Složitější obousměrné propojení s objednávkami stavíme jako integraci na míru. Pošlete nám dokumentaci API dodavatele a řekneme vám, co z ní jde vytěžit.