Software libero per chi fa crescere una piccola impresa

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

Crea fatture, preventivi e ordini con LuaBill. Inserisci i dati in un'applicazione desktop e lascia a LuaLaTeX l'impaginazione, dal PDF professionale alla fattura elettronica strutturata.

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.

Abbiamo scelto LuaLaTeX per la qualità della composizione. LaTeX è un sistema affermato nell'editoria tecnica e scientifica; LuaBill porta la stessa cura nei documenti quotidiani dell'impresa attraverso un'interfaccia grafica.

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.10 · 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 esegue la validazione esterna e conserva il rapporto insieme ai file.

Lingue e valute

Scegli separatamente inglese, tedesco, francese, italiano o russo per l'interfaccia e le etichette del documento. Sono accettati EUR, USD, RUB, CNY e altri codici valuta; la valuta attiva resta visibile nella finestra.

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.

Calcoli da controllare

Lavora con quantità, sconti, 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

Aggiungi note di progetto, immagini di firma e timbro 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 vecchi file .bill, 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.

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 gli strumenti per i documenti

    Installa una distribuzione TeX con LuaLaTeX e texlua e i font adatti. Aggiungi Java 17+ per le fatture elettroniche e Ghostscript per ZUGFeRD.

  2. Installa LuaBill e verifica i componenti

    Scegli il pacchetto per il tuo sistema. In Aiuto → Componenti e installazione controlla gli strumenti trovati, installa quelli mancanti e ripeti la 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 e il rapporto.

Guida utente ↗
04 / LuaBill

Scarica LuaBill 0.1.10

LuaBill lavora sul tuo computer. I pacchetti differiscono per l'installazione di Python e delle librerie grafiche; gli strumenti per generare i documenti restano separati su ogni piattaforma.

Installatore pronto · x64

Windows

Scarica per Windows

v0.1.10 · 81.5 MB · EXE

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

Dettagli
  1. Installa MiKTeX o TeX Live con LuaLaTeX/texlua e i font necessari. Aggiungi Java e Ghostscript in base al formato di output che ti serve.
  2. Avvia l'installatore LuaBill per il tuo account utente. Scegli se creare il collegamento sul desktop e associare i progetti .luabill.
  3. Apri LuaBill dal menu Start o dal collegamento e controlla i componenti. Non serve installare Python separatamente.

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.

Installazione da sorgenti · anteprima

Linux

Scarica per Linux

v0.1.10 · 55.6 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. Installa LuaLaTeX/texlua, font e librerie di sistema tramite i pacchetti della tua distribuzione. Aggiungi Java 17+ e Ghostscript per i formati elettronici che ti servono.
  2. Estrai l'intero archivio, apri un terminale nella cartella ed esegui sh install.sh. Serve Internet per installare la versione fissata di PySide6 in un ambiente Python privato.
  3. 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.10 · 55.6 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 MacTeX o un'altra distribuzione TeX adatta e i font. Aggiungi Java 17+ per la validazione elettronica e Ghostscript per ZUGFeRD, se non è già fornito.
  2. Estrai lo ZIP e apri Install_LuaBill.command. Questa fase di installazione usa Internet per installare PySide6 in un ambiente Python privato.
  3. Apri ~/Applications/LuaBill.app. I file dell'applicazione si trovano in ~/Library/Application Support/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.

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

Installa i componenti necessari al formato scelto. Il menu Aiuto spiega cosa manca e propone i collegamenti ai download ufficiali.

LuaLaTeX + texlua

Necessari per generare i documenti

Scegli una distribuzione TeX, mantienila aggiornata e installa i pacchetti usati da LuaBill. Un'installazione TeX minima può richiedere pacchetti aggiuntivi al primo utilizzo.

Ghostscript

Necessario per ZUGFeRD; facoltativo per il PDF ordinario

Ghostscript prepara il PDF/A-3 di ZUGFeRD e può comprimere i normali PDF. Installalo separatamente o tramite il gestore di pacchetti del sistema.

Java 17+

Necessario per XML, XRechnung e ZUGFeRD

Un JRE o JDK compatibile esegue Mustang per validare l'XML e creare il file ZUGFeRD. 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 o DejaVu Sans

Consigliati per tutte le lingue

Installa un font Unicode adatto per visualizzare correttamente testo latino e cirillico. Il sistema operativo o la distribuzione TeX potrebbero già fornire i font necessari.

Una volta completata l'installazione, i documenti vengono elaborati localmente. Installare dipendenze o pacchetti TeX mancanti può richiedere Internet. Riavvia LuaBill dopo aver modificato il PATH del sistema.

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 e rapporto di validazione.

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 di calcolo comune controlla importi e dati richiesti. Mustang valida l'XML strutturato prima della pubblicazione di un risultato elettronico riuscito.
  • Per ZUGFeRD vengono verificati anche PDF/A e contenitore; l'XML estratto viene confrontato con il file XML separato. Conserva il rapporto .validation.xml con la fattura emessa.
  • 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.
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 installato, ma i campi strutturati si compilano con testo normale. Gli sviluppatori possono adattare sorgenti e modelli.

I dati dei clienti e delle fatture vengono caricati online?

LuaBill genera i documenti localmente e non invia i dati a un servizio online di generazione. L'installazione iniziale delle dipendenze può usare Internet. Decidi separatamente come inviare i documenti completati.

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 una guida dettagliata nella lingua dell'interfaccia, la verifica dei componenti e i riferimenti dei componenti terzi. Le guide funzionano senza Internet e sono incluse anche nei sorgenti.

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.