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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/biano.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.