> For the complete documentation index, see [llms.txt](https://docs.portos.sk/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.portos.sk/pokladna/rozsirenia/odmeny.md).

# Odmeny

Rozšírenie Odmeny umožňuje prepojiť externé vernostné systémy priamo s aplikáciou PORTOS Pokladňa.

## Nastavenie odmien

Pre aktiváciu rozšírenia Odmeny je potrebné v obrazovke Nastavenia prejsť do sekcie Rozšírenia - Odmeny a zapnúť prepínač **Používať odmeny**.

{% hint style="info" %}
Rozšírenie Odmeny je vhodné používať v kombinácii s rozšírením **Zákaznícke účty**.
{% endhint %}

Externý vernostný systém v systéme PORTOS označujeme ako **Zdroj odmien**. Zdrojom odmien môže byť ktorýkoľvek vernostný systém či aplikácia, ak spĺňa  [protokol Rewards API](https://developers.portos.sk/integrations/rewards-api). V aplikácii PORTOS Pokladňa je možné nastaviť aj viac zdrojov odmien.

<figure><img src="/files/9CTyGlasOCyQh6SQwZRE" alt=""><figcaption></figcaption></figure>

Nový zdroj odmien vytvoríte kliknutím na tlačidlo :heavy\_plus\_sign:. Pre úpravu existujúceho zdroja odmien stlačte tlačidlo s ikonou ceruzky v príslušnom riadku. Kliknutím na tlačidlo s ikonou koša zdroj odmien odstránite.

Pre každý zdroj odmien je potrebné vyplniť:

* **Aktívne**: určuje, či bude pre tento zdroj získavaný zoznam odmien.
* **Názov**: ľubovoľný textový popis, vďaka ktorému odlíšite odmeny z tohto zdroja pre prípad, že bude aktívnych viac zdrojov.
* **Spojenie so serverom**: správne nastavenia v tejto sekcii by vám mala poskytnúť technická podpora k vernostnému systému. Ide o URL adresy, na ktorých sú pripravené API koncové body spĺňajúce [protokol Rewards API](https://developers.portos.sk/integrations/rewards-api).
  * **URL adresa načítania odmien**: vložte adresu webovej lokality, ktorú bude aplikácia PORTOS pokladňa používať na načítanie zoznamu odmien.
  * **URL adresa uplatnenia odmien**: vložte adresu webovej lokality, ktorú bude aplikácia PORTOS pokladňa používať na uplatnenie odmeny.
  * **API kľúč**: bezpečnostný kľúč používaný pri komunikácii s externým vernostným systémom.
  * **Verzia protokolu**: určuje podporovanú verziu komunikačného [protokolu Rewards API](https://developers.portos.sk/integrations/rewards-api).

<figure><img src="/files/ymuEophPU8Qaw6ztMsXv" alt="" width="563"><figcaption></figcaption></figure>

### Zobrazenie a uplatnenie odmeny

Po tom, ako spárujete otvorený účet so zákazníckym účtom, sa zo všetkých aktívnych zdrojov odmien automaticky získajú dostupné odmeny. Pri názve zákazníckeho účtu sa zobrazí oranžová sekcia upozorňujúca na dostupné odmeny spolu s informáciou o ich počte.

Niektoré odmeny môžu byť viazané na prítomnosť tovaru na účte alebo na minimálnu hodnotu nákupu. Počet odmien sa tak pri editácii položiek na účte môže líšiť.

<figure><img src="/files/q2II2pNnOHCHrbsgbBWW" alt=""><figcaption></figcaption></figure>

Po kliknutí na oranžovú sekciu sa zobrazí dialógové okno so zoznamom dostupných odmien.

<figure><img src="/files/N3hkuFen4RC7U1GVw77O" alt=""><figcaption></figcaption></figure>

V úvode dialógového okna sú zobrazené informácie o zákazníckom účte evidovanom v externom vernostnom systéme:

* názov vernostného účtu
* aktuálny počet vernostných bodov
* informácia o maximálnom počte uplatniteľných odmien

Pod týmito informáciami sa nachádza zoznam samotných odmien. Pre každú odmenu sú indikované nasledujúce informácie získané z externého vernostného systému:

* Názov odmeny
* Popis odmeny
* Počet bodov, ktoré budú z vernostného účtu pri uplatnení danej odmeny odpočítané
* Názov zdroja odmien (vhodné v prípade, ak sa používa súčasne viacero zdrojov odmien)