# DataFirefly Marketplace — Guida completa > Guida completa all'installazione, configurazione e utilizzo del modulo DataFirefly Marketplace per PrestaShop 8 e 9. - Pagina: - Lingua: it - Aggiornato il: 2026-06-27 - Altre lingue: [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), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-marketplace/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-marketplace/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-marketplace/index.md) - Indice: ## 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 1. Nel back office, vai su **Moduli > Gestore moduli**, fai clic su **Carica un modulo** e seleziona l'archivio `dfmarketplace.zip`. 2. 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). 3. 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.