PrestaNexus — Synchronisation Dolibarr ⇄ PrestaShop

La passerelle ERP / e-commerce complète et bidirectionnelle entre Dolibarr ERP/CRM et une ou plusieurs boutiques PrestaShop.

1 Présentation

PrestaNexus transforme Dolibarr en véritable back-office de votre commerce PrestaShop. Clients, adresses, catalogue, déclinaisons, stocks, prix, commandes, factures, paiements, avoirs et expéditions circulent automatiquement entre les deux logiciels, dans le sens que vous choisissez pour chaque type de donnée.

Conçu pour la production, le module repose sur un moteur de synchronisation professionnel : file d'attente persistante, reprises automatiques, protection contre les doublons et les boucles, gestion des conflits, simulation avant import et journalisation complète. Il fonctionne sans aucune modification du cœur de Dolibarr ni de PrestaShop.

2. Points forts

• Synchronisation bidirectionnelle configurable objet par objet : Dolibarr → PrestaShop, PrestaShop → Dolibarr ou dans les deux sens.
• Source de vérité paramétrable pour chaque type de donnée : Dolibarr, PrestaShop, dernière modification ou validation manuelle.
• Multi-boutiques : plusieurs boutiques PrestaShop connectées simultanément, chacune avec sa clé, sa langue, sa devise, son entrepôt, ses règles et ses correspondances.
• Zéro doublon : chaque commande, facture, paiement ou avoir n'est créé qu'une seule fois, même si l'événement est reçu plusieurs fois.
• Temps réel et planifié : triggers Dolibarr, webhooks PrestaShop signés, et tâches CRON de rattrapage (synchronisation delta).
• Gros volumes : traitement par lots, pagination, détection des changements par empreinte, adapté à des centaines de milliers de produits, clients et commandes.
• Sécurité : clés API chiffrées (AES-256-GCM), webhooks HMAC, protection CSRF, droits utilisateurs détaillés, secrets masqués dans les journaux.
• Compatibilité multi-version grâce à une architecture d'adaptateurs pour Dolibarr et pour PrestaShop.

3. Fonctionnalités détaillées

3.1 Connexion et multi-boutiques

• Assistant de connexion : URL, clé Webservice, boutique et groupe de boutiques, langue, devise, entrepôt, niveau de prix, mode de synchronisation.
• Bouton « Tester la connexion » : version de PrestaShop, adaptateur utilisé, nom de la boutique, langues, devises, multiboutique, volumes et permissions Webservice manquantes.
• Découverte automatique qui pré-remplit les correspondances : langues, devises, taxes, transporteurs, statuts de commande et groupes clients.
• Assistant de première synchronisation en 10 étapes, de la connexion jusqu'à l'import initial.

3.2 Catalogue

• Produits et services : référence, EAN, UPC, ISBN, MPN, nom, descriptions, poids et dimensions, coût, statut, catégories, marque, champs SEO et traductions.
• Déclinaisons PrestaShop synchronisées avec les variantes Dolibarr : attributs, valeurs, référence, EAN, impact de prix et de poids.
• Catégories avec arborescence complète et catégorie principale.
• Marques et fabricants, représentés dans Dolibarr sous forme de catégories dédiées.
• Images principales et secondaires, avec détection d'empreinte pour ne jamais renvoyer une image identique.
• Filtres : uniquement certaines catégories, uniquement les produits actifs, par type de produit.

3.3 Stocks

• Modes Dolibarr maître, PrestaShop maître ou bidirectionnel.
• Stock réel ou virtuel, calculé sur un ou plusieurs entrepôts Dolibarr (plusieurs entrepôts peuvent alimenter une même boutique).
• Protection anti-boucle : une quantité envoyée à PrestaShop n'est jamais réimportée comme une nouvelle modification.

3.4 Prix et taxes

• Prix hors taxe comme référence, niveaux de prix Dolibarr, prix spécifiques par client.
• Correspondance des règles de taxes PrestaShop avec les taux de TVA Dolibarr, par pays, sans jamais créer de taux en double.
• Calculs décimaux exacts, sans erreur d'arrondi, et prise en charge du multidevise.

3.5 Clients, contacts et adresses

• Création automatique des tiers Dolibarr à partir des clients PrestaShop, particuliers comme professionnels (société, SIRET, TVA intracommunautaire).
• Stratégies anti-doublons : identifiant externe, e-mail, numéro de TVA, SIRET, référence ; les cas ambigus sont signalés au lieu de créer un doublon.
• Adresses de facturation et de livraison synchronisées avec les contacts Dolibarr.
• Option de création automatique d'un compte PrestaShop pour chaque nouveau client Dolibarr.

3.6 Commandes et statuts

• Import automatique des commandes PrestaShop : client, adresses, lignes et déclinaisons, remises, frais de port, emballage cadeau, message, mode de paiement, transporteur et devise.
• Contrôle des totaux : tout écart entre PrestaShop et Dolibarr est signalé dans la note de la commande.
• Produits inconnus : ligne libre, import du produit ou blocage avec erreur, au choix.
• Écran de correspondance des statuts : chaque état PrestaShop déclenche une action Dolibarr (valider, annuler, clôturer…) et chaque événement Dolibarr peut mettre à jour l'état PrestaShop.

3.7 Factures, paiements et avoirs

• Facture Dolibarr créée automatiquement selon la règle choisie : commande validée, paiement accepté, commande expédiée ou livrée.
• Import des paiements avec correspondance des moyens de paiement (Stripe, PayPal, virement, paiement à la livraison…) et compte bancaire ; aucun paiement n'est jamais enregistré en double ni au-delà du reste à payer.
• Avoirs PrestaShop importés en avoirs Dolibarr, avec réintégration du stock en option.

3.8 Expéditions et suivi

La validation d'une expédition dans Dolibarr met à jour la commande PrestaShop : numéro de suivi, transporteur et passage à l'état « Expédié », avec envoi optionnel de l'e-mail au client.

3.9 Correspondances et règles métier

• Correspondance des valeurs : statuts, moyens de paiement, taxes, transporteurs, entrepôts, langues, devises, groupes clients.
• Constructeur de correspondances de champs : extrafields Dolibarr ⇄ champs PrestaShop, avec conversion texte, nombre, date, booléen, liste ou JSON.
• Moteur de règles métier sans code, par exemple : « si la boutique est France et que la commande dépasse 500 €, affecter le commercial X ».

3.10 Fiabilité et performances

• File d'attente persistante : aucune synchronisation lourde n'est exécutée pendant une requête web.
• Reprises automatiques avec délai exponentiel ; une opération en échec n'est jamais perdue et peut être relancée.
• Isolation des tâches : une erreur sur un produit n'arrête jamais la synchronisation des autres.
• Idempotence, détection des changements par empreinte, synchronisation delta.
• Centre de gestion des conflits : valeur Dolibarr, valeur PrestaShop et ancienne valeur côte à côte, avec choix en un clic.
• Limitation de débit et disjoncteur pour ne jamais saturer la boutique ; reprise progressive après une panne.
• Mode simulation (dry-run) : nombre d'éléments à créer, à mettre à jour, inchangés, en conflit ou en erreur, sans aucune modification de données.

3.11 Pilotage

Commerce Sync Control Center — capture réelle du module dans Dolibarr 23.0.4.

• Commerce Sync Control Center : indicateurs clés, graphiques sur 30 jours, activité récente, dernières erreurs et tâches planifiées.
• Synchronisation manuelle par type d'objet, historique des lots, file d'attente, journaux filtrables et exportables en CSV.
• Onglets PrestaShop sur les fiches produit, tiers, commande et facture.
• Rapports : chiffre d'affaires, panier moyen, nouveaux clients, produits les plus vendus, ruptures, taux d'annulation et de remboursement.
• Diagnostic, moniteur de santé et console d'administration.

3.12 Sécurité et RGPD

• 12 droits Dolibarr distincts : consultation, administration, synchronisation par domaine, journaux, conflits, relances, correspondances, purge.
• Suppressions jamais propagées par défaut : archivage ou désactivation privilégiés.
• Export et anonymisation des données de synchronisation d'un client ; notifications administrateur (e-mail, agenda, webhook).

4. Matrice des synchronisations

Le sens de chaque objet se règle boutique par boutique. « — » indique une opération que les API ne permettent pas (par exemple, le Webservice PrestaShop ne permet pas de créer une facture).

5. Prérequis

• Dolibarr 17 ou supérieur, PHP 7.1 ou supérieur avec les extensions curl, openssl, json, dom, simplexml et mbstring.
• Modules Dolibarr : Tiers, Produits, Commandes, Factures et Tâches planifiées ; en option : Stocks, Variantes, Multidevise, Banques.
• PrestaShop 1.6.1 à 9.x avec le Webservice activé et une clé API disposant des permissions requises ; HTTPS recommandé.
• Pour le temps réel : le module compagnon PrestaShop « nxwebhook » fourni.

6. Installation

• Dans Dolibarr : Accueil → Configuration → Modules → Déployer/installer un module externe, puis envoyer le fichier prestanexus-1.0.zip.
• Activer le module PrestaNexus dans la liste des modules.
• Dans PrestaShop : activer le Webservice et créer une clé API avec les permissions indiquées dans le manuel.
• Dans Dolibarr : PrestaShop → Configuration → Connexions → Nouvelle connexion, puis « Tester la connexion ».
• Lancer l'assistant de première synchronisation (correspondances, simulation, import initial).
• Vérifier que les tâches planifiées de Dolibarr sont exécutées (crontab système) et, pour le temps réel, installer le module compagnon nxwebhook.

7. Compatibilité

Le code est livré avec 469 tests automatisés (moteur, API, services métier). La matrice détaillée figure dans docs/TEST_MATRIX.md.

8. Limites connues

• Les mots de passe des clients ne peuvent pas être transférés : le client utilise « mot de passe oublié ».
• Les retours marchandise de PrestaShop ne sont pas exposés par le Webservice : ils sont traités via les avoirs.
• Le stock des produits gérés par lot ou numéro de série ne peut pas être corrigé depuis PrestaShop.
• Les règles de prix catalogue et les codes promotionnels n'ont pas d'équivalent dans Dolibarr : ils sont importés comme remises sur les commandes.

9. Questions fréquentes

Le module modifie-t-il Dolibarr ou PrestaShop ?

Non. Il utilise uniquement les mécanismes officiels : module, triggers, hooks, Webservice et un module compagnon PrestaShop standard.

Une commande peut-elle être importée deux fois ?

Non. Chaque commande est identifiée de façon unique ; un même événement reçu plusieurs fois ne crée jamais de doublon.

Que se passe-t-il si la boutique est indisponible ?

Les tâches restent en file d'attente, le disjoncteur suspend les appels puis reprend progressivement, sans perte ni duplication.

Puis-je tester avant d'importer mes données ?

Oui, le mode simulation affiche ce qui serait créé, mis à jour ou en conflit sans rien modifier.

Puis-je connecter plusieurs boutiques ?

Oui, sans limite, chacune avec sa propre configuration.

10. Éditeur et support

NEXT GESTION — www.nextgestion.com — contact@nextgestion.com

Module distribué sous licence GPL v3 ou ultérieure. Documentation complète en français et en anglais incluse (manuel PDF).

Démo du module PrestaNexus
Login : demo
Mot de passe : demo