psimport

📌 Versione del modulo: 1.0.0 📅 Ultimo aggiornamento: 13/07/2026 👤 Editore/Licenza: Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Lingue dell'interfaccia: 📧 Supporto: tramite e-mail all'indirizzo contact@atoo-net.com ✅ Compatibilità Dolibarr: Dolibarr 24.0 o superiore ✅ Compatibilità PrestaShop: PrestaShop dalla versione 1.6 alla 9.x ✅ Versione PHP richiesta: PHP 8.1 o superiore 💡 Aggiornamenti gratuiti per un anno per la stessa versione, quindi sconto del 50% sulla versione successiva.

Migra i dati del tuo negozio PrestaShop verso Dolibarr con psimport

Il modulo psimport fornisce un insieme completo di strumenti di migrazione che consentono di trasferire i dati di un negozio PrestaShop esistente verso Dolibarr ERP/CRM.

Permette di recuperare e importare categorie, clienti, indirizzi, prodotti, immagini dei prodotti, file scaricabili e ordini.

La migrazione utilizza l'API REST Webservice standard di PrestaShop. Normalmente non è necessario alcun accesso diretto al database MySQL di PrestaShop.

Invece di creare immediatamente i record in Dolibarr, psimport memorizza prima le informazioni recuperate in tabelle intermedie di staging. Ciò permette di controllare i dati, individuare gli errori e correggere eventuali problemi prima di eseguire l'importazione definitiva.

Il meccanismo di staging permette inoltre di riavviare soltanto le importazioni non riuscite, senza dover scaricare nuovamente tutti i dati da PrestaShop.

🔄 Dati che possono essere migrati

🧩 Un processo di migrazione sicuro in due fasi

Ogni operazione di migrazione è suddivisa in due fasi distinte:

1. Recupero: i dati vengono recuperati da PrestaShop tramite l'API Webservice e quindi memorizzati nelle tabelle di staging di psimport.

2. Importazione: i record di staging controllati e convalidati vengono convertiti in oggetti Dolibarr.

Questa separazione offre un controllo migliore rispetto a una migrazione diretta, poiché consente di verificare i dati recuperati prima che vengano apportate modifiche al database Dolibarr.

🗃️ Tabelle intermedie di staging

psimport utilizza tabelle dedicate i cui nomi iniziano con:

llx_psimport_*

Queste tabelle memorizzano le informazioni recuperate da PrestaShop prima della loro importazione definitiva in Dolibarr.

Per ogni risorsa, il modulo visualizza:

📊 Interfaccia di gestione delle importazioni

La scheda Gestione dell'importazione fornisce una vista centralizzata di tutte le operazioni di migrazione.

Da questa interfaccia è possibile:

• Recuperare i dati da PrestaShop utilizzando l'azione Fetch

• Importare i dati di staging in Dolibarr utilizzando l'azione Importa

• Visualizzare il numero di record in attesa, importati correttamente o in errore

• Reimpostare i record in errore affinché vengano elaborati nuovamente soltanto quelli

• Svuotare una tabella di staging prima di effettuare un nuovo test di migrazione

• Consultare la data dell'ultimo recupero dei dati

🔁 Riavviare soltanto le importazioni in errore

Ogni record di staging possiede uno stato di importazione:

Dopo aver corretto la causa di un errore, utilizzare l'azione Reimposta errori per riportare le righe interessate allo stato in attesa.

È quindi possibile riavviare l'importazione corrispondente. I record già importati correttamente non vengono elaborati una seconda volta.

In questo modo non è necessario ricominciare l'intera migrazione a causa di un numero limitato di record non validi o incompleti.

📦 Migrazione di prodotti e servizi

psimport importa i prodotti PrestaShop in Dolibarr insieme alle loro principali informazioni commerciali e fiscali.

La migrazione dei prodotti comprende:

• Il riferimento del prodotto

• Il nome e la descrizione del prodotto

• I prezzi al netto e al lordo dell'IVA

• La determinazione dell'aliquota IVA tramite i gruppi di regole fiscali di PrestaShop

• L'associazione con le categorie importate

• L'immagine principale del prodotto

• La galleria completa delle immagini del prodotto

• I file scaricabili associati ai prodotti virtuali

Il tipo di oggetto di destinazione in Dolibarr può essere selezionato nella configurazione del modulo.

Per moduli software, licenze, documenti e altri elementi digitali, si consiglia di importare i prodotti PrestaShop come servizi Dolibarr.

🧾 Determinazione delle aliquote IVA

PrestaShop non espone sempre direttamente la percentuale IVA finale nella risorsa prodotto.

psimport determina l'aliquota applicabile leggendo la configurazione fiscale di PrestaShop tramite le seguenti risorse Webservice:

• tax_rule_groups

• tax_rules

• taxes

Ciò consente di trasferire in modo più preciso i prezzi dei prodotti e le aliquote IVA verso Dolibarr.

I risultati relativi all'IVA devono tuttavia essere verificati nei dati di staging e su un campione di schede prodotto Dolibarr prima di importare l'intero catalogo.

🖼️ Immagini principali e gallerie complete dei prodotti

psimport può recuperare sia l'immagine principale sia la galleria completa associata a ciascun prodotto PrestaShop.

La galleria viene recuperata tramite l'endpoint delle immagini dei prodotti PrestaShop e memorizzata in una tabella di staging dedicata prima di essere importata in Dolibarr.

Il modulo:

• Recupera tutte le immagini associate a ciascun prodotto

• Mantiene, quando possibile, l'ordine delle immagini restituito da PrestaShop

• Rileva e ignora i duplicati esatti tra l'immagine principale e la galleria

• Segnala le immagini che non è stato possibile scaricare o importare

Poiché la risposta esatta dell'API può variare a seconda della versione di PrestaShop, si consiglia di eseguire un primo test su un numero limitato di prodotti prima di importare l'intero catalogo.

📥 File scaricabili dei prodotti virtuali

L'API Webservice standard di PrestaShop non espone i file scaricabili associati ai prodotti virtuali.

Per aggirare questa limitazione, psimport include il modulo PrestaShop opzionale Psimport Bridge.

Una volta installato sul negozio di origine, il bridge permette a psimport di recuperare i file già registrati nella tabella PrestaShop dei download dei prodotti.

Il bridge:

• Utilizza la stessa chiave API Webservice PrestaShop di psimport

• Funziona in modalità di sola lettura

• Non modifica il database PrestaShop

• Non modifica i file memorizzati sul server PrestaShop

• Consente l'accesso esclusivamente ai file già registrati come file prodotto scaricabili

• Può essere rimosso al termine della migrazione

È inoltre possibile effettuare una migrazione manuale alternativa esportando la tabella dei download dei prodotti PrestaShop e copiando la directory di download del negozio di origine.

👥 Migrazione di clienti e indirizzi

psimport recupera i clienti e i relativi indirizzi da PrestaShop prima di creare i soggetti terzi corrispondenti in Dolibarr.

La migrazione può includere:

• L'identità del cliente

• Il nome dell'azienda, quando disponibile

• L'indirizzo e-mail

• I numeri di telefono

• L'indirizzo postale

• Il codice postale e la città

• Le informazioni relative al Paese

• Gli indirizzi di consegna e fatturazione associati

I clienti e gli indirizzi vengono gestiti insieme per preservare la relazione tra ogni cliente e le relative informazioni di indirizzo.

🛒 Migrazione degli ordini

psimport può recuperare e importare gli ordini dei clienti PrestaShop e le relative righe.

La migrazione degli ordini comprende:

• Il riferimento dell'ordine PrestaShop

• Il cliente associato

• La data dell'ordine

• I prodotti e i servizi ordinati

• Le quantità e i prezzi unitari

• Le aliquote IVA

• I totali dell'ordine

• La corrispondenza dei metodi di pagamento

• Il filtraggio in base agli stati degli ordini PrestaShop selezionati

Prima di importare gli ordini, gli identificativi degli stati ordine PrestaShop accettati e le corrispondenze dei metodi di pagamento devono essere verificati in base alla configurazione del negozio di origine.

I prodotti e i clienti devono essere importati prima degli ordini, affinché le righe degli ordini possano essere associate agli oggetti Dolibarr corretti.

📋 Ordine di migrazione consigliato

Per preservare le relazioni tra gli oggetti importati, si consiglia il seguente ordine di esecuzione:

1. Categorie

2. Clienti e indirizzi

3. Prodotti o servizi

4. File scaricabili dei prodotti

5. Gallerie complete delle immagini dei prodotti

6. Ordini e righe degli ordini

Ogni fase deve essere verificata prima di passare alla successiva.

🔍 Controlli consigliati dopo ogni fase

• Confrontare il numero di record in PrestaShop, nelle tabelle di staging e in Dolibarr

• Esaminare i record di staging in attesa e in errore

• Controllare la gerarchia delle categorie importate

• Verificare i nomi, gli indirizzi e-mail e gli indirizzi postali dei clienti

• Controllare i riferimenti, le descrizioni e le associazioni alle categorie dei prodotti

• Verificare i prezzi al netto dell'IVA, i prezzi comprensivi di IVA e le aliquote IVA

• Aprire un campione di immagini dei prodotti e di file scaricabili

• Controllare le associazioni tra clienti e prodotti negli ordini importati

• Confrontare le righe e i totali degli ordini tra PrestaShop e Dolibarr

⚙️ Prerequisiti lato PrestaShop

Il Webservice PrestaShop deve essere attivato da:

Parametri avanzati → Webservice → Attiva il servizio web di PrestaShop

Deve quindi essere creata una chiave API Webservice con diritti di lettura sulle risorse necessarie:

categories, customers, addresses, countries, products, images, tax_rule_groups, tax_rules, taxes, orders, order_details

Sono necessari esclusivamente i permessi GET, poiché psimport legge i dati da PrestaShop e non scrive alcun dato nel negozio di origine.

⚙️ Prerequisiti lato Dolibarr

I seguenti moduli standard Dolibarr devono essere attivati prima di avviare la migrazione:

L'attivazione di psimport crea automaticamente le tabelle di staging necessarie. Durante un'installazione standard non è richiesta alcuna importazione SQL manuale.

🔑 Configurazione della connessione API

La connessione viene configurata dalla pagina delle impostazioni del modulo psimport in Dolibarr.

È disponibile un test di connessione per verificare l'URL dell'API e la chiave Webservice prima di avviare la migrazione.

🛡️ Protezione del negozio di origine

psimport è progettato per leggere le informazioni da PrestaShop senza modificare il negozio di origine.

• La chiave Webservice PrestaShop richiede esclusivamente permessi GET

• La migrazione scrive i dati esclusivamente nel database e nelle directory dei documenti Dolibarr

• Il modulo opzionale Psimport Bridge funziona in modalità di sola lettura

• Il bridge espone esclusivamente i file scaricabili già registrati in PrestaShop

• Nessun ordine, cliente o prodotto viene modificato in PrestaShop

Prima di qualsiasi operazione di migrazione è tuttavia fortemente consigliato eseguire un backup completo di entrambe le applicazioni e dei relativi documenti.

☁️ Risoluzione dei problemi Cloudflare ed errori HTTP 403

Se la connessione all'API funziona in un browser, ma psimport riceve una risposta HTTP 403 Forbidden con un corpo vuoto, la richiesta potrebbe essere bloccata da un firewall o da un servizio di protezione contro i bot prima di raggiungere PrestaShop.

Questo problema può verificarsi in particolare quando il negozio di origine è protetto da Cloudflare Bot Fight Mode, ModSecurity o un altro Web Application Firewall.

Per Cloudflare, consultare:

Sicurezza → Analisi → Eventi

Se la richiesta viene visualizzata come una verifica gestita generata da Bot Fight Mode, disattivare temporaneamente la protezione durante la migrazione oppure creare una regola di esclusione adeguata, se il piano Cloudflare utilizzato lo consente.

La protezione di sicurezza può essere riattivata dopo la migrazione.

🧪 Iniziare con un test su un campione limitato

Prima di avviare una migrazione completa, si consiglia vivamente di testare ogni risorsa con un limite ridotto di record.

Ciò permette di:

• Convalidare la connessione all'API

• Controllare la struttura dei dati recuperati

• Confermare la determinazione delle aliquote IVA

• Verificare la corrispondenza di prodotti e clienti

• Controllare i permessi di download delle immagini e dei file

• Confermare le corrispondenze degli stati degli ordini e dei metodi di pagamento

• Individuare le differenze di compatibilità tra le versioni di PrestaShop

Una volta convalidato il campione, lo stesso processo può essere eseguito senza limiti per migrare l'intero insieme di dati.

🧭 Casi d'uso tipici

• Sostituire un negozio PrestaShop con un marketplace Dolibarr: recuperare il catalogo esistente, i clienti e lo storico degli ordini prima del cambio di piattaforma.

• Centralizzare i dati commerciali: integrare i clienti, i prodotti e gli ordini PrestaShop nel sistema Dolibarr ERP/CRM dell'azienda.

• Migrare un negozio di moduli software: trasferire prodotti virtuali, archivi dei moduli, file di documentazione e immagini dei prodotti verso Dolibarr.

• Preparare una migrazione controllata: verificare e correggere i dati di staging prima della creazione dei record in Dolibarr.

• Riprendere una migrazione interrotta: riavviare soltanto i record in errore senza scaricare o importare nuovamente quelli già elaborati correttamente.

• Conservare lo storico degli ordini: recuperare i vecchi ordini dei clienti e le relative righe per consultarli e seguirli commercialmente in Dolibarr.

❓ FAQ

• È necessario un accesso diretto al database MySQL di PrestaShop?
  No. La migrazione standard utilizza l'API REST Webservice di PrestaShop. Un'esportazione manuale del database rappresenta soltanto una soluzione alternativa opzionale per recuperare i file scaricabili quando Psimport Bridge non può essere installato.

• Quali versioni di PrestaShop sono supportate?
  psimport supporta PrestaShop dalla versione 1.6 alla 9.x tramite l'API Webservice standard di PrestaShop.

• Quale versione di Dolibarr è richiesta?
  Il modulo richiede Dolibarr 24.0 o superiore.

• Quale versione di PHP è richiesta?
  È richiesto PHP 8.1 o superiore.

• psimport modifica i dati in PrestaShop?
  No. L'API PrestaShop viene utilizzata esclusivamente con permessi GET. I dati vengono letti da PrestaShop e creati in Dolibarr.

• Psimport Bridge modifica PrestaShop?
  No. Il bridge funziona in modalità di sola lettura e consente esclusivamente l'accesso ai file già registrati come prodotti scaricabili.

• I record in errore possono essere importati nuovamente?
  Sì. Correggere i dati o la configurazione, reimpostare i record in errore e quindi riavviare soltanto l'importazione interessata.

• I record già importati vengono duplicati quando si riavvia un'importazione?
  No. Lo stato di staging permette di identificare i record già importati correttamente.

• Posso controllare le informazioni prima dell'importazione?
  Sì. Tutti i dati recuperati vengono prima memorizzati nelle tabelle di staging, in modo da poter essere verificati prima dell'importazione definitiva.

• Perché il test dell'API restituisce un errore HTTP 403?
  La richiesta potrebbe essere bloccata da Cloudflare Bot Fight Mode, ModSecurity o da un altro firewall situato davanti al negozio PrestaShop.

• Devo testare la migrazione prima di importare tutto?
  Sì. Testare sempre ogni risorsa su un campione limitato e verificare il risultato prima di avviare la migrazione completa.

Perché utilizzare psimport?

• Migrare un negozio PrestaShop senza sviluppare script SQL di conversione specifici

• Utilizzare l'API Webservice standard di PrestaShop senza richiedere l'accesso diretto al database

• Controllare e correggere i dati prima di creare gli oggetti in Dolibarr

• Importare categorie, clienti, indirizzi, prodotti, immagini, file e ordini

• Recuperare i file scaricabili associati ai prodotti virtuali

• Determinare le aliquote IVA a partire dalla configurazione fiscale di PrestaShop

• Monitorare le importazioni in attesa, riuscite o in errore da un'interfaccia centralizzata

• Riavviare soltanto i record in errore invece di ripetere l'intera migrazione

• Mantenere invariato il negozio PrestaShop di origine durante la migrazione

• Preparare una transizione controllata da PrestaShop a un negozio basato su Dolibarr

⚠️ Raccomandazione importante

Una migrazione di dati deve sempre essere testata su un'istanza Dolibarr separata prima di essere eseguita in un ambiente di produzione.

Prima di iniziare, creare un backup completo di:

• Il database PrestaShop

• I file PrestaShop e la directory di download

• Il database Dolibarr

• La directory dei documenti Dolibarr

Dopo ogni fase della migrazione, confrontare il numero di record di origine e di destinazione e controllare manualmente un campione rappresentativo dei dati importati.

📖 Documentazione

La documentazione completa del modulo è disponibile sul wiki ufficiale di Dolibarr:

👉 Wiki Dolibarr – Modulo psimport (IT)

Documentazione francese:

👉 Wiki Dolibarr – Modulo psimport (FR)

Documentazione inglese:

👉 Wiki Dolibarr – Modulo psimport (EN)

Altri moduli