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 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ń.

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.