> For the complete documentation index, see [llms.txt](https://napoveda.rocketoo.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://napoveda.rocketoo.cz/rocketoo/rozsireni/biano.md).

# 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](https://www.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?

{% hint style="info" %}
Modul je nutné nejprve nainstalovat ve **Správci rozšíření**. 
{% endhint %}

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?

{% stepper %}
{% step %}
V menu klikněte na **Rocketoo**→ **E-shop** → **Feedy**.
{% endstep %}

{% step %}
Najděte feed **Biano.cz - Feed** nebo **Dostupnostní Feed**.
{% endstep %}

{% step %}
Klikněte na jeho název.
{% endstep %}

{% step %}
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
  {% endstep %}
  {% endstepper %}

### 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í

{% stepper %}
{% step %}
Otevřete detail feedu.
{% endstep %}

{% step %}
Klikněte na tlačítko **Vygenerovat nyní**.
{% endstep %}

{% step %}
Počkejte, až se feed vygeneruje.
{% endstep %}

{% step %}
URL feedu se zobrazí v detailu.
{% endstep %}
{% endstepper %}

## 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

{% stepper %}
{% step %}
V detailu feedu **Biano.cz - Feed** klikněte na **Nastavení**.
{% endstep %}

{% step %}
Nastavte si následující možnosti.
{% endstep %}
{% endstepper %}

#### 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

{% stepper %}
{% step %}
V detailu feedu **Biano.cz - Dostupnostní Feed** klikněte na **Nastavení**.
{% endstep %}

{% step %}
Nastavte:

* **Zakázané kategorie** - stejně jako u základního feedu
  {% endstep %}
  {% endstepper %}

### 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?

{% stepper %}
{% step %}
V menu klikněte na **Produkty** → **Kategorie**.
{% endstep %}

{% step %}
Klikněte na kategorii, kterou chcete párovat.
{% endstep %}

{% step %}
V záložce **Feedy** najdete sekci **Biano kategorie**.
{% endstep %}
{% endstepper %}

### Jak přiřadit Biano kategorii?

{% stepper %}
{% step %}
V detailu kategorie otevřete záložku **Feedy**.
{% endstep %}

{% step %}
V poli **Biano kategorie** klikněte na výběrové pole.
{% endstep %}

{% step %}
Vyberte odpovídající kategorii z Biano/Heureka stromu.
{% endstep %}

{% step %}
Klikněte **Uložit**.
{% endstep %}
{% endstepper %}

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

<details>

<summary><strong>Musím mít obě feedy aktivní?</strong></summary>

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

</details>

<details>

<summary><strong>Jak dlouho trvá vygenerování feedu?</strong></summary>

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.

</details>

<details>

<summary><strong>Můžu změnit URL feedu?</strong></summary>

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

</details>

### Produkty a export

<details>

<summary><strong>Které produkty se exportují?</strong></summary>

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.

</details>

<details>

<summary><strong>Jak můžu vyřadit produkt z feedu?</strong></summary>

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

</details>

<details>

<summary><strong>Exportují se i varianty produktů?</strong></summary>

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

</details>

### Ceny a dostupnost

<details>

<summary><strong>V jaké měně se exportují ceny?</strong></summary>

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

</details>

<details>

<summary><strong>Jak se počítá dodací lhůta?</strong></summary>

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

</details>

<details>

<summary><strong>Co když má produkt na více skladech?</strong></summary>

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

</details>

### Kategorie

<details>

<summary><strong>Musím párovat každou kategorii?</strong></summary>

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

</details>

<details>

<summary><strong>Co když má jedna kategorie více Biano kategorií?</strong></summary>

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

</details>

<details>

<summary><strong>Proč nemůžu najít některou kategorii?</strong></summary>

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

</details>

### Parametry produktů

<details>

<summary><strong>Které parametry se exportují?</strong></summary>

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...)

</details>

<details>

<summary><strong>Můžu změnit, které parametry se exportují?</strong></summary>

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

</details>

<details>

<summary><strong>Co když má produkt moc parametrů?</strong></summary>

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

</details>

### Technické otázky

<details>

<summary><strong>Jak často se feed generuje?</strong></summary>

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

</details>

<details>

<summary>Můžu feed vygenerovat ručně?</summary>

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

</details>

<details>

<summary>Co když se feed nevygeneruje?</summary>

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

</details>