XML feed vs. API: jaký je vlastně rozdíl
Začněme od jádra, protože z něj plyne všechno ostatní. Feed je jednosměrný. Je to soubor (XML nebo CSV), do kterého e-shop zapíše produkty, ceny a dostupnost, a ten se v daných intervalech předá ven. Tok dat jde jedním směrem — z e-shopu k příjemci. Příjemce (srovnávač, reklamní systém) si z feedu vezme, co potřebuje, ale nic vám zpátky neposílá.
API je obousměrné. Místo souboru, který se občas předá, jde o průběžnou komunikaci dvou systémů: e-shop přes API nabídku nejen vystaví, ale taky přijímá — objednávky, které na marketplace vznikly, a zpětně hlásí třeba změnu skladu nebo stav objednávky. Data tečou tam i zpět, a daleko aktuálněji než u dávkového feedu.
Rozdíl shrnuje tabulka:
| Vlastnost | Feed (XML/CSV) | API integrace |
|---|---|---|
| Směr toku dat | jednosměrný (jen ven) | obousměrný (tam i zpět) |
| Aktualizace | dávkově, s prodlevou | průběžně |
| Objednávky | neumí přijmout | stahuje do e-shopu |
| Sklad zpět | neumí synchronizovat | synchronizuje |
| Vhodné pro | srovnávače, reklamu | prodej na marketplace |
Z toho plyne jednoduché pravidlo: kde stačí data jen ukázat, vystačíte si s feedem; kde se musí i obchodovat — přijímat objednávky a držet sklad v reálu — potřebujete API.
Kde feed na marketplace naráží
Feed je skvělý sluha pro srovnávače a reklamu, ale na marketplace má tři tvrdé limity:
- Zpoždění. Feed se neaktualizuje okamžitě — data se obnovují dávkově (Conviu zdrojová data stahuje a aktualizuje v hodinovém cyklu). Mezi dvěma aktualizacemi marketplace pracuje se zastaralým stavem.
- Neumí přijmout objednávku. Marketplace je prodejní kanál — vzniká na něm objednávka, kterou musíte zpracovat. Feed je ale jen výpis zboží; nemá kudy objednávku poslat zpátky do e-shopu.
- Neumí synchronizovat sklad zpět. Když se zboží prodá jinde, marketplace se to z feedu nedozví dost rychle. Hrozí přeprodej — prodáte kus, který už nemáte.
Přeprodej je na marketplace citlivá věc: platformy hlídají spolehlivost prodejce a opakované rušení objednávek kvůli „není skladem“ vás stojí hodnocení i viditelnost. Proto na marketplace nestačí data jen posílat — musí téct oběma směry.
Kdy je čas přejít na API
Přechod na API není povinný krok pro každého. Pozná se podle situace. Zvažte ho, když platí některý z těchto bodů:
- Začínáte prodávat na marketplace (Allegro, Kaufland, eMAG), ne jen inzerovat na srovnávači.
- Potřebujete objednávky z marketplace na jednom místě — zpracovávat je v e-shopu jako každou jinou, ne ručně opisovat z cizí administrace.
- Hlídáte sklad v reálném čase a chcete předejít přeprodeji u zboží, které prodáváte na víc kanálech najednou.
- Škálujete počet nabídek natolik, že ruční správa v rozhraní marketplace přestává stíhat.
Naopak pokud jen chcete být vidět na Heurece nebo Zboží.cz a prodej probíhá ve vašem e-shopu, feed bohatě stačí — API by byla zbytečná komplikace. (Heureka je mimochodem hraniční případ: jede na feedu, ale objednávky umí předávat taky — k tomu se ještě dostaneme.)
Čím je marketplace jiný: sdílený katalog a EAN
Marketplace se od srovnávače zásadně liší ještě v jedné věci — sdíleném katalogu. Na srovnávači má každý e-shop svou vlastní nabídku se svými názvy a popisy. Na marketplace existuje jedna produktová karta, na kterou se „věší“ nabídky více prodejců, a ta karta je vázaná na EAN (mezinárodní čárový kód produktu).
Důsledky jsou praktické:
- Kaufland — produkty žijí na sdílených kartách podle EAN. Pokud kartu pro daný EAN už založil jiný prodejce, nové produktové údaje znovu neposíláte — dodáte jen nabídková data (cenu, sklad, dostupnost). Bez plnohodnotného EAN/GTIN se prakticky prodávat nedá.
- Allegro — ve většině případů se nabídka napáruje na existující kartu automaticky. Když Allegro produkt s daným EAN nezná, doplní se kategorie a povinné parametry a založí se nová nabídka.
Proto u marketplace nestačí „mít hezký feed“. Data se musí napárovat na cizí katalog a komunikace musí běžet obousměrně — což je přesně práce pro API.
Co řeší Conviu
Conviu pokrývá marketplace napojení přes API, takže přechod z feedu nevyžaduje vlastní vývoj. Co konkrétně zajišťuje:
- Vystavení a správu nabídek přes API na Allegro, Kaufland a eMAG — přidání, aktualizaci i stažení nabídek programově, ne ručně kus po kuse.
- Párování na sdílený katalog přes EAN — u Kauflandu na existující karty, u Allegra automaticky, případně s doplněním kategorie a povinných parametrů.
- Modul Objednávky — stahuje objednávky z marketplace přímo do e-shopu, abyste je zpracovali jako běžné objednávky a nemuseli chodit do cizích rozhraní. U Allegra je dotažená i zpětná synchronizace stavů objednávek.
Podrobněji popisuje API napojení článek o napojení dat přes API na marketplace a stahování objednávek novinka o synchronizaci objednávek. Jak obousměrný tok vypadá v praxi u konkrétní platformy, ukazuje doplněk pro Upgates — objednávky z Allegra, Kauflandu i Heureky se propíšou do e-shopu automaticky.
A ještě k Heurece jako hraničnímu případu: Heureka Marketplace běží na feedu s povinnými parametry, ale objednávky umí předávat (přes webhook do modulu Objednávky) — viz propojení Heureka Marketplace s Conviu. Ukazuje to, že feed a API se nevylučují; u jednoho kanálu mohou fungovat vedle sebe.
Migrační scénář: od feedu k API
Přechod z feedu na API integraci nemusí být skok do neznáma. Probíhá zhruba v těchto krocích:
- 1. Ověřte EAN. Projděte katalog a doplňte chybějící EAN/GTIN — bez nich se na sdílené karty marketplace nenapárujete. Tohle bývá nejčastější brzda celého přechodu.
- 2. Připravte data nabídky. Cena, dostupnost, dodací doba a povinné parametry dané platformy musí být kompletní a v očekávaném tvaru.
- 3. Napojte API kanál. V Conviu vystavíte nabídky přes API na zvolený marketplace; produkty se napárují na katalog přes EAN.
- 4. Zapněte objednávky. Modulem Objednávky začnete stahovat objednávky z marketplace do e-shopu a hlídat sklad, ať nevzniká přeprodej.
Feed přitom nikam nemizí — dál ho používáte na srovnávače a do reklamy. API jen přidáváte tam, kde se navíc obchoduje. Vstupní data (produkty, ceny, dostupnost) přitom v Conviu spravujete na jednom místě, ať jdou ven feedem, nebo přes API — jeden zdroj dat pro oba světy popisuje princip master feedu.
Detailní, krok-za-krokem návody pro jednotlivé platformy — specifika Allegra, Kauflandu i Heureky — rozebírá téma o prodeji na marketplace.
Shrnutí: feed ukazuje, API obchoduje
Feed a API nejsou konkurenti, ale dva nástroje na dvě různé práce. Feed je jednosměrný export — ideální, když chcete produkty ukázat na srovnávačích a v reklamě. API je obousměrná integrace — nutná, když chcete na marketplace obchodovat: přijímat objednávky, držet sklad v reálu a napárovat se na sdílený katalog přes EAN. Moment přechodu poznáte podle toho, že vám marketplace začne posílat objednávky a feed na ně přestane stačit.
Chcete prodávat na Allegru nebo Kauflandu a nechcete na to mít vlastní vývoj? Napojíme vás přes API a převezmeme správu nabídek i objednávek; vy řešíte prodej. Širší kontext datových toků e-shopu najdete v průvodci produktovými feedy a napojením.
