Documenti con voci

A cosa serve

Nel passaggio iniziale del wizard, un Documento Generico o una Registrazione Libera può essere compilato con un importo unico oppure con le voci, cioè le righe che dettagliano cosa hai comprato o venduto. Una Fattura Elettronica usa invece sempre le righe. Questa pagina spiega le due modalità, così sai sempre da dove viene il totale e quali dati devi inserire tu.

Documenti senza voci: due importi determinano il terzo

Quando non usi le voci, il riquadro Importi presenta tre valori:

Imponibile
IVA, espressa come importo e non come percentuale
Totale

Compilane due qualsiasi e XIQUIL ricava il terzo. Per esempio, da imponibile e IVA ottiene il totale; da totale e IVA ricava l’imponibile. Puoi indicare lo sconto in percentuale oppure in valore: XIQUIL ricava l’altro valore. Sconto e bollo, quando presenti, continuano a partecipare alla relazione:

totale = imponibile + IVA - sconto in valore + bollo

Non esiste un’aliquota IVA complessiva a livello di documento: l’aliquota appartiene alle singole righe.

Come riconoscere un valore calcolato

Il campo ricavato da XIQUIL ha un bordo tratteggiato e l’etichetta calcolato. Non è bloccato: se lo modifichi, il valore diventa inserito da te e il calcolo si sposta su uno degli altri due campi. Puoi anche svuotare il campo che vuoi far ricalcolare.

Documenti con voci: totale delle righe più bollo

Quando un documento ordinario usa le voci, imponibile, IVA e sconto di testata sono ricavati dalle righe. Il totale segue questa regola:

totale = somma dei totali di riga + bollo

Il bollo resta quindi compilabile anche in modalità voci e non viene più azzerato. Se aggiungi, modifichi o elimini una riga, oppure cambi il bollo, il totale si aggiorna.

I Documenti Generici e le Registrazioni Libere possono usare l’importo unico oppure le voci. Le Fatture Elettroniche hanno sempre almeno una riga: è il formato FatturaPA stesso a richiederla. Per una fattura semplice basta una riga; con più aliquote, inserisci almeno una riga per aliquota.

Compilare una voce

Per aggiungere o modificare una voce, l’editor si apre come fascia nella tabella delle righe; XIQUIL la porta in vista. Usa Annulla per chiuderla senza modifiche e Aggiungi voce o Salva voce per confermare. L’editor usa gli stessi segnali visivi del riquadro Importi: i valori ricavati hanno bordo tratteggiato ed etichetta calcolato.

La descrizione è obbligatoria e non può contenere soltanto spazi.
La valuta non si sceglie sulla riga: è ereditata dal documento.
L’impostazione del documento IVA inclusa o IVA esclusa viene conservata; indica se il prezzo unitario della riga è lordo o netto.
L’unità di misura è consigliata, ma può restare vuota quando non è significativa, per esempio per alcuni servizi.
Categoria e focus appartengono alla riga quando il documento usa le voci.

IVA della voce: percentuale oppure importo

Per una riga ordinaria devi compilare almeno uno tra:

% IVA complessiva
IVA (importo)

XIQUIL ricava automaticamente l’altro valore. Se inserisci l’importo IVA, la percentuale risultante è mostrata come % IVA complessiva, arrotondata a un decimale. È un rapporto indicativo tra IVA e imponibile, non l’aliquota legale applicata: può quindi rappresentare anche valori esteri o decimali e non viene ricondotta alle sole aliquote italiane.

Nelle righe di una FatturaPA, invece, l’aliquota dichiarata conserva il suo significato fiscale. Le eventuali rettifiche della riga importate dall’XML sono conservate: determinano imponibile, IVA e totale della riga anche quando riapri il documento.

Riepilogo IVA della Fattura Elettronica

Nella compilazione manuale XIQUIL costruisce il riepilogo IVA dalle righe e raggruppa i valori per aliquota e natura. Due righe allo 0% con nature diverse restano quindi separate. Nel riepilogo devi completare a mano soltanto l’esigibilità e l’eventuale riferimento normativo.

Categoria e focus a livello di voce

Quando un documento usa le voci, categoria e focus si impostano sulla singola voce, non sulla testata. Questo permette di avere un unico documento che spalma righe su categorie o progetti diversi (es. una fattura del supermercato con righe “Alimentari” e righe “Casa”). Anche in una fattura importata da XML questi due campi restano modificabili: sono una classificazione XIQUIL, non un dato fiscale del documento originale.

”Voce wins”: come vengono mostrati categoria e focus in elenco

Poiché in modalità voci la testata non porta categoria/focus, in elenco e nelle dashboard XIQUIL aggrega i valori distinti dalle voci:

Se il documento usa le voci, il focus (e la categoria) di testata resta vuoto e vince quello delle voci
L’elenco mostra i focus distinti trovati sulle voci (con nome, icona e colore)
Le dashboard attribuiscono ogni importo alla categoria/focus della sua voce

Questo comportamento — la voce prevale sulla testata — è il funzionamento previsto. Se vedi il focus “vuoto” sulla testata di un documento a voci ma popolato in elenco, è corretto: il valore arriva dalle voci.

Sconti, IVA e ritenute: cosa entra nel totale

Elemento	Entra nel totale del documento?
Imponibile / IVA / sconto della voce	✅ Sì — aggregati riga per riga
Bollo del documento ordinario	✅ Sì — si aggiunge alla somma dei totali di riga
Sconti/maggiorazioni a livello di Fattura Elettronica	✅ Nella compilazione manuale sono applicati in cascata, nell’ordine indicato; per una fattura importata resta autorevole il totale XML
Ritenute (FE)	❌ No — il totale resta lordo
Casse previdenziali (FE)	❌ No

Se XIQUIL riconosce un possibile duplicato

Quando salvi una fattura simile a una già presente, XIQUIL mostra il codice del documento trovato e i campi che coincidono. Puoi:

creare una voce separata, se si tratta davvero di due documenti distinti;
aprire il documento esistente, per controllarlo senza creare un doppione.

Se hai modifiche in corso, prima di aprire il documento esistente può comparire la conferma di abbandono delle modifiche non salvate.

La scelta di creare una voce separata viene ricordata per quella coppia: le modifiche successive al nuovo documento non ripropongono lo stesso conflitto.

Attenzione ai doppioni da retry

Le voci vengono aggiunte, non deduplicate. Se per un errore di rete o un doppio click invii due volte la stessa voce, entrambe vengono inserite e la componente di riga del totale raddoppia (il bollo resta aggiunto una sola volta). Non esiste oggi un controllo automatico anti-duplicato sulla singola aggiunta.

Esempio nell’editor

Scelta fra Inserimento semplice e Gestisci con voci In una Registrazione Libera puoi scegliere se inserire gli importi complessivi o gestire le singole voci.

Editor della voce con sconto 10%, imponibile 90 euro, IVA 19,80 euro e totale 109,80 euro Lo sconto del 10% vale 10 euro; l’imponibile è 90 euro. Con IVA al 22%, l’IVA calcolata è 19,80 euro e il totale è 109,80 euro. I valori ricavati mostrano l’etichetta «calcolato».

Vedi anche

Tipi di documento supportati — quali documenti usano le voci
Fattura elettronica: manuale vs import — cosa cambia tra inserimento manuale e XML
Categorie — classificare gli importi delle singole righe
Focus — analizzare righe per progetto o area