Tento článek popisuje, jak dostat produktové karty (ne ceny/sklady — na to je samostatný článek Aktualizace cen a skladů) do Base katalogu. Návazně na Základní principy rozepisujeme tři konkrétní varianty.
Varianta 1 — import přes XML feed
Base umí cyklicky importovat produktové karty z XML feedu ve specifikaci Heureka nebo Shoptet. Na vyžádání umíme načítat i libovolné vlastní (custom) elementy z takového feedu, ale toto nastavení musí být zatím provedeno z naší strany — kontaktujte implementační oddělení.
- Frekvence importu: typicky jednou denně, u enterprise účtů až třikrát denně.
- Nevýhoda: v tomto režimu nemáte žádné API metody na zápis — vše řídí obsah feedu.
Varianta 2 — plně přes API
Pokud chcete zakládání a úpravu produktů řídit programaticky, použijte addInventoryProduct. Odeslání produktu se stejným ID existující kartu aktualizuje, takže stejná metoda slouží pro založení i update.
Než produkt založíte, potřebujete znát ID kategorie a výrobce (viz Kategorie a výrobci) — obojí se do produktu vyplňuje formou reference na existující ID, ne textem.
Hybridní varianta — feed pro karty, API jen pro Base ID
Pokud karty zakládáte přes feed/e-shopovou integraci, ale chcete si průběžně načítat interní Base ID nově vzniklých produktů (např. abyste přes ně mohli navázat vlastní skladovou synchronizaci), použijte getInventoryProductLogs — vrací log událostí u produktů (a jejich variant) v katalogu, včetně nově přiřazených ID.
Frekvence synchronizace
| Typ dat | Obvyklá frekvence |
|---|
| Import/aktualizace produktových karet (feed) | ~1× denně (enterprise až 3×) |
| Aktualizace cen a skladů | ~4–5× za hodinu |
Pokud potřebujete synchronizovat i dodací lhůty nebo máte specifický požadavek na strukturu feedu, kontaktujte implementační oddělení — máme na to už promyšlené postupy.