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


---

# 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/ceneo.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.