DataFirefly Marketplace: kompletny przewodnik
Instalacja, konfiguracja i prowadzenie platformy marketplace multi-vendor w PrestaShop 8 i 9.
Prezentacja
DataFirefly Marketplace zamienia Twój sklep PrestaShop w platformę marketplace multi-vendor. Zewnętrzni sprzedawcy rejestrują się, publikują produkty i zarządzają zamówieniami, podczas gdy Ty sterujesz prowizjami, płatnościami i zgodnością z poziomu zaplecza.
Moduł pokrywa cały cykl: rejestracja i weryfikacja sprzedawców, kompletny panel sprzedawcy, rzeczywisty podział zamówień na podzamówienia, silnik prowizji, regulowana płatność dzielona (Mangopay i Stripe Connect), dostawa per sprzedawca, zgodność europejska (DSA, P2B, VAT), opinie, komunikator, plany, spory i analityka, wszystko w pięciu językach (FR, EN, ES, DE, IT).
Zgodność i wymagania
- PrestaShop 8.0, 8.1, 8.2 i 9.x
- PHP 8.1 lub nowszy
- Multisklep i wielojęzyczność
- Dla płatności dzielonej: konto Mangopay i/lub Stripe Connect (klucze sandbox do testów, klucze produkcyjne do eksploatacji)
Instalacja
- W zapleczu przejdź do Moduły > Menedżer modułów, kliknij Załaduj moduł i wybierz archiwum
dfmarketplace.zip. - Instalacja tworzy niezbędne tabele, rejestruje hooki i dodaje menu Marketplace w zapleczu, a także zestaw danych demonstracyjnych (plany i reguły prowizji).
- Otwórz Marketplace > Konfiguracja, aby skonfigurować moduł.
Przy odinstalowaniu tabele danych są celowo zachowywane, aby nie utracić historii sprzedawców, zamówień i prowizji.
Konfiguracja początkowa
W Marketplace > Konfiguracja uzupełnij główne parametry:
- Prowizja domyślna: stawka stosowana, gdy nie istnieje bardziej szczegółowa reguła (domyślnie 15%).
- Domyślny dostawca płatności: Mangopay lub Stripe Connect, a następnie odpowiednie klucze.
- Tryb hybrydowy: pozwala operatorowi sprzedawać własne produkty obok sprzedawców zewnętrznych.
- Fakturuj zamówienia podrzędne: generuje dedykowaną fakturę dla każdego podzamówienia sprzedawcy.
- Status uwalniający escrow: status zamówienia, który wyzwala uwolnienie środków do portfeli sprzedawców (na przykład „Wysłano” lub „Dostarczono”).
- Pokaż tożsamość sprzedawcy (DSA): aktywuje blok tożsamości profesjonalnego sprzedawcy na witrynie.
- Prefiks faktury prowizyjnej oraz okres wypowiedzenia P2B (dni).
- Automatyczna walidacja produktów: jeśli włączona, produkty sprzedawców są publikowane bez moderacji.
Zarządzanie sprzedawcami
Rejestracja
Zalogowany klient może zostać sprzedawcą przez stronę rejestracji modułu (link ze swojego konta). Podaje nazwę sklepu, formę prawną i informacje prawne. Otrzymuje e-mail z potwierdzeniem przyjęcia zgłoszenia.
Weryfikacja i KYC
Z poziomu Marketplace > Sprzedawcy operator może zatwierdzić, zawiesić lub odrzucić sprzedawcę. Przy zatwierdzeniu uruchamiany jest onboarding PSP i wysyłany e-mail z potwierdzeniem. Sprzedawca może przesłać swoje dokumenty KYC (wyciąg z rejestru handlowego, dokument tożsamości, dane konta bankowego) ze swojego pulpitu.
Zgodnie z rozporządzeniem P2B każde zawieszenie wiąże się z e-mailem informującym sprzedawcę, z uzasadnieniem przekazywanym osobno.
Panel sprzedawcy
Sprzedawca dysponuje odseparowanym pulpitem: ma dostęp wyłącznie do własnych danych.
- Pulpit: saldo portfela, kwota do wypłaty, liczba produktów, status, zamówienia, księga główna.
- Mój profil: logo, baner, prezentacja, polityki zwrotów i dostawy, publiczne dane kontaktowe i pola DSA.
- Moje produkty: tworzenie i edycja kompletnych kart (zdjęcia, referencja/SKU, EAN, stan, cena i VAT, ilość, kategoria, waga i wymiary, opisy).
- Dostawa: wybór oferowanych przewoźników i reguły kosztów (według ceny lub wagi, per strefa, z progiem darmowej dostawy).
Podział zamówień
Gdy zamówienie zawiera produkty kilku sprzedawców, moduł dzieli je na prawdziwe zamówienia podrzędne (jedno per sprzedawca). Każde podzamówienie ma własne koszty dostawy, utrwaloną prowizję, fakturę i zapis w portfelu. Logiczny szczegół jest zachowywany dla śledzenia, a separacja między sprzedawcami jest ścisła.
Faktura zamówienia nadrzędnego podąża za natywnym przepływem PrestaShop. Sprawdź na swojej wersji, czy moduł płatności nie utrwala faktury nadrzędnej na pełną kwotę przed podziałem.
Prowizje
Silnik stosuje kaskadę reguł, od najbardziej szczegółowej do najbardziej ogólnej: produkt › sprzedawca › kategoria › globalna, z fallbackiem na prowizję domyślną. Reguły mogą być procentowe, kwotowe lub hybrydowe, na bazie brutto lub netto.
Obsługiwane są progi miesięcznego obrotu: na przykład 15% do 5 000 € miesięcznego obrotu, a następnie 12% powyżej. Prowizja jest utrwalana w momencie zamówienia i nigdy nie jest przeliczana ponownie.
Płatność dzielona, portfel i escrow
Adaptery Mangopay i Stripe Connect pobierają środki w sposób dzielony i przechowują je w escrow. Po osiągnięciu skonfigurowanego statusu zamówienia środki są uwalniane do portfeli sprzedawców.
Wypłaty
Sprzedawca wnioskuje o wypłatę ze swojego pulpitu. Operator wykonuje wypłaty z Marketplace > Prowizje i płatności jednym kliknięciem (przelew SEPA przez PSP). Każdy ruch jest rejestrowany w księdze głównej portfela.
Webhooki
Skonfiguruj URL webhooka modułu po stronie PSP (kontroler webhook), aby synchronizować statusy płatności. Podpis jest weryfikowany przy każdym wywołaniu.
Dostawa per sprzedawca
Każdy sprzedawca definiuje swoich przewoźników i reguły kosztów. Przy wysyłce wprowadza przewoźnika i numer śledzenia ze swojego pulpitu: e-mail jest wysyłany do kupującego, a gdy wszystkie podzamówienia zamówienia są wysłane, zamówienie nadrzędne automatycznie przechodzi w status „Wysłano”.
Zgodność europejska
- DSA: tożsamość profesjonalnego sprzedawcy (nazwa, numer rejestrowy, VAT, punkt kontaktowy) jest wyświetlana na jego witrynie.
- Faktury prowizyjne: generowane automatycznie w okresach miesięcznych, numerowane i archiwizowane. Operator może uruchomić masowe generowanie z Marketplace > Faktury prowizyjne.
- P2B: strona publikuje warunki obowiązujące sprzedawców, parametry rankingu i okres wypowiedzenia w razie zmiany.
- VAT „platforma uznana za dostawcę”: wskaźnik per sprzedawca jest wyświetlany i przenoszony na fakturę prowizyjną.
Moduł udostępnia i wyświetla wskaźnik VAT, ale nie zawiera silnika podziału OSS. Szczegółowy podział VAT pozostaje sterowany konfiguracją podatków Twojego sklepu.
Opinie, komunikator, plany, spory i analityka
- Opinie: kupujący, którzy zamawiali u sprzedawcy, mogą zostawić opinię, moderowaną z Marketplace > Opinie. Średnia ocena jest przeliczana automatycznie.
- Komunikator: wątki dyskusji między kupującym, sprzedawcą i operatorem; skrzynka odbiorcza po stronie sprzedawcy.
- Plany sprzedawcy: domyślnie Free, Pro i Premium, z limitami produktów, stawkami prowizji i dostępem do analityki. Zarządzane z Marketplace > Plany sprzedawcy.
- Spory i zwroty: otwierane per podzamówienie, rozstrzygane z Marketplace > Spory i zwroty, z ewentualnym zwrotem odzwierciedlanym w portfelu sprzedawcy.
- Analityka: widok operatora (GMV, stopa prowizji, najlepsi sprzedawcy) w Marketplace > Analityka oraz statystyki per sprzedawca (zależne od planu) w jego pulpicie.
Zakładki zaplecza
Menu Marketplace grupuje: Sprzedawcy, Zamówienia sprzedawców, Prowizje i płatności, Faktury prowizyjne, Opinie, Spory i zwroty, Plany sprzedawcy, Analityka i Konfiguracja.
FAQ i rozwiązywanie problemów
Środki nie są uwalniane do sprzedawców
Sprawdź, czy „Status uwalniający escrow” jest zdefiniowany w konfiguracji i czy dani sprzedawcy zakończyli onboarding PSP (portfel utworzony).
Produkt sprzedawcy nie pojawia się w sklepie
Produkt pozostaje ukryty, dopóki nie zostanie zatwierdzony. Sprawdź jego status walidacji na liście produktów sprzedawcy albo włącz automatyczną walidację.
Po aktualizacji ekran administracyjny zwraca błąd
Wyczyść cache PrestaShop (folder var/cache) po instalacji lub aktualizacji, a następnie przeładuj zaplecze.