psimport

📌 Version du module : 1.0.0 📅 Dernière mise à jour : 13/07/2026 👤 Éditeur/Licence : Philippe GRAND / Atoo-Net / GNU GPL v3+ 🌍 Langues de l'interface : 📧 Support : par e-mail à l'adresse contact@atoo-net.com ✅ Compatibilité Dolibarr : Dolibarr 24.0 ou supérieur ✅ Compatibilité PrestaShop : PrestaShop 1.6 à 9.x ✅ Version PHP requise : PHP 8.1 ou supérieur 💡 Mises à jour gratuites pendant 1 an pour une même version, puis 50 % de remise sur la version suivante.

Migrez les données de votre boutique PrestaShop vers Dolibarr avec psimport

Le module psimport fournit un ensemble complet d'outils de migration permettant de transférer les données d'une boutique PrestaShop existante vers Dolibarr ERP/CRM.

Il permet de récupérer et d'importer vos catégories, clients, adresses, produits, images de produits, fichiers téléchargeables et commandes.

La migration utilise l'API REST Webservice standard de PrestaShop. Aucun accès direct à la base de données MySQL de PrestaShop n'est normalement nécessaire.

Au lieu de créer immédiatement les enregistrements dans Dolibarr, psimport stocke d'abord les informations récupérées dans des tables intermédiaires de staging. Cela permet de contrôler les données, d'identifier les erreurs et de corriger les problèmes avant de lancer l'import définitif.

Le mécanisme de staging permet également de relancer uniquement les imports ayant échoué, sans avoir à télécharger de nouveau toutes les données depuis PrestaShop.

🔄 Données pouvant être migrées

🧩 Un processus de migration sécurisé en deux étapes

Chaque opération de migration est divisée en deux étapes distinctes :

1. Récupération : les données sont récupérées depuis PrestaShop au moyen de l'API Webservice, puis stockées dans les tables de staging de psimport.

2. Import : les enregistrements de staging contrôlés et validés sont convertis en objets Dolibarr.

Cette séparation offre un meilleur contrôle qu'une migration directe, car elle permet de vérifier les données récupérées avant qu'elles ne modifient la base de données Dolibarr.

🗃️ Tables intermédiaires de staging

psimport utilise des tables dédiées dont les noms commencent par :

llx_psimport_*

Ces tables stockent les informations récupérées depuis PrestaShop avant leur import définitif dans Dolibarr.

Pour chaque ressource, le module affiche :

📊 Interface de gestion des imports

L'onglet Gestion de l'import fournit une vue centralisée de toutes les opérations de migration.

Depuis cette interface, vous pouvez :

• Récupérer les données depuis PrestaShop avec l'action Fetch

• Importer les données de staging dans Dolibarr avec l'action Importer

• Consulter le nombre d'enregistrements en attente, importés avec succès ou en erreur

• Réinitialiser les enregistrements en erreur afin de ne retraiter que ceux-ci

• Vider une table de staging avant d'effectuer un nouveau test de migration

• Consulter la date de la dernière récupération des données

🔁 Relancer uniquement les imports en erreur

Chaque enregistrement de staging possède un statut d'import :

Après avoir corrigé la cause d'une erreur, utilisez l'action Réinitialiser les erreurs pour replacer les lignes concernées dans le statut en attente.

Vous pouvez ensuite relancer l'import correspondant. Les enregistrements déjà importés avec succès ne sont pas traités une seconde fois.

Cela évite de recommencer toute la migration à cause d'un petit nombre d'enregistrements invalides ou incomplets.

📦 Migration des produits et services

psimport importe les produits PrestaShop dans Dolibarr avec leurs principales informations commerciales et fiscales.

La migration des produits comprend :

• La référence du produit

• Le nom et la description du produit

• Les prix hors taxes et toutes taxes comprises

• La détermination du taux de TVA à partir des groupes de règles de taxes PrestaShop

• L'association avec les catégories importées

• L'image principale du produit

• La galerie complète des images du produit

• Les fichiers téléchargeables associés aux produits virtuels

Le type d'objet cible dans Dolibarr peut être sélectionné dans la configuration du module.

Pour les modules logiciels, licences, documents et autres éléments numériques, il est recommandé d'importer les produits PrestaShop en tant que services Dolibarr.

🧾 Détermination des taux de TVA

PrestaShop n'expose pas toujours directement le pourcentage final de TVA dans la ressource produit.

psimport détermine le taux applicable en lisant la configuration fiscale de PrestaShop à travers les ressources Webservice suivantes :

• tax_rule_groups

• tax_rules

• taxes

Cela permet de transférer plus précisément les prix des produits et les taux de TVA vers Dolibarr.

Les résultats concernant la TVA doivent néanmoins être contrôlés dans les données de staging ainsi que sur un échantillon de fiches produits Dolibarr avant d'importer l'ensemble du catalogue.

🖼️ Images principales et galeries complètes des produits

psimport peut récupérer à la fois l'image principale et la galerie complète associée à chaque produit PrestaShop.

La galerie est récupérée au moyen du point d'accès des images produits de PrestaShop et stockée dans une table de staging dédiée avant son import dans Dolibarr.

Le module :

• Récupère toutes les images associées à chaque produit

• Conserve l'ordre des images renvoyé par PrestaShop lorsque cela est possible

• Détecte et ignore les doublons exacts entre l'image principale et la galerie

• Signale les images qui n'ont pas pu être téléchargées ou importées

La réponse exacte de l'API pouvant varier selon les versions de PrestaShop, il est recommandé d'effectuer un premier test sur un nombre limité de produits avant d'importer l'ensemble du catalogue.

📥 Fichiers téléchargeables des produits virtuels

L'API Webservice standard de PrestaShop n'expose pas les fichiers téléchargeables associés aux produits virtuels.

Pour contourner cette limitation, psimport inclut le module PrestaShop optionnel Psimport Bridge.

Une fois installé sur la boutique source, ce bridge permet à psimport de récupérer les fichiers déjà référencés dans la table PrestaShop des téléchargements produits.

Le bridge :

• Utilise la même clé API Webservice PrestaShop que psimport

• Fonctionne en lecture seule

• Ne modifie pas la base de données PrestaShop

• Ne modifie pas les fichiers stockés sur le serveur PrestaShop

• Donne uniquement accès aux fichiers déjà enregistrés comme fichiers produits téléchargeables

• Peut être supprimé une fois la migration terminée

Une migration manuelle alternative est également possible en exportant la table des téléchargements produits de PrestaShop et en copiant le répertoire de téléchargement de la boutique source.

👥 Migration des clients et des adresses

psimport récupère les clients et leurs adresses depuis PrestaShop avant de créer les tiers correspondants dans Dolibarr.

La migration peut inclure :

• L'identité du client

• Le nom de la société, lorsqu'il est disponible

• L'adresse e-mail

• Les numéros de téléphone

• L'adresse postale

• Le code postal et la ville

• Les informations relatives au pays

• Les adresses de livraison et de facturation associées

Les clients et les adresses sont traités ensemble afin de préserver la relation entre chaque client et ses informations d'adresse.

🛒 Migration des commandes

psimport peut récupérer et importer les commandes clients PrestaShop ainsi que leurs lignes.

La migration des commandes comprend :

• La référence de la commande PrestaShop

• Le client associé

• La date de la commande

• Les produits et services commandés

• Les quantités et les prix unitaires

• Les taux de TVA

• Les totaux de la commande

• La correspondance des modes de paiement

• Le filtrage selon les statuts de commandes PrestaShop sélectionnés

Avant d'importer les commandes, les identifiants de statuts PrestaShop acceptés et les correspondances des modes de paiement doivent être contrôlés selon la configuration de la boutique source.

Les produits et les clients doivent être importés avant les commandes afin que les lignes de commandes puissent être associées aux bons objets Dolibarr.

📋 Ordre de migration recommandé

Afin de préserver les relations entre les objets importés, l'ordre d'exécution recommandé est le suivant :

1. Catégories

2. Clients et adresses

3. Produits ou services

4. Fichiers produits téléchargeables

5. Galeries complètes d'images produits

6. Commandes et lignes de commandes

Chaque étape doit être contrôlée avant de passer à la suivante.

🔍 Contrôles recommandés après chaque étape

• Comparer le nombre d'enregistrements dans PrestaShop, les tables de staging et Dolibarr

• Examiner les enregistrements en attente et en erreur dans les tables de staging

• Contrôler la hiérarchie des catégories importées

• Vérifier les noms, adresses e-mail et adresses postales des clients

• Contrôler les références, descriptions et associations de catégories des produits

• Vérifier les prix hors taxes, les prix toutes taxes comprises et les taux de TVA

• Ouvrir un échantillon d'images et de fichiers téléchargeables

• Contrôler les associations entre clients et produits dans les commandes importées

• Comparer les lignes et les totaux des commandes entre PrestaShop et Dolibarr

⚙️ Prérequis côté PrestaShop

Le Webservice PrestaShop doit être activé depuis :

Paramètres avancés → Webservice → Activer le service web de PrestaShop

Une clé API Webservice doit ensuite être créée avec des droits de lecture sur les ressources nécessaires :

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

Seuls les droits GET sont nécessaires, car psimport lit les données de PrestaShop et n'écrit aucune donnée dans la boutique source.

⚙️ Prérequis côté Dolibarr

Les modules standards Dolibarr suivants doivent être activés avant de lancer la migration :

L'activation de psimport crée automatiquement les tables de staging nécessaires. Aucun import SQL manuel n'est requis dans le cadre d'une installation standard.

🔑 Configuration de la connexion API

La connexion se configure depuis la page de paramétrage du module psimport dans Dolibarr.

Un test de connexion permet de vérifier l'URL de l'API et la clé Webservice avant de démarrer la migration.

🛡️ Protection de la boutique source

psimport est conçu pour lire les informations de PrestaShop sans modifier la boutique source.

• La clé Webservice PrestaShop nécessite uniquement des droits GET

• La migration écrit les données uniquement dans la base de données et les répertoires de documents Dolibarr

• Le module optionnel Psimport Bridge fonctionne en lecture seule

• Le bridge expose uniquement les fichiers téléchargeables déjà enregistrés dans PrestaShop

• Aucune commande, aucun client et aucun produit n'est modifié dans PrestaShop

Une sauvegarde complète des deux applications et de leurs documents est néanmoins fortement recommandée avant toute opération de migration.

☁️ Dépannage Cloudflare et erreurs HTTP 403

Si la connexion à l'API fonctionne dans un navigateur mais que psimport reçoit une réponse HTTP 403 Forbidden avec un corps vide, la requête peut être bloquée par un pare-feu ou un service de protection contre les robots avant d'atteindre PrestaShop.

Cela peut notamment se produire lorsque la boutique source est protégée par Cloudflare Bot Fight Mode, ModSecurity ou un autre pare-feu applicatif Web.

Pour Cloudflare, consultez :

Sécurité → Analyse → Événements

Si la requête apparaît comme un challenge géré généré par Bot Fight Mode, désactivez temporairement cette protection pendant la migration ou créez une règle d'exclusion adaptée si l'offre Cloudflare utilisée le permet.

La protection de sécurité peut être réactivée après la migration.

🧪 Commencer par un test sur un échantillon limité

Avant de lancer une migration complète, il est fortement recommandé de tester chaque ressource avec une limite réduite d'enregistrements.

Cela permet de :

• Valider la connexion à l'API

• Contrôler la structure des données récupérées

• Confirmer la détermination des taux de TVA

• Vérifier le rapprochement des produits et des clients

• Contrôler les droits de téléchargement des images et des fichiers

• Confirmer les correspondances des statuts de commandes et des modes de paiement

• Identifier les différences de compatibilité entre les versions de PrestaShop

Une fois l'échantillon validé, le même processus peut être exécuté sans limite afin de migrer l'ensemble des données.

🧭 Cas d'utilisation typiques

• Remplacer une boutique PrestaShop par une marketplace Dolibarr : récupérer le catalogue existant, les clients et l'historique des commandes avant le changement de plateforme.

• Centraliser les données commerciales : intégrer les clients, produits et commandes PrestaShop dans le Dolibarr ERP/CRM de l'entreprise.

• Migrer une boutique de modules logiciels : transférer les produits virtuels, archives de modules, fichiers de documentation et images produits vers Dolibarr.

• Préparer une migration contrôlée : vérifier et corriger les données de staging avant la création des enregistrements dans Dolibarr.

• Reprendre une migration interrompue : relancer uniquement les enregistrements en erreur sans télécharger ou importer de nouveau ceux ayant déjà réussi.

• Conserver l'historique des commandes : récupérer les anciennes commandes clients et leurs lignes afin de les consulter et de les suivre commercialement dans Dolibarr.

❓ FAQ

• Un accès direct à la base de données MySQL de PrestaShop est-il nécessaire ?
  Non. La migration standard utilise l'API REST Webservice de PrestaShop. Un export manuel de la base de données constitue uniquement une solution alternative facultative pour récupérer les fichiers téléchargeables lorsque Psimport Bridge ne peut pas être installé.

• Quelles versions de PrestaShop sont prises en charge ?
  psimport prend en charge PrestaShop 1.6 à 9.x au moyen de l'API Webservice standard de PrestaShop.

• Quelle version de Dolibarr est requise ?
  Le module nécessite Dolibarr 24.0 ou supérieur.

• Quelle version de PHP est requise ?
  PHP 8.1 ou supérieur est requis.

• psimport modifie-t-il les données dans PrestaShop ?
  Non. L'API PrestaShop est utilisée avec des droits GET uniquement. Les données sont lues depuis PrestaShop et créées dans Dolibarr.

• Psimport Bridge modifie-t-il PrestaShop ?
  Non. Le bridge fonctionne en lecture seule et donne uniquement accès aux fichiers déjà enregistrés comme produits téléchargeables.

• Les enregistrements en erreur peuvent-ils être importés de nouveau ?
  Oui. Corrigez les données ou la configuration, réinitialisez les enregistrements en erreur, puis relancez uniquement l'import concerné.

• Les enregistrements déjà importés sont-ils dupliqués lorsqu'un import est relancé ?
  Non. Le statut de staging permet d'identifier les enregistrements déjà importés avec succès.

• Puis-je contrôler les informations avant leur import ?
  Oui. Toutes les données récupérées sont d'abord stockées dans les tables de staging afin de pouvoir être vérifiées avant l'import définitif.

• Pourquoi le test de l'API renvoie-t-il une erreur HTTP 403 ?
  La requête peut être bloquée par Cloudflare Bot Fight Mode, ModSecurity ou un autre pare-feu placé devant la boutique PrestaShop.

• Dois-je tester la migration avant de tout importer ?
  Oui. Testez toujours chaque ressource sur un échantillon limité et vérifiez le résultat avant de lancer la migration complète.

Pourquoi utiliser psimport ?

• Migrer une boutique PrestaShop sans développer de scripts de conversion SQL spécifiques

• Utiliser l'API Webservice standard de PrestaShop sans nécessiter d'accès direct à la base de données

• Contrôler et corriger les données avant de créer les objets dans Dolibarr

• Importer les catégories, clients, adresses, produits, images, fichiers et commandes

• Récupérer les fichiers téléchargeables associés aux produits virtuels

• Déterminer les taux de TVA à partir de la configuration fiscale PrestaShop

• Suivre les imports en attente, réussis ou en erreur depuis une interface centralisée

• Relancer uniquement les enregistrements en erreur au lieu de recommencer toute la migration

• Conserver la boutique PrestaShop source inchangée pendant la migration

• Préparer une transition contrôlée de PrestaShop vers une boutique basée sur Dolibarr

⚠️ Recommandation importante

Une migration de données doit toujours être testée sur une instance Dolibarr distincte avant d'être réalisée dans un environnement de production.

Avant de commencer, effectuez une sauvegarde complète de :

• La base de données PrestaShop

• Les fichiers PrestaShop et le répertoire de téléchargement

• La base de données Dolibarr

• Le répertoire de documents Dolibarr

Après chaque étape de migration, comparez le nombre d'enregistrements source et cible, puis contrôlez manuellement un échantillon représentatif des données importées.

📖 Documentation

La documentation complète du module est disponible sur le wiki officiel de Dolibarr :

👉 Wiki Dolibarr – Module psimport (FR)

Documentation anglaise :

👉 Wiki Dolibarr – Module psimport (EN)

Plus de modules