Biano

Modul Biano vám umožňuje:

• Automaticky generovat XML feed pro Biano.cz a Heureka.cz

• Exportovat dostupnost produktů v samostatném feedu

• Párovat vlastní kategorie s kategoriemi Biano

• Řídit, které produkty se budou exportovat

• Nastavit, které parametry produktů se zobrazí v porovnávači

Co je Biano?

Biano.cz je největší galerie realizací českých interiérových designérů a architektů. Zákazníci zde mohou procházet inspiraci a zároveň si nábytek, doplňky a dekorace rovnou vybrat a koupit z připojených e-shopů.

Kde najdu modul?

Modul je nutné nejprve nainstalovat ve Správci rozšíření.

Po instalaci modulu naleznete v menu Rocketoo→ E-shop → Feedy dvě nové položky:

• Biano.cz - Feed - základní feed s kompletními informacemi

• Biano.cz - Dostupnostní Feed - rychlá aktualizace skladových zásob

Nastavení feedů

Jak nastavit feed?

1

V menu klikněte na Rocketoo→ E-shop → Feedy.

2

Najděte feed Biano.cz - Feed nebo Dostupnostní Feed.

3

Klikněte na jeho název.

4

V detailu feedu nastavte:

• Aktivní - zapněte/vypněte generování feedu

• URL - URL adresa feedu (lze upravit)

• Interval generování - jak často se feed aktualizuje

Automatická aktualizace

Feedy se automaticky generují podle nastaveného intervalu:

• Základní feed - doporučujeme 1x denně

• Dostupnostní feed - každou hodinu (výchozí nastavení)

Ruční vygenerování

1

Otevřete detail feedu.

2

Klikněte na tlačítko Vygenerovat nyní.

3

Počkejte, až se feed vygeneruje.

4

URL feedu se zobrazí v detailu.

Základní XML feed

Co obsahuje základní feed?

Základní XML feed exportuje kompletní informace o produktech:

• Název produktu a varianty

• Popis produktu

• Ceny včetně DPH

• Obrázky produktu

• Dostupnost a dodací lhůta

• Parametry produktů

• Kategorie (Biano nebo vaše kategorie)

• EAN/ISBN kódy

• Značka/výrobce

Nastavení základního feedu

1

V detailu feedu Biano.cz - Feed klikněte na Nastavení.

2

Nastavte si následující možnosti.

Exportované parametry

Můžete vybrat, které typy parametrů se budou exportovat:

• Zahrnout parametry pro filtrování - parametry, které zákazníci používají k filtrování (např. barva, materiál)

• Zahrnout parametry pro detail produktu - parametry zobrazené v detailu (např. rozměry, váha)

• Zahrnout parametry pro generování názvu - parametry, které tvoří název varianty (např. velikost)

Doporučení: Nechte všechny možnosti zapnuté, aby byl export co nejkompletnější.

Zakázané kategorie

Pokud nechcete exportovat produkty z určitých kategorií:

1. V nastavení feedu najděte Zakázat export z kategorií

2. Zaškrtněte kategorie, které nechcete exportovat Produkty z těchto kategorií nebudou součástí feedu

Příklad použití:

• Kategorie "Dárky" - máte dárky, které nejsou nábytek

• Kategorie "Služby" - nabízíte služby, které nelze na Biano prezentovat

• Kategorie "Výprodej" - chcete výprodejové zboží zobrazit pouze na vlastním e-shopu

Dostupnostní XML feed

K čemu slouží dostupnostní feed?

Dostupnostní feed je zjednodušený XML soubor, který obsahuje pouze:

• ID produktu

• Aktuální skladové množství

Tento feed se aktualizuje každou hodinu a umožňuje Biano rychle aktualizovat dostupnost produktů bez potřeby stahovat celý základní feed.

Které produkty se exportují?

Do dostupnostního feedu se exportují pouze produkty, které:

• Sledují zásoby (mají zapnuté sledování zásob)

• Mají skladem více než 0 ks

• Nejsou ze zakázaných kategorií

Nastavení dostupnostního feedu

1

V detailu feedu Biano.cz - Dostupnostní Feed klikněte na Nastavení.

2

Nastavte:

• Zakázané kategorie - stejně jako u základního feedu

Parametr měny

URL může obsahovat parametr měny pro export v jiné měně:

https://vase-domena.cz/api/v1/feed/biano.xml?currency=EUR

Párování kategorií

Proč párovat kategorie?

Biano používá vlastní hierarchii kategorií. Správné párování zajistí, že:

• Produkty se zobrazí ve správné kategorii na Biano

• Zákazníci najdou vaše produkty při filtrování

• Vaše nabídka bude relevantnější

Kde párovat kategorie?

1

V menu klikněte na Produkty → Kategorie.

2

Klikněte na kategorii, kterou chcete párovat.

3

V záložce Feedy najdete sekci Biano kategorie.

Jak přiřadit Biano kategorii?

1

V detailu kategorie otevřete záložku Feedy.

2

V poli Biano kategorie klikněte na výběrové pole.

3

Vyberte odpovídající kategorii z Biano/Heureka stromu.

4

Klikněte Uložit.

Příklad:

• Vaše kategorie: "Jídelní židle"

• Biano kategorie: "Nábytek > Židle > Jídelní židle"

Co když nepáruju kategorii?

Pokud kategorii nepárujete, v XML feedu se použije:

• Cesta vašich kategorií - např. "Nábytek | Židle | Jídelní židle"

Biano tento formát také podporuje, ale doporučujeme vždy párovat pro přesnější zařazení.

Aktualizace kategorií z Heureky

Strom Biano kategorií se automaticky aktualizuje:

• Každou sobotu v 1:30 ráno

• Stahuje se přímo z Heureka.cz

Pokud potřebujete kategorii, která není v seznamu:

1. Počkejte na další automatickou aktualizaci

2. Případně kontaktujte podporu

Často kladené otázky

Obecné otázky

Musím mít obě feedy aktivní?

Ne, můžete používat pouze základní feed. Dostupnostní feed je volitelný pro rychlejší aktualizaci skladů.

Jak dlouho trvá vygenerování feedu?

Závisí na počtu produktů. U menších e-shopů (do 1000 produktů) to trvá 1-2 minuty, u větších může trvat déle.

Můžu změnit URL feedu?

Ano, v detailu feedu klikněte na URL a upravte ji. Nezapomeňte aktualizovat URL i v administraci Biano.

Produkty a export

Které produkty se exportují?

Exportují se všechny aktivní produkty kromě těch:

• Ze zakázaných kategorií

• S cenou 0 Kč nebo nižší U dostupnostního feedu navíc pouze ty se sledováním zásob a množstvím > 0.

Jak můžu vyřadit produkt z feedu?

Máte několik možností:

• Zakažte celou kategorii v nastavení feedu

• Deaktivujte produkt na e-shopu

• Přesuňte produkt do nezakázané kategorie

Exportují se i varianty produktů?

Ano, každá varianta se exportuje jako samostatná položka v XML feedu.

Ceny a dostupnost

V jaké měně se exportují ceny?

Exportují se v měně nastavené jako výchozí pro frontend (zákazníky).

Jak se počítá dodací lhůta?

Dodací lhůta se počítá z pole "Dostupnost" u varianty. Pokud je dostupnost nastavena na "2 dny", v feedu se zobrazí jako 2.

Co když má produkt na více skladech?

V feedu se zobrazí součet zásob ze všech skladů.

Kategorie

Musím párovat každou kategorii?

Není to povinné, ale doporučené. Nepárované kategorie se exportují s vaším názvem cesty.

Co když má jedna kategorie více Biano kategorií?

Můžete přiřadit více Biano kategorií. Produkt se pak zobrazí ve všech vybraných kategoriích.

Proč nemůžu najít některou kategorii?

Strom kategorií se aktualizuje jednou týdně. Pokud byla kategorie přidána na Heurece nedávno, počkejte na další aktualizaci.

Parametry produktů

Které parametry se exportují?

Exportují se parametry podle vašeho nastavení v feedu:

• Parametry pro filtrování (barva, materiál...)

• Parametry pro detail (rozměry, váha...)

• Parametry pro název (velikost, varianta...)

Můžu změnit, které parametry se exportují?

Ano, v nastavení feedu odškrtněte typy parametrů, které nechcete exportovat.

Co když má produkt moc parametrů?

To nevadí, Biano zobrazí pouze relevantní parametry podle typu produktu.

Technické otázky

Jak často se feed generuje?

Podle nastaveného intervalu. Výchozí je 1x denně pro základní feed a každou hodinu pro dostupnostní.

Můžu feed vygenerovat ručně?

Ano, v detailu feedu klikněte na "Vygenerovat nyní".

Co když se feed nevygeneruje?

Zkontrolujte log chyb v detailu feedu. Časté příčiny: - Nízká paměť serveru - Časový limit PHP - Chybějící produkty nebo kategorie