Astra Rabaty dla PrestaShop

1. Do czego służy Astra Rabaty

Astra Rabaty jest modułem do budowania kampanii promocyjnych i kontrolowania sposobu, w jaki rabaty są liczone, pokazywane klientowi oraz zapisywane w zamówieniu. Moduł może współpracować ze standardowymi regułami koszyka PrestaShop, a nie tylko z promocjami utworzonymi w Astra.

2. Okres testowy, licencja i wsparcie

Nowy klient automatycznie otrzymuje 14 dni pełnego okresu testowego na domenie. Trial służy do sprawdzenia kampanii, koszyka, checkoutu i zgodności z innymi modułami przed zakupem właściwej licencji.

Proponowany cennik licencji — 1 domena

Przedłużenie wsparcia technicznego

3. Instalacja i aktualizacja

1. W Back Office przejdź do Moduły → Menedżer modułów → Załaduj moduł.
2. Wgraj paczkę ZIP Astra Rabaty.
3. Po instalacji otwórz Konfiguruj. Przycisk kieruje do ekranu Główne.
4. Przed tworzeniem kampanii przejdź do Testowanie i upewnij się, że testujesz wyłącznie na własnym ruchu.
5. Przy aktualizacji wgraj nowszą paczkę na istniejącą instalację. Skrypty upgrade aktualizują tabele i rejestrację hooków.

4. Nawigacja Back Office

W menu administracyjnym znajduje się jedna pozycja Astra Rabaty. Wewnątrz modułu są trzy główne ekrany:

5. Ustawienia Główne

Te ustawienia są niezależne od konfiguracji pojedynczej kampanii. Określają globalne zachowanie rabatów produktowych w sklepie.

5.1. Wyświetlanie rabatów w koszyku

5.2. Sposób liczenia rabatów procentowych

5.3. Zapis rabatów w zamówieniu

6. Sumowanie rabatów a tryb sekwencyjny

Domyślne sumowanie od ceny bazowej

Astra zapamiętuje cenę pozycji przed rabatami CartRule. Każdy procent dotyczący produktu jest liczony od tej samej podstawy.

Nie jest tworzona żadna dodatkowa techniczna reguła typu „korekta sumowania”. Finalna produktowa część wyniku jest używana w koszyku, checkout, płatności i zamówieniu.

Tryb sekwencyjny

Limit 100%

Jeżeli suma procentów na jednym produkcie przekroczy 100%, cena końcowa nie może zejść poniżej 0,00. Faktycznie zastosowana część kolejnych reguł jest odpowiednio przycinana.

7. Typy kampanii

8. Rabaty progowe — konfiguracja dokładna

1. Utwórz kampanię typu Rabat progowy od wartości lub ilości.
2. Ustaw nazwę, status, priorytet, daty i odbiorców.
3. Wybierz Produkty aktywujące / zakres kampanii: wszystkie produkty, kategorie, marki albo ręczną listę produktów.
4. W polu Jak liczyć próg wybierz jedną z sześciu podstaw.
5. Dodaj dowolną liczbę progów.
6. Dla każdego progu ustaw osobno rodzaj korzyści.
7. Dla procentu lub kwoty wybierz osobno Co rabatować.
8. Opcjonalnie pomiń produkty przecenione katalogowo i ustaw maksymalny rabat kampanii na koszyk.

8.1. Jak liczyć próg

8.2. Rodzaj korzyści na progu

• rabat procentowy,
• rabat kwotowy,
• darmowa wysyłka.

8.3. Każdy próg może działać inaczej

Astra wybiera najwyższy osiągnięty próg.

9. Co rabatować — wszystkie cele

10. Zakres produktów, marki i odbiorcy

Zakres asortymentu

• wszystkie produkty,
• konkretne produkty z autocomplete,
• kategorie i opcjonalnie podkategorie,
• producenci / marki,
• pierwsza opcja Wszystkie marki oznacza brak ograniczenia producenta.

Wybrane marki są dodatkowym warunkiem AND względem produktów/kategorii.

Warunki ilościowe

• minimalna liczba sztuk,
• minimalna liczba różnych produktów,
• ilość liczona łącznie w zakresie albo wymagana w jednej kategorii,
• opcjonalne pomijanie produktów przecenionych katalogowo.

Odbiorcy

• wszyscy klienci lub wybrane grupy klientów,
• wszyscy / tylko zalogowani / tylko goście,
• kod publiczny lub przypisany do konkretnego klienta.

11. Produkt promocyjny i cena końcowa 0,01 zł

Nie trzeba zmieniać ceny katalogowej produktu. Astra oblicza różnicę potrzebną do osiągnięcia ceny docelowej wyłącznie w kwalifikowanym koszyku.

1. Dodaj produkt promocyjny do kampanii.
2. Wybierz próg, z którym nagroda jest powiązana.
3. Wybierz produkt i liczbę promocyjnych sztuk.
4. Jako korzyść wybierz: gratis, procent, kwotę albo Ustaw cenę końcową produktu.
5. Dla prezentu za 1 grosz wpisz 0,01.
6. Wybierz dodawanie ręczne albo automatyczne.

12. Kup produkt aktywujący → odbierz produkt promocyjny

1. Wybierz typ kampanii produktowej.
2. Wskaż konkretny produkt aktywujący albo użyj całego zakresu kampanii.
3. Ustaw wymaganą liczbę produktów aktywujących.
4. Wybierz produkt promocyjny i jego liczbę sztuk.
5. Ustaw gratis, cenę końcową, rabat procentowy lub kwotowy.
6. Wybierz dodawanie produktu promocyjnego lub rabatowanie produktu już znajdującego się w koszyku.
7. Opcjonalnie włącz powtarzanie nagrody za każdy pełny zestaw i ustaw maksymalny limit nagród.

W trybie ręcznego wyboru moduł zapamiętuje ilość produktu obecną przed wyborem nagrody, dzięki czemu po utracie warunku usuwa tylko promocyjne sztuki dodane ponad wcześniejszą ilość.

13. Kampanie uruchamiane kodem

1. Wybierz typ Kampania uruchamiana kodem rabatowym.
2. Ustaw warunki, zakres i korzyść.
3. Dodaj kod. Pusty klient = kod publiczny; wybrany klient = kod indywidualny.
4. Ustaw limit łączny i limit użyć per klient.
5. Zapisz kampanię. Klient wpisuje kod w standardowym polu kuponu PrestaShop.

14. Łączenie kampanii i natywnych promocji

14.1. Kampanie Astra między sobą

Domyślnie kampania może łączyć się ze wszystkimi kampaniami Astra, także utworzonymi później. Można przełączyć ją na tryb łączenia wyłącznie z wybranymi kampaniami.

Jeżeli dwie spełnione kampanie nie mogą działać razem, decyduje priorytet: niższa liczba oznacza wyższy priorytet.

14.2. Działanie z natywnymi promocjami PrestaShop

15. Rabaty per produkt dla natywnych CartRule PrestaShop

Astra nie ogranicza allocatora do własnych kampanii. Analizuje finalny zestaw reguł zwrócony przez PrestaShop.

• rabat procentowy,
• rabat kwotowy,
• cały koszyk,
• najtańszy produkt,
• konkretny produkt,
• grupa / ograniczenie produktów,
• wiele reguł jednocześnie,
• reguły automatyczne i uruchamiane kodem.

Darmowa wysyłka nie jest rozkładana na produkty. Jeżeli reguła zawiera rabat produktowy i darmową wysyłkę jednocześnie, na produkty przenoszona jest tylko część produktowa.

16. Zapis rabatów jako przecenione produkty

Opcja Zapisz jako przecenione produkty służy sklepom, które chcą, aby systemy zewnętrzne widziały cenę produktu już po rabacie.

Co jest aktualizowane

• order_detail — ceny jednostkowe i sumy produktów,
• orders.total_products*,
• pozostała wartość order_cart_rule,
• podatki,
• pojedyncza faktura zamówienia.

Produktowa część rabatu przeniesiona do cen nie może zostać odjęta ponownie jako osobny rabat.

17. Historia zastosowanych rabatów

Astra zapisuje trwały snapshot rabatów do tabeli abpe_order_discount_history. Dzięki temu po przeniesieniu rabatu do cen produktów nadal wiadomo, jakie promocje zostały użyte.

Zapisywane informacje

• nazwa i kod reguły,
• źródło: Astra lub PrestaShop,
• id_cart_rule,
• id_campaign dla kampanii Astra,
• rodzaj: procent / kwota / darmowa wysyłka,
• faktycznie zastosowana kwota rabatu,
• tryb liczenia,
• rozbicie rabatu na produkty.

Gdzie historia jest widoczna

• na stronie potwierdzenia zamówienia w bloku Zastosowane rabaty,
• w szczegółach zamówienia klienta,
• w Back Office w bocznej kolumnie zamówienia.

Bloki na potwierdzeniu i w Back Office są domyślnie zwinięte. Kliknięcie nagłówka rozwija szczegóły. Na stronie potwierdzenia blok jest pod głównym podsumowaniem zamówienia w displayOrderConfirmation1.

18. Komunikaty frontowe i hooki

Komunikat nie jest obowiązkowy. Jedna kampania może mieć wiele treści przypisanych do różnych miejsc sklepu i różnych stanów.

Przykład wywołania własnych hooków w szablonie produktu:

{hook h='rabatyprodukt' product=$product}
{hook h='rabatyprezent' product=$product}

Kiedy pokazywać komunikat

• zawsze, gdy kampania jest dostępna,
• przed spełnieniem warunku,
• po spełnieniu warunku,
• gdy kampanię blokuje natywna promocja PrestaShop.

19. Koszyk i aktualizacje AJAX

Zmiana ilości, usunięcie produktu albo dodanie/usunięcie kodu powodują ponowne przeliczenie kampanii.

• komunikaty koszyka są odświeżane po prestashop.updatedCart,
• techniczne CartRule są synchronizowane z aktualnym koszykiem,
• produkty promocyjne mogą zostać dodane, uzupełnione lub usunięte po zmianie warunku,
• ceny finalne w trybie rabatu per produkt są ponownie prezentowane po AJAX.

20. Tryb testowy i logi

Tryb testowy i logger są niezależnymi funkcjami. Tryb testowy kontroluje, dla kogo Astra działa. Logger tylko zapisuje diagnostykę.

Testerzy

Filtry działają jako OR. Pusta lista testerów w TEST MODE oznacza: nikt nie jest testerem.

Co może pojawić się w logu

recompute.start
snapshot.built
campaign.match
campaign.calculation
campaign.application
evaluation.result
product_discount.base_price_total
product_discount.allocator
product_discount.presenter_cart
synchronizer.create_rule / reuse_rule / replace_rule
recompute.done

21. Gotowe scenariusze konfiguracji

21.1. 10% od 500 zł na cały koszyk

1. Typ: Rabat progowy od wartości lub ilości.
2. Zakres: wszystkie produkty.
3. Jak liczyć próg: wartość całego koszyka.
4. Próg: 500.
5. Korzyść: procent 10.
6. Co rabatować: cały koszyk.

21.2. T-shirt tylko aktywuje rabat 10% na cały koszyk od 500 zł

1. Zakres kampanii: kategoria T-shirty.
2. Jak liczyć próg: wartość całego koszyka.
3. Próg: 500.
4. Co rabatować: cały koszyk.
5. Po usunięciu ostatniego T-shirtu kampania przestaje działać, nawet jeżeli koszyk nadal ma 500 zł.

21.3. Progi ilościowe

21.4. Kup 2, trzeci produkt za 0,01 zł

1. Typ kampanii produktowej.
2. Wymagana liczba produktów aktywujących: 2.
3. Liczba produktów promocyjnych: 1.
4. Korzyść: cena końcowa produktu.
5. Wartość: 0,01.
6. Opcjonalnie włącz powtarzanie za każdy pełny zestaw.

21.5. Natywny kupon 10% + kampania Astra 5% + druga kampania 5%

Przy domyślnym trybie sumowania produkt objęty wszystkimi trzema regułami pokazuje łącznie 20%. Każda reguła procentowa jest liczona od tej samej ceny bazowej produktu.

22. Zalecany proces wdrożenia produkcyjnego

1. Zainstaluj moduł i pozostaw TEST MODE.
2. Dodaj własne IP lub klienta testowego.
3. Skonfiguruj kampanię.
4. Sprawdź produkt kwalifikowany i niekwalifikowany.
5. Sprawdź zmianę ilości AJAX-em.
6. Sprawdź kilka CartRule jednocześnie.
7. Sprawdź koszyk, checkout i metodę płatności.
8. Jeżeli używasz zapisu cen po rabacie, sprawdź order_detail, Back Office i integracje zewnętrzne.
9. Sprawdź blok Zastosowane rabaty na potwierdzeniu i w Back Office.
10. Dopiero po pełnym odbiorze wyłącz TEST MODE.

23. Diagnostyka — najczęstsze problemy