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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://napoveda.rocketoo.cz/rocketoo/rozsireni/darkove-karty.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.