Odoo

Weglob - Création site internet et applications
Weglob - Création site internet et applications

Odoo au Maroc : Tutoriel pour connecter comptabilité à WooCommerce avec des données propres

Introduction : Pourquoi intégrer Odoo et WooCommerce au Maroc ?

Pour les entreprises marocaines utilisant à la fois Odoo comme ERP et WooCommerce comme plateforme e-commerce, l’intégration des deux systèmes n’est plus un luxe, mais une nécessité opérationnelle. Sans synchronisation automatique, chaque commande WooCommerce doit être saisie manuellement dans Odoo, entraînant :

  • Des risques d’erreurs de saisie

  • Un décalage temporel entre les ventes et la comptabilité

  • Une impossibilité d’avoir une vision financière en temps réel

  • Des difficultés pour le reporting fiscal marocain (TVA, déclarations CNSS, etc.)

Ce tutoriel vous guide pas à pas pour établir une connexion fiables et propre, en adaptant le processus aux spécificités du contexte marocain.

Prérequis essentiels

1. Configuration de base

  • Odoo : Version 15+ (Community ou Enterprise) avec modules Comptabilité et Ventes installés

  • WooCommerce : Boutique fonctionnelle avec produits et commandes

  • Hébergement : Accès FTP/SSH à votre site WooCommerce pour l’installation du connecteur

  • Connaissances : Bases de gestion des produits et de la TVA marocaine (TVA 20%, 7%, etc.)

2. Adaptation marocaine indispensable

Dans Odoo, vérifiez ou créez :

  • Un plan comptable marocain (ou adaptez le plan français)

  • Les taxes TVA conformes à la réglementation marocaine

  • Les journaux comptables (Ventes, Banque, Caisse)

  • Les modes de paiement correspondants (Espèces, Carte, Virement, paiement à la livraison)

Étape 1 : Préparer vos données pour une intégration propre (le secret de la réussite)

Avant toute connexion technique, nettoyez vos données existantes. C’est l’étape la plus critique pour éviter la pollution de votre comptabilité.

Dans Odoo :

  1. Standardisez les références produits :

    • Vérifiez que chaque produit dans Odoo a un identifiant unique (Référence interne) identique à celui dans WooCommerce

    • Éliminez les doublons : un produit = une référence Odoo

    • Pour les produits variables (tailles, couleurs), assurez-vous que chaque variante a sa propre référence

  2. Vérifiez les comptes comptables par défaut :

    • Pour chaque catégorie de produit, définissez un compte de revenus (70xxx) et un compte de TVA collectée (44566xxx)

    • Exemple : "Vente de marchandises" → Compte 711, TVA 20% → 445661

  3. Créez un partenaire spécifique pour WooCommerce :

    • Nom : "WooCommerce – Boutique en ligne"

    • Type : "Client"

    • Numéro de TVA : laissez vide ou mettez le vôtre si nécessaire pour les déclarations

Dans WooCommerce :

  1. Harmonisez les SKU :

    • Exportez vos produits WooCommerce (CSV)

    • Assurez-vous que la colonne SKU correspond exactement aux Références internes Odoo

    • Corrigez les écarts : espaces superflus, majuscules/minuscules, caractères spéciaux

  2. Vérifiez les taxes WooCommerce :

    • Paramètres → Taxes → Vérifiez que les taux correspondent à ceux d’Odoo (ex: 20% pour la TVA standard)

    • Base de calcul : "Prix du produit" (inclus TVA) pour correspondre à la pratique marocaine

Étape 2 : Choix et installation du connecteur

Options au Maroc :

  1. Module Odoo officiel (module connector_woocommerce dans Odoo Apps) – Gratuit mais nécessite développement

  2. Solutions tierces populaires :

    • Odoo Connector par Magestore (payant, support francophone)

    • Woocommerce Connector par Webkul

    • Solutions locales : Certains intégrateurs marocains (comme Odoo.ma, Edukate.ma) proposent des modules pré-configurés pour le Maroc

Installation recommandée pour les PME marocaines :

Pour un équilibre coût/fonctionnalités, privilégiez un module certifié Odoo avec :

  • Support en français

  • Configuration pré-établie pour la TVA marocaine

  • Synchronisation bidirectionnelle

  • Gestion des stocks en temps réel

Procédure d’installation type :

# Via Odoo Apps (si module officiel)

1. Activer le mode développeur

2. Apps → Mettre à jour la liste des applications

3. Rechercher "WooCommerce"

4. Installer le module choisi

Configuration initiale dans Odoo :

  1. Paramètres → Connecteurs → API

  2. Créez un nouveau backend WooCommerce

  3. Entrez :

    • URL de la boutique WooCommerce (ex: https://votreboutique.ma)

    • Clé API (générée dans WooCommerce → Paramètres → Avancé → REST API)

    • Activer la synchronisation des commandes, produits, clients

Étape 3 : Configuration précise de la synchronisation

Mapping des données critiques :

Élément WooCommerce Mapping Odoo (spécifique Maroc)
Commande "Complétée" Facture client + Paiement enregistré
Commande "En attente" Bon de commande (non facturé)
Mode paiement "Virement" Journal bancaire spécifique
Mode paiement "À la livraison" Compte_client (à encaisser plus tard)
Produit "Simple" Article stockable/service
Frais de port Compte 706 (Prestations de services) ou 711 selon nature

Configuration TVA marocaine :

Dans le connecteur, définissez les règles fiscales :

  • Si le client est au Maroc → TVA 20%

  • Si export vers CEDEAO → TVA 0% avec justificatif

  • Si client professionnel avec TVA identifiée → Facturation avec TVA

Où configurer : Paramètres du connecteur → Règles fiscales → Créer une règle :

Condition : Client.pays = 'MA'

Action : Appliquer taxe 'TVA 20% Maroc'

Étape 4 : Test rigoureux avant mise en production

NE SYNCHRONISEZ JAMAIS DIRECTEMENT EN PRODUCTION SANS TEST !

Protocole de test marocain :

  1. Créez une commande test dans WooCommerce :

    • Produit avec TVA 20%

    • Client marocain (adresse à Casablanca, par exemple)

    • Paiement "Virement bancaire"

  2. Lancez la synchronisation manuelle :

    • Connecteurs → WooCommerce → Synchroniser manuellement

    • Vérifiez dans Odoo :

      • La facture générée a-t-elle le bon client ?

      • Les montants HT/TTC sont-ils corrects ?

      • La TVA est-elle sur le compte 44566 ?

      • Le compte de revenus est-il le 711 ?

  3. Vérifiez l’impact sur le plan comptable :

    • Accédez à Comptabilité → Journal des ventes

    • La ligne doit apparaître avec : 
      Débit : 411 (Client)
      
Crédit : 711 (Ventes) = montant HT
      
Crédit : 44566 (TVA collectée) = montant TVA

  4. Testez un scénario d’export :

    • Commandes avec adresse internationale

    • Commandes avec exonération (client export)

    • Commandes avec plusieurs produits (taux TVA différents)

Étape 5 : Automatisation et Plan Comptable Marocain

Configuration automatique :

Dans le connecteur, définissez :

  • Fréquence de synchronisation : Toutes les 15 minutes (ou heures selon volume)

  • Synchronisation automatique à l’état : "Processing" → "Completed" dans WooCommerce

Adaptation au Plan Comptable Marocain (PCM) :

Assurez-vous que vos comptes Odoo correspondent au PCM :

Type d’opération Compte PCM (exemple) Configuration Odoo
Vente de marchandises 711 Compte de revenus produit
TVA collectée 445661 Taxe 20%
Frais de port facturés 706 Compte de services
Ristournes commerciales 659 Compte de charges

Astuce : Dans Odoo, allez dans Comptabilité → Configuration → Comptes et filtrez par "Maroc" pour vérifier.

Étape 6 : Maintenance et bonnes pratiques

Journal de synchronisation :

surveillez régulièrement :

  • Connecteurs → Importations : Repérez les échecs

  • Journal des erreurs (Paramètres → Technique → Journal des erreurs)

Nettoyage périodique :

  1. Mensuellement :

    • Vérifiez la réconciliation automatique des paiements

    • Comparez le chiffre d’affaires WooCommerce vs Odoo (doivent être identiques)

    • Exportez le livre de TVA pour vérifier cohérence

  2. Après chaque mise à jour WooCommerce :

    • Testez la synchronisation avec 2-3 commandes

    • Vérifiez les nouveaux champs personnalisés

Dépannage courant (cas marocains) :

Problème Solution
TVA non calculée Vérifiez que le client a un pays (MA) et que les taxes WooCommerce sont activées
Compte de revenus wrong Vérifiez le mapping produit → catégorie → compte comptable
Devise en EUR au lieu de MAD Dans les paramètres WooCommerce, devise = MAD. Dans Odoo, monnaie de la société = MAD
Double écriture Désactivez la création automatique de facture dans WooCommerce si Odoo la crée

Conclusion : Les avantages pour votre entreprise marocaine

Une intégration propre entre Odoo et WooCommerce vous apporte :

✅ Conformité fiscale garantie : TVA calculée automatiquement selon les règles marocaines
✅ Gain de temps : Finies les saisies manuelles répétitives
✅ Visibilité en temps réel : Chiffre d’affaires, stocks, trésorerie à jour
✅ Audit simplifié : Toutes les transactions traçables, avec justificatifs liés
✅ Scalabilité : Gestion de milliers de commandes sans effort supplémentaire

Recommandation finale :

Pour les entreprises au Maroc, investissez dans une configuration initiale propre. Faites appel à un intégrateur Odoo francophone connaissant la réglementation marocaine si nécessaire. Les 2-3 jours passés à nettoyer les données et tester rigoureusement vous éviteront des mois de corrections comptables.

Ressources utiles :

Note : Ce tutoriel est générique. Pour votre configuration spécifique, consultez toujours un expert-comptable marocain, surtout concernant le plan comptable et les déclarations fiscales.