# Dárkové karty

Modul **Dárkové karty** rozšiřuje e‑shop o speciální typ produktu – dárkový poukaz.\
Při splnění podmínek na objednávce se automaticky:

* **vygenerují vouchery** (jeden kód za každý zakoupený kus dárkové karty),
* **navážou na objednávku a produkt**,
* **odešle e‑mail zákazníkovi** s přehledem všech vygenerovaných kódů, a vytištěným poukazem v příloze e-mailu,
* do **historie objednávky** se zapíše záznam s možností e‑mail z historie znovu odeslat.

## Jak modul funguje

* V katalogu produktů máte speciální typ produktu – **dárková karta**.
* Zákazník si může tento produkt vložit do košíku jako běžné zboží (včetně více kusů).
* V nastavení modulu zvolíte **stav objednávky**, na který modul reaguje (např. ***Zaplaceno***).
* Při přechodu objednávky do tohoto stavu se spustí událost, která:
  * projde položky objednávky,
  * pro každý produkt typu dárková karta vytvoří **tolik voucherů, kolik je kusů**,
  * nastaví hodnotu voucheru podle ceny položky, nastaví restrikce voucheru zadané v nastavení modulu a případně nastaví zadanou platnost,
  * uloží vazby mezi voucherem, objednávkou a produktem,
  * připraví a odešle **e‑mail** s voucherem/vouchery.

## Nastavení modulu

V backendu v menu **Rocketoo → Nastavení** (podle konfigurace projektu) najdete sekci **Dárkové karty**.

{% hint style="info" %}
Pokud nevidíte nastavení modulu, zkontrolujte oprávnění uživatele a zda je plugin aktivní (nainstalován).
{% endhint %}

### Stav objednávky pro generování voucherů

Určuje, na jaký stav objednávky modul reaguje (např. „Zaplaceno“, „Vyřízeno“).

Při přechodu objednávky do tohoto stavu se:

* vygenerují vouchery,
* uloží vazby na objednávku a produkty,
* odešle e‑mail s vouchery.

Výchozí hodnota: stav s kódem `processed`, pokud existuje.

### Přikládat voucher k e‑mailu

Pokud je zaškrtnuto, modul se pokusí přiložit k e‑mailu s vouchery také soubor s voucherem. Jako obrázek voucheru se generuje obrázek zadaný u produktu, kde se do nastavených míst vypíše kód voucheru, případně platnost.

Pokud není zaškrtnuto, e‑mail obsahuje pouze textový přehled kódů.

#### Nastavení voucherů a restrikcí

V této části definujete výchozí parametry a omezení pro vouchery, které modul generuje z dárkových karet.

**Minimální hodnota nákupu**

Určuje minimální hodnotu košíku / objednávky, od které je možné voucher uplatnit. Hodnota je v měně nastavené pro e‑shop.

Pokud je pole prázdné, minimální hodnota není tímto nastavením omezena (další omezení mohou plynout z restrikcí níže nebo z modulu Vouchers).

**Platnost voucheru od / do**

* ***Platný od*** - Pokud je nastaveno, vygenerované vouchery budou platné až od tohoto data.
* ***Platný do*** - Pokud je nastaveno, vygenerované vouchery budou platné jen do tohoto data.

{% hint style="info" %}
Kombinací těchto polí můžete nastavit, že dárkové karty zakoupené dnes budou platné např. od 1. 1. příštího roku do 31. 12. příštího roku.
{% endhint %}

#### Restrikce uplatnění voucheru

Hlavní možnosti restrikcí:

* **Omezit na vybrané kategorie**
  * Po zaškrtnutí se zobrazí pole pro výběr kategorií.
  * Voucher lze uplatnit pouze na produkty z vybraných kategorií.
* **Vyloučit produkty z vybraných kategorií**
  * Po zaškrtnutí se zobrazí pole pro výběr kategorií.
  * Voucher nelze uplatnit na produkty z těchto kategorií.
* **Omezit na vybrané skupiny produktů**
  * Po zaškrtnutí se zobrazí pole pro výběr skupin produktů.
  * Voucher lze uplatnit pouze na produkty z vybraných produktových skupin.
* **Omezit na povinné produkty**
  * Zapíná režim, kdy se uplatnění váže na jednu vybranou produktovou skupinu.
  * Dropdown s výběrem produktové skupiny.
  * **Slevu v košíku navázat na konkrétní produkt**
    * Po zaškrtnutí se zobrazí pole pro výběr konkrétního produktu, na který se sleva fyzicky aplikuje.

Tento mechanismus umožňuje např.:

* omezit voucher jen na konkrétní produktovou řadu,
* zároveň určit, že sleva se uplatní na „hlavní“ produkt z dané skupiny.

Další omezení kombinovatelnosti

* **Omezit na nezlevněné produkty**
  * Pokud je zaškrtnuto, voucher nelze uplatnit na produkty ve slevě / akci.
* **Omezit na produkty, které nejsou v akci**
  * Pokud je zaškrtnuto, voucher nelze kombinovat s jinými vouchery / slevami.
* **Nekombinovat se slevami, vybrat lepší cenu**
  * Pokud je zaškrtnuto, voucher se nekombinuje se slevou, ale systém zvolí výhodnější variantu pro zákazníka (sleva z voucheru vs. aktuální sleva produktu).

{% hint style="info" %}
Logika uplatnění restrikcí je sdílená s obecným modulem Slevové kupóny. Nastavení v GiftCards slouží jako výchozí pravidla pro všechny vouchery vygenerované z dárkových karet.
{% endhint %}

## Vytváření dárkových karet v objednávkách

{% stepper %}
{% step %}

### Zákazník vytvoří objednávku

* Vloží do košíku jeden nebo více produktů typu **dárková karta**.
* Může objednat **více kusů stejného poukazu** – modul pro každý kus vygeneruje **samostatný kód**.
  {% endstep %}

{% step %}

### Objednávka změní stav na spouštěcí (např. Zaplaceno)

Při změně stavu objednávky na stav nastavený v modulu se spustí akce a ta:

* projde položky objednávky,
* pro každý **produkt typu Dárková karta** a jeho množství:
  * vygeneruje odpovídající počet voucherů,
  * přiřadí je k objednávce a produktu,
  * nastaví hodnotu voucheru podle ceny položky,
* sesbírá všechny vouchery pro danou objednávku pro odeslání e‑mailem.
  {% endstep %}
  {% endstepper %}

## Historie objednávky a opětovné odeslání e‑mailu

Vygenerování a odeslání voucherů se zapíše do **historie objednávky**:

* Při úspěšném vygenerování voucherů se zapíše záznam typu např.\
  „Dárkové poukazy vygenerovány / odeslány“.
* Pokud se e‑mail nepodaří odeslat, uloží se informace o neúspěšném odeslání.
* U záznamu je  **tlačítko pro opětovné odeslání e‑mailu** s vouchery, po kliknutí se odešle e-mail zákazníkovi se všemi vouchery dané objednávky. Tím lze jednoduše přeposlat e‑mail, pokud se zákazníkovi ztratil nebo mu nepřišel.

## Přehled voucherů v administraci

V administraci v sekci **Marketing → Dárkové karty**. Zde vidíte výpis všech vygenerovaných dárkových karet.

V seznamu  jsou tyto sloupce:

* **Objednávka** – číslo objednávky pro kterou byl voucher vygenerovaný, kliknutím přejdete do detailu objednávky.
* **Produkt** – název produktu, ke kterému voucher patří.
* **Kód slevového kupónu**
* **Platnost do** – datum platnosti voucheru:
  * červeně pro prošlý voucher,
  * oranžově pokud expiruje brzy,
  * normálně pro běžnou platnost.
* **Použitelný** - zda už byl voucher použitý nebo je ještě aktivní. Kliknutím můžete voucher **deaktivovat**.

## Záložka „Dárkové karty“ v detailu objednávky

V detailu objednávky přidává modul novou záložku **Dárkové karty**.

Na této záložce vidíte:

* všechny vouchery navázané na danou objednávku,
* název produktu,
* kód voucheru,
* hodnotu / slevu,
* stav (aktivní, použitý, expirovaný).

Tato záložka slouží pro **rychlou kontrolu**, které kódy byly k objednávce vygenerovány a v jakém jsou stavu.

## Často kladené otázky

<details>

<summary>Posílá se e‑mail pro každý voucher zvlášť?</summary>

Ne. Všechny vouchery pro jednu objednávku se po vygenerování sesbírají a **odešlou v jednom souhrnném e‑mailu**.

</details>

<details>

<summary>Kde můžu změnit text e‑mailu s vouchery?</summary>

V **Nastavení** **→  E-mailové šablony**. Šablona **Dárkové poukazy - slevový kupón** `rocketoo.giftcards::mail.customer.cs.voucher` .

</details>

<details>

<summary>Jak znovu odešlu e‑mail s vouchery zákazníkovi?</summary>

* Otevřete v administraci danou objednávku,
* v záložce ***Historie*** najděte záznam o vygenerování / odeslání voucherů,
* klikněte na tlačítko **Přeposlat e‑mail**,
* systém znovu odešle zákazníkovi e‑mail se všemi vouchery pro danou objednávku.

</details>