# DataFirefly Affiliate Program: program partnerski dla PrestaShop > Instalacja Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, przesyłając plik ZIP, albo skopiuj folder dfaffiliate do katalogu /modules/ sklepu i kliknij Zainstaluj. Podczas instalacji moduł tworzy swoje… - Strona: - Język: pl - Zaktualizowano: 2026-09-23 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfaffiliate/index.md), [en](https://www.datafirefly.com/en/documentation/dfaffiliate/index.md), [es](https://www.datafirefly.com/es/documentation/dfaffiliate/index.md), [de](https://www.datafirefly.com/de/documentation/dfaffiliate/index.md), [it](https://www.datafirefly.com/it/documentation/dfaffiliate/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaffiliate/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaffiliate/index.md) - Indeks: ## Instalacja Zainstaluj moduł w **Moduły > Menedżer modułów > Załaduj moduł**, przesyłając plik ZIP, albo skopiuj folder `dfaffiliate` do katalogu `/modules/` sklepu i kliknij Zainstaluj. Podczas instalacji moduł tworzy swoje tabele, zapisuje ustawienia domyślne i dodaje w sekcji Sprzedaż menu **Afiliacja** z pięcioma pozycjami: Partnerzy, Prowizje, Zestawienia i wypłaty, Reguły prowizji oraz Ustawienia. Przycisk Konfiguruj w menedżerze modułów otwiera stronę ustawień, która zaczyna się od przeglądu programu. Aby przejść z wersji 1.0.0 na 1.1.0, wystarczy przesłać nowy plik ZIP: skrypt aktualizacji dodaje nowe ustawienia i hooki, nie zmieniając istniejących partnerów, prowizji ani zestawień. Przed uruchomieniem programu wybierz w ustawieniach **kolor akcentu**. Barwi on przyciski, zakładki i etykiety strony programu i strefy partnera. ## Pierwsze ustawienia Przed zaproszeniem pierwszych partnerów sprawdź co najmniej te punkty: - **Domyślna wartość prowizji**: 10 % od produktów netto po instalacji lub stała kwota za zamówienie. - **Ważność cookie**: domyślnie 30 dni, czas między kliknięciem a zamówieniem. - **Zatwierdzaj prowizję przy** i **Odrzucaj prowizję przy**: statusy zamówień potwierdzające płatność oraz te, które je anulują (anulowane, zwrócone, błąd płatności). - **Okres karencji**: domyślnie 30 dni. Zatwierdzona prowizja trafia do zestawienia dopiero po tym czasie, aby uwzględnić zwroty. - **Minimalna wypłata**: poniżej tej kwoty saldo przechodzi na kolejny miesiąc. - **Nazwa firmy, IBAN i BIC**: niezbędne do wygenerowania pliku przelewów SEPA. ## Śledzenie i atrybucja ### Linki śledzące Każdy partner ma kod. Przenoszą go dwa rodzaje linków: - **parametr śledzenia**, dodawany do dowolnego adresu sklepu: `?aff=CODE`. Nazwę parametru zmienisz w ustawieniach, na przykład na `ref`; - **krótkie linki**, które partner tworzy w swojej strefie z adresu produktu, kategorii lub dowolnej strony. Przekierowują na wybraną stronę i liczą kliknięcia oraz zamówienia dla każdego linku. Po kliknięciu podpisane cookie (`dfaff_ref`) zapisuje partnera. Podpis uniemożliwia odwiedzającemu jego zmianę. Roboty wyszukiwarek, zautomatyzowane przeglądarki i własne kliknięcia partnera nie są liczone, a ten sam odwiedzający jest liczony raz na 30 minut. Adres IP nie jest przechowywany w jawnej postaci. ### Kolejność przypisania zamówienia 1. **Osobisty kod rabatowy** partnera użyty w zamówieniu, nawet bez kliknięcia. 2. **Link lub cookie**: koszyk jest wiązany z partnerem już podczas wizyty, co obejmuje też płatności potwierdzane później przez bank. 3. **Klient wcześniej pozyskany** przez tego partnera, jeśli ustawienie **Prowizje od powracających klientów** jest większe niż 0 dni. **Model atrybucji** rozstrzyga sytuację, w której odwiedzający kliknie linki dwóch partnerów: _ostatnie kliknięcie_ (domyślnie), wygrywa ostatnio odwiedzony partner; _pierwsze kliknięcie_, pierwszy zachowuje sprzedaż do wygaśnięcia cookie. ### Zabezpieczenia - Partner nie otrzymuje prowizji od własnych zamówień, rozpoznawanych po koncie klienta i adresie e-mail. - **Tylko nowi klienci**: prowizję daje tylko pierwsze zamówienie klienta. - **Minimalna kwota zamówienia**: produkty netto po rabatach, 0 oznacza brak minimum. ## Prowizje ### Obliczanie Podstawą jest kwota produktów netto. Przy włączonej opcji **Odliczaj rabaty** kupony zamówienia są odejmowane od podstawy; kupon na darmową wysyłkę jej nie zmienia. Koszty wysyłki nigdy nie są wliczane. Kwota jest przeliczana na domyślną walutę sklepu. Stosowana stawka to kolejno: własna prowizja partnera, jeśli ją ma, w przeciwnym razie stawka programu. Dla procentów reguły produktów, a potem kategorii zastępują stawkę pozycja po pozycji. Przy stałej kwocie powstaje jedna prowizja na zamówienie i tylko jedna, gdy PrestaShop dzieli koszyk na kilka zamówień dla kilku przewoźników. ### Reguły dla kategorii i produktów Zakładka **Reguły prowizji** ustala procent dla kategorii lub produktu, na przykład 3 % na elektronikę i 15 % na akcesoria. Reguła produktu ma pierwszeństwo przed regułą kategorii. Dla kategorii moduł sprawdza najpierw domyślną kategorię produktu, potem najlepszą z pozostałych. Stawka 0 wyklucza produkty z prowizji. Reguły dotyczą tylko prowizji procentowych. ### Cykl życia - Przy zamówieniu prowizja powstaje jako **Oczekująca**. - Gdy zamówienie osiągnie status zatwierdzający, staje się **Zatwierdzona**, a data zatwierdzenia rozpoczyna okres karencji. - Gdy zamówienie przejdzie w status anulowania, zostaje **Odrzucona**. - **Częściowa korekta** zmniejsza prowizję proporcjonalnie do zwróconej kwoty produktów. - Jeśli prowizja jest już w zestawieniu lub została wypłacona, moduł jej nie zmienia: tworzy **ujemną korektę**, odliczaną od następnego zestawienia bez okresu karencji. Drugi status anulowania tego samego zamówienia nie tworzy kolejnego potrącenia. ### Prowizje ręczne W zakładce Prowizje opcja **Dodaj prowizję ręczną** uznaje lub obciąża partnera (kwota ujemna dla potrącenia), z notatką widoczną w jego strefie. Te pozycje podlegają temu samemu cyklowi zestawień co prowizje od zamówień. ## Partnerzy ### Zgłoszenia Publiczna strona programu przedstawia twoje warunki (stawka, czas trwania cookie, minimalna wypłata), trzy kroki i FAQ generowane z ustawień. Tekst prezentacji edytujesz w ustawieniach, w każdym języku. Jeśli wybierzesz stronę CMS z regulaminem programu, kandydat musi go zaakceptować. Kandydat musi być zalogowany na konto klienta. Podaje, gdzie publikuje, opisuje swoich odbiorców i opcjonalnie firmę. Domyślnie każde zgłoszenie czeka na twoje zatwierdzenie, a na **e-mail powiadomień** trafia wiadomość. Przy włączonym **automatycznym zatwierdzaniu zgłoszeń** konto jest od razu aktywne. ### Karta partnera Karta zaczyna się od podsumowania (kliknięcia, zamówienia, prowizje oczekujące, należne i wypłacone) oraz linku śledzącego do skopiowania, a potem zawiera trzy bloki: - **Tożsamość i kanał**: imię i nazwisko, e-mail, strona, odbiorcy, status i notatka wewnętrzna. Zmiana statusu na Zatwierdzony wysyła e-mail „Twoje konto partnera jest aktywne”. - **Śledzenie i prowizja**: kod partnera, własna prowizja, własny czas trwania cookie, osobisty kod rabatowy. Jeśli kod jeszcze nie istnieje, a podasz procent rabatu, reguła koszyka zostanie utworzona automatycznie, z limitem jednego użycia na klienta. - **Dane do wypłaty**: przelew SEPA lub PayPal, właściciel rachunku, IBAN, BIC, e-mail PayPal. Możesz dodać partnera bez konta klienta: otrzymuje zestawienia e-mailem, ale nie ma strefy online. Jeśli konto klienta używa tego samego adresu e-mail, zostaje powiązane automatycznie. Partnera z otwartymi prowizjami lub nieopłaconym zestawieniem nie można usunąć: zawieś go albo najpierw rozlicz saldo. ## Co widzi partner - **Moje konto**: kafelek „Strefa partnera” lub „Zostań partnerem” dla klienta, który jeszcze nim nie jest. - **Przegląd**: generator linków, pasek liczb (kliknięcia, zamówienia, konwersja, oczekujące, zatwierdzone, wypłacone), wykres z 30 dni, warunki i ostatnie linki. - **Moje linki**: wszystkie krótkie linki z kliknięciami, zamówieniami, kopiowaniem i usuwaniem. - **Prowizje**: data, zamaskowany numer zamówienia, źródło, podstawa, prowizja, status, filtr według statusu i przewidywany miesiąc wypłaty. Żadne dane klientów nie są wyświetlane. - **Zestawienia**: jedno zestawienie na miesiąc, do podglądu i wydruku w PDF. - **Dane do wypłaty**: wybór przelewu lub PayPal, IBAN weryfikowany po cyfrach kontrolnych i wyświetlany w formie zamaskowanej. Kropka i komunikat sygnalizują brakujące dane. - **Karta produktu**: pole „Twój link partnerski”, widoczne tylko dla zalogowanego partnera, podaje link do produktu i stawkę za ten produkt. ## Zestawienia i wypłaty ### Tworzenie zestawień Zestawienie grupuje dla jednego partnera i jednego miesiąca zatwierdzone prowizje utworzone przed końcem miesiąca, których okres karencji minął, oraz ujemne korekty. Jeśli suma jest niższa niż minimalna wypłata, nic nie powstaje, a saldo przechodzi dalej. Zestawienia można tworzyć na dwa sposoby: - **Zestawienia i wypłaty > Utwórz miesięczne zestawienia**: wybierz miesiąc, sprawdź w podglądzie kwoty dla każdego partnera, a następnie utwórz zestawienia i wyślij e-maile. - **Adres cron** widoczny w przeglądzie ustawień. Wywołuj go raz dziennie: między 1. a 5. dniem miesiąca tworzy zestawienia za poprzedni miesiąc. Dodaj `&period=RRRR-MM`, aby wymusić wybrany miesiąc. Jest chroniony tokenem. ### Wypłaty dla partnerów Na liście zestawień zaznacz te do opłacenia i użyj odpowiedniej akcji zbiorczej: - **Eksportuj plik przelewów SEPA (XML)**: plik pain.001.001.03 do importu w banku, dla partnerów opłacanych przelewem. Wymaga EUR jako waluty domyślnej i IBAN firmy. - **Eksportuj plik PayPal Payouts (CSV)**: do zbiorczych wypłat PayPal dla partnerów opłacanych przez PayPal. - **Eksportuj dla księgowości (CSV)**: wszystkie zaznaczone zestawienia, separator średnik. Eksport płatności jest odrzucany, z komunikatem wskazującym dane zestawienie, gdy zaznaczone zestawienie jest już opłacone albo brakuje IBAN lub jest nieprawidłowy: niepełny plik zostawiłby partnera bez wypłaty, a opłacone zestawienie mogłoby zostać opłacone dwa razy. Po wykonaniu przelewu oznacz zestawienia jako opłacone, zbiorczo lub w szczegółach zestawienia, podając numer referencyjny i datę płatności. Powiązane prowizje przechodzą w status Opłacona. ## E-maile Moduł wysyła cztery e-maile, przetłumaczone na 8 języków i wysyłane w języku odbiorcy, łącznie z formatem kwot: - **Nowe zgłoszenie partnera**, na adres powiadomień. - **Twoje konto partnera jest aktywne**, z linkiem do strefy partnera. - **Nowa sprzedaż**, z prowizją, podstawą i stawką, nigdy z danymi klienta. Do wyłączenia w ustawieniach oraz przez każdego partnera w danych do wypłaty. - **Zestawienie dostępne**, z kwotą i linkiem do zestawienia. Szablony znajdują się w folderze `mails/` modułu i można je dostosować jak każdy e-mail PrestaShop. ## Panel administracyjny - **Przegląd** (strona ustawień): aktywni partnerzy, zgłoszenia do rozpatrzenia, kliknięcia, zamówienia i sprzedaż z 30 dni, prowizje oczekujące, należne i wypłacone, najlepsi partnerzy. - **Strona zamówienia**: pole pokazuje partnera, prowizję, jej status i źródło. - **Eksport CSV** list partnerów i prowizji, z surowymi kwotami gotowymi do arkusza kalkulacyjnego. ## RODO i usuwanie kont Moduł rejestruje się w oficjalnym module RODO PrestaShop. Eksport danych klienta obejmuje jego profil partnera i prowizje. Usunięcie anonimizuje partnera (imię, e-mail, IBAN, strona i odbiorcy wyczyszczone, linki i kliknięcia usunięte), zachowując prowizje i zestawienia na potrzeby księgowości. Gdy pracownik usunie konto klienta, powiązany partner zostaje zachowany bez konta online, a jego dane do wypłaty pozostają. ## Rozwiązywanie problemów ### Kliknięcia nie są liczone Testuj w oknie prywatnym, bez logowania się na konto partnera: jego własne kliknięcia są ignorowane. Zautomatyzowane przeglądarki są filtrowane jak roboty. Jeśli sklep używa cache całych stron, strona podana z cache nie uruchamia PHP i parametr `?aff=` nie jest widoczny: używaj krótkich linków, które zawsze przechodzą przez PrestaShop, albo wyklucz parametr z cache. ### Prowizja pozostaje oczekująca Sprawdź, czy aktualny status zamówienia jest zaznaczony w **Zatwierdzaj prowizję przy**. Jeśli status zmienił pracownik bez uprawnienia Wyświetl do modułu (Zaawansowane > Zespół > Uprawnienia), PrestaShop nie uruchomił modułu: ustaw ponownie ten status zamówienia z konta administratora. ### Generator linków odrzuca adres Generator przyjmuje tylko adresy twojego sklepu. Wklej pełny adres tak, jak widnieje w przeglądarce, w domenie sklepu. ### Eksport SEPA jest odrzucany Przeczytaj wyświetlony komunikat: wskazuje zestawienie już opłacone lub partnera bez IBAN. Odznacz je lub uzupełnij dane. Sprawdź też, czy nazwa firmy i IBAN firmy są wypełnione. ## Zgodność - PrestaShop od 8.0 do 9.x, ten sam plik ZIP dla obu wersji. - Wiele języków i walut, prowizje liczone w walucie domyślnej. - Architektura ModuleAdminController, bez zależności Composer. - Moduł i e-maile przetłumaczone na angielski, francuski, hiszpański, niemiecki, włoski, niderlandzki, polski i portugalski.