> ## 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.

# Numéros de document dans les modèles

> Imprimez les numéros de facture, d'avoir et de devis avec {{ document_number }}, la date de facture avec {{ document_date }}, ainsi qu'une mention d'annulation.

Lorsque la numérotation des documents est activée, Foliant attribue aux factures, aux avoirs et aux devis leurs propres numéros séquentiels, comme `INV-0042`. Un modèle imprime le numéro avec `{{ document_number }}`, ou, dans l'éditeur visuel, avec le bloc **Numéro de document**.

## Avant de commencer

* Activez la numérotation dans **Paramètres › Documents et impression › Numérotation des documents**. Consultez [Configurer la numérotation des documents](https://foliant-help.iforiti.com/fr/invoices-and-numbering/document-numbering.md).
* Sur la page des paramètres du modèle, réglez son **Type de document** sur **Facture**, **Avoir** ou **Devis**. Les modèles de type **Autre (non numéroté)** ne reçoivent pas de numéro.

## Dans l'éditeur visuel

Ajoutez le bloc **Numéro de document** (dans **Conformité**). Il imprime le numéro et la date du document avec leurs libellés, comme « Numéro de facture » et « Date de facture » (« Date de l'avoir » sur un avoir, « Date du devis » sur un devis), dans la langue du document. Il n'apparaît que sur les documents numérotés.

Vous pouvez aussi ajouter **Numéro de document** et **Date du document** aux **Détails sous le titre** d'un bloc **En-tête**, ou choisir **Numéro de document** comme contenu encodé par un bloc **Code-barres / QR**.

## Dans le code

| Variable | Description |
| - | - |
| `{{ document_number }}` | Le numéro du document. Vide si le document n'a pas de numéro. |
| `{{ document_issued_at }}` | Le moment où le numéro a été attribué. Vide si le document n'a pas de numéro. Mettez-le en forme avec `date`. |
| `{{ document_date }}` | La date du document, toujours renseignée : la date d'attribution de son numéro, sinon la date de la commande (la date du remboursement pour un avoir). Utilisez-la comme date de facture. Mettez-la en forme avec `date`. |
| `{{ document_voided }}` | Vrai si le document a été annulé. Son numéro reste utilisé et n'est jamais réattribué. |
| `{{ document_kind }}` | `invoice`, `credit_note` ou `quote` ; vide si le modèle n'est pas numéroté. |

N'imprimez le numéro que s'il existe :

```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` imprime « Date de facture » dans la langue du document ; utilisez `document_date.credit_note` ou `document_date.quote` pour les autres types.

## La date de facture

La date d'une facture est le jour de son émission : le jour où son numéro a été attribué. Ce n'est ni la date de la commande, ni la date du jour, qui change à chaque réimpression. `{{ document_date }}` vous donne cette date :

* Sur un document numéroté, c'est le jour d'attribution du numéro, dans le fuseau horaire de votre boutique. Réimprimer le document le mois suivant ne la modifie pas.
* Sur un document sans numéro, c'est la date de la commande. Pour les commandes importées d'ailleurs, c'est la date à laquelle la commande a été traitée. Un avoir utilise la date de son remboursement.

Un même modèle fonctionne donc, que la numérotation soit activée ou non. Les modèles intégrés de facture, d'avoir et de devis l'impriment déjà, avec le libellé « Date de facture », « Date de l'avoir » ou « Date du devis ». Si votre propre modèle imprime `'now' | date` comme date, remplacez-le par `{{ document_date | date: '%d %B %Y' }}`.

## Si votre modèle n'imprime pas le numéro

Lorsque le modèle d'un document numéroté n'utilise `document_number` nulle part, Foliant ajoute à la fin une petite ligne avec le numéro et sa date d'attribution, comme « Numéro de facture : INV-0042 · 4 octobre 2026 », afin que le numéro ne manque jamais. Ajoutez `{{ document_number }}` à l'endroit voulu, et cette ligne disparaît. Si votre modèle imprime déjà `document_date` ou `document_issued_at`, la ligne n'affiche que le numéro.

## Bon à savoir

* Un document reçoit son numéro la première fois qu'il est téléchargé, imprimé ou exporté, et le conserve.
* L'aperçu de l'éditeur affiche le numéro que recevrait votre prochain document, sans le consommer.
* Un code-barres du numéro : `{{ document_number | barcode }}`. Consultez [Codes-barres et codes QR](https://foliant-help.iforiti.com/fr/template-editor/liquid-barcodes-and-qr-codes.md).
* Les modèles portant sur toutes les commandes sélectionnées ne sont jamais numérotés.

## Articles associés

* [Configurer la numérotation des documents](https://foliant-help.iforiti.com/fr/invoices-and-numbering/document-numbering.md)
* [Référence des blocs](https://foliant-help.iforiti.com/fr/template-editor/block-catalogue.md)
* [Codes-barres et codes QR](https://foliant-help.iforiti.com/fr/template-editor/liquid-barcodes-and-qr-codes.md)
* [Dates, langues et traductions](https://foliant-help.iforiti.com/fr/template-editor/liquid-dates-and-languages.md)


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