ÚvodSpecifikace feedu

Specifikace feedu a základní podmínky

Podporujeme napojení e-shopu odkudkoliv. Nejjednodušší cesta je XML feed (formát Heureka.cz/Zboží.cz) - ten umí nativně nebo přes bezplatný plugin exportovat i Shoptet (nejrozšířenější platforma v ČR), WooCommerce, Upgates, PrestaShop i další. Pokud váš e-shop XML feed nenabízí, nabízíme jako alternativu i CSV katalog (viz níže) - stačí zadat URL adresu a zbytek obstará automatický import.

1. Zboží obsažené v XML FEEDu musí být dostupné na stránkách E-shopu, jednotlivé Zboží musí být uvedeno pouze jednou na samostatných odkazech s unikátní URL adresou, která musí odpovídat URL adrese uváděné v rámci XML FEEDu, kde lze najít informace o ceně Zboží a k tomuto jednotlivému Zboží odeslat Objednávku.

2. Informace o Zboží exportované v rámci XML FEEDu musí být pravdivé a aktuální a musí se týkat výhradně samotného Zboží, nikoliv propagace E-shopu.

3. Cena Zboží v XML FEEDu musí být uvedena v korunách českých a být pro Uživatele koncová, tzn. včetně všech autorských, recyklačních a dalších poplatků, se správně uvedeným DPH. Obchodník je povinen udržovat cenu poštovného, dopravného a balného neustále aktuální.

4. Zboží obsažené v rámci XML FEEDu musí být v souladu s právním řádem České republiky, zejména se nesmí jednat o zboží, s nímž Obchodník není oprávněn disponovat, zboží porušující duševní vlastnictví, nebo zboží určené k propagaci a šíření extremistických názorů ve smyslu trestněprávních předpisů platných v ČR.

5. XML FEED může obsahovat pouze Zboží, které je Obchodník schopen Uživateli dodat a u něhož zná alespoň přibližnou dobu dodání.

6. Informace o dostupnosti Zboží musí být uvedena pravdivě a musí zahrnovat veškeré informace, které mohou mít vliv na dodání Zboží Uživateli.

7. Podrobné technické a obsahové podmínky XML FEEDu jsou obdobné jako u srovnávačů zboží typu Zboží.cz nebo Heureka.cz a jsou pro Obchodníky závazné. Nedodržování těchto podmínek může mít za následek ukončení Smlouvy nebo blokaci e-shopu.

Formát XML feedu

Feed očekáváme jako validní XML v kořenovém formátu obdobném formátu Heureka.cz / Zboží.cz (SHOP > SHOPITEM). U každé položky (<SHOPITEM>) zpracováváme následující elementy:

ElementVýznamPovinné
PRODUCTNAME / PRODUCTNázev produktuano
URLOdkaz na produkt v e-shopuano
PRICE_VAT / PRICEKoncová cena s DPH v Kčano
IMGURLOdkaz na hlavní obrázek produktune
DESCRIPTION / DESCPopis produktune
CATEGORYTEXTKategorie produktu z feedu - u balíčku Pro a vyšších se podle ní vyhodnocuje rozšířené mapování kategorií (viz níže), jinak jen informativníne

Formát CSV katalogu (alternativa k XML feedu)

Pokud e-shop XML feed nenabízí, stačí zadat URL adresu CSV souboru (podporujeme čárku i středník jako oddělovač, běžný v exportech z Excelu). Sloupce se párují automaticky podle názvu hlavičky - stačí, aby soubor obsahoval některý z uvedených názvů (nezáleží na velikosti písmen):

PoleRozpoznávané názvy sloupcePovinné
Název produktunazev, název, name, titleano
Odkaz na produkturl, link, odkazano
Cenacena, priceano
Obrázekobrazek, image, image_urlne
Popispopis, descriptionne
Kategoriekategorie, categoryne
EANean, barcodene
SKU / kód produktusku, kod, codene

Typ zdroje (XML feed / CSV katalog) se nastavuje ve vaší administraci u adresy zdroje.

8. Feed se aktualizuje jednou denně, ve všední dny, automatizovaně přes cron.

9. Produkty se nepřiřazují dle kategorií specifikace Zboží.cz nebo Heureka.cz, ale do rubrik dle vámi vybrané kategorie produktů e-shopu při registraci. Na výběr jsou tyto rubriky:

Rozšířené mapování kategorií Balíček Pro a vyšší

Pokud máte v jednom XML feedu více druhů zboží (např. šperky i obuv), umožňuje balíček Pro a vyšší nastavit si vlastní pravidla podle klíčového slova z elementu CATEGORYTEXT nebo z názvu produktu - první shoda vyhrává a produkt se přeřadí do zvolené kategorie, zbytek zůstane ve výchozí kategorii e-shopu. Pravidla se nastavují ve vaší administraci u pole s adresou XML feedu. Podrobnosti k balíčkům najdete na stránce Balíčky a ceník.