DataFirefly Marketplace: volledige gids

Overzicht

DataFirefly Marketplace verandert uw PrestaShop-winkel in een marktplaats met meerdere verkopers. Externe verkopers schrijven zich in, publiceren hun producten en beheren hun bestellingen, terwijl u vanuit de backoffice de commissies, de betalingen en de naleving orkestreert.

De module dekt de volledige cyclus: inschrijving en validatie van de verkopers, complete verkopersomgeving, echte opsplitsing van bestellingen in subbestellingen, commissiemotor, gereguleerde gesplitste betaling (Mangopay en Stripe Connect), levering per verkoper, Europese naleving (DSA, P2B, btw), reviews, berichten, abonnementen, geschillen en analytics, alles in vijf talen (FR, EN, ES, DE, IT).

Compatibiliteit en vereisten

• PrestaShop 8.0, 8.1, 8.2 en 9.x
• PHP 8.1 of hoger
• Multistore en meertalig
• Voor de gesplitste betaling: een Mangopay- en/of Stripe Connect-account (sandboxsleutels voor de tests, productiesleutels voor de exploitatie)

Installatie

1. Ga in de backoffice naar Modules > Modulebeheer, klik op Een module uploaden en selecteer het archief dfmarketplace.zip.
2. De installatie maakt de nodige tabellen aan, registreert de hooks en voegt het menu Marketplace toe aan de backoffice, plus een set demogegevens (abonnementen en commissieregels).
3. Open Marketplace > Configuratie om de module in te stellen.

Initiële configuratie

Vul in Marketplace > Configuratie de hoofdparameters in:

• Standaardcommissie: tarief dat wordt toegepast wanneer er geen specifiekere regel bestaat (standaard 15%).
• Standaard betaalprovider: Mangopay of Stripe Connect, plus de bijbehorende sleutels.
• Hybride modus: laat de operator toe zijn eigen producten naast die van de externe verkopers te verkopen.
• Subbestellingen factureren: genereert een eigen factuur voor elke verkoper-subbestelling.
• Status die de escrow vrijgeeft: bestelstatus die de vrijgave van de fondsen naar de verkopersportefeuilles activeert (bijvoorbeeld “Verzonden” of “Geleverd”).
• Verkopersidentiteit tonen (DSA): activeert het identiteitsblok van de professionele verkoper op de etalage.
• Voorvoegsel van de commissiefactuur en P2B-opzegtermijn (dagen).
• Automatische productvalidatie: indien ingeschakeld worden verkopersproducten zonder moderatie gepubliceerd.

Verkopersbeheer

Inschrijving

Een ingelogde klant kan verkoper worden via de inschrijvingspagina van de module (link vanuit zijn account). Hij vult de winkelnaam, zijn rechtsvorm en zijn juridische gegevens in. Er wordt hem een ontvangstbevestiging per e-mail gestuurd.

Validatie en KYC

Vanuit Marketplace > Verkopers kan de operator een verkoper goedkeuren, schorsen of afwijzen. Bij goedkeuring wordt de PSP-onboarding gestart en een validatiemail verzonden. De verkoper kan zijn KYC-documenten (uittreksel handelsregister, identiteitsbewijs, bankgegevens) uploaden vanuit zijn dashboard.

Verkopersomgeving

De verkoper beschikt over een afgeschermd dashboard: hij heeft alleen toegang tot zijn eigen gegevens.

• Dashboard: portefeuillesaldo, uit te keren bedrag, aantal producten, status, bestellingen, grootboek.
• Mijn profiel: logo, banner, presentatie, retour- en leveringsbeleid, publieke contactgegevens en DSA-velden.
• Mijn producten: aanmaken en bewerken van volledige productpagina’s (foto’s, referentie/SKU, EAN, staat, prijs en btw, aantal, categorie, gewicht en afmetingen, beschrijvingen).
• Levering: selectie van de aangeboden vervoerders en kostenregels (op prijs of gewicht, per zone, met gratisdrempel).

Opsplitsing van bestellingen

Bevat een bestelling producten van meerdere verkopers, dan splitst de module ze op in echte subbestellingen (één per verkoper). Elke subbestelling heeft haar eigen verzendkosten, haar bevroren commissie, haar factuur en haar portefeuillecreditering. Het logische detail wordt bewaard voor de traceerbaarheid, en de afscherming tussen verkopers is strikt.

Commissies

De motor past een cascade van regels toe, van de meest specifieke naar de meest algemene: product › verkoper › categorie › globaal, met terugval op de standaardcommissie. De regels kunnen procentueel, als vast bedrag of hybride zijn, op basis incl. of excl. btw.

Schijven op maandomzet worden ondersteund: bijvoorbeeld 15% tot € 5.000 maandomzet, daarna 12% daarboven. De commissie wordt op het moment van de bestelling bevroren en nooit herberekend.

Gesplitste betaling, portefeuille en escrow

De Mangopay- en Stripe Connect-adapters innen de fondsen gesplitst en houden ze in escrow. Bij het bereiken van de geconfigureerde bestelstatus worden de fondsen vrijgegeven naar de verkopersportefeuilles.

Uitbetalingen

De verkoper vraagt een opname aan vanuit zijn dashboard. De operator voert de uitbetalingen met één klik uit vanuit Marketplace > Commissies & betalingen (SEPA-overschrijving via de PSP). Elke beweging wordt getraceerd in het grootboek van de portefeuille.

Webhooks

Configureer de webhook-URL van de module aan PSP-zijde (controller webhook) om de betaalstatussen te synchroniseren. De handtekening wordt bij elke aanroep geverifieerd.

Levering per verkoper

Elke verkoper bepaalt zijn vervoerders en zijn kostenregels. Bij de verzending voert hij vanuit zijn dashboard de vervoerder en het trackingnummer in: er wordt een e-mail naar de koper gestuurd, en zodra alle subbestellingen van een bestelling zijn verzonden, gaat de hoofdbestelling automatisch naar de status “Verzonden”.

Europese naleving

• DSA: de identiteit van de professionele verkoper (bedrijfsnaam, registratienummer, btw, contactpunt) wordt op zijn etalage getoond.
• Commissiefacturen: automatisch per maandperiode gegenereerd, genummerd en gearchiveerd. De operator kan de bulkgeneratie starten vanuit Marketplace > Commissiefacturen.
• P2B: een pagina publiceert de voorwaarden voor de verkopers, de rangschikkingsparameters en de opzegtermijn bij wijziging.
• Btw “platform als fictieve leverancier”: een indicator per verkoper wordt getoond en overgenomen op de commissiefactuur.

Reviews, berichten, abonnementen, geschillen en analytics

• Reviews: kopers die bij een verkoper hebben besteld, kunnen een review achterlaten, gemodereerd vanuit Marketplace > Reviews. De gemiddelde score wordt automatisch herberekend.
• Berichten: conversaties tussen koper, verkoper en operator; inbox aan verkoperszijde.
• Verkopersabonnementen: standaard Free, Pro en Premium, met productquota, commissietarieven en analytics-toegang. Beheerd vanuit Marketplace > Verkopersabonnementen.
• Geschillen en retouren: geopend per subbestelling, opgelost vanuit Marketplace > Geschillen & retouren, met eventuele terugbetaling doorberekend op de portefeuille van de verkoper.
• Analytics: operatorweergave (GMV, commissietarief, beste verkopers) in Marketplace > Analytics, en statistieken per verkoper (afhankelijk van het abonnement) in zijn dashboard.

Backoffice-tabbladen

Het menu Marketplace bundelt: Verkopers, Verkopersbestellingen, Commissies & betalingen, Commissiefacturen, Reviews, Geschillen & retouren, Verkopersabonnementen, Analytics en Configuratie.

FAQ en probleemoplossing

De fondsen worden niet vrijgegeven naar de verkopers

Controleer of de “Status die de escrow vrijgeeft” in de configuratie is ingesteld en of de betrokken verkopers hun PSP-onboarding hebben afgerond (portefeuille aangemaakt).

Een verkopersproduct verschijnt niet in de winkel

Een product blijft verborgen zolang het niet is goedgekeurd. Controleer de validatiestatus in de productlijst van de verkoper, of schakel de automatische validatie in.

Na een update geeft een beheerscherm een fout

Leeg de PrestaShop-cache (map var/cache) na de installatie of update en herlaad daarna de backoffice.