> ## 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: typy kariet a nastavenie bodov

> Nastavte každý typ karty pre Storyous a nakonfigurujte body vo svojich produktoch vo VEXiON.

Táto príručka pokrýva každý typ karty a ako nastaviť jej body v tabuľke produktov VEXiON. Ako získať a upraviť túto tabuľku, pozri [Ponuka a produkty](https://vexioncards.mintlify.site/cs/knowledge-base/storyous-menu.md).

> [!NOTE]
>
> **Princíp:** nastavujete lojalitu na produktoch **vo VEXiON** (zarábanie, uplatnenie, zľava), Storyous posiela každý predaj do VEXiON a VEXiON aktualizuje kartu. V pokladni môže personál zapnúť alebo vypnúť akýkoľvek benefit.

## Pečiatková karta

Jednoduchý program "zbieraj pečiatky, vyhraj odmenu".

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
flowchart TD
    A[Zákazník kúpi produkt<br/>earnPoints = 1] --> B[Storyous posiela predaj do VEXiON]
    B --> C[VEXiON pridá 1 pečiatku]:::vexion
    C --> D[Dostatok pečiatok?<br/>redeemPoints dosiahnutý]
    D --> E[Pokladný aplikuje odmenu<br/>zľava % na najlacnejší predmet]
    E --> F[VEXiON odpočíta pečiatky]:::vexion
    classDef vexion fill:#36C6FA,color:#fff,stroke:#2BA8D9;
```

**V tabuľke produktov VEXiON** nastavte pre každý produkt:

| Pole | Význam | Príklad |
| - | - | - |
| Vernosť | V programe | Áno |
| Získať pečiatky | Pečiatky zarobené za nákup | 1 |
| Uplatniť pečiatky | Pečiatky potrebné na odmenu | 10 |
| Zľava | Percento zľavy pri uplatnení | 100% (zadarmo) |

> [!NOTE]
>
> Pri **pečiatkových kartách** majú stĺpce názvy *Získať pečiatky* a *Uplatniť pečiatky*, pri **bodových kartách** tie isté stĺpce znejú *Získať body* a *Uplatniť body*. V exportnom a importnom súbore sa vždy volajú `earnPoints` a `redeemPoints`, nech používate ktorýkoľvek typ karty.

**Príklad: pečiatková karta na kávu**

| Produkt | Zarábajúce | Uplatnenie | Zľava |
| - | :-: | :-: | :-: |
| Espresso | 1 | 10 | 100% |
| Cappuccino | 1 | 10 | 100% |
| Latte | 1 | 10 | 100% |

Výsledok: jednu pečiatku za kávu a po 10 pečiatkach je akákoľvek káva zadarmo.

> [!NOTE]
>
> **Cena odmeny sa určuje podľa produktu, nie podľa karty.** Hodnota **Uplatniť pečiatky** je vlastná cena daného produktu v pečiatkach a môže byť nižšia, než koľko pečiatok má karta. Pečivo nastavené na 3 na 10-pečiatkovej karte si zákazník môže uplatniť hneď, ako má 3.

### Rôzne percenta zliav

Odmena nemusí byť 100%. Môžete uplatniť čiastočnú zľavu, čo je užitočné pre drahšie položky.

| Produkt | Cena | Uplatnenie | Zľava | Zákazník platí |
| - | :-: | :-: | :-: | :-: |
| Espresso | 1,80€ | 10 | 100% | 0€ (zadarmo) |
| Cappuccino | 2,50€ | 10 | 50% | 1,25€ |
| Latte | 2,90€ | 10 | 60% | 1,16€ |

### Automatický výber odmeny

Ak má zákazník dostatok pečiatok a v košíku sú oprávnené produkty, VEXiON odmeny ponúkne sám, **najprv najlacnejšiu odmenu** (jednotková cena produktu vynásobená percentom zľavy). Ak pečiatky pokryjú len jednu položku, ponúkne sa jedna odmena. Ak pokryjú viac položiek, VEXiON ich ponúkne postupne, každú s vlastným prepínačom, kým pečiatky nedôjdu. Obsluha môže jednotlivé odmeny vypnúť. Keď má každý oprávnený produkt **rovnaké** percento zľavy, ako prvý ide najlacnejší predmet.

> [!NOTE]
>
> **Pri pečiatkových kartách jedno uplatnenie pokryje jednu položku.** Ak sú v košíku dva kusy odmeňovaného produktu v jednom riadku, zľavu dostane len jeden. Ak chcete dať zadarmo dva, natukajte ich ako dva samostatné riadky.

> [!NOTE]
>
> **Zbierať alebo uplatniť, nikdy oboje.** V jednej transakcii zákazník buď zbiera pečiatky, alebo uplatňuje odmenu. Ak uplatní, za tento nákup pečiatky nezbiera.

## Bodová karta, Kreditný cashback

Body sa konvertujú na **eurový kredit**, ktorý môže zákazník minúť na akýkoľvek budúci nákup. Tento režim funguje naprieč **všetkými** vašimi prevádzkami.

### Cashback na tejto pokladni

Storyous počíta body podľa **Hodnoty 1 vernostného bodu**, ktorú nastavíte. Zákazník aj tak vidí **kredit vo vašej mene** na karte a v každej správe. Pri hodnote bodu 0,05 € sa 160 bodov zobrazí ako **8,00 €** kreditu (pri hodnote bodu 0,25 Kč je 160 bodov **40 Kč**). Obrazovka Storyous ukazuje riadok ako "Kredit: 8,00 € (160 bodov)".

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
flowchart TD
    A[Zákazník kúpi produkty] --> B[Zarába body<br/>stĺpec Zarábajúce body]
    B --> C[Body sa hromadia na karte]:::vexion
    C --> D[Pokladný zadá čiastku na uplatnenie]
    D --> E[Body sa konvertujú na eurá<br/>body x hodnota bodu]:::vexion
    classDef vexion fill:#36C6FA,color:#fff,stroke:#2BA8D9;
```

**Nastavenie:**

1. V sekcii **Nastavenia integrácie** nastavte **Typ bodovej karty** na **Bodové karty**, **Spôsob uplatnenia** na **Kreditný cashback** a pole **Hodnota bodu** (napríklad `0.01`, teda 1 bod = 0,01€).
2. V tabuľke produktov nastavte **Zarábajúce body** na svojich produktoch. Používa sa iba stĺpec zarábania, nič sa neuplatňuje za produkt.

**Príkladné nastavenie produktov** (body úmerné cene):

| Produkt | Cena | Zarábajúce body |
| - | :-: | :-: |
| Espresso | 1,80€ | 2 |
| Cappuccino | 2,50€ | 3 |
| Cheesecake | 4,50€ | 5 |

Nákup Cappuccina a Cheesecake-u zarába 8 bodov.

**Ako sa konvertujú body** (pri 0,01€ za bod):

| Body | Kredit |
| - | :-: |
| 100 | 1€ |
| 500 | 5€ |
| 1000 | 10€ |

V pokladni pokladný zadá, koľko kreditu chce zákazník použiť (akúkoľvek čiastku do jeho zostatku). Pozri [Práca v pokladni](https://vexioncards.mintlify.site/cs/knowledge-base/storyous-pos.md#bodové-karty).

## Bodová karta, Produktové odmeny

Body sa zarábajú a uplatňujú na **konkrétnych produktoch**, ako pečiatky, ale s flexibilnými množstvami bodov.

> [!WARNING]
>
> **Iba jedna prevádzka.** Hodnoty vernosti sú uložené vo vlastnej tabuľke produktov každej prevádzky, takže odmena nastavená v jednej prevádzke v druhej neexistuje. Nič vám nebráni zvoliť tento režim aj pri viacerých pripojených prevádzkach, museli by ste však každú nastaviť zvlášť a ten istý zákazník by v každej dostal inú odmenu. Ak máte viac ako jednu prevádzku, použite **Kreditný cashback**.

Nastavte **Zarábajúce body**, **Uplatnenie bodov** a **Zľavu** na každom produkte, presne ako u pečiatkovej karty, ale s desatinnými hodnotami bodov.

**Príklad**

| Produkt | Cena | Zarábajúce | Uplatnenie | Zľava |
| - | :-: | :-: | :-: | :-: |
| Espresso | 1,80€ | 2 | 20 | 100% |
| Cappuccino | 2,50€ | 3 | 25 | 100% |
| Cheesecake | 4,50€ | 5 | 40 | 100% |

Drahšie produkty zarábajú viac a stoja viac bodov na uplatnenie. Zákazník buď zarába, alebo uplatňuje v jednej transakcii, nie oboje.

Produktové odmeny fungujú inak ako pečiatky v troch veciach. VEXiON ponúka oprávnené produkty **najprv najlacnejšie, podľa ceny riadku na účte**, a uplatní **toľko produktov, koľko dovolia body**. Percento zľavy sa uplatní na **celú cenu riadku**, takže riadok s dvoma kusmi toho istého produktu dostane zľavu na oba kusy jedným uplatnením. Vždy nastavte **Zľavu** nad 0: produkt s Uplatniť nad 0 a Zľavou 0 sa ponúkne ako „0 % zľava“ a body aj tak stojí.

## Odstupňované zarábanie (bodové karty)

Bodová karta môže zarábať body **rýchlejšie pre verných zákazníkov** pomocou stupňov. Nastavíte body produktu **raz, pri základnej sadzbe**, a VEXiON ich vynásobí stupňom zákazníka.

**Ako to funguje:** každý stupeň má **násobiteľ zarábania** (napríklad Bronz 1x, Striebro 3x, Zlato 5x). Keď VEXiON spracuje predaj, hľadá stupeň zákazníka podľa ich celkových výdavkov a násobí základné zarobené body. Toto sa vzťahuje **iba na zarábanie**, uplatnenia sa nikdy nenásobia. Funguje v oboch režimoch **Kreditný cashback** a **Produktové odmeny**.

> [!WARNING]
>
> **Nastavte iba základný stupeň.** Zadajte `earnPoints` každého produktu pri sadzbe **najnižšieho** stupňa. Nevytvárajte samostatné hodnoty pre každý stupeň. VEXiON automaticky škáluje pre vyššie stupne.

**Príklad** (základné zarábajúce body, stupne Bronz 1x / Striebro 3x / Zlato 5x):

| Produkt | Základné zarábanie | Bronz zarábia | Striebro zarábia | Zlato zarábia |
| - | :-: | :-: | :-: | :-: |
| Espresso | 2 | 2 | 6 | 10 |
| Cheesecake | 5 | 5 | 15 | 25 |

Stupeň zákazníka sa určuje z jeho celkových výdavkov a posúva sa sám, keď minie viac. Stupne a násobitele sa nastavujú **na karte vo VEXiON**, nie v nastaveniach Storyous.

## Zľavová karta

Automatické zľavy v percentách podľa stupňa zákazníka. Toto funguje naprieč **všetkými** prevádzkami a výdavky sa sčítavajú.

VEXiON sleduje celkové výdavky zákazníka a aplikuje zľavu podľa stupňa automaticky v pokladni. Stupne sa nastavujú **na karte vo VEXiON**, nie v nastaveniach Storyous:

| Stupeň | Minimálne výdavky | Zľava |
| - | :-: | :-: |
| Bronz | 0€ | 5% |
| Striebro | 500€ | 10% |
| Zlato | 1500€ | 15% |

> [!NOTE]
>
> Zľava sa vzťahuje iba na produkty, ktoré majú **Lojalitu** zapnutú v tabuľke produktov. Keď výdavky zákazníka presiahnu prah, ich stupeň a zľava sa sami aktualizujú.

### Zamestnanecká karta

**Zamestnanecká karta** je zľavová karta nastavená pre personál so zľavovými úrovňami na mesiac a voliteľným **mesačným limitom**. Funguje v pokladni Storyous ako akákoľvek zľavová karta, s dvoma rozdielmi:

* S mesačným limitom sa zľava zastaví, keď sa limit vyčerpá, až do **dňa obnovy**. Bez limitu platí posledný krok až do dňa obnovy.
* Stupeň sa vyhodnocuje na základe **výdavkov zamestnanca v tomto mesiaci**, nie na základe celoživotných výdavkov.

Ako u akejkoľvek zľavy sa vzťahuje iba na produkty, ktoré majú **Lojalitu** zapnutú. Úplné nastavenie nájdete v [Zamestnanecká karta](https://vexioncards.mintlify.site/cs/knowledge-base/employee-card.md).

## Darčeková karta

Predplatený kredit, ktorý príjemca minie v pokladni.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
flowchart TD
    A[1. Kupujúci objedná na vašej stránke<br/>darčekových kariet] --> B[2. Kupujúci dostane QR kód]
    B --> C[3. Personál naskenuje QR objednávky<br/>pri pokladni, Naskenujte alebo napíšte kód]
    C --> D[4. Personál potvrdí účet,<br/>kupujúci platí základnú čiastku]
    D --> E[5. VEXiON vytvorí darčekovú kartu<br/>s akýmkoľvek pridaným bonusom]:::vexion
    E --> F[6. Kupujúci dostane potvrdzovací e-mail,<br/>príjemca dostane kartu]:::vexion
    classDef vexion fill:#36C6FA,color:#fff,stroke:#2BA8D9;
```

**Nastavenie** (v sekcii **Nastavenia integrácie**, po zapnutí **Darčeková karta**):

| Nastavenie | Význam | Príklad |
| - | - | - |
| Minimálna hodnota | Najnižšia čiastka za kartu | 10€ |
| Maximálna hodnota | Najvyššia čiastka za kartu | 1000€ |
| Bonusový program | Extra hodnota pri nákupe alebo doplnení | Zapnuté |
| Percentuálny bonus | Koľko extra | 10% |

**Bonusový program:** s 10% bonusom, zaplatenie 50€ načíta 55€ a zaplatenie 100€ načíta 110€. **Kupujúci platí iba základnú čiastku**, bonus je zadarmo. Pri online objednávke zaplatenej pri pokladni sú suma a bonus tie, ktoré kupujúci videl na stránke darčekových kariet (možnosti súm darčekovej karty), nie percento z týchto nastavení. Percento platí pre karty predávané starším formulárom v predajni.

**Míňanie:** príjemca ukáže svoju kartu, personál ju naskenuje a pri platbe sa použije zostatok. Ak nestačí, zákazník zaplatí rozdiel v hotovosti alebo kartou.

**Doplnenie:** darčekovú kartu je možné doplniť v pokladni a bonus sa aplikuje znova, **ale až keď sa jej zostatok minie**. Pokladňa sprístupní skenovanie len vtedy, keď sú na účte položky, a karta, na ktorej ešte je kredit, tieto položky vždy zaplatí namiesto dobitia.

### Predaj darčekových kariet online (digitálne darčekové karty)

Darčekové karty môžete predávať aj **online** bez zapojenia personálu. Zákazník si ich kupuje na vašej webovej stránke darčekových kariet, **Stripe spracuje platbu** a VEXiON **okamžite načíta zostatok na kartu príjemcu**. Príjemca dostane kartu v peňaženke s už načítaným zostatkom, pripravené minúť v pokladni pri ďalšej návšteve.

> [!NOTE]
>
> Predaj darčekových kariet online vyžaduje integráciu **Stripe Connect** (Nastavenia - Integrácie). Keďže Storyous číta zostatok z VEXiON v pokladni, online načítaný zostatok je hneď použiteľný, na strane Storyous sa nič iné nemusí synchronizovať.

Úplné kroky v pokladni nájdete v [Práca v pokladni](https://vexioncards.mintlify.site/cs/knowledge-base/storyous-pos.md#darčekové-karty).

## Často kladené otázky

> [accordion] Kde nastavujem body, vo VEXiON alebo Storyous?
>
> Vo **VEXiON**, v tabuľke produktov. Storyous poskytuje iba názvy produktov, ceny a kategórie.

> [accordion] Môžem používať pečiatky a body súčasne?
>
> Nie. V rámci bodových kariet si vyberiete **buď** pečiatkovú kartu **alebo** bodovú kartu. Zákazníci zbierajú jeden typ.

> [accordion] Môžem mať desatinné body?
>
> Áno pre **bodové karty** (napríklad 2,5). Pre **pečiatkovú kartu** sa odporúčajú celé čísla, aby počty pečiatok boli čisté.

> [accordion] Prečo nemôžem používať Produktové odmeny s viacerými prevádzkami?
>
> Náklady na uplatnenie produktu sú viazané na menu a ceny jedného miesta. Použite **Kreditný cashback**, ktorý je pevná sadzba eur za bod a funguje všade.

> [accordion] Čo znamenajú Uplatnenie a Zľava?
>
> **Uplatnenie** je počet potrebných bodov alebo pečiatok, **Zľava** je koľko sa odpočíta (100% = zadarmo). Napríklad Uplatnenie 10, Zľava 100% dáva produkt zadarmo za 10 pečiatok.


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