EM SmartFill

emSmartFill — Dati clienti belgi sempre accurati grazie al BCE/KBO

Il modulo emSmartFill collega il tuo Dolibarr al registro ufficiale belga BCE/KBO (Banque-Carrefour des Entreprises) tramite l'API cbeapi.be. Con un solo clic, verifichi i tuoi clienti/fornitori belgi, precompili le loro schede con i dati ufficiali e ripulisci in massa le partite IVA mal formattate. Ideale per commercialisti, liberi professionisti e PMI che vogliono un anagrafica clienti pulita — ed è ora un prerequisito per il futuro obbligo belga di fatturazione elettronica Peppol B2B (2026).

✅ Verifica con un clic dalla scheda controparte

• Su ogni scheda di controparte belga compare un pulsante «Verifica con BCE»
• Recupero in tempo reale di nome ufficiale, indirizzo completo, forma giuridica, stato (attiva/cessata) e codici NACE
• Stato di verifica mantenuto sulla scheda: Verificato, Non trovato, Errore
• Data dell'ultima verifica visibile direttamente sulla controparte

🎯 Precompilazione intelligente — confronto campo per campo

Invece di una sovrascrittura cieca che distrugge le tue modifiche locali, emSmartFill confronta campo per campo i dati BCE con i tuoi dati Dolibarr, e ti permette di scegliere con precisione cosa aggiornare:

• Confronto visivo Valore attuale / Valore BCE / Stato per ogni campo
• Caselle individuali — selezionate di default solo per campi vuoti o diversi
• Scorciatoie: «Seleziona tutte le differenze» e «Seleziona solo i campi vuoti»
• Campi coperti: nome, alias, indirizzo, CAP, città, paese, numero d'impresa (BCE), partita IVA

🧹 Normalizzazione partite IVA in massa — multi-paese

Molte anagrafiche clienti accumulano nel tempo partite IVA mal formattate: prefisso paese mancante, punti, trattini, spazi, maiuscole/minuscole incoerenti. emSmartFill le individua e le corregge in pochi clic, su tutta la tua base, per 10 paesi europei:

• 🇧🇪 Belgio, 🇫🇷 Francia, 🇱🇺 Lussemburgo, 🇳🇱 Paesi Bassi, 🇩🇪 Germania, 🇪🇸 Spagna, 🇮🇹 Italia, 🇵🇹 Portogallo, 🇦🇹 Austria, 🇮🇪 Irlanda
• 3 schede: Analisi (categorizzazione), Correzioni automatiche (in massa), Revisione manuale (casi ambigui)
• Ogni correzione registrata nel registro di audit (prima/dopo)
• Niente viene modificato senza la tua conferma esplicita

⚡ Verifica in massa fino a 4000+ controparti

Hai una grande anagrafica da verificare? Il modulo la gestisce senza timeout o saturazione dell'API:

• Pipeline AJAX a lotti — nessuna chiamata HTTP dura più di 10 secondi
• Pausa / Ripresa in qualsiasi momento — puoi chiudere la scheda e riprendere più tardi
• Filtri: tutti, mai verificati, non verificati dalla data, riprova errori, riprova «non trovati»
• Throttle configurabile per rispettare le quote dell'API
• Rilevamento automatico delle esecuzioni interrotte (crash del browser, disconnessione) e ripresa con un clic
• Report dettagliato per esecuzione con filtri per stato e link diretto a ogni controparte

🤖 Automazione opzionale

• Trigger Dolibarr: verifica automatica alla creazione/modifica di una controparte (opzione disattivata di default)
• Precompilazione automatica alla creazione (opzione indipendente)
• Compatibile con il pulsante IVA nativo di Dolibarr — emSmartFill lo sostituisce con una versione che funziona davvero per il Belgio

📊 Registro audit e manutenzione

• Ogni verifica, precompilazione e correzione viene registrata (chi, quando, cosa)
• Pagina di debug: filtri per tipo di azione / stato / data / utente, vista espandibile delle risposte API grezze
• Pagina di manutenzione: controllo di integrità del database, riparazione dei campi extra se necessario

🛡️ Sicurezza e conformità

• Validazione CSRF rigorosa su tutte le azioni sensibili
• Chiave API cifrata nella configurazione di Dolibarr e mai riesposta nell'HTML
• Retry / backoff automatico in caso di picchi di carico dell'API (429, 5xx)
• Architettura non invasiva: solo hook e trigger, nessuna modifica al core di Dolibarr

🔌 Prerequisiti

Il modulo utilizza l'API cbeapi.be, un provider belga specializzato nell'accesso al registro BCE/KBO. 2500 richieste al giorno gratuite alla registrazione — più che sufficienti per la maggior parte delle PMI. Per volumi maggiori (più di 2500 verifiche/giorno, tipicamente studi commercialisti con grande clientela), sono disponibili piani a pagamento direttamente su cbeapi.be.

Nota: questo modulo funziona solo per le società belghe (verifica contro il BCE/KBO). La normalizzazione delle partite IVA, invece, è multi-paese UE.

🔧 Compatibilità

• Dolibarr: 17.0 → 22.0
• PHP: 8.0 → 8.3
• Compatibile con o senza il modulo Multicompany
• Nessuna dipendenza esterna (nessun composer in produzione)

📚 Per saperne di più

👉 Pagina prodotto emSmartFill

👉 Documentazione completa — guida all'installazione, configurazione della chiave API cbeapi.be, FAQ e casi d'uso

🔗 Sinergie con gli altri moduli E-dem

emSmartFill prepara il terreno per la fatturazione elettronica Peppol resa obbligatoria in Belgio per il B2B nel 2026. Un'anagrafica controparti pulita = fatture Peppol che vanno a buon fine senza errori. Da abbinare a:

• emPeppol — invio/ricezione di fatture tramite la rete Peppol

🤝 Supporto e aggiornamenti

Modulo mantenuto attivamente. Supporto reattivo via email.

• 📧 Supporto: support@e-dem.com
• 🌐 Sito web: www.e-dem.com