LuaBill · Documentazione LuaBill

Risolvere i problemi di generazione

Il messaggio principale indica il contesto; il registro aiuta a trovare la prima causa precisa.

Parti dal registro

Apri la scheda Registro di creazione e la cartella di lavoro indicata dopo un errore. Per LuaLaTeX consulta pass1.txt e document.log; cerca il primo errore anziché i messaggi che ne derivano.

Prova quindi a riprodurre il problema con un esempio incluso. Se funziona, confronta campi e formato del documento interessato. Conserva una copia del progetto prima di modificarne i dati.

LuaLaTeX, pacchetti e font

Usa Aiuto → Componenti e installazione per verificare gli eseguibili, poi la procedura guidata per una compilazione di prova. Dopo installazioni o modifiche del PATH, chiudi e riapri LuaBill.

TeX Live può mostrare « LuaHBTeX » per il comando lualatex: è il motore utilizzato e il nome non è un errore. Deve però esistere il comando lualatex, che seleziona il formato LaTeX; avviare direttamente luahbtex non è equivalente.

  • Un pacchetto .sty mancante va preparato con il gestore della distribuzione TeX o con la procedura guidata.
  • MiKTeX può installare pacchetti a richiesta se l’opzione è attiva; TeX Live utilizza il proprio sistema di pacchetti.
  • Devono essere disponibili anche font e metriche matematiche: il test LuaLaTeX autonomo aiuta a verificarli.
lualatex --version
texlua --version
Scarica il test LuaLaTeX e gli strumenti →

Java, XML e PDF/A

I formati elettronici richiedono Java 17 o successivo, anche quando una vecchia versione Java è già installata. Il rapporto dei componenti indica l’eseguibile effettivamente scelto. Ghostscript serve a ZUGFeRD; il PDF ordinario può essere creato senza la compressione Ghostscript.

Un errore di validazione può dipendere da indirizzo, riferimento acquirente, identificativo elettronico, trattamento fiscale o incoerenza degli importi. Leggi identificativo della regola e messaggio nei rapporti prima di correggere il campo interessato.

Verifica una XRechnung →Verifica un documento ZUGFeRD →

Progetti, risultati e versione installata

Il progetto .luabill contiene i dati del documento; la cartella di uscita appartiene alle impostazioni utente. Il pannello dei risultati permette di ritrovare PDF, XML e la loro cartella. Un vecchio risultato può restare sul disco dopo un errore: controlla messaggio e percorsi dell’ultima generazione.

La versione dell’applicazione è visibile in Informazioni su LuaBill. L’inventario degli standard e del validatore è in Aiuto → Standard di fatturazione elettronica e aggiornamenti. La ricerca settimanale è facoltativa e disattivata per impostazione predefinita; non installa aggiornamenti automaticamente.

Confronta le note di versione →
← Torna alla documentazione

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.