Karty Podarunkowe Premium

Instrukcja obsługi · LMW Commerce

Quick-start — 5 minut do pierwszej sprzedaży

Jeśli działasz szybko, to tyle Ci wystarczy. Pełny manual poniżej dla perfekcjonistów.

  1. 1Zainstaluj aplikację z Shoper AppStore (zakładka Aplikacje → Karty Podarunkowe Premium → Zainstaluj).
  2. 2Kliknij ikonę aplikacji w panelu Asortyment → otworzy się iframe z onboardingiem.
  3. 3Uzupełnij 3 rzeczy w onboardingu: nazwa sklepu na bonie (np. „JAKULO"), wgraj logo PNG, utwórz pierwszy voucher przez kreator (5 klików).
  4. 4Przejdź do Shopera → Asortyment → Produkty → znajdź nową „Kartę podarunkową" → zakładka Warianty → zaznacz checkboxy wartości kwot i motywów, które mają być widoczne dla klienta → Zapisz.
  5. 5Wyślij sobie test (zakładka „Podgląd & Test" w apce → motyw → Twój email → Wyślij test). Zobacz PDF w skrzynce.
Gotowe. Twój sklep sprzedaje karty podarunkowe 24/7. Klient kupuje, PDF automatycznie leci na e-mail obdarowanej osoby.

1. Instalacja

Aplikację znajdziesz w Shoper AppStore (kategoria Produkty / Personalizacja produktów).

[Screenshot w przygotowaniu]
Karty Podarunkowe Premium na liście Shoper AppStore
Rys. 1 — Aplikacja na liście Shoper AppStore
  1. W panelu Shopera przejdź do Aplikacje → Sklep z aplikacjami.
  2. Wyszukaj „Karty Podarunkowe Premium".
  3. Kliknij Zainstaluj → zaakceptuj uprawnienia (tworzenie produktów, kategorii, dostawy, odczyt zamówień).
  4. Po instalacji aplikacja pojawi się w menu Asortyment → Aplikacje → Karty Podarunkowe Premium.
Ważne: Aplikacja wymaga aktywnego planu Shopera (Standard lub wyższy). Na planie Basic moduł „Webhooki" nie jest dostępny — apka nie wyśle voucherów po zamówieniu.

2. Pierwsze uruchomienie

Po otwarciu aplikacji zobaczysz Dashboard z onboardingiem 3-krokowym. Pasek postępu (0% → 33% → 66% → 100%) pokaże Ci co jeszcze trzeba zrobić.

[Screenshot w przygotowaniu]
Dashboard z onboardingiem 3 kroki
Rys. 2 — Dashboard z onboardingiem (nowy sklep, 0% ukończone)

3 kroki startu:

  • Ustaw nazwę sklepu — krótka nazwa (max 24 znaki) drukowana na PDF. Np. „JAKULO"
  • Wgraj logo — PNG/JPG z przezroczystym tłem (max 2 MB). Aplikacja automatycznie zrobi jasną i ciemną wersję pod różne motywy tła
  • Utwórz pierwszy voucher — kreator 5-krokowy (patrz sekcja 6)

3. Ustawienia sklepu

Zakładka Ustawienia zawiera podstawową konfigurację widoczną na voucherze i w procesie zakupu.

[Screenshot w przygotowaniu]
Sekcja Wygląd vouchera
Rys. 3 — Sekcja „Wygląd vouchera"

Wygląd vouchera

  • Prefix kodu — literowy początek każdego kodu rabatowego (np. „JK" → JK-A7B9C2). Domyślnie „EV".
  • Nazwa sklepu na bonie — widoczna na górze każdego PDF.
  • Ważność voucherów — w miesiącach. Domyślnie 12. Po tym czasie kod wygasa.
  • Domyślny motyw PDF — używany gdy klient nie wybierze motywu lub produkt go nie ma.

4. Sposób dostarczania voucheru

Trzy opcje, każda ma swoje zastosowanie:

Link w mailu sklepu

Rekomendowane. Klient dostaje jeden mail — od Twojego sklepu, z Twoim brandingiem, z linkiem do pobrania PDF. Najczystsze.

Załącznik PDF

Drugi mail z PDF-em w załączniku z adresu prezent@lmwcommerce.com. Odpowiedź klienta wraca na Twój email ze sklepu (Reply-To).

Oba sposoby

Klient dostaje dwa maile: linkowy od Ciebie + z załącznikiem PDF od apki. Bezpiecznik gdyby pierwszy wylądował w spamie.

5. SMTP — własny nadawca (opcjonalnie, dla zaawansowanych)

Domyślnie maile z PDF wychodzą z naszego serwera (nadawca: noreply-karty@evoucher.lmwcommerce.com). Chcesz żeby klient widział Twój adres w polu „Od"?

  1. Rozwiń sekcję „Własny serwer SMTP" w Ustawieniach
  2. Wpisz dane SMTP Twojej skrzynki (znajdziesz w panelu hostingu: seohost, home.pl, Google Workspace)
  3. Zapisz → apka od tego momentu wysyła z Twojego adresu
Uwaga: Niektóre hostingi blokują SMTP od 465 (SSL). Jeśli dostajesz błąd connection timeout — spróbuj port 587 (STARTTLS).

6. Utworzenie pierwszego vouchera

Zakładka Produkty → sekcja „Utwórz kartę podarunkową w sklepie".

Krok 1 — Jeden produkt czy wiele?

Dwie filozofie:

  • Tryb A (rekomendowany): jeden produkt „Karta podarunkowa" z dropdownami kwota + motyw. Klient wszystko wybiera na jednej stronie.
  • Tryb B (dla SEO): osobny produkt per okazja (np. „Karta ślubna", „Karta urodzinowa"). Każdy ma własny URL w Google — łapie long-tail.
[Screenshot w przygotowaniu]
Kreator — wybór trybu A lub B
Rys. 6 — Wybór trybu w Kroku 1 kreatora

Krok 2 — Nazwa i kwoty

Wpisz nazwę produktu (domyślnie „Karta podarunkowa") i zaznacz kwoty, które klient może wybrać (50–1000 zł).

Krok 3 — Motywy graficzne

16 gotowych motywów podzielonych na 4 grupy: Premium, Stylowe, Okazjonalne, Relaksacyjne. Najedź na kafel i kliknij „podgląd" żeby zobaczyć gotową kartę z Twoim logo.

[Screenshot w przygotowaniu]
Galeria 16 motywów z podglądem
Rys. 7 — Galeria motywów w Kroku 3

Krok 4 — Pola dedykacji

3 opcjonalne pola które klient wypełnia przy zakupie: Od kogo (40 zn.), Dla kogo (40 zn.), Życzenia (120 zn.). Zostaw wszystkie 3 zaznaczone — ograniczysz się tylko jeśli nie chcesz personalizacji.

Krok 5 — Darmowa dostawa elektroniczna

Apka automatycznie doda w Shoperze nową dostawę „E-mail (wysyłka elektroniczna)" 0 zł. Ta dostawa jest widoczna TYLKO przy produktach cyfrowych — nie zepsuje Twoich InPostów, DPD ani kurierów.

Klik „Utwórz produkty w Shoperze" — tworzenie trwa 15–60 sekund (nie odświeżaj strony).

7. Konfiguracja wariantów w panelu Shopera

Po utworzeniu produktu wejdź do Shoper → Asortyment → Produkty → Karta podarunkowa → zakładka Warianty.

[Screenshot w przygotowaniu]
Zakładka Warianty w produkcie — zaznacz checkboxy
Rys. 8 — Zaznaczanie aktywnych wartości w zakładce Warianty
  1. Przy Kwota zaznacz checkboxy kwot, które mają być widoczne dla klienta (np. 100/200/300 zł)
  2. Przy Motyw (jeśli tryb A) zaznacz motywy, które chcesz udostępnić
  3. Opcjonalnie: kliknij wartość Motyw → pole „Zdjęcie" → wybierz z galerii produktu → zmiana motywu na stronie produktu automatycznie zmieni zdjęcie
  4. Kliknij Zapisz
Znany bug Shopera: po kliknięciu Zapisz UI czasem się zawiesza. Obejście: zmień grupę wariantów na dowolną inną → wróć do oryginalnej → checkboxy są zachowane → kliknij Zapisz.

8. Podgląd vouchera i testowy mail

Zakładka Podgląd & Test — 3 kroki żeby zweryfikować wygląd przed włączeniem sprzedaży.

[Screenshot w przygotowaniu]
Zakładka Podgląd & Test
Rys. 9 — Zakładka Podgląd & Test
  1. Wybierz motyw z dropdownu — pola dedykacji auto-uzupełniają się przykładami dopasowanymi do okazji
  2. Kliknij „Pokaż podgląd" → zobaczysz PDF dokładnie tak, jak dostanie go klient
  3. Wpisz swój email → „Wyślij test" → sprawdź skrzynkę i zobacz jak wygląda w Gmail/Outlook

9. Pierwsze prawdziwe zamówienie

Po opublikowaniu produktu klient może kupić voucher. Co się dzieje:

  1. Klient wchodzi w produkt „Karta podarunkowa", wybiera kwotę, motyw, wpisuje dedykację
  2. Przechodzi do koszyka → wybiera dostawę „E-mail (wysyłka elektroniczna) 0 zł"
  3. Płaci (przelew, BLIK, karta — cokolwiek masz włączone w Shoperze)
  4. Shoper wysyła webhook order.paid do aplikacji
  5. Aplikacja generuje unikalny kod rabatowy (np. JK-A7B9C2), wystawia go w Shoperze jako kupon
  6. Generuje PDF z dedykacją, logiem, motywem, ważnością do daty
  7. Wysyła PDF na e-mail obdarowanej osoby (lub kupującego, zależnie od konfiguracji)
  8. W Dashboardzie apki pojawia się wpis „voucher wystawiony" (status: aktywny)

Obdarowana osoba wpisuje kod w koszyku Twojego sklepu → otrzymuje rabat równy kwocie voucheru.

10. FAQ

Klient nie dostał maila z voucherem

Sprawdź zakładkę Dashboard → czy voucher jest na liście (status: aktywny, kolumna E-mail: ✓). Jeśli ✗ — kliknij „Wyślij ponownie" przy voucherze. Częsty powód: mail trafił do spamu (sprawdź folder Oferty/Promocje w Gmail).

Chcę zmienić motyw istniejącego voucheru

Motyw drukowany jest na PDF w chwili wystawienia — nie zmieni się retroaktywnie. Możesz jednak wysłać ponownie z aktualnym motywem: Dashboard → voucher → Wyślij ponownie.

Jak anulować voucher?

Dashboard → voucher → Anuluj. Kod rabatowy zostanie dezaktywowany w Shoperze (nie będzie można go użyć przy kasie). Dla pełnego zwrotu pieniędzy — zrób zwrot zamówienia w standardowy sposób w Shoperze.

Ile kodów rabatowych tworzy apka?

Jeden kod na voucher. Każdy wystawiony voucher = nowy unikalny kod w Shoperze → Marketing → Kupony rabatowe.

Co z voucherami wystawionymi przed zmianą ustawień?

Zasady drukowane na voucherze (łączenie z promocjami itp.) to snapshot w chwili wystawienia. Jeśli zmienisz ustawienia — stare vouchery dalej mają swoje stare zasady. Ale efektywne zachowanie kodu w koszyku zależy od aktualnych ustawień apki w chwili użycia.

Czy mogę używać apki na dwóch sklepach?

Tak. Zainstaluj osobno w każdym sklepie — każdy ma swoje ustawienia, logo, statystyki i listę voucherów.

Co się stanie jak odinstaluję apkę?

Apka przestanie obsługiwać nowe zamówienia (webhook wygaśnie). Utworzone produkty, kategoria „Karty podarunkowe" i wystawione kody rabatowe pozostają w Twoim sklepie jako zwykłe produkty/kupony. Możesz je usunąć ręcznie.

RODO / dane osobowe

Aplikacja przechowuje tylko: email obdarowanej osoby, imię/nick wpisane w dedykacji, kod voucheru, datę wystawienia. Hosting: Hetzner (Niemcy, Unia Europejska). Dane kasujemy na żądanie sklepu (prezent@lmwcommerce.com).

Kontakt / wsparcie

E-mail: prezent@lmwcommerce.com (odpowiedź do 24h w dni robocze). Demo na żywo: jakulo.pl/Vouchery-prezentowe.