Aller au contenu principal

DoliHorus - Synchronisation comptable Horus pour Dolibarr

DoliHorus est un module Dolibarr qui synchronise vos factures et paiements entre Dolibarr et Horus, le logiciel de comptabilité belge. Il s'intègre directement dans votre interface Dolibarr et communique avec Horus via une connexion OAuth2 sécurisée, sans aucune dépendance externe (cURL natif).

Introduction

Qu'est-ce que Horus ?

Horus est un logiciel de comptabilité belge utilisé par de nombreuses fiduciaires et entreprises en Belgique. Il offre une gestion complète de la comptabilité, des journaux, des comptes et des déclarations fiscales.

Pourquoi DoliHorus ?

  • Synchronisation automatique : Envoyez vos factures de vente et d'achat directement de Dolibarr vers Horus, sans ressaisie
  • Clients synchronisés : Créez et mettez à jour automatiquement les fiches clients dans Horus à partir de Dolibarr
  • Suivi des paiements : Récupérez les statuts de paiement depuis Horus et créez automatiquement les paiements dans Dolibarr
  • Notes de crédit : Envoyez vos avoirs vers Horus en un clic
  • Mapping TVA configurable : Configurez la correspondance entre vos taux TVA Dolibarr et les comptes comptables Horus
  • Connexion sécurisée : Authentification OAuth2 pour une communication fiable et sécurisée
  • Multi-entité : Compatible avec les installations multi-entités de Dolibarr
  • Zéro dépendance : Fonctionne avec cURL natif, aucune librairie externe requise

Prérequis

Avant d'installer DoliHorus, vérifiez que votre environnement remplit les conditions suivantes :

Élément Version minimum
Dolibarr 18.0 ou supérieur
PHP 7.4 ou supérieur
Extensions PHP curl, json

Vous aurez également besoin d'un compte Horus avec accès API (identifiants OAuth2 : Client ID et Client Secret). Contactez votre fournisseur Horus pour obtenir ces informations.

Note : DoliHorus est compatible avec les installations multi-entités de Dolibarr. Chaque entité peut avoir sa propre configuration Horus.

Installation

Depuis le DoliStore

  1. Rendez-vous sur le DoliStore et recherchez DoliHorus
  2. Achetez le module et téléchargez l'archive ZIP
  3. Décompressez l'archive dans le dossier htdocs/custom/ de votre installation Dolibarr
  4. Le dossier final doit être htdocs/custom/dolihorus/

Activation dans Dolibarr

  1. Connectez-vous à Dolibarr en tant qu'administrateur
  2. Allez dans Accueil → Configuration → Modules/Applications
  3. Recherchez "DoliHorus" dans la liste des modules
  4. Cliquez sur le bouton Activer

Une fois le module activé, un nouveau menu DoliHorus apparaît dans votre barre de navigation.

Configuration

La configuration de DoliHorus s'effectue en trois étapes depuis les pages d'administration du module.

Étape 1 : Connexion OAuth2

  1. Accédez à DoliHorus → Configuration (page setup.php)
  2. Renseignez l'URL de votre instance Horus
  3. Saisissez votre Client ID OAuth2
  4. Saisissez votre Client Secret OAuth2
  5. Cliquez sur Tester la connexion pour vérifier que les identifiants sont corrects
  6. Une fois la connexion validée, cliquez sur Enregistrer

Important : Les identifiants OAuth2 sont fournis par votre administrateur Horus ou votre fiduciaire. Assurez-vous que l'accès API est activé sur votre compte Horus.

Étape 2 : Paramètres comptables

  1. Accédez à DoliHorus → Paramètres (page config.php)
  2. Sélectionnez le dossier comptable Horus à utiliser
  3. Configurez les journaux :
    • Journal des ventes (pour les factures clients)
    • Journal des achats (pour les factures fournisseurs)
    • Journal financier (pour les paiements)
  4. Définissez les comptes comptables par défaut pour les produits et services
  5. Configurez le type de paiement par défaut et le mapping des modes de paiement
  6. Validez la configuration

Astuce : Vous pouvez définir un compte comptable spécifique pour chaque produit ou service dans sa fiche Dolibarr. Le compte par défaut ne sera utilisé que si aucun compte spécifique n'est défini.

Étape 3 : Mapping TVA

  1. Accédez à DoliHorus → Mapping TVA (page tax_mapping.php)
  2. La page affiche tous vos taux TVA Dolibarr
  3. Pour chaque taux, associez le code TVA Horus correspondant
  4. Validez le mapping
Taux Dolibarr Code Horus typique Description
21% 21 TVA standard
12% 12 TVA réduit
6% 6 TVA réduit
0% 0 Exonéré / Intracommunautaire

Conseil : Assurez-vous de mapper tous vos taux TVA utilisés avant d'envoyer des factures. Un taux non mappé provoquera une erreur lors de l'envoi.

Utilisation

Synchronisation des clients

DoliHorus synchronise automatiquement les fiches clients entre Dolibarr et Horus.

Synchronisation automatique :

  • Lorsqu'un client Dolibarr est utilisé dans une facture envoyée vers Horus, DoliHorus vérifie s'il existe déjà dans Horus
  • Si le client n'existe pas, il est créé automatiquement avec ses informations (nom, adresse, numéro TVA)
  • Si le client existe déjà, ses informations sont mises à jour si nécessaire
  • La recherche se fait par numéro de TVA pour éviter les doublons

Synchronisation manuelle :

  1. Ouvrez la fiche d'un tiers dans Dolibarr
  2. Cliquez sur l'onglet Horus
  3. Cliquez sur Synchroniser vers Horus pour forcer la synchronisation

Envoi de factures de vente

  1. Ouvrez une facture client validée dans Dolibarr
  2. Cliquez sur l'onglet Horus
  3. Vérifiez le résumé de la facture et les informations comptables
  4. Cliquez sur Envoyer vers Horus
  5. Le système transmet la facture avec toutes les lignes, montants TVA et comptes comptables

Envoi automatique :

Vous pouvez activer l'envoi automatique dans les paramètres du module. Les factures seront alors envoyées vers Horus dès leur validation dans Dolibarr.

Envoi de factures d'achat

Le processus est identique pour les factures fournisseurs :

  1. Ouvrez une facture fournisseur validée
  2. Cliquez sur l'onglet Horus
  3. Cliquez sur Envoyer vers Horus
  4. La facture est enregistrée dans le journal des achats configuré

Envoi de notes de crédit

Les avoirs (notes de crédit) sont envoyés de la même manière que les factures :

  1. Ouvrez un avoir validé dans Dolibarr
  2. Cliquez sur l'onglet Horus
  3. Cliquez sur Envoyer vers Horus
  4. L'avoir est enregistré dans Horus avec les montants en négatif

Récupération des paiements

DoliHorus peut interroger Horus pour récupérer les statuts de paiement de vos factures.

  1. Accédez à DoliHorus → Paiements
  2. Cliquez sur Vérifier les paiements pour interroger Horus
  3. Les factures payées dans Horus sont identifiées
  4. Cliquez sur Créer les paiements pour enregistrer automatiquement les paiements dans Dolibarr

Astuce : Vous pouvez configurer une tâche planifiée (cron) pour automatiser la vérification des paiements à intervalles réguliers.

Statuts de synchronisation

Statut Description
Non envoyée La facture n'a pas encore été envoyée vers Horus
Envoyée La facture a été transmise avec succès vers Horus
Payée Horus indique que la facture a été payée
Erreur L'envoi a échoué (voir le message d'erreur pour les détails)

Options avancées

La page DoliHorus → Configuration contient des paramètres supplémentaires pour affiner le comportement du module.

Comptes comptables par produit

Vous pouvez définir un compte comptable Horus spécifique pour chaque produit ou service dans Dolibarr. Lors de l'envoi d'une facture, DoliHorus utilisera :

  1. Le compte comptable défini sur le produit (si renseigné)
  2. Le compte comptable par défaut configuré dans les paramètres du module (sinon)

Mapping des types de paiement

Configurez la correspondance entre les modes de paiement Dolibarr et les types de paiement Horus :

Mode Dolibarr Type Horus
Virement bancaire Virement
Carte bancaire Carte
Prélèvement Domiciliation
Espèces Caisse

Envoi automatique

Activez l'envoi automatique pour que les factures soient transmises vers Horus dès leur validation. Cette option peut être configurée séparément pour :

  • Les factures de vente
  • Les factures d'achat
  • Les notes de crédit

Multi-entité

En mode multi-entité, chaque entité Dolibarr dispose de sa propre configuration DoliHorus :

  • Identifiants OAuth2 distincts
  • Dossier comptable Horus séparé
  • Journaux et comptes comptables indépendants
  • Mapping TVA propre à chaque entité

Maintenance et diagnostic

La page de maintenance vous permet de vérifier l'état de votre installation et de diagnostiquer les problèmes éventuels.

Vérification de la connexion

Accédez à DoliHorus → Maintenance (page maintenance.php) pour lancer une vérification :

  • Connexion OAuth2 : Test d'authentification avec Horus
  • Token valide : Vérification que le token d'accès est actif
  • Dossier comptable : Validation de l'accès au dossier configuré
  • Version API : Compatibilité avec la version de l'API Horus

Page À propos

La page DoliHorus → À propos (page about.php) affiche :

  • La version du module installée
  • Les informations de licence
  • Les liens utiles vers la documentation et le support

Callback OAuth2

La page callback.php gère le retour d'authentification OAuth2. Elle est utilisée automatiquement lors de la connexion initiale et du renouvellement des tokens. Vous n'avez normalement pas à intervenir sur cette page.

Problèmes courants

L'envoi échoue avec "Authentication failed"

  • Vérifiez vos identifiants OAuth2 dans la configuration
  • Testez la connexion depuis la page Maintenance
  • Vérifiez que votre accès API Horus est toujours actif

Erreur "Tax mapping missing"

  • Un taux TVA utilisé dans la facture n'a pas de correspondance Horus
  • Allez dans le mapping TVA et configurez le taux manquant

Erreur "Accounting folder not found"

  • Le dossier comptable configuré n'est plus accessible
  • Vérifiez la configuration et sélectionnez un dossier valide

Le client n'est pas créé dans Horus

  • Vérifiez que le numéro de TVA est renseigné sur la fiche tiers Dolibarr
  • Assurez-vous que la connexion API est fonctionnelle

Les paiements ne se synchronisent pas

  • Vérifiez que les factures ont bien été envoyées vers Horus au préalable
  • Testez la connexion depuis la page Maintenance
  • Vérifiez que le journal financier est correctement configuré

FAQ

Quels types de factures sont supportés ?

DoliHorus supporte les factures de vente, les factures d'achat (fournisseurs) et les notes de crédit (avoirs) pour les deux types.

DoliHorus fonctionne-t-il en multi-entité ?

Oui, DoliHorus supporte les installations multi-entités de Dolibarr. Chaque entité peut avoir sa propre configuration OAuth2, dossier comptable et mapping TVA.

Les paiements sont-ils créés automatiquement dans Dolibarr ?

Oui, lorsque DoliHorus détecte qu'une facture a été payée dans Horus, il peut créer automatiquement le paiement correspondant dans Dolibarr. Cette fonctionnalité peut être déclenchée manuellement ou via une tâche planifiée.

Faut-il installer des librairies supplémentaires ?

Non, DoliHorus utilise exclusivement cURL natif de PHP pour communiquer avec l'API Horus. Aucune dépendance externe n'est requise.

Comment sont gérés les doublons de clients ?

DoliHorus utilise le numéro de TVA comme identifiant unique pour la synchronisation des clients. Si un client avec le même numéro de TVA existe déjà dans Horus, ses informations sont mises à jour au lieu de créer un doublon.

Comment mettre à jour le module ?

  1. Téléchargez la nouvelle version depuis le DoliStore
  2. Remplacez les fichiers dans htdocs/custom/dolihorus/
  3. Accédez à Dolibarr, le module détectera la mise à jour et appliquera les migrations nécessaires

Où trouver de l'aide ?

  • Support E-dem : Contactez-nous pour toute question technique
  • Documentation Horus : Contactez votre fournisseur Horus pour les questions relatives à l'API