E-Invoice: XRechnung 3.0, ZUGFeRD & Factur-X

Fatturazione elettronica strutturata per Dolibarr — 100 % locale

Questo modulo aggiunge a Dolibarr una fatturazione elettronica completamente strutturata. Copre sia i requisiti del settore pubblico tedesco (B2G) sia quelli del commercio tra imprese (B2B) in un unico pacchetto autonomo che funziona interamente sul vostro server. Nessun dato lascia il vostro sistema e non è richiesto alcun abbonamento a un servizio di conversione di terze parti.

Formati di esportazione

• XRechnung 3.0 (UBL 2.1) — Documenti Invoice e CreditNote, il formato richiesto per le fatture destinate alle autorità federali tedesche.
• ZUGFeRD / Factur-X (UN/CEFACT CII) — XML strutturato incorporato nel PDF della fattura come vero file ibrido PDF/A-3, tramite la libreria inclusa atgp/factur-x. I destinatari ricevono in un unico allegato un PDF leggibile dall'uomo e un XML leggibile dalla macchina.

Generazione automatica alla validazione della fattura

Quando validate (approvate) una fattura in Dolibarr, il modulo genera automaticamente l'XML e lo allega al documento. Il trigger adotta una logica Soft-Fail: se la generazione fallisce, Dolibarr prosegue normalmente e registra l'errore senza bloccare il flusso di approvazione.

Importazione delle fatture fornitori

Caricate un file XML UBL 2.1 o CII e il modulo crea una bozza di fattura fornitore in Dolibarr. Il fornitore viene abbinato tramite la partita IVA o la ragione sociale; se non viene trovata alcuna corrispondenza, viene creato automaticamente un nuovo record fornitore. Le righe vengono trasferite senza reinserimento manuale.

Controllo di plausibilità EN16931 integrato

Prima della generazione o dell'importazione, il modulo esegue un controllo nativo in PHP che copre le regole sui campi obbligatori EN16931 (serie BR-*) e le regole di coerenza aritmetica (serie BR-CO-*). Il risultato è un elenco chiaro di errori e avvisi mostrato direttamente nell'interfaccia di Dolibarr.

Ambito della validazione: Si tratta di un controllore di plausibilità delle regole fondamentali implementato in PHP nativo. Non è la suite ufficiale di validazione KoSIT Schematron/Saxon XSLT 2.0 e non dispone di certificazione ufficiale. Per gli invii che richiedono una pre-validazione certificata KoSIT, sottoponete l'XML al validatore ufficiale KoSIT separatamente.

Leitweg-ID per le fatture al settore pubblico (B2G)

Un campo personalizzato dedicato (BT-10, Leitweg-ID) viene creato automaticamente nella scheda cliente all'installazione del modulo. Compilatelo una sola volta per ogni cliente del settore pubblico e verrà incluso automaticamente in ogni XRechnung in uscita — senza inserimento manuale per ciascuna fattura.

Configurazione

• Selezione del profilo (XRechnung 3.0 UBL / ZUGFeRD EN16931 / Factur-X EN16931)
• Generazione automatica alla validazione della fattura: attiva/disattiva
• Incorporamento PDF/A-3: attiva/disattiva
• Controllo di plausibilità EN16931: attiva/disattiva
• Verifica opzionale dello schema XSD Factur-X
• Pulsante di generazione di prova direttamente nella pagina di configurazione
• Caricamento per l'importazione XML delle fatture fornitori
• Interfaccia disponibile in tedesco e inglese

Dettagli tecnici

• Licenza: GPLv3 — open source, senza chiave di licenza a runtime
• Dolibarr 18.0 – 23.0 (testato su 23.0.3)
• PHP 7.4 – 8.2
• Nessuna chiamata ad API esterne, nessuna dipendenza dal cloud
• Libreria inclusa: atgp/factur-x v3.3 per l'incorporamento PDF/A-3