EM Clearfacts

EMClearFacts — Invio automatico delle fatture a Clearfacts da Dolibarr

Il modulo EMClearFacts collega il tuo Dolibarr direttamente alla piattaforma contabile Clearfacts tramite la sua API GraphQL ufficiale. Invia le tue fatture clienti e fornitori al tuo commercialista con un clic o automaticamente, in formato XML UBL o PDF, con una pista di audit completa e permanente di ogni invio.

Basta caricare manualmente i PDF su Clearfacts: convalida la tua fattura in Dolibarr, EMClearFacts pensa al resto.

🚀 Invio di fatture clienti e fornitori

• Invio in un clic dalla scheda di qualsiasi fattura convalidata
• Invio automatico alla convalida tramite una coda intelligente
• Supporto per fatture di vendita e fatture di acquisto, con attivazione indipendente
• Gestione nativa delle note di credito
• Azione di massa «Aggiungi alla coda Clearfacts» sulle liste delle fatture
• Pulsante Clearfacts e badge di stato direttamente sulla scheda di ogni fattura (visualizzazione configurabile)

📄 Formato intelligente: XML UBL o PDF

EMClearFacts rileva automaticamente il miglior formato disponibile per ogni fattura:

• Se un file XML UBL è allegato alla fattura (ad esempio tramite il modulo EMPeppol o un altro modulo di fatturazione elettronica), viene inviato in priorità a Clearfacts — permettendo la registrazione automatica di righe, IVA e totali
• Altrimenti, il PDF della fattura viene inviato automaticamente
• Comportamento configurabile: preferire sempre XML o inviare sempre PDF

🔐 Due metodi di autenticazione a scelta

• OAuth 2.0 (consigliato per uso multi-utente) — flusso Authorization Code tramite un relay automatico, senza dover copiare-incollare codici
• Personal Access Token (PAT) di 80 caratteri — ideale per uso interno monoutente, configurazione in 30 secondi
• Passa da un metodo all'altro in qualsiasi momento senza perdere la cronologia

🏢 Rilevamento automatico dell'amministrazione

Non è più necessario inserire manualmente la partita IVA del tuo dossier Clearfacts:

• EMClearFacts interroga l'API Clearfacts e elenca automaticamente le amministrazioni a cui hai accesso
• Selezione tramite menu a tendina se ci sono più amministrazioni, selezione automatica se ce n'è solo una
• Mostra nome, numero azienda e dettagli direttamente dall'API

⚙️ Coda di invio intelligente

Tra la convalida di una fattura e il suo effettivo invio, un ritardo configurabile ti lascia il controllo:

• Ritardo prima dell'invio automatico (15 minuti per impostazione predefinita) — annulla o modifica una fattura subito dopo la convalida senza che venga inviata
• Retry automatici con backoff esponenziale (1 min, 5 min, 15 min) in caso di errore temporaneo
• Recupero automatico di elementi bloccati (worker interrotto, crash PHP) dopo 15 minuti
• Pulsante «Elabora ora» che bypassa le finestre di backoff per forzare un invio immediato dopo la correzione di un problema
• Annullamento di un invio in sospeso, retry individuale o in massa delle fatture in errore

📊 Cronologia permanente (audit trail)

Ogni invio è tracciato in modo permanente e mai cancellato. La cronologia è la tua pista di audit ufficiale:

• Data e ora precise di ogni tentativo
• UUID Clearfacts restituito dall'API per ogni invio riuscito (link diretto al documento nel tuo account Clearfacts)
• Formato trasmesso (PDF o XML UBL), utente che ha avviato l'invio
• Messaggio di errore dettagliato in caso di fallimento
• Pagina dedicata «Fatture inviate» con filtri per stato, tipo, riferimento, intervallo di date
• Scheda Clearfacts su ogni scheda fattura — cronologia per una fattura specifica
• Protezione automatica contro i duplicati: una fattura già inviata con successo non viene mai rinviata per errore

🧪 Sandbox e produzione

• Commutatore di ambiente tra Sandbox (sandbox.clearfacts.be) e Produzione (app.clearfacts.be)
• Banner giallo visibile su tutte le pagine del modulo in modalità Sandbox per evitare confusioni
• Testa la tua configurazione con fatture reali prima di passare in produzione

⚡ Semplice da installare, potente da usare

• Nessuna dipendenza esterna — niente Composer, nessuna libreria di terze parti da installare, il modulo funziona subito dopo l'estrazione
• Modalità Semplice / Esperto: interfaccia pulita per iniziare velocemente, opzioni avanzate accessibili con un clic
• Non invasivo: solo hook e trigger, nessuna modifica al core di Dolibarr
• Compatibile con Multicompany: configurazione indipendente per entità (token, amministrazione, opzioni di invio)
• Cron job Dolibarr integrato per l'elaborazione automatica della coda (ogni 5 minuti)
• Documentazione completa per l'utente finale in francese e inglese inclusa nel modulo (installazione, configurazione, utilizzo, FAQ)

🔧 Compatibilità

• Dolibarr: 18.0+
• PHP: 7.4 — 8.3
• Compatibile con o senza il modulo Multicompany
• Funziona insieme ad altri moduli di fatturazione elettronica come EMPeppol (invia a Clearfacts e Peppol dalla stessa fattura)

📚 Per saperne di più

👉 Pagina prodotto EMClearFacts

👉 Documentazione completa — guida di installazione, configurazione, FAQ e casi d'uso

🤝 Supporto e aggiornamenti

Modulo mantenuto attivamente e aggiornato regolarmente. Supporto via email reattivo.

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