EM Clearfacts

EMClearFacts — Automatic invoice sending to Clearfacts from Dolibarr

The EMClearFacts module connects your Dolibarr directly to the Clearfacts accounting platform through its official GraphQL API. Send your customer and supplier invoices to your accountant in one click or automatically, in XML UBL or PDF format, with a complete and permanent audit trail of every upload.

No more manual PDF uploads in Clearfacts: validate your invoice in Dolibarr, EMClearFacts takes care of the rest.

🚀 Customer and supplier invoice sending

• One-click sending from the card of any validated invoice
• Automatic sending on validation through a smart upload queue
• Support for sales invoices and purchase invoices, with independent activation
• Native handling of credit notes
• "Add to Clearfacts queue" mass action on invoice list pages
• Clearfacts button and status badge directly on each invoice card (display configurable)

📄 Smart format: XML UBL or PDF

EMClearFacts automatically detects the best available format for every invoice:

• If a UBL XML file is attached to the invoice (for example via the EMPeppol module or any other e-invoicing module), it is sent to Clearfacts as the preferred format — enabling automatic posting of line items, VAT and totals
• Otherwise, the invoice PDF is sent automatically
• Configurable behaviour: always prefer XML, or always send PDF

🔐 Two authentication methods

• OAuth 2.0 (recommended for multi-user scenarios) — Authorization Code flow through an automatic relay, no more copy-pasting of codes
• Personal Access Token (PAT) — an 80-character token, perfect for single-user internal usage, setup in 30 seconds
• Switch between both methods at any time without losing your history

🏢 Automatic administration detection

No more manual entry of your Clearfacts VAT number:

• EMClearFacts queries the Clearfacts API and automatically lists the administrations you have access to
• Dropdown selection if several administrations are available, automatic selection if there is only one
• Displays the name, company number and details directly from the API

⚙️ Smart upload queue

Between invoice validation and actual upload, a configurable delay keeps you in control:

• Delay before automatic sending (15 minutes by default) — cancel or modify an invoice right after validation without it being sent
• Automatic retries with exponential backoff (1 min, 5 min, 15 min) on temporary failures
• Automatic recovery of stuck items (interrupted worker, PHP crash) after 15 minutes
• "Process now" button that bypasses backoff windows to force an immediate upload after fixing an issue
• Cancel a pending upload, retry a single failed item or all failed items at once

📊 Permanent audit trail

Every upload is traced permanently and never purged. The history is your official audit trail:

• Exact date and time of every attempt
• Clearfacts UUID returned by the API on successful uploads (direct link to the document in your Clearfacts account)
• Transmitted format (PDF or UBL XML), user who initiated the upload
• Detailed error message on failure
• Dedicated "Sent invoices" page with filters by status, type, reference, date range
• Clearfacts tab on every invoice card — localized history for a given invoice
• Automatic duplicate protection: an invoice already sent successfully is never sent again by mistake

🧪 Sandbox and production

• Environment switch between Sandbox (sandbox.clearfacts.be) and Production (app.clearfacts.be)
• Yellow banner visible on every module page in Sandbox mode to prevent any confusion
• Test your setup with real invoices before going live

⚡ Easy to install, powerful to use

• No external dependencies — no Composer, no third-party library to install, the module works right after extraction
• Simple / Expert mode: clean interface to get started fast, advanced options accessible in one click
• Non-intrusive: hooks and triggers only, no Dolibarr core modifications
• Multicompany compatible: independent configuration per entity (token, administration, sending options)
• Built-in Dolibarr scheduled task for automatic queue processing (every 5 minutes)
• Complete end-user documentation in English and French shipped with the module (installation, configuration, usage, FAQ)

🔧 Compatibility

• Dolibarr: 18.0+
• PHP: 7.4 — 8.3
• Compatible with or without the Multicompany module
• Works alongside other e-invoicing modules such as EMPeppol (send to Clearfacts and Peppol from the same invoice)

📚 Learn more

👉 EMClearFacts product page

👉 Full documentation — installation guide, configuration, FAQ and use cases

🤝 Support and updates

Actively maintained and regularly updated module. Responsive email support.

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