Automatiser e-commerce dans Dolibarr : Tutoriel pas à pas pour réduire les erreurs

1. Introduction

Dolibarr est un ERP / CRM open‑source qui propose de nombreuses fonctionnalités pour gérer les ventes en ligne, les stocks, la facturation et la comptabilité. Lorsqu’il est intégré à une boutique e‑commerce (PrestaShop, Magento, WooCommerce, etc.) ou lorsqu’on utilise le module Dolibarr E‑Commerce pour créer directement des boutiques, l’automatisation des processus permet de :

  • Réduire les saisies manuelles, source majeure d’erreurs.

  • Accélérer le traitement des commandes, des factures et des stocks.

  • Améliorer la traçabilité et la conformité aux exigences légales.

Ce guide vous montre, étape par étape, comment mettre en place les automatisations les plus utiles pour diminuer les fautes humaines dans Dolibarr.

2. Prérequis

Élément Niveau requis
Serveur PHP >= 7.4, MySQL >= 5.7 ou MariaDB, Apache/Nginx
Dolibarr Version 18.x (ou supérieure) – téléchargée depuis https://github.com/Dolibarr/dolibarr
Extensions PHP curl, dom, simplexml, mbstring, gd, openssl
Modules complémentaires – Dolibarr E‑Commerce (pour créer une boutique)
– Dolibarr Marketplace / API (pour les flux externes)
– Dolibarr Stock (gestion des variantes)
Connaissances Notions de serveur web, base de données, sécurité (HTTPS, droit d’accès)

Astuces : Avant tout, faites une sauvegarde de votre base de données et de votre dossier htdocs/dolibarr. Testez chaque changement sur un environnement de test.

3. Installer et configurer le module E‑Commerce

3.1 Activation du module

  1. Connectez‑vous à l’administration Dolibarr (http://votredomaine.com/dolibarr/admin.php).

  2. Allez dans Modules ► Commercial.

  3. Recherchez le sous‑module E‑Commerce et cliquez sur Installer.

  4. Suivez les étapes d’installation (création de tables dédiées ps_woocommerce_*, etc.).

Note : Si vous avez déjà un site e‑commerce existant (WooCommerce, PrestaShop), vous pouvez soit le remplacer soit garder les deux en mode « détachement » avec l’API.

3.2 Paramétrage de base

Champ Valeur recommandée
Nom du shop “Ma Boutique – automatisée”
Devise EUR (ou votre devise)
Taxes Activer la TVA (ou la TVA locale)
Prix TTC / HT Choisir le mode de calcul selon votre comptabilité
Passerelles de paiement Stripe, PayPal, ou tout module dédié (ex. ccab3ds).
Transport Activer les modules d’expédition (Colissimo, Chronopost).
Langue / Pays Français, Belgique, Suisse, etc.

Bonne pratique : Une fois les paramètres définis, cliquez sur Sauvegarder et utilisez le bouton Effacer le cache (Administration ► Maintenance ► Nettoyer le cache).

4. Automatiser la création et le traitement des devis & factures

4.1 Paramétrage du workflow

  1. Accéder au menu : Ventes ► Devis → Paramètres avancés → Workflow.

  2. Activer l’option “Création automatique d’une facture à partir d’un devis validé”.

4.2 Utiliser les modèles de documents

  • Facture → Modèle ► Créer / Modifier.

  • Insérez des variables dynamiques ({client_name}, {order_number}, {total_HT}) pour éviter les oublis.

  • Sauvegardez le modèle et activez‑le comme modèle par défaut.

4.3 Synchronisation avec un ERP ou une plateforme externe

  • Export CSV : En Factures ► Export choisissez CSV et configurez un script externe (ex. cron.php) pour envoyer le fichier à votre CRM.

  • API REST : Activez le module API (Modules ► API) puis créez une URL DTO (Data Transfer Object) qui publie les factures au format JSON vers un webhook.

Éviter les erreurs :

  • Vérifiez que les champs obligatoires (TVA, numéro client) sont toujours renseignés avant export.

  • Ajoutez un contrôle « Si le champ “Numéro de facture” est vide, génère‑le automatiquement à partir de la séquence en cours. »

5. Simplifier la gestion des stocks et des commandes

5.1 Règles d’automatisation de la logistique

Situation Action automatique Exemple de règle dans Dolibarr
Stock critique (< seuil_min) Créer une commande fournisseur Gestion ► Stock ► Règles ► “Automatiquement commander”.
Paiement reçu Passer la commande à l’état “expédiée” Commandes ► Paramètres ► “Passer à expédié après paiement confirmé”.
Retour produit Créer un avoir Accueil ► Retour ► “Créer automatiquement un avoir”.

5.2 Utilisation du module “Automatisation des réapprovisionnements”

  1. Menu : Gestion ► Stock ► Réapprovisionnement automatique. 2. Définir : – seuil_min = 10

    • seuil_max = 30

    • quantité_commande = 50 3. Planifier un cron quotidien : 

0 2 * * * php /var/www/html/dolibarr/cron/automatic_stocks.php >> /var/log/dolibarr_stock.log 2>&1

Astuces anti‑erreurs :

  • Log : Redirigez les logs vers un fichier afin de pouvoir analyser les messages d’erreur.

  • Email : Ajoutez une notification par mail lorsqu’une commande fournisseur est générée (ex. notify_fournisseur.php).

6. Réduire les erreurs de facturation récurrente

6.1 Modèles de coefficient de TVA dynamique

Si vous avez des produits soumis à différents taux de TVA, créez un groupe de prix avec une règle de TVA liée à la catégorie du produit.

// Exemple de script d’insertion rapide (à placer dans un module custom)

$product_cat = 'LIVRE'; // catégorie personnalisée

$tax_rate = getTaxRateFromCategory($product_cat); // récupère le taux stocké

$facture->addLine('TVA', $tax_rate);

6.2 Vérification de cohérence avant export

Utilisez le plugin “Checks avancés” (disponible dans les modules « Contrib ») :

  1. Créer un nouveau « Check » Facture_Validité.

  2. Définir les règles :

    • client_id ≠ null

    • facture_number unique

    • total_TTC > 0 3. Planifier l’exécution au moment de la sauvegarde via le hook after_save.

Cette vérification empêche l’enregistrement de factures incomplètes et empêche les exports qui échoueraient.

7. Automatiser les communications client (notifications, factures PDF) ### 7.1 Envoi automatique de mails

  • Administration ► Notification ► Email → Activer “Envoi automatique après création de facture”.

  • Choisissez le template « Facture‑PDF‑HTML » (inclut le design responsive).

7.2 Génération PDF en mode batch

# Script cron (exemple : générer PDFs chaque jour à 01:00)

0 1 * * * php /var/www/html/dolibarr/bin/pdf_generator.php --all > /var/log/dolibarr_pdf.log 2>&1

  • Le script parcourt toutes les factures en attente (status = 0) et crée un PDF stocké dans docs/factures/ avec le nom de fichier fact_{num_facture}.pdf.

  • Ajoutez le champ {pdf_link} dans les emails pour que le client puisse télécharger le document.

Prévention des erreurs : > – Implémentez une vérification de taille du PDF (ex. < 5 Mo). Si le fichier dépasse, en soi il y a probablement une mauvaise configuration du générateur.

  • Activez le mode debug ($conf['pdf_debug'] = 1;) lors des tests pour afficher les erreurs de rendu.

8. Nettoyage et contrôle périodique

Action Fréquence Description
Audit des ventes Mensuel Export des rapports de ventes et comparaison avec le CRM.
Contrôle des doublons Trimestriel Script de recherche des numéros de facture/bon de commande dupliqués.
Sauvegarde de la DB Hebdomadaire mysqldump + compression, stocker sur un serveur distant.
Mise à jour de Dolibarr Tous les 3 mois Application du dernier patch de sécurité (ex. 18.0.3).

9. Ressources complémentaires

Ressource URL
Documentation officielle Dolibarr (module E‑Commerce) https://www.dolibarr.org/fr/doc/18.x/en_US/Craft/E-commerce
Forum communautaire « Automatisation » https://forums.dolibarr.org
Pack d’exemples de scripts Crane https://github.com/Dolibarr/contrib/tree/master/php/cron
Tutoriel vidéo (en français) https://youtu.be/EXAMPLE_AUTOMATISATION_DOLIBARR

10. Conclusion

En suivant ces étapes, vous transformerez Dolibarr d’un simple gestionnaire de ventes en une plateforme d’e‑commerce entièrement automatisée.
Les bénéfices attendus sont :

  • Réduction considerably des erreurs (saisie, duplication, calcul de TVA). – Gain de temps important pour les équipes administratives et logistiques.

  • Amélioration de la conformité (factures toujours correctes, numérotation séquentielle).

  • Scalabilité facilitée : vous pouvez ajouter d’autres flux (API, chatbot, marketplace) sans réinventer le processus.

Le secret réside dans la combinaison de :

  1. Configuration rigoureuse des modèles (devis, factures, modèles d’email).

  2. Utilisation de hooks et de scripts cron pour déclencher les actions 자동isées. 3. Contrôle continu via des sauvegardes, logs et audits périodiques.

N’hésitez pas à adapter les exemples de code et les paramètres à votre contexte (type de produit, seuils de stock, législation locale).

Bonne automatisation ! 🚀

Cet article a été rédigé par [Votre Nom], consultant Dolibarr expert en automation e‑commerce. Pour toute assistance personnalisée, contactez‑nous à contact@exemple.com.

Publications similaires