EM Clearfacts

EMClearFacts — Envoi automatique de vos factures vers Clearfacts

Le module EMClearFacts connecte votre Dolibarr directement à la plateforme comptable Clearfacts via son API GraphQL officielle. Envoyez vos factures clients et fournisseurs vers votre dossier comptable en un clic ou automatiquement, au format XML UBL ou PDF, avec une piste d'audit complète et permanente de chaque envoi.

Fini le dépôt manuel de PDF dans Clearfacts : validez votre facture dans Dolibarr, EMClearFacts s'occupe du reste.

🚀 Envoi de factures clients et fournisseurs

• Envoi en un clic depuis la fiche d'une facture validée
• Envoi automatique à la validation grâce à une file d'attente intelligente
• Support des factures de vente et des factures fournisseurs (achat), avec activation indépendante
• Gestion native des avoirs (credit notes)
• Action de masse « Ajouter à la file Clearfacts » sur les listes de factures
• Bouton Clearfacts et badge de statut directement sur la fiche de chaque facture (affichage configurable)

📄 Format intelligent : XML UBL ou PDF

EMClearFacts détecte automatiquement le meilleur format disponible pour chaque facture :

• Si un fichier XML UBL est attaché (par exemple via le module EMPeppol ou un autre module de facturation électronique), il est transmis en priorité à Clearfacts — ce qui permet la comptabilisation automatique des lignes, TVA et totaux
• Sinon, le PDF de la facture est envoyé automatiquement
• Comportement configurable : préférer systématiquement le XML, ou toujours envoyer le PDF

🔐 Deux méthodes d'authentification au choix

• OAuth 2.0 (recommandé pour un usage multi-utilisateurs) — flot Authorization Code via un relais automatique, plus besoin de copier-coller de code
• Personal Access Token (PAT) de 80 caractères — idéal pour un usage interne, une seule personne, configuration en 30 secondes
• Basculement entre les deux méthodes à tout moment sans perdre l'historique

🏢 Détection automatique de l'administration

Plus besoin de saisir manuellement le numéro de TVA de votre dossier Clearfacts :

• EMClearFacts interroge l'API Clearfacts et liste automatiquement les administrations auxquelles vous avez accès
• Sélection par menu déroulant si plusieurs administrations, sélection automatique s'il n'y en a qu'une
• Affichage du nom, du numéro d'entreprise et des détails directement depuis l'API

⚙️ File d'attente intelligente

Entre la validation d'une facture et son envoi effectif à Clearfacts, un délai configurable vous laisse la main :

• Délai avant envoi automatique (15 minutes par défaut) — annulez ou modifiez une facture juste après validation sans qu'elle parte
• Retries automatiques avec backoff exponentiel (1 min, 5 min, 15 min) en cas d'erreur temporaire
• Récupération automatique des items bloqués (worker interrompu, crash PHP) au bout de 15 minutes
• Bouton « Traiter maintenant » qui bypass les délais de retry pour forcer un envoi immédiat après correction d'un problème
• Annulation d'un envoi en attente, relance individuelle ou en masse d'une facture en échec

📊 Historique permanent (audit trail)

Chaque envoi est tracé de manière permanente et jamais purgé. L'historique constitue votre piste d'audit officielle :

• Date et heure précises de chaque tentative
• UUID Clearfacts retourné par l'API pour chaque envoi réussi (lien direct vers le document dans votre compte Clearfacts)
• Format transmis (PDF ou XML UBL), utilisateur ayant initié l'envoi
• Message d'erreur détaillé en cas d'échec
• Page dédiée « Factures envoyées » avec filtres par statut, type, référence, plage de dates
• Onglet Clearfacts sur chaque fiche facture — historique localisé pour une facture donnée
• Protection anti-doublon automatique : une facture déjà envoyée avec succès n'est jamais renvoyée par erreur

🧪 Sandbox et production

• Commutateur d'environnement entre Sandbox (sandbox.clearfacts.be) et Production (app.clearfacts.be)
• Bandeau jaune visible sur toutes les pages en mode Sandbox pour éviter toute confusion
• Testez votre configuration avec de vraies factures avant de passer en production

⚡ Simple à installer, puissant à utiliser

• Aucune dépendance externe — pas de Composer, pas de bibliothèque tierce à installer, le module fonctionne immédiatement après extraction
• Mode Simple / Expert : interface épurée pour démarrer vite, options avancées accessibles en un clic
• Non-intrusif : hooks et triggers uniquement, aucune modification du core Dolibarr
• Compatible Multicompany : configuration indépendante par entité (token, administration, options d'envoi)
• Tâche planifiée Dolibarr intégrée pour le traitement automatique de la file d'attente (toutes les 5 minutes)
• Documentation utilisateur complète en français et en anglais incluse dans le module (installation, configuration, utilisation, FAQ)

🔧 Compatibilité

• Dolibarr : 18.0+
• PHP : 7.4 — 8.3
• Compatible avec ou sans module Multicompany
• Compatible avec d'autres modules de facturation électronique comme EMPeppol (envoyez vers Clearfacts et Peppol depuis la même facture)

📚 En savoir plus

👉 Page produit EMClearFacts

👉 Documentation complète — guide d'installation, configuration, FAQ et cas d'usage

🤝 Support et mises à jour

Module activement maintenu et mis à jour régulièrement. Support réactif par email.

• 📧 Support : support@e-dem.com
• 🌐 Site web : www.e-dem.com