Software libero per chi fa crescere una piccola impresa

Il tuo lavoro conta. I documenti dovrebbero essere più semplici.

Prepara fatture, preventivi e ordini in un modulo desktop chiaro. LuaBill unisce la composizione curata di LuaLaTeX alle esportazioni di fatture strutturate; le formule facoltative aiutano a descrivere il lavoro tecnico.

Open source · Nessun abbonamento · Documenti elaborati sul tuo computer

Documento di esempio
01 · PDF / XRechnung / ZUGFeRD 02 · Windows / Linux / macOS03 · DE / EN / FR / IT / RU
01 / LuaBill

Più tempo per la tua attività

Avviare un'impresa richiede competenza, energia e coraggio. Impaginare una fattura dovrebbe restare un compito semplice.

LuaBill è pensato per chi avvia un'impresa, per i professionisti indipendenti e per i piccoli gruppi che vogliono preparare documenti affidabili con un percorso chiaro. Il nostro obiettivo è concreto: ridurre le attività ripetitive e rendere più facile controllare le informazioni importanti.

Ci siamo concentrati inizialmente sulla qualità dei documenti prodotti e su moduli di inserimento pratici e ben organizzati. LuaLaTeX porta nei documenti quotidiani dell’impresa la cura della composizione tecnica e scientifica, comprese le formule matematiche quando servono al progetto.

Il progetto è libero e gratuito. Puoi leggere il codice, adattarlo alle tue esigenze e contribuire a migliorarlo. Il primo mercato è la Germania: la versione attuale supporta venditori con sede in Germania e clienti in Germania, nel resto dell'UE o fuori dall'UE.

L'interfaccia desktop di LuaBill. La lingua dell'interfaccia e quella del documento si scelgono separatamente.

Guida utente ↗
L'interfaccia desktop di LuaBill. La lingua dell'interfaccia e quella del documento si scelgono separatamente.
LuaBill 0.1.30 · Italiano · Documento di esempio
02 / LuaBill

Un percorso chiaro, dal preventivo alla fattura

Un modulo per i dati, un modello coerente per il documento e calcoli condivisi tra PDF e XML.

Documenti curati

LuaLaTeX produce un'impaginazione coerente, tabelle leggibili e testo multilingue. Il PDF generato può aprirsi subito nel tuo visualizzatore abituale.

Dieci tipi di documento

Fatture, preventivi, documenti di consegna, conferme d'ordine, fatture pro forma, ordini d'acquisto, note di credito, fatture di annullamento, richieste di preventivo e lettere.

Fatture elettroniche strutturate

Esporta XML CII EN 16931, XRechnung o ZUGFeRD con XML incorporato nel PDF/A-3. LuaBill applica le regole verificate incluse nel programma e conserva rapporti, versioni e impronte SHA-256 accanto al risultato.

Lingue e valute

Scegli separatamente inglese, tedesco, francese, italiano o russo per l’interfaccia e il documento. Gli importi usano i separatori della lingua scelta. Per le valute supportate, le note indicano sempre codice, nome completo e simbolo, tra cui EUR, USD, RUB e CNY.

Regimi IVA con spiegazioni

Scegli il caso supportato per un'operazione tedesca nazionale o internazionale B2B. LuaBill prepara spiegazioni IVA e collegamenti normativi facoltativi in base alla scelta e ai gruppi IVA del documento.

Verifica la partita IVA del cliente in VIES

Avvia la verifica VIES dalla scheda Cliente. LuaBill registra l’esito e la data ricevuti. Una verifica positiva ancora valida aggiunge una spunta verde al numero IVA nell’interfaccia e nel PDF, anche se la fattura precede la verifica.

Calcoli da controllare

Lavora con quantità, sconti percentuali, aliquote IVA diverse e acconti realmente ricevuti. Imponibile, IVA e saldo usano lo stesso motore di calcolo per il documento visivo e i dati strutturati.

Dati cliente ben separati

Indirizzi strutturati, numero cliente facoltativo e campi distinti per nome del contatto, ruolo, email, telefono, cellulare, fax e sito web. I collegamenti di contatto supportati sono cliccabili nel PDF.

Dettagli utili

Mostra o nascondi le immagini di firma e timbro con le caselle di controllo. Aggiungi note di progetto e un QR di pagamento EPC/SEPA per le fatture EUR compatibili. Le immagini delle firme sono elementi visivi, non firme crittografiche.

Progetti locali e preferenze salvate

Conserva progetti .luabill modificabili e profili venditore riutilizzabili. L'applicazione ricorda lingua, finestra e impostazioni di output; progetti e risultati possono stare in cartelle separate.

Un flusso di lavoro adattabile

Importa i file .bill esistenti, anche con strutture precedenti, usa l’editor grafico o genera documenti dalla riga di comando Python. L’installatore Windows e gli installatori da sorgenti per Linux e macOS condividono lo stesso codice applicativo.

Formule ed enfasi nel testo

Remarks supporta enfasi e formule LaTeX, tra cui integrali, somme e frazioni. Un campo Documento → Progetto compilato appare per primo con un’etichetta tradotta in grassetto; la stessa nota viene esportata in XML. Un progetto vuoto non aggiunge note automatiche e le note standard corrispondenti compaiono una sola volta. Il PDF compone le formule; l’XML ne conserva il sorgente LaTeX. L’introduzione appare solo nel PDF.

Preparazione guidata dei componenti

La procedura di LuaBill 0.1.27 riutilizza gli strumenti compatibili già presenti e prepara quelli mancanti per PDF, XML/XRechnung o ZUGFeRD. Conserva il registro e verifica la creazione di un esempio prima di indicare il completamento.

LuaLaTeX · PDF · XML

Una fattura di ingegneria, con le equazioni

Le spiegazioni tecniche possono far parte di un documento aziendale leggibile.

Questo esempio in inglese di una pagina fattura lo sviluppo e la verifica di un regolatore PID analogico e di un regolatore PI digitale. Il progetto modificabile permette di esaminare i campi e riutilizzare la struttura per il proprio lavoro.

  • PID analogico: termini integrale e derivativo, con uno stadio derivatore filtrato che usa Tf = 35 ms.
  • PI digitale: relazione di ricorrenza secondo Eulero all’indietro con periodo di campionamento Ts = 10 ms.
  • 86 ore; EUR 8.650,00 al netto dell’IVA; IVA al 19% (EUR 1.643,50); totale EUR 10.293,50.
  • QR EPC/SEPA con la dicitura «Pay with Code» e un timbro dimostrativo da 35 mm sovrapposto alla firma.
\(\displaystyle u(t)=K_p e(t)+K_i\int_0^t e(\tau)\,d\tau-K_d\frac{dy(t)}{dt}\)

\[u[k]=u[k-1]+K_p(e[k]-e[k-1])+K_i T_s e[k]\]

Scarica il sorgente .bill ↓

Scarica tutti e sette gli esempi (ZIP) ↓

Gli stessi sette esempi sono inclusi nell’installer: progetti .luabill modificabili, sorgenti .bill e PDF pronti da consultare. Lo ZIP contiene anche le immagini dimostrative della firma e del timbro. Estrai l’archivio prima di aprire un progetto. SHA-256

Anteprima di una fattura di ingegneria inglese di una pagina con formule per regolatori PID analogico e PI digitale
Solo dimostrazione: aziende, persone e coordinate bancarie sono fittizie. Il documento di esempio è in inglese e usa EUR.
03 / LuaBill

Il primo documento, passo dopo passo

Non serve scrivere Lua o LaTeX per compilare il modulo. Parti da un esempio e sostituisci tutti i dati fittizi.

  1. Installa LuaBill

    Scarica il pacchetto del tuo sistema e avvia il suo installatore. Windows include Python e PySide6/Qt; Linux e macOS usano un Python compatibile già installato e creano un ambiente privato.

  2. Prepara i formati che ti servono

    Apri Aiuto → Preparare la creazione dei documenti. Scegli PDF, PDF + XML/XRechnung o ZUGFeRD, esamina il piano e fai clic su Prepara i componenti selezionati. I download richiedono Internet; attendi il completamento della verifica.

  3. Imposta il documento e le parti

    Scegli tipo, lingua, valuta, numero, date e regime IVA. Inserisci venditore e cliente, compresi gli indirizzi elettronici richiesti dal formato di fattura scelto.

  4. Aggiungi gli articoli e controlla i totali

    Inserisci prodotti o servizi, quantità, prezzi e sconti. Aggiungi note e acconti effettivamente ricevuti, poi usa Verifica totali per individuare dati incompleti o incoerenti.

  5. Salva il progetto e genera

    Salva il progetto modificabile .luabill, scegli la cartella di output e crea PDF/XML. Dopo una generazione riuscita, il pannello dei risultati mostra i file e può aprire automaticamente il PDF.

  6. Esamina il risultato e invia il file corretto

    Leggi il PDF e verifica che la validazione elettronica sia riuscita. Invia XRechnung come XML o ZUGFeRD come PDF ibrido tramite il canale concordato con il destinatario. Conserva i file emessi, i rapporti di verifica e il riepilogo delle versioni.

Guida utente ↗
04 / LuaBill

Scarica LuaBill 0.1.30

Il pacchetto LuaBill resta compatto: non contiene una distribuzione TeX completa, Java o Ghostscript. La procedura guidata prepara separatamente i componenti richiesti dai tuoi formati; i download iniziali si aggiungono al pacchetto dell’applicazione.

Installatore pronto · x64

Windows

Scarica per Windows

v0.1.30 · 84.7 MB · EXE

Windows 10 versione 1809 o successiva oppure Windows 11, x64. Python, PySide6/Qt e Mustang sono inclusi.

Dettagli
  1. Avvia l’installatore LuaBill per il tuo account utente. Scegli il collegamento sul desktop e l’associazione dei progetti .luabill se desiderati; non serve installare Python separatamente.
  2. Al termine dell’installazione lascia selezionata l’apertura della procedura di preparazione. Puoi aprirla anche da Aiuto → Preparare la creazione dei documenti.
  3. Scegli PDF, PDF + XML/XRechnung o ZUGFeRD, esamina il piano e fai clic su Prepara i componenti selezionati. Gli strumenti compatibili vengono riutilizzati; quando occorre, la procedura può scaricare Basic MiKTeX, una JRE Temurin 21 e Ghostscript.
  4. Attendi la preparazione dei pacchetti TeX, delle lingue e dei font Noto privati, poi la compilazione di controllo. Apri il PDF di prova; in caso di errore consulta Dettagli e registro prima di creare il primo documento.

L'installatore non è ancora firmato con un certificato Authenticode: Windows può mostrare un autore sconosciuto. Verifica la provenienza del download e lo SHA-256 pubblicato. La generazione dei tre profili e la validazione XML/ZUGFeRD sono state verificate in Windows con gli strumenti già installati; l’installazione completa delle dipendenze su un PC pulito resta da provare.

Installazione da sorgenti · anteprima

Linux

Scarica per Linux

v0.1.30 · 58.5 MB · GZ

Linux desktop con glibc 2.34+ su x86-64 oppure glibc 2.39+ su ARM64. Servono Python 3.10–3.15, venv e pip; sono consigliati Python 3.12 o 3.13. Alpine/musl non è supportato.

Dettagli
  1. Prepara Python compatibile, venv, pip e le librerie grafiche richieste dalla distribuzione. Gli strumenti TeX esistenti restano utilizzabili; non occorre scaricare texlive-full.
  2. Estrai l’archivio completo ed esegui sh install.sh --setup-components --language it nella sua cartella. Internet serve a scaricare PySide6 in un ambiente Python privato e aprire poi la procedura guidata.
  3. Scegli il profilo e avvia la preparazione. In Ubuntu/Debian, i comandi apt proposti si eseguono in un Terminale dove puoi inserire la password. Un’installazione TUG TeX Live separata usa il proprio tlmgr; i file dei font Noto restano privati per LuaBill.
  4. Dopo il completamento delle verifiche, avvia LuaBill dal menu delle applicazioni. La cartella predefinita è $XDG_DATA_HOME/LuaBill se la variabile contiene un percorso assoluto, altrimenti ~/.local/share/LuaBill.

Python e Qt non sono inclusi nel pacchetto. L'installazione nativa e l'avvio grafico su Linux non sono ancora stati verificati dall'attuale ambiente di compilazione Windows. Il pacchetto è disponibile come anteprima.

Installazione da sorgenti · anteprima

macOS

Scarica per macOS

v0.1.30 · 58.5 MB · ZIP

macOS 14.4 o successivo, Intel o Apple Silicon, con Python 3.10–3.15 compatibile. Sono consigliati Python 3.12 o 3.13.

Dettagli
  1. Installa un Python compatibile se necessario. La distribuzione TeX adatta già presente viene riutilizzata; non è richiesto il download del MacTeX completo.
  2. Estrai lo ZIP ed esegui sh Install_LuaBill.command --setup-components --language it in un Terminale. L’installatore scarica PySide6 in un ambiente Python privato e apre la procedura guidata.
  3. Con Homebrew già presente, il piano può proporre BasicTeX, Temurin 21 e Ghostscript in base al profilo; installazione e pacchetti tlmgr vengono gestiti nel Terminale. Senza Homebrew, prepara gli strumenti mancanti tramite i collegamenti ufficiali: la procedura non installa Homebrew automaticamente.
  4. Attendi le verifiche del profilo, poi apri ~/Applications/LuaBill.app. I file applicativi si trovano in ~/Library/Application Support/LuaBill e i font Noto scaricati restano privati per LuaBill.

Python e Qt non sono inclusi nel pacchetto. Il programma di avvio creato localmente non ha firma Apple Developer ID né notarizzazione. L'installazione nativa e l'avvio grafico su macOS non sono ancora stati verificati qui.

Prepara la creazione dei documenti con una procedura guidata →

Windows dispone di un installatore pronto all'uso. Per Linux e macOS sono disponibili installatori da sorgenti in anteprima. Controlla requisiti e stato delle verifiche di ogni piattaforma prima del download.

Gli strumenti dietro i tuoi documenti

Scegli le funzionalità necessarie. Aiuto → Preparare la creazione dei documenti mostra un piano, prepara i componenti dopo il tuo clic e verifica realmente la generazione del profilo scelto.

LuaLaTeX + texlua

Necessari per generare i documenti

LuaLaTeX e texlua provengono da una distribuzione TeX. In Windows, la procedura può preparare Basic MiKTeX e i 19 pacchetti diretti del modello, le loro dipendenze e i dati EN/DE/FR/IT/RU. Un’installazione compatibile già presente viene riutilizzata. Il messaggio di versione LuaHBTeX è normale: usa sempre il comando lualatex.

Ghostscript

Necessario per ZUGFeRD; facoltativo per il PDF ordinario

Ghostscript prepara il PDF/A-3 di ZUGFeRD e può comprimere i PDF ordinari. La procedura lo prepara solo per un profilo che ne ha bisogno, usando l’installatore ufficiale Windows o il gestore di pacchetti supportato.

Java 17+

Necessario per XML, XRechnung e ZUGFeRD

Java 17+ esegue Mustang per la validazione XML e ZUGFeRD. In Windows viene proposta una JRE Temurin 21; su macOS il pacchetto Homebrew temurin@21 contiene un JDK. Una versione compatibile già presente viene riutilizzata. Mustang è incluso; il PDF ordinario non richiede Java.

Python + PySide6/Qt

Inclusi su Windows; da predisporre su Linux/macOS

Python esegue l'applicazione e PySide6/Qt fornisce finestre e menu. Gli installatori Linux/macOS creano un ambiente isolato usando un Python compatibile già installato e scaricano PySide6 durante l'installazione.

Noto Sans + Noto Sans Mono

Font privati per tutte le lingue

La procedura può scaricare un insieme fissato di font Noto con la relativa licenza e verificarne lo SHA-256. LuaBill li carica direttamente dai propri file privati, senza registrarli nel sistema operativo. Il test verifica caratteri latini e cirillici, simboli monetari e formule.

Aprire la procedura avvia il rilevamento; download e installazioni iniziano con Prepara i componenti selezionati. Possono servire finestre di installazione o una password di amministratore. Verificare la creazione dei documenti compila un esempio senza installare pacchetti. Il primo download dei componenti si aggiunge al pacchetto compatto di LuaBill.

Prepara la creazione dei documenti con una procedura guidata

LuaBill 0.1.27 ti accompagna dalla scelta dei formati a un PDF di controllo. Il pacchetto resta compatto: i componenti esterni necessari vengono scaricati durante la preparazione.

  1. Apri la procedura guidata

    Lascia selezionata la sua apertura al termine dell’installazione Windows oppure scegli Aiuto → Preparare la creazione dei documenti. In Linux/macOS, --setup-components può aprirla dopo l’installazione.

  2. Scegli i formati e controlla il piano

    Seleziona PDF, PDF + XML/XRechnung o ZUGFeRD. Gli strumenti compatibili già presenti vengono riutilizzati; il piano mostra le operazioni proposte prima del loro avvio.

  3. Prepara i componenti selezionati

    Fai clic su Prepara i componenti selezionati. In Windows la procedura può scaricare Basic MiKTeX, la JRE Temurin 21 e Ghostscript, quindi preparare i pacchetti TeX e i font Noto privati. I download vengono verificati e il registro resta visibile.

  4. Controlla il documento di prova

    Il test compila due volte pacchetti, lingue e font, poi crea un documento fittizio con il profilo scelto. Apri il PDF o Dettagli e registro. L’annullamento conserva i download verificati; un’operazione di installazione già avviata deve prima terminare.

Prepara la creazione dei documenti con una procedura guidata
LuaBill 0.1.30 · Documento di esempio

PDF

LuaLaTeX, texlua, pacchetti del modello e font. Java non serve; Ghostscript resta facoltativo per la compressione.

PDF + XML / XRechnung

Gli stessi componenti, più Java 17+ per la validazione esterna Mustang. In Windows una nuova installazione utilizza una JRE Temurin 21.

ZUGFeRD

Gli stessi componenti elettronici, più Ghostscript per preparare il PDF/A-3 prima di incorporare l’XML e validare il contenitore.

Linux e macOS restano installazioni da sorgenti con un ambiente Python privato. Ubuntu/Debian usa apt; un’installazione TUG TeX Live separata usa il proprio tlmgr. Su macOS, Homebrew già installato può fornire BasicTeX e gli strumenti mancanti; Homebrew non viene installato automaticamente. I percorsi nativi Linux/macOS e l’installazione completa delle dipendenze su un PC pulito restano da verificare.

Scarica il test LuaLaTeX autonomo (ZIP) ↓

Il test si può inviare senza LuaBill: carica i 19 pacchetti diretti del modello e verifica le cinque lingue, caratteri, formule, tabelle e icone. L’archivio contiene istruzioni DE/EN/RU e un PDF di riferimento. MiKTeX può scaricare i pacchetti mancanti se la funzione è abilitata; i font di sistema non vengono installati automaticamente. Somme di controllo SHA-256

Aggiornare, verificare e disinstallare

LuaBill 0.1.30 aggiunge regole di verifica aggiornate, un riepilogo delle versioni e una ricerca facoltativa degli aggiornamenti. Installa la nuova versione nella stessa cartella e verifica il profilo che ti serve.

01

Installare la nuova versione

Chiudi LuaBill e installa la nuova versione sopra quella esistente. Non occorre disinstallare prima.

  • In Windows mantieni la cartella proposta per l’installazione esistente.
  • In Linux/macOS riutilizza lo stesso --prefix per una cartella personalizzata.
  • Progetti, risultati e impostazioni nelle cartelle personali restano conservati.
  • Dopo l’aggiornamento, apri Aiuto → Standard di fatturazione elettronica e aggiornamenti per vedere le regole attive e, se lo desideri, consultare le pubblicazioni ufficiali.
Linuxsh install.sh
macOSsh Install_LuaBill.command

Salva a parte le modifiche manuali ai file del programma. In Linux/macOS un conflitto interrompe l’aggiornamento. Evita di installare una versione precedente sopra una più recente.

02

Preparare e verificare i componenti

Il rapporto elenca gli strumenti trovati; Aiuto → Preparare la creazione dei documenti completa il rilevamento con preparazione guidata e una vera prova di generazione.

  • Scegli PDF, PDF + XML/XRechnung o ZUGFeRD; gli strumenti compatibili già installati vengono riutilizzati.
  • Fai clic su Prepara i componenti selezionati per i download, i pacchetti TeX e i font Noto privati.
  • Il test compila due volte il file LaTeX multilingue, poi crea un esempio fittizio con il percorso del profilo. PDF e registro restano disponibili.
Linuxsh install.sh --setup-components --language it
macOSsh Install_LuaBill.command --setup-components --language it

Gli strumenti mancanti non annullano l’installazione dell’editor. La generazione dei tre profili è stata verificata in Windows con i componenti presenti; installazioni native Linux/macOS e preparazione completa su un PC pulito restano da provare.

03

Rimuovere i file del programma

Il programma di disinstallazione di un nuovo archivio può rimuovere una vecchia installazione senza reinstallarla.

  • Chiudi LuaBill e indica lo stesso --prefix per un’installazione personalizzata.
  • Documenti, impostazioni e file modificati o sconosciuti vengono conservati.
  • Leggi gli avvisi e l’elenco dei file rimasti.
Linuxsh uninstall.sh
macOSsh Uninstall_LuaBill.command

Anche il piccolo archivio separato rimuove le installazioni esistenti. Restano gli strumenti di sistema TeX, Java e Ghostscript e la cartella scaricata.

Programma di disinstallazione separato per Linux/macOS ↓ ZIP · 23 KB

Somme di controllo SHA-256

Guida utente ↗

05 / LuaBill

Un documento leggibile. Dati strutturati quando servono.

Il nome di un PDF non dice se contiene una fattura elettronica strutturata. Scegli il formato accettato dal destinatario e controlla il risultato.

PDF

.pdf

Un documento visivo per leggere, stampare e controllare. Un normale PDF non contiene un insieme di dati strutturati della fattura.

Invialo quando il PDF ordinario è il formato adatto e concordato.

XML CII EN 16931

.xml + vista PDF

Una fattura CII strutturata con PDF visivo separato, rapporti di verifica e riepilogo delle versioni.

L'XML è la fattura strutturata. Invialo tramite il canale concordato; il PDF può accompagnarlo per la lettura.

XRechnung

XRechnung 3 CII .xml

XML strutturato con riferimenti e indirizzi elettronici richiesti dal profilo scelto. Un PDF separato facilita il controllo del contenuto.

Trasmetti l'XML al portale o all'indirizzo indicato dal destinatario, usando il riferimento di instradamento che ti ha comunicato.

ZUGFeRD

PDF/A-3 con XML incorporato

Un PDF ibrido combina il documento leggibile con il suo allegato XML EN 16931. LuaBill salva anche un XML separato identico.

Di norma invia il PDF ibrido. Segui le indicazioni del destinatario se richiede anche l'XML separato.

Cosa verifica LuaBill

  • Il motore comune controlla importi e dati richiesti. Ogni risultato elettronico supera le regole CII EN 16931 1.3.17 e i controlli Mustang; le risorse XRechnung utilizzate sono quelle di Schematron 2.6.0.
  • Per ZUGFeRD vengono verificati anche PDF/A e contenitore; l’XML estratto viene confrontato con il file separato. Conserva i rapporti .validation.xml e .validation-rules.xml e il riepilogo .validation-info.json con il PDF e l’XML emessi.
  • La validazione tecnica non verifica le registrazioni fiscali, la realtà dell'operazione o l'unicità del numero di fattura. Controlla il contenuto commerciale e le richieste del destinatario. Preventivi e ordini restano documenti PDF.
05.1 / LuaBill

Versioni delle regole visibili, verifiche documentate

Il validatore e le sue regole si aggiornano separatamente. LuaBill include un insieme di regole verificato, mostra le versioni attive e conserva i dettagli che permettono di sapere come è stata controllata ogni fattura elettronica.

Composizione di LuaBill 0.1.30 verificata il 28 ottobre 2026. Le versioni seguenti descrivono questo pacchetto; le fonti ufficiali consentono di seguire le pubblicazioni successive.

Le versioni di verifica incluse

Regole CII EN 16931
1.3.17Eseguite esplicitamente per ogni generazione XML, XRechnung e ZUGFeRD.
XRechnung
3.0.2 · Schematron 2.6.0Il formato e le regole hanno numerazioni distinte. Le risorse CII incluse sono quelle di Schematron 2.6.0.
ZUGFeRD / Factur-X
2.5.2 / 1.09.2Profilo EN 16931, XML incorporato nel PDF/A-3 e verifica del contenitore.
Mustang CLI / veraPDF
2.26.0 / 1.30.2Il JAR Mustang originale resta invariato. Il pacchetto verificato di LuaBill dà la precedenza alle regole CII aggiornate.
Finestra italiana di LuaBill con le regole attive EN 16931 1.3.17 e XRechnung Schematron 2.6.0 e le risorse originali del validatore
La finestra distingue le regole attive dal contenuto iniziale del JAR e permette di cercare aggiornamenti.

Conservare le prove della verifica

Aiuto → Standard di fatturazione elettronica e aggiornamenti mostra le regole attive e quelle del JAR originale. Il pulsante Versioni della verifica apre i dettagli dell’ultimo risultato. L’adattatore XRechnung conserva controlli e livelli di errore ufficiali; rimuove soltanto un blocco di metadati del rapporto che questo Mustang non può leggere.

*.pdf
Il documento visivo; in ZUGFeRD contiene anche l’XML strutturato.
*.xml
I dati strutturati della fattura, salvati separatamente anche per ZUGFeRD.
*.validation.xml
Il rapporto originale Mustang: verifica dell’XML e, per ZUGFeRD, del PDF/A e del contenitore.
*.validation-rules.xml
Il rapporto SVRL del controllo esplicito con le regole CII EN 16931 correnti del pacchetto.
*.validation-info.json
Versioni di LuaBill, del validatore e delle regole, impronte SHA-256, profilo XML e risultati delle fasi.
06 / LuaBill

Prima di iniziare

LuaBill è gratuito anche per uso aziendale?

Sì. Il codice e la documentazione propri di LuaBill sono disponibili con Apache License 2.0, anche per uso commerciale secondo i suoi termini. Non è richiesto un abbonamento LuaBill. I componenti terzi mantengono le licenze originali.

Devo conoscere Lua o LaTeX?

No. Il modulo grafico gestisce la normale compilazione. LuaLaTeX deve essere disponibile, ma la procedura guidata può preparare i componenti necessari sui sistemi supportati. I campi strutturati si compilano con testo normale; gli sviluppatori possono adattare sorgenti e modelli.

Devo scaricare una distribuzione LaTeX completa?

No. Il pacchetto LuaBill non include una distribuzione TeX completa. In Windows la procedura può preparare Basic MiKTeX e i pacchetti del modello. I componenti aggiuntivi vengono scaricati separatamente: serve quindi Internet per la loro preparazione. In Linux il volume dipende dai pacchetti della distribuzione; alcuni insiemi di font possono essere grandi.

Posso inserire formule LaTeX in un documento aziendale?

Sì. Remarks supporta un insieme limitato di comandi LaTeX per evidenziare il testo e inserire formule, inclusi integrali, sommatorie e frazioni. Racchiudi la matematica tra \( ... \) o \[ ... \]; il testo normale non richiede marcatura. Nel PDF le formule vengono composte. Nelle note esportate in XML, il sorgente LaTeX rimane testo semplice e il programma del destinatario non lo visualizza automaticamente come formula. Il testo introduttivo è solo per il PDF. Non sono supportati pacchetti e macro arbitrari.

I dati dei clienti e delle fatture vengono caricati online?

LuaBill genera i documenti localmente e non carica le fatture su un servizio di generazione. Il numero IVA del cliente viene inviato a VIES solo quando fai clic su Verifica in VIES. La preparazione dei componenti e la ricerca degli aggiornamenti possono usare Internet; quest’ultima non trasmette dati di fatture, clienti o XML. Decidi come inviare la fattura completata.

Come funzionano la verifica VIES e la spunta verde?

Inserisci il numero IVA UE completo con prefisso paese (XI per l’Irlanda del Nord, EL per la Grecia), poi fai clic su Verifica in VIES in Cliente. Una risposta completa registra esito e data; salva il progetto .luabill per conservarli. Una risposta negativa rimuove la spunta verde. In caso di errore del servizio o della connessione, i dati precedenti restano invariati. La validità scelta si conta in giorni di calendario rispetto a oggi e, per il PDF, al giorno di generazione; la data della fattura non influisce. La verifica non controlla il nome o l’indirizzo del cliente e non determina il trattamento fiscale dell’operazione.

Posso fatturare a clienti fuori dalla Germania?

La versione attuale supporta venditori con sede in Germania e clienti in Germania, in altri paesi UE o fuori dall'UE. Scegli l'operazione reale e il paese di consegna: un cliente estero da solo non dimostra il diritto a un'esenzione IVA.

Posso usare un'altra lingua o valuta?

Interfaccia e documento si impostano separatamente in EN, DE, FR, IT o RU. Sono accettati EUR, USD, RUB, CNY e altri codici valuta, senza conversione automatica del cambio. Le tue descrizioni e i testi personali non vengono tradotti automaticamente.

Quale file devo inviare al cliente?

.luabill è il progetto modificabile da conservare. XRechnung si trasmette come XML; ZUGFeRD di solito come PDF ibrido con XML incorporato. Invia un PDF ordinario quando è adatto all'operazione e accettato dal destinatario.

Il PDF o la firma dimostrano il formato?

No. Nome e aspetto del file non provano la presenza di un XML valido. Controlla il formato scelto e il rapporto. Le immagini di firma e timbro sono elementi grafici, non firme elettroniche crittografiche.

LuaBill sostituisce un programma di contabilità?

LuaBill prepara documenti. Non gestisce la numerazione unica aziendale, le scritture contabili, i movimenti bancari o l'archivio delle versioni emesse. Questi processi vanno organizzati separatamente.

Come trasferisco il lavoro su un altro computer?

Copia il progetto .luabill e le immagini di firma e timbro utilizzate. Seleziona nuovamente le immagini se i percorsi sono cambiati. La cartella di output dipende dalle preferenze del nuovo computer e non viene salvata nel progetto.

Dove trovo istruzioni e informazioni sulle licenze?

Il menu Aiuto offre la guida nella lingua dell’interfaccia, il rapporto dei componenti, la procedura Preparare la creazione dei documenti, Standard di fatturazione elettronica e aggiornamenti e i riferimenti dei componenti terzi. Le guide sono incluse nell’applicazione e nei sorgenti; preparare componenti o cercare aggiornamenti può richiedere Internet.

Devo disinstallare LuaBill prima di aggiornarlo?

No. Chiudi LuaBill e avvia il nuovo programma di installazione nella stessa cartella. In Linux/macOS riutilizza l’eventuale --prefix personalizzato. Documenti e impostazioni restano conservati. Salva separatamente le modifiche manuali ai file del programma; su Unix un conflitto interrompe l’aggiornamento.

Perché LuaLaTeX mostra LuaHBTeX?

Il messaggio «This is LuaHBTeX» è normale: LuaLaTeX usa questo motore in TeX Live. Il comando deve restare lualatex; anche texlua deve mantenere il proprio nome di avvio. LuaBill 0.1.14 e successivi preservano questi collegamenti. Non sostituire lualatex con un avvio diretto di luahbtex.

Dove posso vedere le versioni del validatore e delle regole usate?

Apri Aiuto → Standard di fatturazione elettronica e aggiornamenti, oppure Versioni della verifica nel pannello dei risultati. Le regole attive sono distinte dalle vecchie risorse del JAR Mustang originale. Il file .validation-info.json conserva versioni, impronte SHA-256, profilo e fasi della verifica della fattura; conservalo insieme ai due rapporti XML.

LuaBill può segnalare che sono disponibili regole aggiornate?

Sì. Cerca aggiornamenti consulta le pubblicazioni ufficiali. Puoi attivare una ricerca settimanale all’avvio, disattivata per impostazione predefinita. Non viene inviato alcun documento e nulla viene installato automaticamente. Una nuova versione tecnica suggerisce di valutare un aggiornamento; da sola non determina una modifica normativa o una scadenza obbligatoria.

Perché rimangono dei file dopo la disinstallazione?

LuaBill conserva intenzionalmente documenti, impostazioni e file modificati o sconosciuti. Restano anche le dipendenze di sistema e la cartella dell’archivio scaricato. Il rapporto indica gli avvisi e i percorsi rimasti. Il programma di disinstallazione di un nuovo archivio può rimuovere una vecchia installazione senza reinstallarla. Anche la cache dei componenti, i font privati e i registri di preparazione possono restare nei dati utente di LuaBill.

07 / LuaBill

Facciamo crescere LuaBill insieme

Le esigenze reali, le osservazioni precise e i piccoli miglioramenti rendono utile un progetto libero.

Condividi un caso concreto

Descrivi il documento e il comportamento necessari alla tua attività. Prepara un esempio riproducibile sostituendo dati personali e commerciali con informazioni fittizie.

Migliora lingue e istruzioni

Aiuta a rendere traduzioni, suggerimenti e guide più corretti e chiari. La verifica dei termini professionali in ogni lingua è particolarmente utile.

Verifica modelli e piattaforme

Prova tabelle lunghe, indirizzi internazionali, valute e formati elettronici. I risultati di installazione e utilizzo su Linux e macOS sono preziosi.

Contribuisci al codice

Leggi i sorgenti e proponi correzioni, test o miglioramenti dell'interfaccia. L'archivio dei sorgenti è disponibile insieme ai pacchetti di ogni versione.

Puoi contattare gli autori tramite i collegamenti di questa pagina. Negli esempi pubblici sostituisci i dati reali e non includere firme o fatture riservate dei clienti. Non serve un account online per usare LuaBill.

Open source · Apache License 2.0

Gli autori del progetto

Vsevolod Shashkov
Mikhail Shashkov

LuaBill nasce da esigenze aziendali quotidiane ed è utilizzato presso DIETZ automation GmbH. Lo sviluppiamo come strumento libero e invitiamo chi lo usa a partecipare alla sua evoluzione.

DIETZ automation GmbH ↗

Copyright 2026 Vsevolod Shashkov & Mikhail Shashkov. Il codice LuaBill è distribuito con Apache License 2.0; i componenti terzi mantengono le proprie licenze.