Napiwek przy Kasie, kompletny przewodnik
Instalacja, konfiguracja i obsługa opcjonalnego napiwku (procent, kwota stała lub dowolna) w koszyku i przy kasie, dla PrestaShop 8 i 9.
Wprowadzenie
Moduł Napiwek przy Kasie (dftip) dodaje na stronie koszyka blok „Dodaj napiwek”, dzięki któremu klient może zostawić opcjonalny napiwek: procent, kwotę stałą lub dowolną kwotę. Napiwek jest następnie natywnie ujmowany w zamówieniu, bez zmian w rdzeniu PrestaShop. Rozwiązanie idealne dla rzemieślników, twórców i gastronomii.
Napiwek jest niesiony przez dedykowaną pozycję zamówienia, której cena jest ustalana dla bieżącego koszyka przez specific_price ograniczony do tego koszyka. Przechodzi więc poprawnie przez zapłaconą sumę, VAT, fakturę i ewentualne korekty, dokładnie tym samym mechanizmem, którego PrestaShop używa do cen niestandardowych przy edycji zamówienia.
Kompatybilność
- PrestaShop 8.0 do 9.x
- PHP 7.4 do 8.3
- Pojedynczy sklep i multistore
- 5 języków: FR, EN, ES, DE, IT
- Motyw Classic i motywy własne
- Bez zależności (ani Composer, ani framework)
Instalacja
- W back office otwórz Moduły > Menedżer modułów.
- Kliknij Wgraj moduł i wskaż plik
dftip.zip. - Po instalacji kliknij Konfiguruj.
Podczas instalacji moduł rejestruje swoje hooki, tworzy ukryty produkt wirtualny „Napiwek” (poza katalogiem i poza wyszukiwarką, bez kosztów wysyłki) przeznaczony do przeniesienia kwoty napiwku i stosuje ustawienia domyślne: napiwek procentowy 5, 10, 15%, dozwolona dowolna kwota, bez VAT.
Konfiguracja
Wszystkie ustawienia znajdują się na stronie konfiguracji modułu.
- Włącz moduł: pokazuje lub ukrywa blok napiwku.
- Tytuł i podtytuł: teksty bloku, konfigurowalne i tłumaczalne w każdym języku.
- Typ napiwku: Procent, Kwota stała albo Oba.
- Proponowane procenty: lista rozdzielona przecinkami, na przykład
5,10,15. - Proponowane kwoty stałe: lista rozdzielona przecinkami w walucie domyślnej, na przykład
1,2,5. - Podstawa naliczania procentu: suma produktów brutto lub netto.
- Zezwól na dowolną kwotę: dodaje pole swobodnego wpisania kwoty.
- Minimalna / maksymalna dowolna kwota: limity stosowane do dowolnej kwoty.
- Podatek naliczany od napiwku: domyślnie Bez podatku; w razie potrzeby możesz wybrać grupę podatkową.
- Pokaż blok na stronie koszyka: włącza wyświetlanie selektora na stronie koszyka.
Tytuł i podtytuł są polami wielojęzycznymi: wybierz język w selektorze pola, aby dopasować tekst. Wartości domyślne w pięciu językach są dostarczane od razu po instalacji.
Działanie
Jak dodawany jest napiwek
Gdy klient wybiera napiwek, moduł zapamiętuje jego wybór (typ i wartość) dla bieżącego koszyka, dodaje pozycję „Napiwek” do koszyka i ustala jej dokładną cenę przy pomocy specific_price ograniczonego do tego koszyka. Operacja odbywa się przez Ajax, bez przeładowania strony, a suma aktualizuje się natychmiast.
Procent przeliczany automatycznie
W przypadku napiwku procentowego kwota podąża za zawartością koszyka: gdy klient doda lub usunie produkt, moduł przelicza kwotę i synchronizuje pozycję przed płatnością. Podstawa naliczania (suma produktów brutto lub netto) jest ustalana w konfiguracji i zawsze wyklucza samą pozycję napiwku oraz koszty wysyłki.
Natywna integracja z zamówieniem
Ponieważ napiwek jest prawdziwą pozycją koszyka, wchodzi do faktycznie zapłaconej sumy i zostaje zapisany w zamówieniu w chwili jego zatwierdzenia. Pojawia się poprawnie na fakturze, w księgowości i w ewentualnych korektach, bez żadnego override’u rdzenia.
VAT od napiwku
Dobrowolny napiwek zwykle pozostaje poza zakresem VAT, dlatego pozycja jest domyślnie dostarczana bez podatku. Jeśli przypiszesz napiwkowi grupę podatkową, wpisana lub wyliczona kwota jest traktowana jako podstawa netto.
Produktu „Napiwek” utworzonego przez moduł nie należy usuwać ani udostępniać w katalogu: służy wyłącznie do przeniesienia kwoty napiwku. Jest ukryty w wyszukiwarce i na listach oraz pozostaje bez kosztów wysyłki.
Usunięcie napiwku
Klient może w każdej chwili usunąć napiwek opcją braku napiwku. Jeśli ręcznie usunie pozycję „Napiwek” z koszyka, moduł kasuje także zapamiętany wybór, aby jej ponownie nie dodawać.
FAQ i rozwiązywanie problemów
Blok napiwku nie pojawia się na stronie koszyka
Sprawdź, czy moduł jest włączony i czy zaznaczona jest opcja pokazywania bloku na stronie koszyka. Następnie wyczyść pamięć podręczną PrestaShop (Ustawienia zaawansowane > Wydajność), a na czas testów wyłącz łączenie i kompresję plików (CCC). Blok wyświetla się, gdy koszyk zawiera co najmniej jedną pozycję.
Napiwek procentowy nie aktualizuje się przy zmianie koszyka
Przeliczenie następuje przy zapisie koszyka oraz przy wczytaniu strony koszyka lub kasy. Jeśli modyfikujesz koszyk akcją Ajax własnego motywu, odśwież stronę: kwota zostanie zsynchronizowana przed płatnością.
Czy napiwek pojawia się na fakturze?
Tak. Napiwek jest pełnoprawną pozycją zamówienia: figuruje w szczegółach zamówienia i na fakturze oraz jest uwzględniany w korektach.
Czy mogę naliczyć VAT od napiwku?
Tak, wybierając grupę podatkową w konfiguracji. Domyślnie napiwek jest bez podatku, zgodnie z naturą napiwku dobrowolnego.
Czy moduł jest kompatybilny z PrestaShop 9 i multistore?
Tak. Moduł działa na PrestaShop 8 i 9, w pojedynczym sklepie i w multistore, jest wielojęzyczny i nie wymaga Composera ani frameworka.