Portfel Klienta i Środki na Koncie dla PrestaShop 8 i 9

Wprowadzenie

DataFirefly Portfel klienta dodaje do PrestaShop 8 i 9 saldo dla każdego klienta. Zapisujesz na nim zwroty, korekty i gesty handlowe; klient wykorzystuje je na etapie płatności kolejnych zamówień i może je sam zasilać. Saldo jest traktowane jak metoda płatności: zamówienie opłacone częściowo portfelem zachowuje sumę, fakturę i podstawę VAT, a część z portfela pojawia się jako pozycja płatności.

Instalacja

1. W Moduły > Menedżer modułów kliknij Załaduj moduł i upuść plik dfwallet-1.1.1.zip.
2. Podczas instalacji moduł tworzy swoje tabele, zakładkę Klienci > Portfele, ukryty produkt wirtualny DFWALLET-TOPUP używany do zasileń i ustawia się na pierwszym miejscu metod płatności.
3. W Płatność > Preferencje sprawdź, czy moduł jest dozwolony dla twoich walut, krajów i grup klientów.

Aby zaktualizować, załaduj nowy plik ZIP: salda, historia i ustawienia zostają zachowane, a skrypty aktualizacji dodają nowe kolumny.

Konfiguracja

Płatność

• Zezwalaj na częściowe użycie przy płatności: gdy saldo nie pokrywa całego zamówienia, klient może je zastosować i zapłacić resztę inną metodą.
• Status zamówienia, gdy portfel opłaca całe zamówienie: domyślnie Płatność zaakceptowana.

Zasilanie przez klienta

• Sugerowane kwoty: oddzielone przecinkami, w walucie domyślnej. Przykład: 20,50,100.
• Dowolna kwota, z minimalnym i maksymalnym zasileniem.
• Bonus za zasilenie: progi w formacie kwota:bonus. Przy 50:5,100:15 zasilenie 100 zł daje 115 zł. Bonus jest dopisywany po opłaceniu zasilenia i cofany, gdy zamówienie zostanie anulowane lub zwrócone.

Zasilenie jest sprzedawane bez VAT, ponieważ to przedpłata. Saldo jest dopisywane dopiero wtedy, gdy zamówienie zasilenia osiągnie status opłacony.

Zwroty i anulowania

• Zwracaj część opłaconą portfelem po anulowaniu zamówienia oraz po zmianie statusu na Zwrócone.
• Automatycznie zasilaj portfel każdą nową korektą: domyślnie wyłączone. Pozostaw wyłączone, jeśli zwracasz też przelewem lub natywnym kuponem; korekty księguje się wtedy pojedynczo ze strony zamówienia.

Uznania związane z zamówieniem (zwroty części portfela i korekty) są ograniczone do jego kwoty: włączenie automatycznego zwrotu i zaksięgowanie korekty tego samego zamówienia nigdy nie zasila dwa razy.

Wygasanie gestów handlowych

• Ważność w miesiącach, 0 oznacza brak wygasania. Dotyczy gestów handlowych, korekt na plus i bonusów za zasilenie. Zwroty, zwrócone płatności i zasilenia nigdy nie wygasają.
• E-mail z przypomnieniem przed wygaśnięciem: liczba dni przed terminem, 0 oznacza brak przypomnienia.

Płatność zawsze najpierw wykorzystuje kwoty, które wygasają najwcześniej.

Zadanie cron

Adres URL widoczny na górze strony konfiguracji, chroniony tokenem, wygasza zaległe uznania i wysyła przypomnienia. Wywołuj go raz dziennie:

0 6 * * * curl -s "https://twoj-sklep.pl/module/dfwallet/cron?token=TWOJ_TOKEN" > /dev/null

Bez crona to samo przetwarzanie działa najwyżej raz na godzinę przy otwarciu listy portfeli, a wygasłe uznania klienta są przetwarzane, gdy tylko jego portfel zostanie wyświetlony.

Zasilanie portfela

Ze strony zamówienia

Panel Portfel klienta pokazuje saldo, operacje powiązane z zamówieniem, przycisk Zaksięguj w portfelu przy każdej korekcie i formularz zasilenia (gest handlowy, zwrot, korekta). Jeśli zamówienie opłacono częściowo portfelem, przycisk pozwala zwrócić tę płatność.

Z karty klienta i z listy

Karta klienta pokazuje saldo i formularz zasilenia lub obciążenia. Klienci > Portfele zawiera listę wszystkich portfeli, szybkie zasilenie po adresie e-mail i szczegółową kartę każdego klienta.

Przy każdej operacji możesz podać wiadomość widoczną dla klienta, notatkę wewnętrzną, datę ważności dla gestów handlowych i wybrać powiadomienie klienta e-mailem.

Masowe zasilenia z pliku CSV

Blok Masowe gesty handlowe przyjmuje plik CSV, jeden klient w wierszu:

email;amount;message;valid_until
jane@example.com;10;Przepraszamy za opóźnioną dostawę;2027-06-30

Wiadomość i data są opcjonalne; daty w formacie RRRR-MM-DD lub DD/MM/RRRR, kwoty z przecinkiem lub kropką. Domyślna wiadomość i ważność dotyczą wierszy bez tych danych. Każdy wiersz ma własny klucz chroniący przed duplikatami: dwukrotne wysłanie tego samego pliku nikogo nie zasili dwa razy. Raport pokazuje wiersze zasilone, już zaimportowane i błędne.

Strona klienta

• Moje konto > Mój portfel: saldo, kwoty wkrótce wygasające, zasilenie i historia z paginacją oraz linkami do zamówień.
• Strona koszyka: przypomnienie o dostępnym saldzie.
• Etap płatności: jeśli saldo pokrywa zamówienie, jako pierwsza proponowana jest opcja Zapłać moim portfelem. W przeciwnym razie przycisk Użyj mojego salda pokazuje odjętą kwotę i resztę do zapłaty, po czym klient wybiera inną metodę.
• Potwierdzenie zamówienia: przypomnienie części opłaconej portfelem i kwoty pozostałej do zapłaty.

Saldo zastosowane w koszyku pojawia się w podsumowaniu jako pozycja Portfel. Jeśli klient usunie ją ikoną kosza, saldo przestaje być używane w tym koszyku.

Księgowość

Przy zatwierdzeniu zamówienia wykorzystane saldo jest zapisywane jako płatność zamówienia. Wartość produktów, VAT i faktura się nie zmieniają. Przy płatności przelewem lub czekiem instrukcje wysyłane klientowi podają faktycznie należną kwotę.

Lista portfeli pokazuje łączne saldo do wykorzystania w każdej walucie: dopóki nie zostanie wydane, jest zobowiązaniem wobec klientów. Blok Eksportuj operacje tworzy plik CSV (UTF-8, separator średnik) z jednym wierszem na operację: data, klient, operacja, kwota, waluta, saldo, zamówienie, korekta, ważność, pracownik, wiadomość i notatka.

E-maile

Dwa szablony są dostarczane w 8 językach w modules/dfwallet/mails/: dfwallet_credit (portfel zasilony) i dfwallet_expiry (przypomnienie przed wygaśnięciem). Są pisane w języku klienta, łącznie z kwotami i datami. Możesz je dostosować w Międzynarodowe > Tłumaczenia > Tłumaczenia e-maili lub nadpisać w motywie.

Odinstalowanie i RODO

Salda i historia są zachowywane przy odinstalowaniu, ponieważ stanowią zobowiązanie wobec klientów. Włącz Usuń salda i historię przy odinstalowaniu tylko wtedy, gdy chcesz wszystko usunąć. Operacje klienta są uwzględniane w eksporcie danych oficjalnego modułu RODO.

Najczęstsze pytania

Klient nie widzi opcji płatności portfelem

Opcja pojawia się tylko wtedy, gdy saldo pokrywa całe zamówienie. W przeciwnym razie nad metodami płatności wyświetla się przycisk Użyj mojego salda, o ile częściowe użycie jest włączone. Sprawdź też, czy moduł jest dozwolony dla waluty, kraju i grupy klienta.

Portfela nie można użyć przy zasileniu

To zamierzone: koszyka zawierającego zasilenie nie można opłacić portfelem.

Panel nie wyświetla się pracownikowi na stronie zamówienia

PrestaShop wykonuje hooki modułu tylko wtedy, gdy profil pracownika ma uprawnienie Wyświetl dla tego modułu. Dodaj je w Zaawansowane > Zespół > Uprawnienia.