> ## Documentation Index
> Fetch the complete documentation index at: https://vexioncards.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Storyous: menu a produkty

> Synchronizujte svoje menu Storyous s aplikáciou VEXiON a nastavte, ktoré produkty zarábajú a vykupujú vernostné body.

So Storyous nastavujete svoje pravidlá vernosti **priamo na produktoch v aplikácii VEXiON**. Najprv synchronizujete menu zo Storyous, potom sa rozhodujete, ktoré produkty zarábajú a vykupujú body.

> [!NOTE]
>
> **Názvy, ceny a kategórie pochádzajú zo Storyous** a sú v aplikácii VEXiON iba na čítanie. V aplikácii VEXiON nastavujete iba **vernostnú časť** (či produkt zarába body, koľko a akékoľvek vykúpenie).

## Synchronizácia menu

Po pripojení (pozrite si [Pripojenie a nastavenie](https://vexioncards.mintlify.site/cs/knowledge-base/storyous-setup.md)), stiahnite si svoje produkty. Pre každú pripojenú prevádzku kliknite na **Synchronizovať menu**.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
flowchart TD
    A[Kliknite na Synchronizovať menu] --> B[VEXiON si stahuje menu zo Storyous]
    B --> C[Nové produkty sú pridané]:::vexion
    B --> D[Existujúce produkty aktualizujú<br/>názov, cenu, kategóriu]:::vexion
    C --> E[Vaše nastavenia vernosti sú zachované]:::vexion
    D --> E
    classDef vexion fill:#36C6FA,color:#fff,stroke:#2BA8D9;
```

| Údaj | Zdroj | Upravovateľné v VEXiON |
| - | - | :-: |
| Názov produktu | Storyous | ❌ |
| Cena | Storyous | ❌ |
| Kategória | Storyous | ❌ |
| Nastavenia vernosti | VEXiON | ✅ |

> [!NOTE]
>
> **Opätovná synchronizácia je bezpečná.** Keď synchronizujete znova, názvy produktov, ceny a kategórie sa obnovujú zo Storyous, ale **vaše už nastavené pravidlá vernosti budú zachované**. Nové produkty prichádzajú so vernosťou **zapnutou** a bodmi na **0**, kým ich nenastavíte.

> [!WARNING]
>
> **Odstránenie produktu v aplikácii Storyous ho nedeaktivuje v aplikácii VEXiON.** Ak vymažete produkt z vášho menu Storyous, jeho nastavenia vernosti ostanú v tabuľke produktov VEXiON, takže by stále zarábali alebo vykupovali body, ak by sa znova objavili. Aby ste produkt vylúčili z programu vernosti, sami vypnite jeho **Vernosť** v tabuľke produktov.

> [!TIP]
>
> Synchronizujte po prvom pripojení, zakaždým keď zmenite svoje menu v aplikácii Storyous a zhruba raz za týždeň, aby ste boli aktuálni.

![Štítok prevádzky s tlačidlom Synchronizovať menu nad tabuľkou Produkty s načítanými produktmi, cenami a stĺpcami vernosti.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/cs/storyous-sync-menu.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=24280a43423d5edfecd103b4bfbc0ae2)

Synchronizácia menu prevádzky zo Storyous

## Tabuľka produktov

Po synchronizácii tabuľka **Produkty** (s hlavičkou s názvom prevádzky) obsahuje každý produkt. Stĺpce sa prispôsobujú typu karty, ktorý ste povolili:

| Stĺpec | Význam |
| - | - |
| Produkt | Názov produktu (zo Storyous) |
| Kategória | Kategória (zo Storyous) |
| Cena | Predajná cena (zo Storyous) |
| Vernosť | Či je produkt v programe vernosti (Áno / Nie) |
| Získať pečiatky / Získať body | Koľko pečiatok alebo bodov produkt zarába |
| Uplatniť pečiatky / Uplatniť body | Koľko pečiatok alebo bodov vykupuje odmenu (iba Pečiatková a Produktové odmeny) |
| Zľava | Percento zľavy pri vykúpení (iba Pečiatková a Produktová odmena) |
| Akcie | Ovládací prvok úpravy (ceruzka) |

> [!NOTE]
>
> **Názvy stĺpcov sa riadia typom karty.** Pri **pečiatkových kartách** znejú *Získať pečiatky* a *Uplatniť pečiatky*, pri **bodových kartách** *Získať body* a *Uplatniť body*. Prepnutie typu karty v nastaveniach integrácie ich okamžite premenuje.

> [!NOTE]
>
> V režime **Cashback** sa zobrazuje iba **Získať body**, pretože body sa konvertujú na pevný eurový kredit, nedá sa nič "vykúpiť" za produkt. V režimoch **Pečiatková** a **Produktové odmeny** dostanete aj **Uplatniť body** a **Zľava**.

> [!WARNING]
>
> **Vykupovateľný produkt potrebuje vyplnené aj Uplatniť, aj Zľavu.** Pri **pečiatkových kartách** sa produkt len s **Uplatniť** pri pokladni nikdy neponúkne, bez chyby a bez náznaku, že niečo chýba. Pri **bodových kartách** v režime **Produktové odmeny** sa produkt s **Uplatniť** nad 0 a **Zľavou 0** ponúkne ako „0 % zľava“ a ak ho obsluha nechá zapnutý, zákazníka stále stoja body. **Zľava** je percento, ktoré sa pri výkupe odpočíta, takže produkt zadarmo potrebuje **Zľavu 100**. Nastavte obe, alebo nechajte obe na 0.

![Tabuľka Produkty so stĺpcami Produkt, Kategória, Cena, Vernosť, Získať pečiatky, Uplatniť pečiatky, Zľava a Akcie, po čerstvej synchronizácii s nulovými hodnotami.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/cs/storyous-product-table.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=4286083ebdc60a9945457466cbbb23e1)

Synchronizovaná tabuľka produktov so stĺpcami vernosti

### Hľadanie produktov

Nad tabuľkou:

* **Hľadať** podľa názvu produktu.
* **Všetky kategórie** filtruje podľa kategórie.
* **Všetky produkty** filtruje podľa stavu vernosti (všetky / povolené / zakázané).
* **Resetovať filtre** ich vymaže.
* **Na stránku** volíte počet zobrazených riadkov (10, 20, 50, 100) a navigácia stránky pre veľké menu.

### Úprava produktu

Kliknite na **ceruzku** v riadku, aby ste ho upravili priamo: prepnite **Vernosť** zapnutú alebo vypnutú a nastavte hodnoty bodov. Kliknite na ikonu **Uložiť**, aby ste zmenu zachovali, alebo **Zrušiť**, aby ste ju zahodili.

## Hromadná úprava s importom a exportom

Pre veľké menu je ručná úprava každého produktu pomala. Exportujte produkty do súboru, nastavte stĺpce vernosti v tabuľkovom procesore a importujte ich späť.

> [!WARNING]
>
> **Export aj import sú viazané na jednu prevádzku.** Oba pracujú s prevádzkou, ktorej tabuľku máte otvorenú, a riadok sa páruje podľa `productId` **iba v rámci tejto prevádzky**. Ak máte viac prevádzok, exportujte a importujte každú zvlášť. Súbor exportovaný z jednej prevádzky a importovaný do inej sa nespáruje s ničím a nič nezmení, hoci import aj tak nahlási počet produktov.

### Odporúčaný pracovný postup

**1. Synchronizovať menu**

Stiahnite si najnovšie produkty zo Storyous.

**2. Exportovať**

Kliknite na **Exportovať Excel** alebo **CSV**, aby ste si stiahnuli všetky produkty s ich aktuálnym nastavením vernosti.

**3. Upraviť v tabuľkovom procesore**

Nastavte stĺpce vernosti pre vaše produkty (detaily nižšie).

**4. Importovať**

Kliknite na **Importovať**, pustite svoj súbor, skontrolujte náhľad a potvrďte.

### Stĺpce súboru

Export obsahuje jeden riadok na produkt. Upravujete iba stĺpce **vernosti**:

| Stĺpec | Upravovať? | Význam |
| - | :-: | - |
| `productId` | ❌ | ID produktu, používa sa na zhodu produktov. **Nemeňte ho.** |
| `productName` | ❌ | Názov (pre vašu referenciu) |
| `price` | ❌ | Cena (pre vašu referenciu) |
| `loyaltyEnabled` | ✅ | `true` alebo `false`, či je produkt v programe |
| `earnPoints` | ✅ | Body/pečiatky zarobené |
| `redeemPoints` | ✅ | Body/pečiatky na vykúpenie odmeny |
| `discount` | ✅ | Percento zľavy pri vykúpení (0 až 100) |

> [!NOTE]
>
> Pre **Bodové karty**, `earnPoints` a `redeemPoints` môžu byť **desatinné čísla** (napríklad `2.5`, `10.75`). Pre **Pečiatkovú kartu** sa odporúčajú celé čísla, aby zákazníci videli čisté počty pečiatok (systém akceptuje desatinné čísla, ale pre pečiatky dávajú malý zmysel).

![Riadok produktu v režime úprav so zaškrtnutou Vernosťou a poliami pre Získať pečiatky, Uplatniť pečiatky a Zľavu, vedľa ikon uloženia a zrušenia.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/cs/storyous-product-edit.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=9ba1d57f8c76a8523c007ea1d924b5e4)

Úprava hodnôt vernosti priamo v riadku

### Čo ukazuje dialóg importu

Kliknutím na **Importovať** sa otvorí **Importovať produkty z Excel alebo CSV**. Ešte pred výberom súboru vypíše pod nadpisom **Pokyny pre import** pravidlá:

* Najprv exportujte vaše menu pomocou **Exportovať Excel**, potom upravte stĺpce vernosti a importujte späť.
* Upraviteľné stĺpce: `loyaltyEnabled`, `earnPoints`, `redeemPoints`, `discount`.
* Pečiatkové karty: používajte iba celé čísla (1, 2, 3...) pre `earnPoints` a `redeemPoints`.
* Neupravujte `productId` ani iné stĺpce, aktualizované budú iba nastavenia vernosti.

Potom na plochu **Kliknite sem alebo pretiahnite súbor** presuňte súbor **.xlsx** alebo **CSV (UTF-8)**.

![Dialóg Importovať produkty z Excel alebo CSV s pokynmi pre import a zónou na pretiahnutie súboru.](https://mintcdn.com/vexioncards/5-v6TFdxrGzbH76d/images/cs/storyous-import-preview.png?fit=max\&auto=format\&n=5-v6TFdxrGzbH76d\&q=85\&s=e29f99bcc5eb7772ebb9302041b29ed1)

Náhľad importu pred potvrdením

### Súhrn importu

Po nahraní sa pred uložením zobrazí krok **Potvrdiť import**. Uvedie názov súboru a zobrazí:

| Zobrazené | Význam |
| - | - |
| Celkový počet produktov v súbore | Koľko riadkov váš súbor obsahuje |
| Produkty na aktualizáciu | Koľko z nich sa zapíše |

spolu s upozornením *„Toto aktualizuje nastavenia vernosti vašich produktov. Produkty s chybami budú preskočené."* Samotné tlačidlo nesie počet, napríklad **POTVRDIŤ IMPORT (134 PRODUKTY)**. Kým ho nestlačíte, nič sa nezapíše.

Aktualizujú sa iba stĺpce vernosti. Názvy produktov a ceny sa importom nikdy nezmenia.

![Dialóg Potvrdiť import s názvom nahraného súboru a súhrnom importu s celkovým počtom produktov v súbore a počtom produktov na aktualizáciu, nad tlačidlom Potvrdiť import.](https://mintcdn.com/vexioncards/OoBUFxdiv70F8-H-/images/cs/storyous-import-confirm.png?fit=max\&auto=format\&n=OoBUFxdiv70F8-H-\&q=85\&s=0c54ae12eddfc96c1f0d716938a5ebab)

Krok Potvrdiť import, predtým než sa čokoľvek zapíše

Následne zelený pruh **Výsledky importu** oznámi, koľko produktov bolo importovaných a upravených, a tabuľka sa obnoví s novými hodnotami.

> [!NOTE]
>
> **„Importované" počíta prečítané riadky, nie zmenené.** Je to počet platných riadkov vo vašom súbore. **Upravené** je to, čo sa v tabuľke naozaj zmenilo. Riadky, ktorých `productId` v menu tejto prevádzky nie je, sa započítajú ako nenájdené a potichu neurobia nič, takže aj súbor, ktorý sa nespáruje s ničím, nahlási zdravo vyzerajúci počet importovaných. Ak sú tieto dve čísla ďaleko od seba, skontrolujte, či ste exportovali z tej istej prevádzky.

![Zelený pruh Výsledky importu hlásiaci 134 importovaných a upravených produktov nad obnovenou tabuľkou produktov s novými hodnotami.](https://mintcdn.com/vexioncards/OoBUFxdiv70F8-H-/images/cs/storyous-import-results.png?fit=max\&auto=format\&n=OoBUFxdiv70F8-H-\&q=85\&s=fcd95afd2bad5daf2a59fa74920adc02)

Výsledok po potvrdenom importe

> [!WARNING]
>
> Riadok, ktorého `productId` neexistuje vo vašej synchronizovanej ponuke, je preskočený. `discount` musí byť medzi 0 a 100. Udržujte stĺpec `productId` presne tak, ako bol exportovaný.

> [!WARNING]
>
> **Tri správania importu, ktoré je dobré poznať:**
>
> * **Používajte vždy kladné čísla.** `earnPoints` a `redeemPoints` sú počty: koľko pečiatok produkt dá a koľko ich treba na uplatnenie. Záporná hodnota nedáva zmysel, takže ju import neprijme a riadok s `-2` sa zapíše ako `0`, nie ako chyba. Ak produkt po importe nič nezarába, skontrolujte v tom stĺpci zabudnuté mínus.
> * **`discount` sa zaokrúhli nadol na celé percento.** Z `12,9` bude `12`.
> * **Desatinné čísla v `earnPoints` a `redeemPoints` sa vždy prijmú** a uložia na dve desatinné miesta, aj pri pečiatkovej karte. Veta „iba celé čísla" v dialógu je odporúčanie, nie pravidlo, ktoré import vynucuje, takže desatinné číslo naimportované na pečiatkovú kartu zostane uložené ako desatinné. Pri pokladni sa pečiatky získané za predaj zaokrúhľujú nadol na celé číslo. Ak chcete čisté počty pečiatok, používajte celé čísla.

## Čo nastaviť ďalej

To, ako vyplníte `earnPoints`, `redeemPoints` a `discount`, závisí od vášho typu karty. Pozrite si [Typy kariet a nastavenie bodov](https://vexioncards.mintlify.site/cs/knowledge-base/storyous-card-types.md) pre vypracované príklady každého.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.