> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Numeri dei documenti nei modelli

> Stampa i numeri di fatture, note di credito e preventivi con `document_number`, la data della fattura con `document_date` e un avviso di annullamento.

Quando la numerazione dei documenti è attiva, Foliant assegna a fatture, note di credito e preventivi una propria numerazione progressiva, ad esempio `INV-0042`. Un modello stampa il numero con `{{ document_number }}` oppure, nell'editor visivo, con il blocco **Numero del documento**.

## Prima di iniziare

* Attiva la numerazione in **Impostazioni › Documenti e stampa › Numerazione dei documenti**. Vedi [Configurare la numerazione dei documenti](https://foliant-help.iforiti.com/it/invoices-and-numbering/document-numbering.md).
* Imposta il **Tipo di documento** del modello su **Fattura**, **Nota di credito** o **Preventivo** nella sua pagina delle impostazioni. I modelli di tipo **Altro (non numerato)** non ricevono numeri.

## Nell'editor visivo

Aggiungi il blocco **Numero del documento** (in **Conformità**). Stampa il numero e la data del documento con le relative etichette, come "Numero fattura" e "Data fattura" ("Data nota di credito" su una nota di credito, "Data preventivo" su un preventivo), nella lingua del documento. Compare solo sui documenti numerati.

Puoi anche aggiungere **Numero del documento** e **Data del documento** ai **Dettagli sotto il titolo** di un blocco **Intestazione**, oppure usare **Numero del documento** come contenuto codificato da un blocco **Codice a barre / QR**.

## Nel codice

| Variabile | Che cos'è |
| - | - |
| `{{ document_number }}` | Il numero del documento. Vuoto quando il documento non ha un numero. |
| `{{ document_issued_at }}` | Quando è stato emesso il numero. Vuoto quando il documento non ha un numero. Formattalo con `date`. |
| `{{ document_date }}` | La data del documento, sempre presente: quando è stato emesso il suo numero, altrimenti la data dell'ordine (per una nota di credito, la data del rimborso). Usala come data della fattura. Formattala con `date`. |
| `{{ document_voided }}` | Vero quando il documento è stato annullato. Il suo numero resta usato e non viene mai riassegnato. |
| `{{ document_kind }}` | `invoice`, `credit_note` o `quote`; vuoto quando il modello non è numerato. |

Stampa il numero solo quando c'è:

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` stampa "Data fattura" nella lingua del documento; usa `document_date.credit_note` o `document_date.quote` per gli altri tipi.

## La data della fattura

La data di una fattura è il giorno in cui è stata emessa: il giorno in cui le è stato assegnato il numero. Non è la data dell'ordine, né la data di oggi, che cambia ogni volta che la ristampi. `{{ document_date }}` ti dà proprio quella data:

* Su un documento numerato, è il giorno in cui è stato emesso il numero, nel fuso orario del tuo negozio. Ristampare il documento il mese prossimo non la cambia.
* Su un documento senza numero, è la data dell'ordine. Per gli ordini importati da altre piattaforme, è la data in cui l'ordine è stato elaborato. Una nota di credito usa la data del suo rimborso.

Così un solo modello funziona sia con la numerazione attiva sia disattivata. I modelli predefiniti di fattura, nota di credito e preventivo la stampano già, con l'etichetta "Data fattura", "Data nota di credito" o "Data preventivo". Se il tuo modello stampa `'now' | date` come data, sostituiscilo con `{{ document_date | date: '%d %B %Y' }}`.

## Se il tuo modello non stampa il numero

Quando il modello di un documento numerato non usa `document_number` da nessuna parte, Foliant aggiunge in fondo una piccola riga con il numero e la data di emissione, ad esempio "Numero fattura: INV-0042 · 4 ottobre 2026", così il numero non manca mai. Aggiungi `{{ document_number }}` dove vuoi e la riga extra scompare. Se il tuo modello stampa già `document_date` o `document_issued_at`, la riga mostra solo il numero.

## Buono a sapersi

* Un documento riceve il suo numero la prima volta che viene scaricato, stampato o esportato, e lo mantiene.
* L'anteprima dell'editor mostra il numero che riceverebbe il tuo prossimo documento, senza consumarlo.
* Un codice a barre del numero: `{{ document_number | barcode }}`. Vedi [Codici a barre e codici QR](https://foliant-help.iforiti.com/it/template-editor/liquid-barcodes-and-qr-codes.md).
* I modelli per tutti gli ordini selezionati non vengono mai numerati.

## Articoli correlati

* [Configurare la numerazione dei documenti](https://foliant-help.iforiti.com/it/invoices-and-numbering/document-numbering.md)
* [Riferimento dei blocchi](https://foliant-help.iforiti.com/it/template-editor/block-catalogue.md)
* [Codici a barre e codici QR](https://foliant-help.iforiti.com/it/template-editor/liquid-barcodes-and-qr-codes.md)
* [Date, lingue e traduzioni](https://foliant-help.iforiti.com/it/template-editor/liquid-dates-and-languages.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.