Program Lojalnościowy

Moduł lojalnościowy pozwala nagradzać stałych klientów punktami za zakupy i aktywność. Punkty można wymieniać na rabaty, darmową dostawę lub karty podarunkowe.

Jak działa program

Klient składa zamówienie → Punkty naliczone (EARN_PURCHASE) → Klient zbiera punkty
→ Osiąga próg poziomu → Awansuje na wyższy tier → Lepsze benefity
→ Realizuje punkty → Rabat / darmowa dostawa / gift card

Konfiguracja programu

Ustawienia podstawowe

W panelu Sklep → Program lojalnościowy → Ustawienia konfigurujesz:

Ustawienie	Opis	Przykład
Przelicznik punktów	Ile punktów za 1 PLN wydane	1 pkt / 1 PLN
Minimalna realizacja	Minimalna liczba punktów do wymiany	100 pkt
Wygasanie punktów	Po ilu dniach niewykorzystane punkty wygasają	365 dni (0 = bez wygasania)
Zaokrąglanie	Jak zaokrąglać naliczone punkty	W dół (floor)

Poziomy (Tiers)

Poziomy motywują klientów do większych zakupów. Każdy poziom ma próg punktowy i zestaw benefitów.

Pole	Opis
Nazwa	Nazwa poziomu (np. "Brązowy", "Srebrny", "Złoty")
Typ	Opcjonalna etykieta poziomu (kosmetyczna). Kolejność i awans zależą wyłącznie od progu punktowego - nie od typu.
Próg punktowy	Minimalna suma punktów all-time do awansu
Próg rocznych wydatków	Alternatywny warunek - minimalna kwota wydana w roku
Mnożnik punktów	Bonus do naliczania (np. 1.5x = 50% więcej punktów)
Rabat procentowy	Stały rabat na zamówienia (np. 5%)
Darmowa dostawa	Czy klient ma darmową dostawę
Priorytetowa obsługa	Obsługa VIP
Wczesny dostęp	Dostęp do nowych produktów przed premierą
Własne benefity	Dowolne benefity (JSON)

Kolejność poziomów: Poziomy są uporządkowane wyłącznie według progu punktowego - od najniższego do najwyższego. Nie ma sztywnych, wbudowanych nazw poziomów; tworzysz dowolną ich liczbę.

Awans i degradacja:

• Nowy uczestnik startuje na poziomie z najniższym progiem.
• System sprawdza awans po każdej akcji przyznającej punkty (zakup, rejestracja, urodziny, recenzja, polecenie, ręczna korekta admina) i awansuje klienta, gdy jego suma punktów all-time (lub roczne wydatki) osiągnie próg wyższego poziomu.
• Degradacja następuje wyłącznie podczas corocznego resetu rocznych wydatków - nigdy natychmiast po zwrocie ani cofnięciu punktów.

Nagrody

Nagrody to sposoby wymiany punktów. Konfigurujesz je w zakładce Nagrody:

Typ nagrody	Opis	Przykład
DISCOUNT	Rabat procentowy na zamówienie	500 pkt → 10% rabatu
FREE_SHIPPING	Darmowa dostawa	200 pkt → darmowa dostawa
GIFT_CARD	Karta podarunkowa	1000 pkt → 50 PLN gift card
PRODUCT	Darmowy produkt	2000 pkt → konkretny produkt

Zarządzanie uczestnikami

Lista uczestników

W zakładce Uczestnicy widzisz wszystkich klientów zapisanych do programu:

• Aktualne punkty - ile punktów klient może wykorzystać teraz
• Punkty all-time - suma wszystkich kiedykolwiek zarobionych
• Aktualny poziom - na jakim tierze jest klient
• Ostatnia aktywność - data ostatniej transakcji punktowej
• Wydatki roczne - kwota wydana w bieżącym roku (wpływa na tier)

Ręczne zarządzanie punktami

Jako admin możesz ręcznie:

• Dodać punkty - np. za reklamację, bonus urodzinowy, akcja promocyjna
• Odjąć punkty - np. korekta błędnego naliczenia
• Każda operacja jest logowana w historii transakcji z powodem

Automatyczne naliczanie

Punkty za zakupy (EARN_PURCHASE)

Punkty naliczane automatycznie po potwierdzeniu płatności:

• Obliczane proporcjonalnie do kwoty zamówienia (po rabatach, przed dostawą)
• Mnożone przez mnożnik poziomu klienta (np. Złoty tier: 1.5x)
• Zaokrąglane w dół
• Pozycje typu karta podarunkowa są wyłączone z naliczania punktów

Punkty za aktywność

Poza zakupami możesz nagradzać klientów punktami za inne akcje. Każdą włączasz osobno i ustawiasz liczbę punktów w Ustawieniach programu:

Akcja	Kiedy naliczane	Częstotliwość
Rejestracja konta	Po założeniu konta klienta (przyznawane przed mailem powitalnym)	Raz na klienta
Urodziny	W bieżącym roku, jeśli klient podał datę urodzin	Raz w roku
Recenzja produktu	Po zatwierdzeniu recenzji napisanej przez zalogowanego klienta	Raz na recenzję
Polecenie znajomego	Patrz „Program poleceń" poniżej	Dwustronnie

Każda z tych akcji może wywołać awans poziomu - system sprawdza próg po każdym naliczeniu.

Program poleceń

Klient generuje swój kod polecenia i udostępnia go znajomym. Konfigurujesz dwie pule punktów:

• Bonus dla poleconego - przyznawany nowemu klientowi od razu przy rejestracji z kodem polecenia.
• Bonus dla polecającego - przyznawany dopiero po pierwszym opłaconym zamówieniu poleconego (ochrona przed nadużyciami).

Polecenie ma konfigurowalny termin ważności (w dniach). Jeśli polecony nie złoży opłaconego zamówienia w tym czasie, polecenie wygasa, a polecający nie otrzymuje bonusu.

Cofanie punktów przy zwrotach (REFUND_REVERSAL)

Gdy klient zwraca zamówienie:

• System automatycznie cofa proporcjonalną liczbę punktów
• Zwrot częściowy → proporcjonalne cofnięcie (np. zwrot 50% → cofnięcie 50% punktów)
• Punkty mogą spaść poniżej zera (ochrona przed fraud)

Wygasanie punktów

Jeśli skonfigurowałeś wygasanie:

• System codziennie sprawdza punkty z datą wygaśnięcia
• Wygasłe punkty oznaczane jako EXPIRED
• Klient otrzymuje powiadomienie przed wygaśnięciem (7 dni, 1 dzień)

Statystyki

Dashboard lojalnościowy pokazuje:

• Łączna liczba uczestników
• Rozkład po poziomach (ile % na każdym tierze)
• Naliczone vs wykorzystane punkty w bieżącym miesiącu
• Top 10 najaktywniejszych uczestników

Integracja z innymi modułami

Moduł	Integracja
Zamówienia	Automatyczne naliczanie punktów po płatności (+ bonus polecającego przy pierwszym opłaconym zamówieniu poleconego)
Zwroty	Automatyczne cofanie punktów
Klienci	Bonus za rejestrację oraz program poleceń (kod polecenia na koncie klienta)
Recenzje	Punkty za zatwierdzoną recenzję zalogowanego klienta
Karty podarunkowe	Wymiana punktów na gift cards
Rabaty	Wymiana punktów na kody rabatowe
Storefront	Widgety: saldo punktów, tier progress, historia