# DataFirefly Marketplace: volledige gids > Overzicht DataFirefly Marketplace maakt van je PrestaShop-winkel een marktplaats met meerdere verkopers. Externe verkopers schrijven zich in, publiceren hun producten, maken hun bestellingen klaar, verzenden ze en beantwoorden hun klanten,… - Pagina: - Taal: nl - Bijgewerkt op: 2026-10-12 - Andere talen: [fr](https://www.datafirefly.com/documentation/datafirefly-marketplace/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-marketplace/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-marketplace/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-marketplace/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-marketplace/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-marketplace/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-marketplace/index.md) - Index: ## Overzicht DataFirefly Marketplace maakt van je PrestaShop-winkel een marktplaats met meerdere verkopers. Externe verkopers schrijven zich in, publiceren hun producten, maken hun bestellingen klaar, verzenden ze en beantwoorden hun klanten, terwijl jij vanuit de backoffice de commissies, de betalingen en de compliance beheert. De module dekt de hele cyclus: inschrijving en goedkeuring van verkopers, verkopersomgeving met tabbladen, echte opsplitsing van bestellingen in deelbestellingen, commissies, gesplitste betaling (Mangopay en Stripe Connect), levering per verkoper, opvolging van bestellingen voor de koper, berichten, Europese conformiteit (DSA, P2B, btw), beoordelingen, abonnementen, geschillen en statistieken. De interface en de e-mails zijn vertaald in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees. ## Compatibiliteit en vereisten - PrestaShop 8.0, 8.1, 8.2 en 9.x - PHP 8.1 of hoger - Multishop en meertalig - Voor de gesplitste betaling: een Mangopay- of Stripe Connect-account (sandboxsleutels om te testen, productiesleutels voor live gebruik) ## Installatie 1. Open in de backoffice **Modules > Modulebeheer**, klik op **Een module uploaden** en selecteer het archief `dfmarketplace.zip`. 2. De installatie maakt de tabellen aan, registreert de hooks, voegt het menu **DataFirefly Marketplace** toe aan de backoffice (labels in de taal van elke medewerker) en maakt drie demo-abonnementen aan: Free, Pro en Premium. 3. Open **DataFirefly Marketplace > Instellingen** om de module in te stellen. Bij het verwijderen van de module worden de gegevenstabellen bewust **bewaard**, zodat de geschiedenis van verkopers, bestellingen en commissies niet verloren gaat. ## Updaten vanaf een eerdere versie Upload het nieuwe archief in Modulebeheer en klik daarna op **Upgraden**. Je hoeft de module niet te verwijderen: het updatescript maakt ontbrekende tabellen aan, voegt nieuwe kolommen toe zonder gegevensverlies, registreert nieuwe hooks, voegt nieuwe instellingen toe, beveiligt de privémappen en leegt de Smarty- en Symfony-cache. Het werkt vanaf elke versie 1.0, 1.1, 1.2 of 1.3. De namen van de backofficemenu's worden bij de update omgezet naar de taal van elke medewerker. Een label dat je zelf hebt hernoemd, blijft behouden. ## Eerste configuratie Vul in **DataFirefly Marketplace > Instellingen** de belangrijkste parameters in: - **Standaardcommissie**: percentage dat geldt wanneer er geen specifiekere regel bestaat (standaard 15%). - **Standaard-PSP**: Mangopay of Stripe Connect, met de bijbehorende sleutels. - **Hybride modus**: de beheerder verkoopt ook eigen producten naast de externe verkopers. - **Deelbestellingen factureren**: voor elke deelbestelling van een verkoper wordt een eigen factuur aangemaakt. - **Status die de escrow vrijgeeft**: bestelstatus die de vrijgave van de gelden naar de wallets van de verkopers activeert (bijvoorbeeld "Verzonden" of "Geleverd"). - **Verkopersidentiteit tonen (DSA)**: toont het identiteitsblok van de professionele verkoper in zijn shop. - **Prefix commissiefactuur** en **P2B-termijn (dagen)**. - **Verkopers automatisch goedkeuren** en **Producten automatisch goedkeuren**: zonder moderatie worden accounts en producten gepubliceerd zodra ze zijn aangemaakt. - **Hoofdcategorie voor verkopers**: beperkt de categorieboom die verkopers in hun productformulier zien. Laat leeg om alle categorieën aan te bieden (de categorie "Root" wordt nooit aangeboden). ## Verkopersbeheer ### Inschrijving Een ingelogde klant wordt verkoper via de inschrijvingspagina van de module (link in zijn account en in het verkopersoverzicht). De pagina legt de stappen uit en toont de abonnementen met hun commissie. De toekomstige verkoper vult de naam van zijn shop, zijn status (particulier of professioneel), zijn juridische gegevens, zijn IBAN en zijn BIC in en gaat akkoord met de verkopersvoorwaarden. De controles gaan over de uniciteit van de shopnaam, de bedrijfsnaam (verplicht voor een professional), het controlegetal van de IBAN en het formaat van de BIC. Bij een fout blijven de ingevulde waarden behouden. Er wordt een ontvangstbevestiging per e-mail verstuurd. ### Goedkeuring en KYC Vanuit **DataFirefly Marketplace > Verkopers** kan de beheerder een verkoper **goedkeuren**, **opschorten** of **afwijzen**. Elke statuswijziging stuurt een e-mail naar de verkoper. Bij goedkeuring start de onboarding bij de betaaldienstverlener. De verkoper uploadt zijn KYC-documenten (uittreksel uit het handelsregister, identiteitsbewijs, bankgegevens) via het tabblad **Documenten** van zijn dashboard. In de verkopersfiche toont het KYC-paneel de documenten: je opent ze vanuit de backoffice en keurt de KYC daarna goed of af. KYC-documenten en commissiefacturen worden opgeslagen in mappen die niet via het web bereikbaar zijn, onder bestandsnamen die niet te raden zijn. Het werkelijke type van elk bestand wordt gecontroleerd en de grootte is beperkt tot 10 MB. Volgens de P2B-verordening gaat elke opschorting gepaard met een e-mail aan de verkoper, met een motivering die apart wordt meegedeeld. ## Verkopersomgeving De verkoper heeft alleen toegang tot zijn eigen gegevens. Zijn dashboard is ingedeeld in tabbladen. ### Overzicht - Checklist **Aan de slag**: goedkeuring van het account, logo en beschrijving, KYC, vervoerders, eerste product. De lijst verdwijnt zodra alles is afgerond. - Kerncijfers: te verwerken bestellingen, verkopen deze maand, walletsaldo, gemiddelde beoordeling. - Verkoopgrafiek over 6 maanden (alleen betaalde en niet-geannuleerde verkopen, afhankelijk van het abonnement van de verkoper). - Laatst ontvangen berichten. ### Bestellingen De lijst is te filteren op **Alle**, **Te verwerken**, **Verzonden** en **Afgerond**. Elke bestelling heeft een eigen pagina met de artikelen, het leveradres en het telefoonnummer, de vervoerder die de klant heeft gekozen, het bericht bij de bestelling, de totalen en het nettobedrag voor de verkoper na commissie. De verkoper brengt de bestelling stap voor stap verder: 1. **In behandeling nemen**: de bestelling gaat van "Te verwerken" naar "Wordt klaargemaakt". 2. **Verzending bevestigen**: hij kiest de vervoerder en vult het trackingnummer in. De trackinglink wordt opgebouwd op basis van de PrestaShop-vervoerder. Met de knop **Pakket toevoegen** registreert hij extra pakketten voor dezelfde bestelling. De klant krijgt bij elke verzending een e-mail. 3. **Markeren als geleverd** zodra het pakket is afgeleverd. De knop **Pakbon afdrukken** maakt een nette pagina zonder de elementen van de website, die je in het pakket kunt steken. ### Financiën Beschikbaar saldo, uitbetalingsverzoek (geblokkeerd als er al een verzoek loopt), geschiedenis van de uitbetalingen, downloadbare commissiefacturen en het transactieoverzicht van de wallet. ### Documenten Uploaden van de KYC-documenten en opvolging van hun status. ### Producten Het productformulier is ingedeeld in secties: informatie, prijs en btw, voorraad, categorieën (in boomstructuur), verzending (gewicht en afmetingen met hun eenheden), beschrijvingen en foto's. De hoofdfoto is gemarkeerd; een afgewezen foto wordt aangeduid met de reden. Invoerfouten (naam, prijs, EAN, afmetingen) worden boven het formulier getoond en de ingevulde waarden blijven behouden. De lijst toont de voorraad, de goedkeuringsstatus en een link naar de productpagina in de winkel. ### Profiel en levering - **Mijn verkopersprofiel** (tabblad Profiel): logo en banner met voorbeeld, beschrijving, verzend- en retourbeleid, openbare contactgegevens, DSA-velden, IBAN en BIC. - **Levering**: keuze van de aangeboden vervoerders en kostenregels per vervoerder, zone en schijf (prijs of gewicht), met een drempel voor gratis verzending. Elke regel wordt in gewone taal weergegeven. ## Kopersomgeving - **Productpagina**: het blok "Verkocht en verzonden door" toont het logo van de verkoper, zijn beoordeling en een link om hem vóór de aankoop een vraag te stellen. - **Standaard besteldetail**: het blok "Je verkopers voor deze bestelling" toont elke verkoper met de status van zijn deel. - **Mijn account > Mijn verkopers en berichten**: de deelbestellingen gegroepeerd per verkoper, met de status, het totaal en het aantal ongelezen berichten. - **Opvolgingspagina per verkoper**: stappen van de bestelling, pakketten met trackinglink, gesprek met de verkoper, een probleem melden of een retour aanvragen, de verkoper beoordelen. Redenen die de koper kan kiezen om een probleem te melden: Pakket niet ontvangen, Artikel beschadigd, Artikel komt niet overeen met de beschrijving, Verkeerd artikel ontvangen, Ik wil een artikel retourneren, Ander probleem. De verkoper krijgt een e-mail en de melding verschijnt in het gesprek. ## Berichten Elk gesprek koppelt een klant, een verkoper en eventueel een bestelling. De klant kan schrijven vóór de aankoop (vanaf de productpagina of de verkopersshop) of over een bestelling. De verkoper antwoordt vanuit zijn inbox; hij kan alleen schrijven naar een klant die bij hem heeft besteld of die al contact met hem heeft opgenomen. Elk nieuw bericht stuurt een e-mail naar de ontvanger. Om misbruik te voorkomen kan een klant maximaal 15 berichten per uur versturen. ## Opsplitsing van bestellingen Bevat een bestelling producten van meerdere verkopers, dan splitst de module ze op in echte **deelbestellingen**, één per verkoper. Elke deelbestelling heeft eigen verzendkosten, een vastgezette commissie, een eigen factuur en een bijschrijving op de wallet. Het logische detail wordt bewaard voor de traceerbaarheid en de scheiding tussen verkopers is strikt. De betaalstatus van de hoofdbestelling (betaling aanvaard, annulering, terugbetaling) wordt doorgezet naar de deelbestellingen. De verkoper krijgt de e-mail "Nieuwe bestelling" maar één keer, zodra de bestelling is betaald. De factuur van de hoofdbestelling volgt de standaardflow van PrestaShop. Controleer op jouw versie dat de betaalmodule geen hoofdfactuur voor het volledige bedrag vastlegt vóór de opsplitsing. ## Commissies De engine past een cascade van regels toe, van de meest specifieke naar de meest algemene: **product, verkoper, categorie, algemeen**, met terugval op de standaardcommissie. Een regel kan een percentage, een vast bedrag of een combinatie zijn, berekend op basis van bedragen incl. of excl. btw. **Staffels op maandomzet** worden ondersteund: bijvoorbeeld 15% tot 5.000 € maandomzet en 12% daarboven. De commissie wordt vastgezet op het moment van de bestelling en wordt nooit herberekend. ## Gesplitste betaling, wallet en escrow De adapters voor Mangopay en Stripe Connect innen de gelden gesplitst en houden ze in escrow. Zodra de bestelling de **ingestelde status** bereikt, worden de gelden vrijgegeven naar de wallets van de verkopers. ### Uitbetalingen De verkoper vraagt een uitbetaling aan via het tabblad Financiën. De beheerder voert de uitbetalingen met één klik uit vanuit **DataFirefly Marketplace > Commissies & uitbetalingen** (SEPA-overschrijving via de betaaldienstverlener). Elke transactie wordt vastgelegd in het transactieoverzicht van de wallet. ### Webhooks Registreer de webhook-URL van de module (controller `webhook`) bij je betaaldienstverlener om de betaalstatussen te synchroniseren. De handtekening wordt bij elke aanroep gecontroleerd. ## Levering per verkoper Elke verkoper bepaalt zijn vervoerders en zijn kostenregels. Zodra alle deelbestellingen van een bestelling zijn verzonden, gaat de hoofdbestelling automatisch naar de status "Verzonden", zonder de standaard-e-mail nog eens te versturen, want de klant heeft al een e-mail per pakket ontvangen. ## Verkopersshop en verkopersoverzicht Elke verkoper heeft een openbare shoppagina met banner, logo en beoordeling. De producten worden getoond met de productkaarten van je thema (foto, prijs in het lokale formaat, toevoegen aan winkelwagen), met sortering en paginering. Tabbladen tonen de shop, het verzendbeleid, het retourbeleid en de wettelijke DSA-gegevens. Beoordelingen tonen de auteur, de datum en de sterren. De shoppagina heeft een kruimelpad, een titel en een beschrijving voor zoekmachines en een canonieke URL. Het verkopersoverzicht toont de goedgekeurde verkopers met een zoekfunctie, het aantal producten, een stukje van hun beschrijving en een oproep om verkoper te worden. ## Europese conformiteit - **DSA**: de identiteit van de professionele verkoper (bedrijfsnaam, registratienummer, btw-nummer, contactpunt) wordt in zijn shop getoond. - **Commissiefacturen**: elke maand automatisch aangemaakt, genummerd en gearchiveerd. Start de bulkaanmaak vanuit **DataFirefly Marketplace > Commissiefacturen**; de knop **Bekijken** opent elke factuur. De verkoper downloadt ze via zijn tabblad Financiën. - **P2B**: een pagina publiceert de voorwaarden voor verkopers, de rangschikkingsparameters en de termijn bij wijzigingen. De verkoper gaat bij de inschrijving akkoord met deze voorwaarden. Wijzig je de voorwaarden, dan verwittigt de knop om het P2B-bericht te versturen, in de instellingen van de module, alle verkopers per e-mail. - **Btw "platform geacht leverancier te zijn"**: een indicator per verkoper wordt getoond en overgenomen op de commissiefactuur. De module toont de btw-indicator, maar bevat geen OSS-verdeelengine. De btw-verdeling blijft aangestuurd door de belastinginstellingen van je winkel. ## Beoordelingen, abonnementen, geschillen en statistieken - **Beoordelingen**: een koper die bij een verkoper heeft besteld, kan hem beoordelen via de verkopersshop of de opvolgingspagina. Beoordelingen worden gemodereerd in **DataFirefly Marketplace > Beoordelingen** en de gemiddelde score wordt automatisch herberekend. - **Verkopersabonnementen**: standaard Free, Pro en Premium, met een productquotum, een commissiepercentage en toegang tot statistieken. Beheerd in **DataFirefly Marketplace > Verkopersabonnementen**. - **Geschillen en retouren**: geopend door de koper op een deelbestelling, afgehandeld in **DataFirefly Marketplace > Geschillen & retouren**, met een eventuele terugbetaling die op de wallet van de verkoper wordt verrekend. - **Statistieken**: weergave voor de beheerder (omzetvolume, commissiepercentage, beste verkopers) in **DataFirefly Marketplace > Statistieken**, en statistieken voor de verkoper in zijn dashboard, afhankelijk van zijn abonnement. ## E-mails Er worden negen sjablonen in HTML en tekst meegeleverd: inschrijving ontvangen, verkoper goedgekeurd, aanvraag afgewezen, account opgeschort, wijziging van de voorwaarden (P2B), bestelling verzonden, nieuwe bestelling, nieuw bericht en geschil geopend. Elke e-mail wordt verstuurd in de taal van de ontvanger, onderwerp inbegrepen, met terugval op het Engels. Je kunt ze aanpassen in **Internationaal > Vertalingen > E-mailvertalingen** of rechtstreeks in de map `mails/` van de module. ## Talen en vertalingen De module wordt vertaald geleverd in het Frans, Engels, Spaans, Duits, Italiaans, Nederlands, Pools en Portugees: pagina's voor verkopers en kopers, fout- en bevestigingsmeldingen, backoffice en e-mails. Om een tekst aan te passen open je **Internationaal > Vertalingen**, kies je **Vertalingen van geïnstalleerde modules**, de module DataFirefly Marketplace en de taal. ## Backofficemenu's Het menu **DataFirefly Marketplace** bevat: Verkopers, Verkopersbestellingen, Commissies & uitbetalingen, Commissiefacturen, Beoordelingen, Geschillen & retouren, Verkopersabonnementen, Statistieken en Instellingen. ## FAQ en probleemoplossing ### De gelden worden niet vrijgegeven naar de verkopers Controleer of de "Status die de escrow vrijgeeft" in de instellingen is ingevuld en of de betrokken verkopers hun onboarding bij de betaaldienstverlener hebben afgerond (wallet aangemaakt). ### Een product van een verkoper verschijnt niet in de winkel Een product blijft verborgen zolang het niet is goedgekeurd. Controleer de status in de productlijst van de verkoper, of schakel het automatisch goedkeuren van producten in. ### De verkoper ontvangt de e-mail over een nieuwe bestelling niet De e-mail wordt verstuurd zodra de bestelling een betaalde status krijgt. Een bestelling die wacht op een overschrijving of cheque stuurt niets zolang de betaling niet is bevestigd. ### De formulierlabels zijn verkeerd uitgelijnd Sommige thema's lijnen alle labels rechts uit. De module zet ze op zijn eigen pagina's terug naar links; blijft de oude weergave staan, leeg dan de cache van PrestaShop en die van je browser. ### Na een update geeft een pagina een fout of is ze niet veranderd Leeg de cache via **Geavanceerde instellingen > Prestaties** (of de map `var/cache`) en herlaad daarna de pagina.