Tipi di documento supportati

A cosa serve

Ogni uscita ed entrata in XIQUIL può avere un tipo di documento associato. Scegliere il tipo giusto ha effetti concreti su come il documento viene trattato dal punto di vista contabile (IVA, scadenze, 730). Questa pagina ti spiega quali tipi esistono e in quali casi usarli.

Ogni Uscita o Entrata in XIQUIL può avere un tipo di documento associato. Esistono due famiglie:

Fattura Elettronica (FE) — i tipi TDxx del formato FatturaPA italiano
Documento Generico (DG) — ricevute, scontrini, bollette e qualsiasi documento non in formato FE

Questa pagina chiarisce quali combinazioni sono volute e, soprattutto, quali campi hanno un effetto contabile e quali sono solo metadati documentali.

Principio generale: la direzione la decide il modulo, non il tipo

In XIQUIL la direzione (Entrata o Uscita) è sempre determinata dal modulo in cui crei il documento, non dal tipo scelto. Apri Uscite → è un’Uscita; apri Entrate → è un’Entrata. Il tipo di documento (sia FE che DG) non impone vincoli di direzione: tutti i tipi sono tecnicamente disponibili in entrambi i moduli.

Fattura Elettronica — tipi TDxx

XIQUIL gestisce tutti i tipi documento da TD01 a TD29. Sono selezionabili sia in creazione manuale (dal wizard del documento) sia in import XML (riconosciuti automaticamente dal file FatturaPA).

Codice	Descrizione	Direzione tipica
TD01	Fattura	Entrata o Uscita
TD02	Acconto/Anticipo su fattura	Entrata o Uscita
TD03	Acconto/Anticipo su parcella	Entrata o Uscita
TD04	Nota di credito	Rettifica (importo negativo)
TD05	Nota di debito	Entrata o Uscita
TD06	Parcella	Entrata o Uscita
TD07	Fattura semplificata	Entrata o Uscita
TD08	Nota di credito semplificata	Rettifica (importo negativo)
TD09	Nota di debito semplificata	Entrata o Uscita
TD16–TD19	Integrazione/autofattura reverse charge	Uscita (autofattura)
TD20–TD23	Autofattura regolarizzazione / splafonamento / depositi IVA	Uscita
TD24, TD25	Fattura differita	Entrata o Uscita
TD26	Cessione beni ammortizzabili	Entrata o Uscita
TD27	Autoconsumo/cessione gratuita senza rivalsa	Uscita
TD28	Acquisti da San Marino con IVA	Uscita
TD29	Comunicazione omessa/irregolare fatturazione	Uscita

Segno degli importi (note di credito)

Per le note di credito TD04 e TD08, XIQUIL registra gli importi contabili in diminuzione, sia nella creazione manuale sia nell’import XML: i valori positivi diventano negativi, quelli già negativi e gli zeri restano tali. La convenzione riguarda imponibile, IVA, sconto come importo e totale.

Questa conversione non modifica bollo, quantità, prezzo unitario o dati fiscali sorgente. I valori fiscali originali e quelli registrati in contabilità restano quindi distinti. Per gli altri tipi, come una TD01 già negativa, la convenzione TD04/TD08 non cambia il segno.

Il riconoscimento vale anche per le etichette configurate che iniziano con il codice seguito da uno spazio o da un trattino, per esempio TD04 Nota di credito e TD04-Nota di credito, anche con spazi prima o dopo l’etichetta.

TDxx “speciali”: metadati, non automatismi contabili

I tipi reverse charge/autofattura (TD16–TD19) e i tipi documentali (TD20–TD23, TD27) non attivano logiche IVA o scadenze diverse. Per XIQUIL il codice TD è un dato anagrafico del documento: classifica il documento per le tue esigenze fiscali, ma non cambia il modo in cui vengono calcolati totali, IVA o scadenze. La gestione IVA del reverse charge (es. natura N6.x) è registrata come metadato nel riepilogo IVA, non come effetto automatico.

Documento Generico — i 15 tipi

I documenti generici coprono tutto ciò che non è una FatturaPA. Sono 15 tipi, tutti disponibili sia in Entrata sia in Uscita.

Tipo	Direzione tipica	Campi specializzati
Documento commerciale (ex scontrino)	Uscita	tipo operazione, n° documento, data/ora, matricola RT, punto cassa, codice lotteria
Scontrino parlante	Uscita	tipo operazione, n° documento, data/ora, matricola RT, codice lotteria
Ricevuta fiscale	Uscita / Entrata	n° documento, data/ora
Corrispettivo periodico	Entrata	punto cassa, periodo da/a, n° ricevuta da/a
Bolletta utenza	Uscita	n° contratto, periodo da/a, lettura prec./attuale, consumo, data scadenza doc.
Avviso di pagamento	Uscita	n° riferimento, data scadenza doc., causale
Verbale/Sanzione	Uscita	autorità emittente, n° verbale, data infrazione, data notifica
Ricevuta estera	Uscita / Entrata	n° riferimento, causale
Receipt digitale	Uscita	n° documento, data/ora
Quietanza di polizza	Uscita	n° polizza, compagnia, copertura da/a, premio
Piano rata/Estratto finanziamento	Uscita	n° rate totali, n° rata corrente, n° riferimento
Ricevuta di donazione	Uscita / Entrata	n° riferimento, causale
Ricevuta caparra/Deposito cauzionale	Uscita / Entrata	n° riferimento, causale, data scadenza doc.
Rimborso ricevuto	Entrata	n° riferimento, causale
Autocertificazione spesa	Uscita	causale

I campi specializzati sono descrittivi

Tutti i campi specializzati dei documenti generici sono metadati puramente descrittivi. Servono a documentare e ritrovare il movimento, ma non alimentano calcoli, dashboard, report o scadenzario. In particolare:

periodo_da/a (bolletta, corrispettivo) → solo descrittivo
data_scadenza_doc (avviso, caparra, bolletta) → non genera una scadenza automatica (vedi Scadenze dai documenti)
premio, copertura_da/a (quietanza) → solo descrittivo
numero_rata_corrente, numero_rate_totali (piano rata) → solo descrittivo; non è collegato al modulo Finanziamenti, che ha un piano di ammortamento proprio

Cosa determina davvero i totali

Nei Documenti Generici e nelle Registrazioni Libere senza voci, due valori qualsiasi fra imponibile, IVA come importo e totale determinano il terzo. Le Fatture Elettroniche hanno sempre almeno una riga. Nei documenti ordinari con voci, il totale è la somma dei totali di riga più il bollo. Una fattura elettronica importata da XML conserva invece i totali dichiarati, mostrando separatamente l’eventuale scarto rispetto alle righe. Vedi Documenti con voci per le regole complete.

Lo stato di pagamento nasce sempre dalle scadenze. Il tipo di documento e i suoi campi specializzati non generano da soli scadenze o movimenti di cassa.

Vedi anche

Documenti con voci — come compilare le righe di un documento
Import XML FatturaPA — importare tipi documento FE da file XML
Fattura elettronica: manuale vs import — quali campi FE sono contabili e quali metadati
Scadenze dai documenti — quando un documento genera (o no) una scadenza