(Guide complet pour les commerçants, restaurateurs et petites structures marocaines)
1. Introduction
Le Point de Vente (POS) est aujourd’hui le cœur battant de la plupart des commerces marocains : petites boutiques, cafés, restaurants, marchés locaux ou boutiques en ligne.
Dolibarr ERP‑CRM est l’un des systèmes open‑source les plus populaires en Europe et en Afrique du Nord, notamment grâce à son module POS intégré (vente de produits, paiement, stocks, factures, rapports…).
Ce qui rend Dolibarr particulièrement attractif au Maroc, c’est la possibilité de :
- Personnaliser les flux de travail avec des modules locaux (TVA % 10/20, devise, paiement mobile).
- Intégrer les solutions de paiement marocaines (Banque Populaire, CDG, etc.) via des plugins REST ou des connexions directes à la passerelle de paiement.
- Utiliser l’interface web depuis n’importe quel appareil (ordinateur, tablette, smartphone).
Dans cet article, nous montrons comment faire passer Dolibarr à la version supérieure (de 0.x à 0.10, ou de 7.x à 8.x), puis comment exploiter le module POS pour servir le marché marocain.
2. Pourquoi envisager une mise à niveau ?
| Raisons de mise à niveau | Impact sur le POS au Maroc |
|---|---|
| Nouvelles fonctionnalités (ex. : amélioration du tableau de bord, gestion multi‑devise) | Permet de créer des devis ou factures en dirahms (MAD) ou DIRHAMS DIGITAUX (e‑MAD), avec affichage automatique selon le pays. |
| Corrections de sécurité | Bonne protection contre les attacks de type injection et conformité aux normes ISO 27001 exigées par les banques marocaines. |
| Compatibilité PHP 8.x | Les serveurs hébergés en cPanel/CloudLinux (très répandu au Maroc) supportent désormais PHP 8.2, garantissant des performances supérieures et moins de latence. |
| Support intégré de Bootstrap 5 | L’interface admin/ POS devient responsive, idéale pour les écrans tactiles de caisses enregistreuses ou les tablettes. |
| Nouvelles extensions (ex. : modules paiement mobile) | Possibilité de connecter Fawry, Inwi Money, ou les QR‑Code de la Banque Al-Maghrib sans développement lourd. |
3. Étapes concrètes pour passer à la dernière version de Dolibarr
3.1. 1. Sauvegarde complète
# 1. Export SQL
mysqldump -u user -p db_name > db_backup.sql
# 2. Copie des dossiers
cp -r /var/www/dolibarr/* /var/www/dolibarr_backup/Astuce : faites également un dump du répertoire
www/files/(documents, pièces jointes).
3.2. 2. Vérifier les exigences techniques
| Version | PHP requis | MySQL/MariaDB recommandé | Extensions PHP |
|---|---|---|---|
| Dolibarr 8.0 | ≥ 7.4 (mais optimisé pour 8.1+) | ≥ 10.2 | mysqli, gd, curl, zip, intl |
Si votre serveur utilise PHP 8.2, assurez‑vous que les modules
intletgdsont activés.
3.3. 3. Installer la mise à jour
-
Téléchargement
wget https://gitlab.com/dolibarr/dolibarr/-/archive/version-8.0.tar.gz
tar -xzf version-8.0.tar.gz -C /var/www/
mv /var/www/dolibarr-version-8.0 /var/www/dolibarr ``` -
Définir les droits
chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr -
Mise à jour de la base
Accédez via le navigateur àhttp://votre‑serveur.com/upgrade.php.
Suivez les étapes :- Sélectionnez la base (
db_name). - Autorisez les modifications (création de nouvelles tables, index, etc.). – Une fois l’opération terminée, supprimez le fichier
upgrade.phppour éviter les réplications.
- Sélectionnez la base (
- Activer le module POS (si non installé)
- Menu Extensions → Modules → Installer → Cherchez POS → Cliquez sur Installer. – Redémarrez l’interface (Ctrl+F5).
3.4. 4. Validation du POS sur le serveur local
| Action | Vérification |
|---|---|
| Création d’un produit | Produit > Ajouter → Champ PUHT (prix TTC), TVA → sélectionnez 10 % ou 20 % selon la catégorie d’article. |
| Gestion des devis | Ajoutez un devis en MAD → Imprimez en PDF. |
| Paiement | Dans la vente, choisissez Mode paiement → CB, Montant cash, Mobile Money. |
| Impression du ticket | Connectez une imprimante thermique (ex. : Zjiang ZT‑400) → Dans Paramètres du POS → Imprimante, choisissez le port USB. |
| Reporting | Rapports → Ventes → Filtrez par période et devise. Export CSV pour comptable. |
4. Configurer le POS pour le marché marocain
4.1. Gestion de la TVA et de la fiscalité locale
| Taux TVA | Lorsqu’il s’applique |
|---|---|
| 10 % | Produits/services soumis à la TVA réduite (ex. : produits d-basic). |
| 20 % | Vente de biens de consommation courante, carburant (exemption partielle selon la catégorie). |
| 0 % | Exportations ou services à l’étranger. |
Procédure :
- Ouvrez Produits → Fiche produit.
- Dans l’onglet TVA, sélectionnez le taux approprié. > – Activez “Appliquer le taux par défaut à la catégorie” si vous avez plusieurs catégories.
4.2. Monnaie et conversion
- Paramètres généraux → Monnaie → Ajouter → Moroccan Dirham (MAD).
- Taux de change : vous pouvez choisir taux fixe ou auto‑mise à jour via API (ex. : exchangerate.host).
- Pour les opérations en Dolla (si vous facturez en devises internationales), activez la option multi‑devise → créez la devise EUR, USD avec leurs taux.
4.3. Paiement mobile et portefeuilles électroniques
| Solution | Intégration possible |
|---|---|
| Inwi Money | Créer un Webhook dans le module Paiement qui renvoie le token à Inwi Money pour finaliser le paiement. |
| Fawry | Utiliser le module “Payment Gateway” (ou développer un petit module REST). |
| CB (Carte Bancaire) | Doliboard propose un module CB pré‑configuré pour les terminaux de paiement PayZen ou Worldline courants au Maroc. |
Exemple de workflow CB
- Le client scanne sa carte sur le terminal POS.
- Le paiement est envoyé à l’API du PSP（fournisseur de service).
- Retour OK → le solde du stock est débité et la vente clôturée.
5. Bonnes pratiques pour exploiter le POS à plein potentiel | Thème | Recommandation |
|——-|—————-|
| Gestion des stocks | Activez “Gestion des seuils de réapprovisionnement” → créez des alertes automatiques par e‑mail aux fournisseurs marocains. |
| Sécurité d’accès | Créez des profils (caissier, manager, comptable) avec des droits spécifiques CRUD sur le module POS. |
| Sauvegarde automatique | Créez une tâche cron quotidienne (0 2 * * * mysqldump ...) pour éviter toute perte de données. |
| Monitoring | Installez php‑fpm + Grafana ou Prometheus pour suivre le temps de réponse des transactions POS (objectif < 200 ms). |
| Support technique local | Engagez un développeur freelance (plateforme Malt, Upwork) spécialisé en Dolibarr pour des personnalisations de paiement ou d’interface. |
| Formation du personnel | Organisez des sessions de 2 h sur l’utilisation du POS (mise à jour, impression du ticket, gestion des retours). |
| Déploiement sur tablette | Utilisez une tablet Android avecChrome en mode plein écran (http://votre‑serveur.com/POS) pour une expérience tactile fluide. |
6. Cas d’usage typiques au Maroc
6.1. Café‑restaurant du Grand Casablanca
- Produits :plats du jour, boissons, desserts.
- TVA : 10 % (alimentation).
- Paiement : CB + Wafe Cash (via plugin REST).
- Intégration : Imprimante thermique Zjiang installée sur le comptoir, connexion au serveur via Wi‑Fi. ### 6.2. Boutique d’artisanat à Marrakech – Produits : textiles, poteries, vêtements.
- Gestion des devis : pour les commandes exportées (Europe).
- Fiscalité : 20 % TVA sur produits finis, 0 % pour exportation (exemple : envoi direct à l’étranger).
- Export des ventes : fichier CSV mensuel partagé avec le comptable local.
6.3. Coopérative agricole du Sahara Occidental
- Stockage : suivi des intrants (semences, engrais).
- Payement : solutions mobiles (Inwi Money, Orange Money).
- Reporting : tableau de bord mensuel affiché sur un écran d’affichage public (promotion du commerce équitable).
7. Prochaines étapes & Ressources
| Ressource | Lien | Description |
|---|---|---|
| Documentation officielle | https://docs.dolibarr.org | Guides détaillés, API et FAQ. |
| Forum francophone | https://forum.dolibarr.org | Échanges avec d’autres utilisateurs marocains, partage de plugins locaux. |
| Extensions POS Maroc | https://github.com/…/dolibarr-pos-morocco | Contribution de la communauté pour le paiement CB et les QR‑code. |
| Webinaires mensuels (hostés par Dolibarr Morocco) | https://zoom.us/j/… | Sessions Live sur la mise à jour et le POS. |
| Formation certifiante | https://openclassrooms.com/courses/dolibarr | Cours en français, incluant un module dédié au POS. |
8. Conclusion
Mettre à niveau Dolibarr pour exploiter son module POS au Maroc revient à déployer un système de caisse numérique complet, compatible avec les exigences fiscales locales, les modes de paiement modernes et les exigences de sécurisation des données.
- La migration est simplifiée par des étapes de sauvegarde, de vérification des pré‑requis et de mise à jour contrôlée.
- Une fois installé, le POS devient compatible avec les taux de TVA marocains, les devis en DIRHAM, les paiements mobiles (Inwi Money, Fawry) et les imprimantes thermiques largement répandées sur le territoire.
- En suivant les bonnes pratiques de gestion des stocks, de sécurité et de formation, les commerçants peuvent optimiser leurs flux de trésorerie, réduire les erreurs de saisie et offrir une expérience client moderne – un vrai atout commercial face à la concurrence.
Prêt à franchir le pas ? Planifiez votre mise à jour, testez d’abord sur un environnement de staging, puis déployez le POS sur le terrain. Votre commerce mérite une solution aussi robuste que les valeurs marocaines d’hospitalité et de pragmatisme.
Bon développement ! 🚀 —
Article rédigé par [Nom du rédacteur], consultant en ERP open‑source pour le marché marocain.