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

# Dotykačka: prehľad

> Prepojte VEXiON cards s vaším Dotykačka POS, aby sa vernostné karty spracovávali automaticky priamo pri pokladni.

Prepojenie VEXiON cards s POS systémom **Dotykačka** znamená, že vernostné karty sa spracúvajú **automaticky priamo pri pokladni**. Zákazníci zbierajú body alebo pečiatky pri každom nákupe, bez samostatného kroku skenovania, na ktorý by museli myslieť.

> [!NOTE]
>
> Toto je prehľad. Ostatné návody k Dotykačke pokrývajú [pripojenie a nastavenie](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-setup.md), [multi-cloud (viacero prevádzok)](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-multicloud.md), [typy kariet a nastavenie bodov](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-card-types.md) a [prácu pri pokladni](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-pos.md).

## Čo je integrácia s Dotykačkou

Prepája váš vernostný program VEXiON s vaším POS systémom Dotykačka. Hlavné funkcie:

* **Jednoduché pripojenie**: prihlásite sa svojím účtom Dotykačka, žiadne manuálne kľúče.
* **Automatický zber bodov**: body sa zbierajú pri každom predaji.
* **Viacero prevádzok (multi-cloud)**: jeden vernostný program naprieč prevádzkami, kde je karta povolená.
* **Všetko v Dotykačke**: body a ich uplatnenie sa nastavujú na produktoch, ktoré už poznáte.

## Výhody

| Výhoda | Čo to znamená |
| - | - |
| Automatická synchronizácia | Zákazníci sú zdieľaní medzi oboma systémami |
| Body priamo v POS | Nastavíte ich na produktoch, ktoré poznáte |
| Viacero prevádzok | Zákazníci zbierajú body na každej prevádzke, kde je ich karta povolená |
| Zľavové skupiny | Automatické zľavy podľa úrovne zákazníka |
| Zákaznícky kredit | Darčekové karty cez vstavaný kredit Dotykačky |
| Okamžité aktualizácie | Karta sa aktualizuje v momente prijatia platby |

## Ako to funguje

Kľúčová myšlienka: v Dotykačke raz nastavíte **hodnotu bodov na svojich produktoch**. Odvtedy stačí, aby bol zákazník **naskenovaný na účtenku**, a tieto body získa. Na ich minutie personál pridá **špeciálny produkt**. VEXiON je vždy synchronizovaný, pretože Dotykačka mu po každej zaplatenej účtenke posiela **objednávkový webhook**.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#E5F6FF','primaryBorderColor':'#36C6FA','primaryTextColor':'#1F1E1F','lineColor':'#36C6FA','actorBkg':'#E5F6FF','actorBorder':'#36C6FA','fontFamily':'Manrope, sans-serif'}}}%%
sequenceDiagram
    participant C as Zákazník
    participant D as Dotykačka POS
    participant V as VEXiON
    Note over D: Jednorazové nastavenie: hodnoty bodov<br/>sú nastavené na produktoch
    C->>D: 1. Personál naskenuje QR kód karty<br/>(priradí zákazníka k účtenke)
    D->>D: 2. Personál pridá produkty<br/>(každý nesie svoju bodovú hodnotu)
    opt Uplatnenie bodov alebo odmeny
        D->>D: 3. Personál pridá špeciálny produkt<br/>(bonusové body, alebo odmenový produkt -10)
    end
    C->>D: 4. Zákazník zaplatí
    D->>V: 5. Dotykačka odošle objednávkový webhook
    V->>V: 6. VEXiON ho spracuje, aktualizuje kartu
    V-->>C: 7. Zákazník vidí nový zostatok v peňaženke
```

### Krok za krokom

1. **Priradenie zákazníka k účtenke.** Personál naskenuje QR kód z peňaženky zákazníka (alebo ho nájde podľa mena či telefónu). Účtenka nemusí byť najprv otvorená a skenovanie môže prebehnúť pred, počas alebo po pridaní položiek.
2. **Personál pridá produkty.** Každý produkt má nastavenú bodovú hodnotu, takže zákazník tieto body automaticky získa po zaplatení účtenky.
3. **Uplatnenie (voliteľné a manuálne):**
   * **Cashback**: personál pridá špeciálny produkt **"Uplatnenie bodov"** a zadá počet bodov na minutie (napríklad 500). Pridá sa **záporná položka**, ktorá zníži účtenku (napríklad 500 bodov × 0,01€ = 5€ zľava).
   * **Pečiatková odmena**: personál pridá **odmenový produkt**, ktorý má **záporné body a cenu 0€** (napríklad -10, pre 10. kávu zadarmo).
   * **Zľavové karty** fungujú inak, percentuálna zľava sa uplatní **automaticky** podľa zľavovej skupiny zákazníka.
4. **Zákazník zaplatí**, účtenka sa uzavrie.
5. **Dotykačka odošle objednávkový webhook** do VEXiON, ktorý ho spracuje a **aktualizuje kartu** v peňaženke zákazníka (získané body/pečiatky a prípadné odpočítané uplatnenie).

> [!WARNING]
>
> **Kedy naskenovať kartu?** Kedykoľvek počas predaja, pred, počas alebo po pridaní položiek. Dôležité je, aby bola karta naskenovaná **pred zaplatením účtenky**, inak sa body nepriradia.

> [!NOTE]
>
> Body a pečiatky sa **získavajú automaticky** (z bodových hodnôt produktov), ale **uplatňujú sa manuálne** (personál pridá špeciálny produkt). Len percentuálne **zľavy** sa uplatňujú úplne automaticky.

## Uplatnenie odmeny

Ak zákazník získal odmenu (napríklad 10. kávu zadarmo):

1. Personál vidí zostatok bodov/pečiatok zákazníka.
2. Pridá odmenový produkt na účtenku (napríklad "Káva zadarmo").
3. Odmenový produkt má nastavené **záporné body**, ktoré sa automaticky odpočítajú.

![Kategória ODMENY v Dotykačka POS s odmenovými produktmi, každý má -10 bodov a cenu 0,00 EUR.](https://mintcdn.com/vexioncards/7ayitPQkSISnQgwu/images/cs/dotykacka-reward-products.png?fit=max\&auto=format\&n=7ayitPQkSISnQgwu\&q=85\&s=445ef54295a2638224dac5dc2901d348)

Odmenové produkty v Dotykačke, každý nastavený na -10 pečiatok

## Podporované typy kariet

| Typ karty | Podporované | Ako to funguje |
| - | :-: | - |
| Pečiatková karta | ✅ | Zbieranie pečiatok, uplatnenie za odmenu |
| Bodová karta (kredit) | ✅ | Body sa menia na zľavu v eurách |
| Zľavová karta | ✅ | Automatické percentuálne zľavy |
| Darčeková karta | ✅ | Predplatený kredit na nákupy |

> [accordion] Pečiatková karta
>
> Kombinované nastavenie: najprv vo VEXiON, potom v Dotykačke. Vo VEXiON vytvoríte kartu a nastavíte, koľko pečiatok získa odmenu (napríklad 10). V Dotykačke nastavíte pečiatky na svojich produktoch a vytvoríte odmenové produkty.
>
> **Dôležité:** záporné pečiatky odmeny sa musia zhodovať s nastavením karty. Karta s 8 pečiatkami potrebuje odmenu -8, karta s 12 pečiatkami potrebuje -12.

> [accordion] Bodová karta (kredit / cashback)
>
> Nastavuje sa výhradne v Dotykačke. Body sa menia na zľavu v eurách. Nastavíte, koľko bodov získa každý produkt, a vytvoríte špeciálny produkt **"Uplatnenie bodov"**, kde definujete hodnotu jedného bodu (napríklad 1 bod = 0,01€). Pri pokladni personál pridá tento produkt, zadá počet bodov na minutie a zľava sa rozpočíta v rámci účtenky.

> [accordion] Zľavová karta
>
> Nastavuje sa vo VEXiON a automaticky sa synchronizuje do Dotykačky. Úrovne zákazníkov a percentá zliav definujete vo VEXiON, **zľavové skupiny sa v Dotykačke vytvárajú automaticky** pod názvom `VEXiON: {Card name} - {Tier}`. Keď útrata zákazníka dosiahne vyššiu úroveň, posunie sa vyššie a jeho zľavová skupina v Dotykačke sa aktualizuje sama.

> [accordion] Darčeková karta
>
> Využíva **zákaznícky kredit** Dotykačky. Kupujúci vyplní formulár online alebo pri pokladni, v Dotykačke sa vytvorí zákaznícky účet pre kupujúceho, zaplatená suma (plus prípadný bonus) sa pripíše na kredit a karta ide kupujúcemu alebo príjemcovi, ktorého si po zaplatení vyberie. Pri pokladni platí **zákazníckym kreditom** a suma sa odpočíta. Ak kredit nestačí, rozdiel doplatí v hotovosti alebo kartou.

Podrobnosti ku každému typu nájdete v [Typy kariet a nastavenie bodov](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-card-types.md).

## Požiadavky a licencie

Potrebujete:

| Požiadavka | Detail |
| - | - |
| Účet Dotykačka | Aktívny účet s licenciou **NAPLNO** alebo **NEOBMEDZENE** |
| Vzdialená správa | Prístup k správe produktov |
| Účet VEXiON | Aktívny účet VEXiON cards. Ten, kto integráciu pripája, musí byť administrátor účtu |
| Plán VEXiON | VEXiON PRO. Integrácie s POS nie sú súčasťou VEXiON ONE |
| Vernostná karta | Aspoň jedna karta vytvorená vo VEXiON |

> [!WARNING]
>
> Integrácia funguje **iba** s licenciami **NAPLNO** a **NEOBMEDZENE**. Základná licencia **JEDNODUCHO** integrácie nepodporuje.

| Funkcia | JEDNODUCHO | NAPLNO | NEOBMEDZENE |
| - | :-: | :-: | :-: |
| Integrácia VEXiON | ❌ | ✅ | ✅ |
| Hromadný import/export produktov | ❌ | ✅ | ✅ |
| Viacero prevádzok (multi-cloud, funkcia Dotykačky v licencii NEOBMEDZENE) | ❌ | ❌ | ✅ |
| Zákaznícky kredit | ❌ | ✅ | ✅ |

## Rýchly štart

**Pred spustením** skontrolujte, že máte plán VEXiON PRO, licenciu Dotykačka NAPLNO alebo NEOBMEDZENE, prístup k Vzdialenej správe, aspoň jednu kartu VEXiON a ste prihlásení do administrácie VEXiON.

**1. Pripojenie k Dotykačke**

V Nastavenia → Integrácie rozbaľte **Dotykačka**, vyberte svoje nastavenia a kliknite na **Pripojiť k Dotykačke**, aby ste sa prihlásili svojím účtom Dotykačka.

**2. Mapovanie vašich prevádzok**

Po pripojení namapujte každú prevádzku Dotykačky na prevádzku VEXiON.

**3. Nastavenie produktov v Dotykačke**

* Pečiatkové / bodové karty: nastavte body na svojich produktoch.
* Zľavové karty: zľavové skupiny sa vytvoria automaticky.
* Darčekové karty: aktivujte zákaznícky kredit.

**4. Hotovo**

Integrácia je aktívna. Kompletný postup nájdete v [Pripojenie a nastavenie](https://vexioncards.mintlify.site/cs/knowledge-base/dotykacka-setup.md).


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