> 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/ceneo.md).

# Ceneo.pl

Modul **Ceneo** vám umožňuje:

* Automaticky generovat XML feed ve formátu Ceneo
* Mapovat kategorie e-shopu na kategorie Ceneo
* Filtrovat produkty a parametry pro export
* Vylučovat vybrané kategorie z feedu
* Sledovat aktuální kategorie z Ceneo API

## Co je Ceneo?

[Ceneo](https://www.ceneo.pl/) je nejpopulárnější polský srovnávač zboží založený v roce 2005. V roce 2022 měl 23 miliony uživatelů. V průměru každá osmá transakce na polských e-shopech pochází z tohoto zdroje, což z něj dělá důležitý prodejní kanál pro e-shopy zaměřené na polský trh.

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

## Nastavení

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

{% step %}
Najděte **Ceneo.pl feed**
{% endstep %}

{% step %}
Klikněte na název feedu pro zobrazení nastavení a zkopírujte si odkaz na XML feed
{% endstep %}
{% endstepper %}

### Základní nastavení feedu

#### URL adresa feedu

Po instalaci máte k dispozici URL adresu XML feedu:

* **Výchozí adresa:** `https://vas-eshop.cz/api/v1/feed/ceneo.xml`
* Tuto adresu předáte do administrace Ceneo

#### Nastavení exportovaných parametrů

Můžete určit, které parametry produktů se mají do feedu exportovat:

Zahrnout parametry použité pro filtrování

* Zaškrtnutím exportujete parametry označené jako "Použít pro filtr"
* Tyto parametry pomáhají zákazníkům filtrovat produkty
* **Výchozí:** Zapnuto

Zahrnout parametry použité pro detail

* Zaškrtnutím exportujete parametry označené jako "Zobrazit v detailu"
* Tyto parametry zobrazují detailní specifikace produktu
* **Výchozí:** Zapnuto

Zahrnout parametry použité pro název

* Zaškrtnutím exportujete parametry použité v názvu varianty
* Například: barva, velikost použitá v názvu
* **Výchozí:** Zapnuto

### Vyloučení kategorií z feedu

{% stepper %}
{% step %}
V nastavení feedu najděte sekci **Zakázané kategorie**.
{% endstep %}

{% step %}
Zaškrtněte kategorie, které se nemají exportovat.
{% endstep %}

{% step %}
Produkty z těchto kategorií se neobjeví ve feedu.
{% endstep %}

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

Příklad použití:

* Vyloučit kategorii "Vzorky zdarma"
* Vyloučit kategorii "Použité zboží"
* Vyloučit kategorie specifické pro jiné trhy

### Co obsahuje XML feed?

Feed automaticky obsahuje:

* **Název produktu a varianty** - pro identifikaci
* **Popis** - text z detailu produktu
* **URL adresa** - odkaz na produkt na vašem e-shopu
* **Cena s DPH** - aktuální cena včetně slevy
* **Obrázky** - hlavní obrázek + další obrázky
* **Kategorie** - mapovaná Ceneo kategorie nebo cesta kategorií
* **EAN** - čárový kód produktu
* **Výrobce** - značka produktu
* **Hmotnost** - v kilogramech
* **Dostupnost** - pouze produkty skladem
* **Parametry** - podle nastavení filtrů výše

### Produkty ve feedu

Do feedu se automaticky zahrnují pouze produkty, které:

* Jsou aktivní (publikované)
* Mají dostupnost "Skladem"
* Nespadají do zakázaných kategorií
* Mají nastavenou cenu

## Mapování kategorií

### Co je mapování kategorií?

Mapování kategorií znamená přiřazení kategorií vašeho e-shopu ke správným kategoriím v systému Ceneo. Díky tomu se vaše produkty zobrazí v relevantních sekcích srovnávače.

### Seznam kategorií Ceneo

Modul automaticky stahuje aktuální seznam kategorií z Ceneo API:

* **Aktualizace:** Každou sobotu v 1:30
* **Strom kategorií:** Obsahuje všechny aktivní kategorie včetně podkategorií
* **Jazyk:** Kategorie jsou v polštině

### Jak přiřadit kategorii?

{% stepper %}
{% step %}
V hlavním menu klikněte na **Produkty**.
{% endstep %}

{% step %}
Vyberte **Kategorie**.
{% endstep %}

{% step %}
Otevřete kategorii, kterou chcete mapovat.
{% endstep %}

{% step %}
Přejděte na záložku **Srovnávače**.
{% endstep %}

{% step %}
V sekci **Ceneo kategorie** vyberte odpovídající kategorii z Ceneo.
{% endstep %}

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

### Příklad mapování

Vaše kategorie: Elektronika → Počítače → Myši\
Ceneo kategorie: Komputery → Myszki komputerowe

Postup:

{% stepper %}
{% step %}
Otevřete kategorii "Myši".
{% endstep %}

{% step %}
Na záložce Srovnávače vyberte "Komputery → Myszki komputerowe".
{% endstep %}

{% step %}
Uložte změny.
{% endstep %}
{% endstepper %}

### Co když kategorii nemapuji?

* Do feedu se vloží **cesta kategorií z vašeho e-shopu**\
  Například: "Elektronika | Počítače | Myši"
* Ceneo se pokusí produkty automaticky zařadit
* Pro lepší výsledky doporučujeme kategorie mapovat

## Předání feedu do Ceneo

### Jak získat URL feedu?

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

{% step %}
Najděte **Ceneo.pl feed**
{% endstep %}

{% step %}
Zkopírujte URL adresu feedu.
{% endstep %}

{% step %}
Výchozí formát: `https://vas-eshop.cz/api/v1/feed/ceneo.xml`
{% endstep %}
{% endstepper %}

### Registrace v Ceneo

{% stepper %}
{% step %}
Přejděte na [Ceneo.pl](https://www.ceneo.pl/).
{% endstep %}

{% step %}
Najděte sekci pro obchodníky.
{% endstep %}

{% step %}
Zaregistrujte svůj e-shop.
{% endstep %}

{% step %}
Vyplňte požadované informace o obchodě.
{% endstep %}
{% endstepper %}

### Nastavení feedu v Ceneo administraci

{% stepper %}
{% step %}
Přihlaste se do administrace Ceneo.
{% endstep %}

{% step %}
Najděte sekci pro přidání XML feedu.
{% endstep %}

{% step %}
Vložte URL adresu vašeho feedu.
{% endstep %}

{% step %}
Nastavte frekvenci aktualizace (doporučeno: denně).
{% endstep %}

{% step %}
Uložte nastavení.
{% endstep %}
{% endstepper %}

Ceneo bude automaticky stahovat váš feed a aktualizovat nabídku produktů.

## Často kladené otázky

### Obecné otázky

<details>

<summary><strong>Jak často se aktualizuje XML feed?</strong></summary>

Feed se generuje v reálném čase při každém otevření. Ceneo si ho stahuje dle nastavené frekvence (doporučeno denně).

</details>

<details>

<summary><strong>Mohou mít e-shopy více feedů pro různé kategorie?</strong></summary>

Modul vytváří jeden univerzální feed. Můžete ale vyloučit konkrétní kategorie z exportu.

</details>

<details>

<summary><strong>Je modul zdarma?</strong></summary>

Modul je zdarma. Ceneo může účtovat poplatky za zařazení do srovnávače - informujte se přímo u Ceneo.

</details>

### Produkty a feed

<details>

<summary><strong>Proč se některé produkty neexportují?</strong></summary>

Produkty musí být aktivní, mít dostupnost "Skladem", nenacházet se v zakázané kategorii a mít nastavenou cenu.

</details>

<details>

<summary><strong>Mohu exportovat i produkty bez dostupnosti?</strong></summary>

Ne, feed automaticky filtruje pouze produkty skladem. To je požadavek Ceneo.

</details>

<details>

<summary><strong>Co když produkt nemá EAN?</strong></summary>

EAN není povinný, ale doporučujeme ho vyplnit pro lepší identifikaci produktů.

</details>

<details>

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

Ano, každá varianta se exportuje jako samostatná položka s vlastním SKU, cenou a parametry.

</details>

### Kategorie

<details>

<summary><strong>Jak často se aktualizují kategorie z Ceneo?</strong></summary>

Automaticky každou sobotu v 1:30. Můžete také vyvolat ruční aktualizaci přes CRON joby.

</details>

<details>

<summary><strong>Co když nenajdu správnou kategorii?</strong></summary>

Vyberte nejbližší možnou kategorii. Ceneo má široký strom kategorií, měli byste najít odpovídající.

</details>

<details>

<summary><strong>Musím mapovat všechny kategorie?</strong></summary>

Ne, mapování není povinné. Pokud kategorii nemapujete, použije se cesta z vašeho e-shopu.

</details>

<details>

<summary><strong>Mohu změnit mapování později?</strong></summary>

Ano, mapování můžete kdykoli změnit v editaci kategorie na záložce Feed.

</details>

### Nastavení

<details>

<summary><strong>Co znamená "Zahrnout parametry pro filtrování"?</strong></summary>

Parametry označené jako "Použít pro filtr" se exportují do feedu. Pomáhají zákazníkům filtrovat produkty.

</details>

<details>

<summary><strong>Jak vyloučit testovací produkty?</strong></summary>

Vložte testovací produkty do samostatné kategorie a tu vyloučete v nastavení zakázaných kategorií.

</details>

<details>

<summary><strong>Mohu změnit URL feedu?</strong></summary>

Výchozí URL je \`ceneo.xml\`. Změnu můžete provést v nastavení XML feedů.

</details>

### Ceneo administrace

<details>

<summary><strong>Jak dlouho trvá schválení feedu v Ceneo?</strong></summary>

Obvykle 1-3 pracovní dny. Ceneo kontroluje kvalitu dat a soulad s pravidly.

</details>

<details>

<summary><strong>Co když Ceneo zamítne můj feed?</strong></summary>

Ceneo vám sdělí důvod zamítnutí. Obvykle jde o chybějící údaje nebo nesprávný formát - modul ale generuje správný formát automaticky.

</details>

<details>

<summary><strong>Mohu sledovat výkon produktů?</strong></summary>

Ano, v administraci Ceneo máte k dispozici statistiky kliknutí, zobrazení a konverzí.

</details>