# Napiwek przy Kasie, kompletny przewodnik > 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… - Strona: - Język: pl - Zaktualizowano: 2026-07-31 - Inne języki: [fr](https://www.datafirefly.com/documentation/dftip/index.md), [en](https://www.datafirefly.com/en/documentation/dftip/index.md), [es](https://www.datafirefly.com/es/documentation/dftip/index.md), [de](https://www.datafirefly.com/de/documentation/dftip/index.md), [it](https://www.datafirefly.com/it/documentation/dftip/index.md), [pt](https://www.datafirefly.com/pt/documentation/dftip/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftip/index.md) - Indeks: ## 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 1. W back office otwórz **Moduły > Menedżer modułów**. 2. Kliknij **Wgraj moduł** i wskaż plik `dftip.zip`. 3. 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.