Karty podarunkowe z saldem w Twoim sklepie

1. Przygotuj produkt-voucher (5 minut)

W panelu Shoper dodaj zwykły produkt, np. „Karta podarunkowa”:

• cena 1,00 zł brutto — kwotę karty ustawia konfigurator (ilość sztuk × 1 zł),
• bez wariantów i bez nominałów,
• ukryty z listy kategorii, jeśli nie chcesz go pokazywać obok innych produktów (karta produktu musi być dostępna).

Potem w GrowVoucher otwórz zakładkę Produkty, wpisz kilka liter nazwy i wybierz produkt z podpowiedzi. Sprawdzimy cenę, warianty i dopniemy ukryte pole „Karta podarunkowa”. Maksymalnie 3 produkty.

2. Ustaw kwoty, motywy i wygląd

W zakładce Wygląd wybierz jeden z trzech stylów konfiguratora (Clean, Bold, Soft), kolor akcentu i kwoty: gotowe presety (np. 50–300 zł) oraz zakres własnej kwoty. Zaznacz motywy kart, które klienci mogą wybrać (domyślnie wszystkie 6: Urodziny, Święta, Ślub, Walentynki, Podziękowanie, Uniwersalny).

Każdą zmianę od razu widzisz w podglądzie po prawej — tak sam widget wygląda w sklepie.

3. Wpięcie w szablon (RWD albo Storefront)

Storefront: w edytorze szablonu dodaj moduł integracji GrowVoucher (plik storefront-module/module.twig dostarczamy razem z aplikacją) na stronie produktu. Slot z rezerwą miejsca zapobiega skakaniu układu:

<div data-growvoucher-configurator
     style="min-height:1520px"></div>

RWD: wklej przed formularzem koszyka fragment z config/rwd-snippet.html (loader + slot z rezerwą).

Bez slota konfigurator zamontuje się sam nad przyciskiem „Do koszyka”, ale rezerwa wysokości daje CLS ≈ 0.

4. Strona „Sprawdź saldo”

Utwórz stronę CMS (np. /sprawdz-saldo) i wklej slot widgetu salda:

<div data-growvoucher-balance style="min-height:160px"></div>

Adres strony wpisz w GrowVoucher w zakładce Wygląd („Strona Sprawdź saldo”) — link trafi do maili z kartą. Obdarowany może sprawdzić saldo, ważność i historię użycia.

5. Szablony maili i PDF

W zakładce E-maile zmień temat i treść trzech wiadomości: karta dla odbiorcy, potwierdzenie dla kupującego i przypomnienie przed wygaśnięciem (domyślnie 30 dni przed). Znaczniki ({{kwota}}, {{kod}}, {{dla}}, {{dedykacja}}, {{waznosc}}, {{link_saldo}}…) uzupełniamy danymi karty. Przycisk Podgląd pokazuje wiadomość na danych przykładowych, a Wyślij test dostarcza ją na adres sklepu.

Każda karta to załącznik PDF: A6 (sama karta) albo A4 (karta + instrukcja dla obdarowanego) — format wybierzesz w Wyglądzie.

6. Zarządzanie kartami

W zakładce Karty znajdziesz wszystkie wydane karty: saldo, odbiorcę, historię użycia i maile. Możesz:

• wystawić kartę ręcznie (reklamacja, zadośćuczynienie, marketing),
• pobrać PDF (A4/A6) i wysłać ponownie,
• przedłużyć ważność, zmienić saldo, unieważnić,
• potwierdzić realizację karty „do weryfikacji”,
• zwrócić kwotę realizacji na saldo (np. po zwrocie zamówienia),
• zaimportować karty hurtowo z CSV (np. kuponówka dla firmy).

7. VAT i bon MPV — co mówić księgowości

Karta GrowVoucher działa jako bon różnego przeznaczenia (MPV): obniża kwotę zamówienia i dokumentu sprzedaży. VAT należny rozlicza się przy realizacji, od pełnej wartości towarów. Dla księgowości przygotowaliśmy:

• raport „Realizacje (CSV)” — data, karta, kwota zniżki, zamówienie,
• raport „Karty (CSV)” — salda i statusy na dzień eksportu,
• szablon regulaminu bonów do adaptacji (link u góry panelu).

Karta nie łączy się z innym kodem rabatowym ani z drugą kartą w jednym zamówieniu. Nie prowadź natywnych kart Shopera i GrowVoucher na tym samym produkcie.

8. Najczęstsze pytania

Co się dzieje po wygaśnięciu planu?
Konfigurator i strona salda się wyłączają, ale wydane karty działają w koszyku (to natywne kody Shopera), a zaplanowane maile z kart wychodzą. Zgromadzone zamówienia przetwarzamy po wznowieniu.

Klient przekroczył saldo częściowo?
Kod zniżka tyle, ile jest na karcie; resztę klient dopłaca. Po zakupie saldo karty automatycznie maleje o realną zniżkę z zamówienia.

Inna waluta niż PLN?
Wersja 1 obsługuje PLN. Sklep z inną walutą bazową nie zobaczy konfiguratora.

RODO?
Trzymamy minimum: e-maile kupującego i odbiorcy, imiona, dedykację. W panelu wyeksportujesz lub usuniesz dane osoby po adresie e-mail; po ustalonym czasie (domyślnie 12 miesięcy od końca karty) dane anonimizujemy automatycznie.