Ide o dve samostatné funkcie, ktoré sa dajú ľahko zameniť. Darčeková poukážka je platobný prostriedok s peňažnou hodnotou, ktorý si zákazník kúpi alebo dostane. Darček k nákupu je pravidlo, ktoré samo pridá vybraný produkt zdarma, keď košík dosiahne stanovenú sumu. Fungujú nezávisle a dajú sa kombinovať.
Kde to nájdete
Darčekové poukážky: Marketing > Darčekové karty na /admin/gift-cards. Darčeky k nákupu: /admin/gift-rules (samostatná obrazovka, mimo hlavného zoznamu poukážok).
Darčekové poukážky
Postup
- Otvorte Marketing > Darčekové karty a zvoľte Vytvoriť poukážku.
- Zadajte Sumu (EUR).
- Zvoľte Platnosť z prednastavených možností (3 mesiace až 5 rokov) alebo Vlastnú hodnotu v mesiacoch (3 – 60).
- Voliteľne vyplňte Meno príjemcu, Email príjemcu a Správu pre príjemcu — pri vyplnenom e-maile sa príjemcovi automaticky odošle notifikácia s kódom karty.
- Uložte cez Vytvoriť poukážku. Kód sa vygeneruje automaticky vo formáte
XXXX-XXXX-XXXX. - V detaile poukážky (
/admin/gift-cards/{id}) vidíte históriu transakcií, zostatok a prípadnú viazanosť na objednávku.
Pozor: Poukážku nejde odstrániť, ak už bola aspoň raz použitá (existuje na nej transakcia iná než nákup) — systém odstránenie odmietne, aby sa nestratila stopa po minutom kredite.
Polia a nastavenia
| Pole | Povinné | Význam |
|---|---|---|
amount | Áno | Hodnota poukážky (1 – 999 999,99). |
validity_months | Nie | Platnosť v mesiacoch (3 – 60), predvolene 12. |
recipient_email | Nie | E-mail príjemcu; pri vyplnení sa odošle notifikácia. |
recipient_name | Nie | Meno príjemcu. |
message | Nie | Osobný odkaz pre príjemcu (max. 1000 znakov). |
status (úprava) | Nie | active alebo disabled. |
expires_at (úprava) | Nie | Dátum expirácie, ak treba predĺžiť alebo skrátiť platnosť. |
Čo sa deje na pozadí
Poukážka drží samostatný zostatok oddelený od pôvodnej hodnoty (initial_balance vs. balance), aby bolo vždy vidieť, koľko sa už minulo. Čerpanie prebieha uzamknutím záznamu počas transakcie, takže dve súbežné platby rovnakou poukážkou nemôžu spolu minúť viac, než na nej reálne je. Keď zostatok klesne na nulu, stav poukážky sa zmení na vyčerpaný.
Suma zaplatená poukážkou sa na faktúre k objednávke zobrazuje ako samostatný riadok Uhradené darčekovou kartou, ktorý znižuje sumu na úhradu — nejde o zľavu, takže DPH ani základ dane sa touto sumou neupravujú.
Pri refundácii objednávky, ktorá bola čiastočne alebo úplne zaplatená poukážkou, sa kredit vráti späť na kartu — vrátane prípadu, že poukážka bola už vyčerpaná (vtedy sa opäť aktivuje). Vrátenie je bezpečné zopakovať viackrát, druhý pokus o rovnakú refundáciu nekredituje sumu duplicitne. Poukážka, ktorú obchodník ručne vypol, po refundácii aktívna nebude — to je zámerné, vypnutie je jeho rozhodnutie.
Darčeky k nákupu
Postup
- Otvorte
/admin/gift-rulesa zvoľte Pridať pravidlo (alebo obdobné tlačidlo na vytvorenie). - Zadajte Názov pravidla, Minimálnu sumu objednávky a vyberte Darčekový variant — konkrétny variant produktu, ktorý sa pridá zdarma.
- Voliteľne nastavte Platnosť od a Platnosť do.
- Prepínačom Aktívne pravidlo zapnite.
Polia a nastavenia
| Pole | Povinné | Význam |
|---|---|---|
name | Áno | Názov pravidla. |
min_order_amount | Áno | Suma, od ktorej sa darček pridá. |
gift_variant_id | Áno | Variant produktu, ktorý sa pridá zdarma. |
is_active | Nie | Zapnutie a vypnutie pravidla. |
starts_at / ends_at | Nie | Okno platnosti pravidla. |
Čo sa deje na pozadí
Pri každom prepočte košíka systém nájde pravidlo s najvyššou hraničnou sumou, ktorú nezľavnená hodnota košíka (bez darčekových položiek) dosahuje, a pridá príslušný darček s nulovou cenou. Keď zákazník odstráni položky a klesne pod hranicu, darček sa z košíka automaticky odstráni. Ak zákazník prekročí vyššiu hranicu iného pravidla, pôvodný darček sa nahradí novým — v košíku je vždy najviac jeden aktuálne oprávnený darček.
Časté problémy
- Darček sa v košíku neobjavil, hoci suma sedí. Skontrolujte Platnosť pravidla a či je Aktívne — pravidlá mimo okna platnosti sa nezohľadňujú.
- Poukážka sa nedá odstrániť. Bola už použitá — má na sebe transakciu inú než nákup; poukážky s históriou sa neodstraňujú.
- Refundácia nevrátila kredit na poukážku. Skontrolujte, či bola daná refundácia už predtým spracovaná — druhý pokus o rovnakú refundáciu kredit znovu nepripíše.
- Darček zmizol po pridaní ďalšej položky do košíka. Zákazník prekročil hranicu iného pravidla s vyšším minimom a pôvodný darček bol nahradený novým.
- Notifikácia s kódom poukážky neprišla príjemcovi. Odosiela sa iba pri vyplnenom e-maile príjemcu pri vytvorení; skontrolujte, či bol e-mail zadaný správne.