EM SmartFill

emSmartFill — Saubere belgische Kundendaten dank BCE/KBO

Das Modul emSmartFill verbindet Ihr Dolibarr mit dem offiziellen belgischen Unternehmensregister BCE/KBO (Banque-Carrefour des Entreprises) über die API cbeapi.be. Mit einem Klick verifizieren Sie Ihre belgischen Geschäftspartner, befüllen deren Karten mit offiziellen Daten und bereinigen massenhaft fehlerhaft formatierte USt-IdNr. Ideal für Steuerberater, Freiberufler und KMU, die eine saubere Kundendatenbank wünschen — und ab 2026 eine Voraussetzung für die kommende belgische Peppol-B2B-Pflicht zur elektronischen Rechnung.

✅ Verifizierung per Klick aus der Geschäftspartner-Karte

• Auf jeder belgischen Geschäftspartner-Karte erscheint eine Schaltfläche „Mit BCE prüfen"
• Echtzeit-Abruf von offiziellem Namen, vollständiger Anschrift, Rechtsform, Status (aktiv/eingestellt) und NACE-Codes
• Verifizierungsstatus auf der Karte gespeichert: Verifiziert, Nicht gefunden, Fehler
• Datum der letzten Prüfung direkt am Geschäftspartner sichtbar

🎯 Intelligentes Vorausfüllen — feldweiser Vergleich

Statt eines blinden Überschreibens, das Ihre lokalen Änderungen zerstört, vergleicht emSmartFill Feld für Feld die BCE-Daten mit Ihren Dolibarr-Werten und lässt Sie genau wählen, was aktualisiert wird:

• Visueller Vergleich Aktueller Wert / BCE-Wert / Status pro Feld
• Individuelle Checkboxen — standardmäßig nur für leere oder abweichende Felder aktiviert
• Schnellauswahl: „Alle Unterschiede auswählen" und „Nur leere Felder auswählen"
• Abgedeckte Felder: Name, Alias, Adresse, PLZ, Stadt, Land, Unternehmensnummer (BCE), USt-IdNr

🧹 Massen-Normalisierung der USt-IdNr — mehrländer

In den meisten Kundendatenbanken sammeln sich fehlerhaft formatierte USt-IdNr an: fehlendes Länderkürzel, Punkte, Bindestriche, Leerzeichen, uneinheitliche Schreibweise. emSmartFill erkennt und korrigiert das in wenigen Klicks, in Ihrer gesamten Datenbasis, für 10 europäische Länder:

• 🇧🇪 Belgien, 🇫🇷 Frankreich, 🇱🇺 Luxemburg, 🇳🇱 Niederlande, 🇩🇪 Deutschland, 🇪🇸 Spanien, 🇮🇹 Italien, 🇵🇹 Portugal, 🇦🇹 Österreich, 🇮🇪 Irland
• 3 Tabs: Analyse (Kategorisierung), Auto-Korrekturen (Massenanwendung), Manuelle Prüfung (mehrdeutige Fälle)
• Jede Korrektur wird im Audit-Log festgehalten (vorher/nachher)
• Es wird nichts geändert ohne Ihre explizite Bestätigung

⚡ Massenverifizierung bis 4000+ Geschäftspartner

Sie haben eine große Datenbasis zu prüfen? Das Modul bewältigt das ohne Timeouts oder API-Überlastung:

• Chunked-AJAX-Pipeline — kein HTTP-Aufruf dauert länger als 10 Sekunden
• Pause / Fortsetzen jederzeit — Tab schließen und später weitermachen
• Filter: alle, nie verifiziert, nicht verifiziert seit Datum, Fehler erneut versuchen, „nicht gefunden" erneut versuchen
• Konfigurierbare Drosselung zur Einhaltung der API-Kontingente
• Automatische Erkennung unterbrochener Läufe (Browser-Absturz, Verbindungsabbruch) und Wiederaufnahme per Klick
• Detaillierter Bericht pro Lauf mit Statusfiltern und direktem Link zu jedem Geschäftspartner

🤖 Optionale Automatisierung

• Dolibarr-Trigger: automatische Verifizierung bei Anlage/Änderung eines Geschäftspartners (standardmäßig deaktiviert)
• Automatisches Vorausfüllen bei der Anlage (unabhängige Option)
• Kompatibel mit der nativen USt-Schaltfläche von Dolibarr — emSmartFill ersetzt sie durch eine Version, die für Belgien tatsächlich funktioniert

📊 Audit-Log & Wartung

• Jede Verifizierung, jedes Vorausfüllen und jede Korrektur wird geloggt (wer, wann, was)
• Debug-Seite: Filter nach Aktionstyp / Status / Datum / Benutzer, ausklappbare Ansicht der Roh-API-Antworten
• Wartungsseite: Datenbankintegritätsprüfung, Reparatur der Zusatzfelder bei Bedarf

🛡️ Sicherheit & Compliance

• Strenge CSRF-Prüfung bei allen sensiblen Aktionen
• API-Schlüssel verschlüsselt in der Dolibarr-Konfiguration und nie im HTML erneut sichtbar
• Automatischer Retry / Backoff bei API-Lastspitzen (429, 5xx)
• Nicht-invasive Architektur: nur Hooks und Trigger, keine Änderung am Dolibarr-Core

🔌 Voraussetzungen

Das Modul nutzt die API cbeapi.be, einen belgischen Anbieter, der auf den Zugriff auf das BCE/KBO-Register spezialisiert ist. 2500 kostenlose Anfragen pro Tag nach Registrierung — für die meisten KMU mehr als ausreichend. Für höhere Volumina (mehr als 2500 Prüfungen/Tag, typisch für Steuerkanzleien mit großer Mandantenbasis) sind kostenpflichtige Tarife direkt bei cbeapi.be verfügbar.

Hinweis: Dieses Modul funktioniert nur für belgische Unternehmen (Prüfung gegen das BCE/KBO). Die USt-Normalisierung hingegen ist EU-weit (mehrländer).

🔧 Kompatibilität

• Dolibarr: 17.0 → 22.0
• PHP: 8.0 → 8.3
• Kompatibel mit oder ohne Multicompany-Modul
• Keine externen Abhängigkeiten (kein Composer in Produktion)

📚 Mehr erfahren

👉 emSmartFill Produktseite

👉 Vollständige Dokumentation — Installationsanleitung, Einrichtung des cbeapi.be-API-Schlüssels, FAQ und Anwendungsfälle

🔗 Synergien mit anderen E-dem-Modulen

emSmartFill bereitet den Boden für die Peppol-E-Rechnung, die ab 2026 in Belgien für B2B verpflichtend ist. Eine saubere Geschäftspartner-Basis = Peppol-Rechnungen, die fehlerfrei durchgehen. Kombinieren mit:

• emPeppol — Senden/Empfangen von Rechnungen über das Peppol-Netzwerk

🤝 Support & Updates

Aktiv gepflegtes Modul. Reaktionsschneller E-Mail-Support.

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