EM Clearfacts

EMClearFacts — Automatischer Rechnungsversand an Clearfacts aus Dolibarr

Das Modul EMClearFacts verbindet Ihr Dolibarr direkt mit der Buchhaltungsplattform Clearfacts über deren offizielle GraphQL-API. Senden Sie Ihre Kunden- und Lieferantenrechnungen an Ihren Steuerberater mit einem Klick oder automatisch, im Format XML UBL oder PDF, mit einer vollständigen und dauerhaften Prüfspur jedes Versands.

Schluss mit dem manuellen Hochladen von PDFs in Clearfacts: Rechnung in Dolibarr validieren, EMClearFacts erledigt den Rest.

🚀 Versand von Kunden- und Lieferantenrechnungen

• Versand mit einem Klick direkt aus der Rechnungskarte
• Automatischer Versand bei Validierung durch eine intelligente Warteschlange
• Unterstützung von Ausgangsrechnungen und Eingangsrechnungen mit unabhängiger Aktivierung
• Native Verarbeitung von Gutschriften
• Massenaktion „Zur Clearfacts-Warteschlange hinzufügen" in den Rechnungslisten
• Clearfacts-Button und Status-Badge direkt auf jeder Rechnungskarte (Anzeige konfigurierbar)

📄 Intelligentes Format: XML UBL oder PDF

EMClearFacts erkennt automatisch das beste verfügbare Format für jede Rechnung:

• Ist eine UBL-XML-Datei an der Rechnung angehängt (z. B. über das Modul EMPeppol oder ein anderes E-Invoicing-Modul), wird sie bevorzugt an Clearfacts gesendet — so können Positionen, Mehrwertsteuer und Summen automatisch verbucht werden
• Andernfalls wird das PDF der Rechnung automatisch gesendet
• Verhalten konfigurierbar: XML immer bevorzugen oder immer PDF senden

🔐 Zwei Authentifizierungsmethoden zur Auswahl

• OAuth 2.0 (empfohlen für Mehrbenutzer-Szenarien) — Authorization Code Flow über ein automatisches Relay, kein Code-Kopieren mehr nötig
• Personal Access Token (PAT) mit 80 Zeichen — ideal für interne Einzelbenutzer, Einrichtung in 30 Sekunden
• Jederzeit zwischen beiden Methoden wechseln, ohne den Verlauf zu verlieren

🏢 Automatische Erkennung der Administration

Keine manuelle Eingabe der USt-Nummer Ihres Clearfacts-Dossiers mehr nötig:

• EMClearFacts fragt die Clearfacts-API ab und listet automatisch die Administrationen auf, auf die Sie Zugriff haben
• Dropdown-Auswahl bei mehreren Administrationen, automatische Auswahl bei nur einer
• Anzeige von Name, Unternehmensnummer und Details direkt aus der API

⚙️ Intelligente Warteschlange

Zwischen Rechnungsvalidierung und tatsächlichem Versand lässt Sie eine konfigurierbare Verzögerung die Kontrolle behalten:

• Verzögerung vor dem automatischen Versand (standardmäßig 15 Minuten) — Rechnung direkt nach Validierung abbrechen oder anpassen, ohne dass sie gesendet wird
• Automatische Wiederholungen mit exponentiellem Backoff (1 Min., 5 Min., 15 Min.) bei temporären Fehlern
• Automatische Wiederherstellung hängender Einträge (abgebrochener Worker, PHP-Crash) nach 15 Minuten
• Button „Jetzt verarbeiten", der Backoff-Fenster umgeht und nach einer Korrektur einen sofortigen Versand erzwingt
• Abbruch eines wartenden Versands, einzelne oder gesammelte Wiederholung fehlgeschlagener Einträge

📊 Dauerhaftes Audit-Log

Jeder Versand wird dauerhaft protokolliert und niemals gelöscht. Das Verlaufsprotokoll ist Ihre offizielle Prüfspur:

• Genaues Datum und Uhrzeit jedes Versuchs
• Clearfacts-UUID, die von der API bei erfolgreichen Uploads zurückgegeben wird (direkter Link zum Dokument in Ihrem Clearfacts-Konto)
• Gesendetes Format (PDF oder UBL XML), Benutzer, der den Versand initiiert hat
• Detaillierte Fehlermeldung bei Fehlschlag
• Dedizierte Seite „Gesendete Rechnungen" mit Filtern nach Status, Typ, Referenz, Datumsbereich
• Clearfacts-Tab auf jeder Rechnungskarte — Verlauf für eine bestimmte Rechnung
• Automatischer Duplikatschutz: Eine erfolgreich gesendete Rechnung wird nie versehentlich erneut gesendet

🧪 Sandbox und Produktion

• Umgebungsumschalter zwischen Sandbox (sandbox.clearfacts.be) und Produktion (app.clearfacts.be)
• Gelbes Banner auf allen Modulseiten im Sandbox-Modus sichtbar, um Verwechslungen zu vermeiden
• Testen Sie Ihre Konfiguration mit echten Rechnungen, bevor Sie in Produktion gehen

⚡ Einfach zu installieren, leistungsstark im Einsatz

• Keine externen Abhängigkeiten — kein Composer, keine Drittbibliothek zu installieren, das Modul funktioniert direkt nach dem Extrahieren
• Einfacher / Expertenmodus: übersichtliche Oberfläche für den schnellen Start, erweiterte Optionen mit einem Klick verfügbar
• Nicht invasiv: nur Hooks und Trigger, keine Änderungen am Dolibarr-Core
• Multicompany-kompatibel: unabhängige Konfiguration pro Mandant (Token, Administration, Versandoptionen)
• Integrierter Dolibarr-Cron-Job für die automatische Verarbeitung der Warteschlange (alle 5 Minuten)
• Vollständige Endbenutzer-Dokumentation in Englisch und Französisch im Modul enthalten (Installation, Konfiguration, Nutzung, FAQ)

🔧 Kompatibilität

• Dolibarr: 18.0+
• PHP: 7.4 — 8.3
• Kompatibel mit oder ohne Multicompany-Modul
• Funktioniert neben anderen E-Invoicing-Modulen wie EMPeppol (senden Sie an Clearfacts und Peppol von derselben Rechnung)

📚 Weitere Informationen

👉 EMClearFacts-Produktseite

👉 Vollständige Dokumentation — Installationsanleitung, Konfiguration, FAQ und Anwendungsfälle

🤝 Support und Updates

Aktiv gepflegtes und regelmäßig aktualisiertes Modul. Reaktionsschneller E-Mail-Support.

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