DataFirefly Marketplace — Guida completa
Installa, configura e gestisci il tuo marketplace multivenditore su PrestaShop 8 e 9.
Panoramica
DataFirefly Marketplace trasforma il tuo negozio PrestaShop in un marketplace multivenditore. Venditori terzi si registrano, pubblicano i propri prodotti e gestiscono i propri ordini, mentre tu orchestri commissioni, pagamenti e conformità dal back office.
Il modulo copre l’intero ciclo: registrazione e validazione dei venditori, area venditore completa, suddivisione reale degli ordini in sotto-ordini, motore di commissioni, pagamento suddiviso regolato (Mangopay e Stripe Connect), spedizione per venditore, conformità europea (DSA, P2B, IVA), recensioni, messaggistica, piani, controversie e analisi, tutto in cinque lingue (FR, EN, ES, DE, IT).
Compatibilità e requisiti
- PrestaShop 8.0, 8.1, 8.2 e 9.x
- PHP 8.1 o superiore
- Multinegozio e multilingua
- Per il pagamento suddiviso: un account Mangopay e/o Stripe Connect (chiavi sandbox per i test, chiavi di produzione per l’esercizio)
Installazione
- Nel back office, vai su Moduli > Gestore moduli, fai clic su Carica un modulo e seleziona l’archivio
dfmarketplace.zip. - L’installazione crea le tabelle necessarie, registra gli hook e aggiunge il menu Marketplace al back office, insieme a un set di dati dimostrativi (piani e regole di commissione).
- Apri Marketplace > Configurazione per configurare il modulo.
Alla disinstallazione, le tabelle dei dati vengono conservate di proposito per non perdere lo storico di venditori, ordini e commissioni.
Configurazione iniziale
In Marketplace > Configurazione, imposta i parametri principali:
- Commissione predefinita: tasso applicato quando non esiste una regola più specifica (15% per impostazione predefinita).
- Fornitore di pagamento predefinito: Mangopay o Stripe Connect, quindi le chiavi corrispondenti.
- Modalità ibrida: consente all’operatore di vendere i propri prodotti accanto ai venditori terzi.
- Fatturare gli ordini figli: genera una fattura dedicata per ogni sotto-ordine del venditore.
- Stato che libera l’escrow: stato dell’ordine che attiva il rilascio dei fondi ai portafogli dei venditori (ad esempio «Spedito» o «Consegnato»).
- Mostrare l’identità del venditore (DSA): attiva il blocco di identità del venditore professionale in vetrina.
- Prefisso della fattura di commissione e preavviso P2B (giorni).
- Approvazione automatica dei prodotti: se attivata, i prodotti dei venditori sono pubblicati senza moderazione.
Gestione dei venditori
Registrazione
Un cliente connesso può diventare venditore tramite la pagina di registrazione del modulo (collegata dal suo account). Indica il nome del negozio, la sua forma giuridica e i suoi dati legali. Viene inviata un’e-mail di conferma di ricezione.
Validazione e KYC
Da Marketplace > Venditori, l’operatore può approvare, sospendere o rifiutare un venditore. All’approvazione, viene attivato l’onboarding del PSP e viene inviata un’e-mail di validazione. Il venditore può caricare i suoi documenti KYC (visura, documento d’identità, coordinate bancarie) dalla sua dashboard.
In conformità al regolamento P2B, ogni sospensione è accompagnata da un’e-mail che informa il venditore, con una motivazione fornita separatamente.
Area venditore
Ogni venditore dispone di una dashboard compartimentata: accede solo ai propri dati.
- Dashboard: saldo del portafoglio, importo da liquidare, numero di prodotti, stato, ordini, libro mastro.
- Il mio profilo: logo, banner, presentazione, politiche di reso e di spedizione, recapiti pubblici e campi DSA.
- I miei prodotti: creazione e modifica di schede complete (foto, riferimento/SKU, EAN, stato, prezzo e IVA, quantità, categoria, peso e dimensioni, descrizioni).
- Spedizione: selezione dei corrieri proposti e regole di spese (per prezzo o peso, per zona, con soglia di gratuità).
Suddivisione degli ordini
Quando un ordine contiene prodotti di più venditori, il modulo lo suddivide in veri ordini figli (uno per venditore). Ogni sotto-ordine ha le proprie spese di spedizione, la propria commissione fissata, la propria fattura e il proprio accredito sul portafoglio. Il dettaglio logico è conservato per la tracciabilità, e la separazione tra venditori è rigorosa.
La fattura dell’ordine padre segue il flusso nativo di PrestaShop. Sulla tua versione, verifica che il modulo di pagamento non fissi una fattura padre per l’importo completo prima della suddivisione.
Commissioni
Il motore applica una cascata di regole, dalla più specifica alla più generale: prodotto › venditore › categoria › globale, con ripiego sulla commissione predefinita. Le regole possono essere in percentuale, a importo fisso o ibride, su base IVA inclusa o esclusa.
Sono supportati scaglioni di fatturato mensile: ad esempio, 15% fino a 5.000 € di fatturato mensile, poi 12% oltre. La commissione viene fissata al momento dell’ordine e mai ricalcolata.
Pagamento suddiviso, portafoglio ed escrow
Gli adattatori Mangopay e Stripe Connect incassano i fondi in modo suddiviso e li trattengono in escrow. Al raggiungimento dello stato dell’ordine configurato, i fondi vengono rilasciati ai portafogli dei venditori.
Liquidazioni
Il venditore richiede un prelievo dalla sua dashboard. L’operatore esegue le liquidazioni da Marketplace > Commissioni e pagamenti con un clic (bonifico SEPA tramite il PSP). Ogni movimento è registrato nel libro mastro del portafoglio.
Webhook
Configura l’URL del webhook del modulo sul lato PSP (controller webhook) per sincronizzare gli stati di pagamento. La firma viene verificata a ogni chiamata.
Spedizione per venditore
Ogni venditore definisce i propri corrieri e le proprie regole di spese. Al momento della spedizione, inserisce il corriere e il numero di tracciamento dalla sua dashboard: viene inviata un’e-mail all’acquirente e, quando tutti i sotto-ordini di un ordine sono stati spediti, l’ordine padre passa automaticamente allo stato «Spedito».
Conformità europea
- DSA: l’identità del venditore professionale (ragione sociale, numero di registrazione, IVA, punto di contatto) è mostrata nella sua vetrina.
- Fatture di commissione: generate automaticamente per periodo mensile, numerate e archiviate. L’operatore può avviare la generazione in massa da Marketplace > Fatture di commissione.
- P2B: una pagina pubblica le condizioni applicabili ai venditori, i parametri di posizionamento e il preavviso in caso di modifica.
- IVA «piattaforma considerata fornitore»: un indicatore per venditore è visualizzato e riportato sulla fattura di commissione.
Il modulo espone e mostra l’indicatore IVA, ma non incorpora un motore di ripartizione OSS. La ripartizione fine dell’IVA resta gestita dalla configurazione fiscale del tuo negozio.
Recensioni, messaggistica, piani, controversie e analisi
- Recensioni: gli acquirenti che hanno acquistato da un venditore possono lasciare una recensione, moderata da Marketplace > Recensioni. La valutazione media viene ricalcolata automaticamente.
- Messaggistica: conversazioni tra acquirente, venditore e operatore; casella di posta del venditore.
- Piani venditore: Free, Pro e Premium per impostazione predefinita, con quote di prodotti, tasso di commissione e accesso alle analisi. Gestiti da Marketplace > Piani venditore.
- Controversie e resi: aperti per sotto-ordine, risolti da Marketplace > Controversie e resi, con l’eventuale rimborso riportato sul portafoglio del venditore.
- Analisi: vista operatore (GMV, take rate, migliori venditori) in Marketplace > Analisi, e statistiche per venditore (in base al piano) nella sua dashboard.
Schede del back office
Il menu Marketplace raggruppa: Venditori, Ordini venditori, Commissioni e pagamenti, Fatture di commissione, Recensioni, Controversie e resi, Piani venditore, Analisi e Configurazione.
FAQ e risoluzione dei problemi
I fondi non vengono rilasciati ai venditori
Verifica che lo «Stato che libera l’escrow» sia impostato nella configurazione e che i venditori interessati abbiano completato l’onboarding del PSP (portafoglio creato).
Un prodotto del venditore non appare nel negozio
Un prodotto resta nascosto finché non viene approvato. Verifica il suo stato di validazione nell’elenco prodotti del venditore, oppure attiva l’approvazione automatica.
Dopo un aggiornamento, una schermata di amministrazione va in errore
Svuota la cache di PrestaShop (cartella var/cache) dopo l’installazione o l’aggiornamento, quindi ricarica il back office.