Module UltimateMarketPlace IT

Modulo UltimateMarketPlace

Presentazione

Il modulo UltimateMarketPlace è un'estensione per Dolibarr ERP/CRM pubblicata da Atoo-Net.

Fornisce tutte le funzionalità necessarie per pubblicare un marketplace online monofornitore: un modello di sito web pronto all'uso (catalogo prodotti, carrello, processo d'ordine, account cliente), utilizzabile con il modulo Sito Web di Dolibarr, per vendere direttamente online i propri prodotti e servizi.

Si tratta di un fork semplificato del modulo Dolibarr «Marketplace» (utilizzato per dolistore.com), da cui è stato rimosso tutto ciò che è specifico dell'associazione Dolibarr, così come il circuito multifornitore di invio e revisione dei moduli da parte di sviluppatori esterni.

Proprietà	Valore
Autore	Philippe Grand — Atoo-Net
Versione	1.0
Licenza	GNU GPL v3+
Dolibarr minimo	v24.0
PHP minimo	v8.0

Perché usare UltimateMarketPlace?

UltimateMarketPlace trasforma la vostra installazione Dolibarr in un negozio online autonomo, senza dipendere da un CMS né da una piattaforma di e-commerce di terze parti (come PrestaShop, WooCommerce…). Il catalogo, gli ordini, le fatture e i clienti restano nativamente in Dolibarr.

Casi d'uso

Vendita di prodotti fisici o dematerializzati

Pubblicate il vostro catalogo di prodotti o servizi direttamente dalle schede prodotto di Dolibarr. Il modulo gestisce sia i beni fisici (con spese di spedizione) sia gli articoli dematerializzati (download, licenze, servizi).

Fidelizzazione dei clienti professionali

Grazie agli sconti automatici per i «clienti preferenziali» (categoria di terzi dedicata), offrite una tariffa preferenziale negoziata ai vostri migliori clienti, con la possibilità di escludere determinati prodotti dallo sconto.

Promozioni commerciali e codici sconto

Create codici sconto (percentuale o importo fisso), limitati nel tempo o nel numero di utilizzi, eventualmente riservati a un prodotto specifico, per dinamizzare le vostre vendite online.

Vendita aggiuntiva (upsell) nel carrello

Proponete automaticamente un prodotto complementare nel carrello (es. assicurazione, garanzia, ecotassa), calcolato come percentuale del totale e limitato ai paesi che scegliete.

Pagamento online

Collegate il processo d'acquisto ai metodi di pagamento già configurati in Dolibarr (Stripe, PayPal, bonifico…), tramite reindirizzamento classico al vostro back-office oppure integrato in un frame all'interno del negozio.

Monitoraggio del traffico

Integrate Matomo Analytics per monitorare l'affluenza e il comportamento d'acquisto nel vostro negozio, senza dipendere da Google Analytics.

Installazione

Prerequisiti: il modulo richiede che i seguenti moduli Dolibarr siano attivati (si attivano automaticamente se necessario): Terzi, Prodotti, Servizi, Categorie, Ordini, Fatture, Banca, Mailing e Sito Web.

Scaricare il modulo da DoliStore oppure clonare il repository Git in htdocs/custom/ultimatemarketplace
Andare su Home → Configurazione → Moduli/Applicazioni
Individuare UltimateMarketPlace nella sezione AtooNet
Attivare il modulo cliccando sul pulsante nella colonna Attivato

Attivazione del modulo UltimateMarketPlace nella sezione AtooNet

All'attivazione, il modulo esegue automaticamente diverse azioni:

Creazione di un sito web dedicato (riferimento ultimatemarketplace) con il modello "website_template-ultimatemarketplace" importato
Creazione di una categoria radice di prodotti per gli articoli visibili nel marketplace
Creazione di una categoria di terzi per i clienti/prospect creati dal sito di vendita
Aggiunta di 3 campi aggiuntivi prodotto: separatore "Marketplace", commento dopo il prezzo (PriceComment) e messaggio di avviso pubblico (DisclaimerMessage)

Configurazione

La configurazione del modulo si effettua in Home → Configurazione → Moduli/Applicazioni → UltimateMarketPlace, suddivisa in diverse schede.

Generale: prodotti e terzi

Costante	Descrizione
`ULTIMATEMARKETPLACE_NAME`	Nome del marketplace
`ULTIMATEMARKETPLACE_EMAIL`	Email di contatto del marketplace
`ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID`	Categoria radice dei prodotti venduti nel marketplace
`ULTIMATEMARKETPLACE_ROOT_CATEGORY_ID_BIS`	Categoria in evidenza nel blocco centrale della homepage
`ULTIMATEMARKETPLACE_VERSIONS_CATEGORY_ID`	Categoria utilizzata dal widget "Versione" della homepage
`ULTIMATEMARKETPLACE_SPECIAL_CATEGORY_ID`	Categoria utilizzata dal widget "Promozioni" della homepage
`ULTIMATEMARKETPLACE_MIN_PRODUCT_PRICE`	Prezzo minimo di un prodotto (se non è gratuito)
`ULTIMATEMARKETPLACE_DELAY_FOR_NEW`	Anzianità massima (in giorni) affinché un prodotto appaia nella sezione "Novità"
`ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_ID`	Categoria assegnata a tutti i prospect/clienti creati dal sito di vendita

Sconti per clienti preferenziali

Costante	Descrizione
`ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_ID`	Categoria di terzi etichettati come "Preferenziale", idonei allo sconto
`ULTIMATEMARKETPLACE_PROSPECTCUSTOMER_PREFERRED_DISCOUNT`	Percentuale di sconto applicata a questi terzi
`ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID`	Categoria di prodotti esclusi da questo sconto

Sito Web

Costante	Descrizione
`ULTIMATEMARKETPLACE_URL_FOR_LOGO`	URL del logo del marketplace
`ULTIMATEMARKETPLACE_THEME_COLOR`	Colore principale del tema (pulsanti, banner, elementi in evidenza)
`ULTIMATEMARKETPLACE_WEBSITE_ID`	Sito Web di Dolibarr utilizzato dal marketplace
`ULTIMATEMARKETPLACE_USER_MANAGE_WEBSITE`	Utente tecnico autorizzato a eseguire le azioni del sito (aggiungere prodotti, gestire terzi, creare ordini)

Importante: se cambiate il sito web associato (ULTIMATEMARKETPLACE_WEBSITE_ID), gli utenti, i terzi e gli ordini già creati restano collegati al vecchio sito e non vengono migrati automaticamente.

Modelli email

Si possono personalizzare tre modelli email di Dolibarr:

Email di benvenuto inviata alla creazione dell'account cliente
Email "password dimenticata"
Email di conferma ordine inviata all'acquirente

Prodotto aggiuntivo nel carrello

Permette di aggiungere automaticamente un prodotto complementare (assicurazione, garanzia, ecotassa…) al carrello:

Costante	Descrizione
`ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_IN_CART_ID`	Prodotto aggiuntivo da aggiungere
`ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_TOTAL_PERCENT`	Prezzo del prodotto aggiuntivo, espresso in % del totale del carrello
`ULTIMATEMARKETPLACE_ADDITIONAL_PRODUCT_APPLICABLE_COUNTRIES`	Codici paese in cui si applica questo prodotto aggiuntivo

Spese di spedizione

Costante	Descrizione
`ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT` / `ULTIMATEMARKETPLACE_SHIPPING_FEES_PRODUCT_ID`	Prodotto Dolibarr utilizzato per fatturare le spese di spedizione

Registrazione: Google reCAPTCHA

Costante	Descrizione
`ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_REGISTER_FORM`	Attiva il Captcha di Google nel modulo di registrazione
`ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SITE_KEY`	Chiave pubblica reCAPTCHA fornita da Google
`ULTIMATEMARKETPLACE_GOOGLE_RECAPTCHA_SECRET_KEY`	Chiave privata reCAPTCHA (da mantenere riservata)

Pagamento

Costante	Descrizione
`ULTIMATEMARKETPLACE_BLOCK_SALES`	Blocca temporaneamente le vendite nel marketplace
`ULTIMATEMARKETPLACE_CLOSE_ORDER_AFTER_PAYMENT`	Chiude automaticamente l'ordine dopo un pagamento riuscito
`ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD`	Metodo di pagamento da utilizzare

Esistono due modalità possibili di integrazione del pagamento:

Pagina separata (predefinita): senza configurazione particolare, il cliente viene reindirizzato alle pagine di pagamento pubbliche del vostro back-office Dolibarr. Svantaggio: il dominio del back-office è visibile al cliente.
Frame (utenti avanzati): la pagina di pagamento del back-office viene richiamata tramite un URL del negozio del marketplace stesso. Richiede una configurazione proxy sul server web del marketplace per reindirizzare le richieste verso il back-office Dolibarr. Vantaggio: il dominio del back-office resta nascosto.

API

Costante	Descrizione
`ULTIMATEMARKETPLACE_PUBLIC_API_KEY`	Chiave pubblica utilizzata per accedere all'API di prodotti/categorie

L'API espone un flusso XML dei prodotti e delle categorie, con i parametri categorieid, limit, page, search e lang. È possibile configurare un instradamento proxy per nascondere l'URL reale dell'API dietro al dominio del negozio.

Matomo

Costante	Descrizione
`ULTIMATEMARKETPLACE_ENABLE_MATOMO`	Attiva Matomo Analytics sul sito del marketplace
`ULTIMATEMARKETPLACE_MATOMO_SITE_KEY`	Identificativo di sito (Site ID) di Matomo
`ULTIMATEMARKETPLACE_MATOMO_SERVER_URL`	URL completo del server Matomo

Codici sconto (coupon)

Una scheda dedicata Codici sconto consente di creare codici sconto:

Tipo di sconto: percentuale o importo fisso al netto delle imposte
Numero massimo di utilizzi (lasciare vuoto per utilizzo illimitato)
Possibile restrizione a un prodotto specifico
Monitoraggio del numero di utilizzi già effettuati

Scheda di amministrazione dei codici sconto

Il codice viene verificato al momento dell'applicazione nel carrello: un codice inesistente, scaduto o già completamente utilizzato viene rifiutato (messaggio "Questo codice sconto non è valido, è scaduto o è già stato utilizzato").

Utilizzo

Negozio online (front office)

Il sito generato dal modulo riprende l'identità visiva definita nella configurazione (logo, colore principale) e offre:

Un catalogo prodotti organizzato per categorie, con evidenziazione di novità e promozioni
Una scheda prodotto con prezzo, commento libero dopo il prezzo e messaggio di avviso pubblico se configurati
Un carrello con applicazione del codice sconto, calcolo automatico degli sconti "cliente preferenziale" e aggiunta dell'eventuale prodotto aggiuntivo
Un processo d'ordine collegato ai metodi di pagamento configurati in Dolibarr
Un'area cliente (registrazione, accesso, storico ordini) protetta da Google reCAPTCHA se attivato

Homepage del negozio generata da UltimateMarketPlace

Gestione delle etichette prodotto

Il menu UltimateMarketPlace → Prodotti senza etichette elenca i prodotti/servizi del marketplace non ancora associati a una categoria/etichetta, per applicare in massa una o più etichette (categorie).

Statistiche

Il modulo aggiunge pagine di statistiche dedicate al marketplace:

Statistiche di fatture e vendite (raggruppamento per paese/aliquota IVA o per zona/aliquota IVA)
Statistiche clienti (ultimi terzi creati, ultimi terzi "preferenziali")
Statistiche prodotti/servizi (classifica per popolarità)

Monitoraggio ordini e fatture

Due voci di menu permettono di individuare rapidamente gli ordini e le fatture provenienti dal marketplace (filtrati per module_source = ultimatemarketplace).

FAQ

Il sito del marketplace non è stato creato automaticamente

Verificate che il modulo Sito Web di Dolibarr sia attivato. Se il sito continua a non esistere dopo l'attivazione del modulo, disattivate e riattivate UltimateMarketPlace.

Come cambio il sito web utilizzato senza perdere gli ordini esistenti?

Non è consigliato: modificare ULTIMATEMARKETPLACE_WEBSITE_ID non migra gli utenti, i terzi e gli ordini già creati verso il nuovo sito. Restano associati al sito precedente.

Posso limitare lo sconto "cliente preferenziale" solo ad alcuni prodotti?

Sì, configurando ULTIMATEMARKETPLACE_DISCOUNT_EXCLUDE_PRODUCTS_CATEGORY_ID con una categoria che raggruppa i prodotti da escludere dallo sconto.

Il pagamento in frame è obbligatorio?

No, è un'opzione per utenti avanzati. Per impostazione predefinita, il pagamento reindirizza semplicemente alle pagine di pagamento pubbliche del vostro back-office Dolibarr, senza alcuna configurazione server particolare.

Quali metodi di pagamento sono compatibili?

Tutti i metodi di pagamento già supportati nativamente da Dolibarr (Stripe, PayPal, bonifico, ecc.), selezionati tramite ULTIMATEMARKETPLACE_MAIN_PAYMENT_METHOD.