# Variables

Pour afficher les valeurs liées au document dans votre modèle, vous devez utiliser des variables. La section suivante répertorie toutes les variables disponibles dans votre document.

Pour afficher la valeur d'une variable, insérez simplement `{{variable_name}}` dans le code de votre thème.

### Compte

Voici les variables disponibles sur l'objet `account` :

| Nom                           | Type   | Description                                          |
| ----------------------------- | ------ | ---------------------------------------------------- |
| `account.logo_url`            | String | L'URL du logo de votre compte                        |
| `account.company_name`        | String | Le nom de votre compte                               |
| `account.address_line_1`      | String | La 1ère ligne d'adresse de votre compte              |
| `account.address_line_2`      | String | La 2ème ligne d'adresse de votre compte              |
| `account.zip_code`            | String | Le code postal de l'adresse de votre compte          |
| `account.city`                | String | La ville de l'adresse de votre compte                |
| `account.country_name`        | String | Le pays de l'adresse de votre compte                 |
| `account.vat_number`          | String | Le numérot de TVA de votre compte                    |
| `account.phone_number`        | String | Le numéro de téléphone de votre compte               |
| `account.email`               | String | L'adresse email de votre compte                      |
| `account.bank_account_number` | String | Le numéro de compte bancaire de votre compte         |
| `account.bic`                 | String | Le numéro BIC (Bank Identifier Code) de votre compte |
| `account.peppol_identifier`   | String | L'identifiant PEPPOL de votre compte                 |

### Document

Voici les variables disponibles sur l'objet `document` :

**Important**

Certaines variables du document ne sont disponibles que pour certains types de documents. Le tableau suivant indique la disponibilité pour chaque type de document (facture, devis ou note de crédit).

<table><thead><tr><th width="279.78125">Nom</th><th>Type</th><th width="100.0546875">Facture</th><th width="99.515625">Devis</th><th width="100.17578125">Note de crédit</th><th>Description</th></tr></thead><tbody><tr><td><code>document.company</code></td><td>Object</td><td>Oui</td><td>Oui</td><td>Oui</td><td>La société du document. Voir la section <a href="https://documentation.factures.com/systeme-de-themes/variables#la-societe-du-document">société du document</a> plus d'informations.</td></tr><tr><td><code>document.number</code></td><td>String</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le numéro du document</td></tr><tr><td><code>document.issue_date</code></td><td>Date</td><td>Oui</td><td>Oui</td><td>Oui</td><td>La date d'envoi du document</td></tr><tr><td><code>document.due_date</code></td><td>Date</td><td>Oui</td><td></td><td></td><td>La date d'échéance du document</td></tr><tr><td><code>document.expiration_date</code></td><td>Date</td><td></td><td>Oui</td><td></td><td>La date d'expiration du document</td></tr><tr><td><code>document.name</code></td><td>String</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le nom du document</td></tr><tr><td><code>document.top_text</code></td><td>Text</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le texte d'entête du document</td></tr><tr><td><code>document.lines</code></td><td>Array</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Les lignes du document. Voir la section <a href="https://documentation.factures.com/systeme-de-themes/variables#lignes-du-document">lignes du document </a>pour plus d'informations</td></tr><tr><td><code>document.sub_total_without_vat</code></td><td>Decimal</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le sous total HTVA du document, sans la réduction appliquée</td></tr><tr><td><code>document.discount_total</code></td><td>Decimal</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le montant de la réduction</td></tr><tr><td><code>document.discount?</code></td><td>Boolean</td><td>Oui</td><td>Oui</td><td></td><td>True si le document a une réduction</td></tr><tr><td><code>document.total_without_vat</code></td><td>Decimal</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le montant total HTVA du document avec la réduction appliquée si il y en a une</td></tr><tr><td><code>document.vat_totals</code></td><td>Array</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Les taux de TVA du document. Voir la section <a href="https://documentation.factures.com/systeme-de-themes/variables#les-totaux-de-tva-du-document">totaux de TVA du document </a>pour plus d'informations</td></tr><tr><td><code>document.bottom_text</code></td><td>Text</td><td>Oui</td><td>Oui</td><td>Oui</td><td>Le texte de bas de page du document</td></tr><tr><td><code>document.permalink</code></td><td>Text</td><td>Oui</td><td>Oui</td><td>Oui</td><td>L'URL vers votre document. <strong>Seulement disponible dans les textes des emails</strong></td></tr><tr><td><code>document.invoice?</code></td><td>Boolean</td><td>Oui</td><td>Oui</td><td>Oui</td><td>True si le document est une facture</td></tr><tr><td><code>document.estimate?</code></td><td>Boolean</td><td>Oui</td><td>Oui</td><td>Oui</td><td>True si le document est un devis</td></tr><tr><td><code>document.credit_note?</code></td><td>Boolean</td><td>Oui</td><td>Oui</td><td>Oui</td><td>True si le document est une note de crédit</td></tr></tbody></table>

### La société du document

Voici les variables disponibles sur l'objet `document.company` :

| Nom                                  | Type   | Description                               |
| ------------------------------------ | ------ | ----------------------------------------- |
| `document.company.name`              | String | Le nom de la société                      |
| `document.company.number`            | String | Le numéro de la société                   |
| `document.company.address_line_1`    | String | La 1ère ligne d'adresse de la société     |
| `document.company.address_line_2`    | String | Le 2ème ligne d'adresse de la société     |
| `document.company.zip_code`          | String | Le code postal de l'adresse de la société |
| `document.company.city`              | String | La ville de l'adresse de la société       |
| `document.company.country_name`      | String | Le pays de l'adresse de la société        |
| `document.company.vat_number`        | String | Le numéro de TVA de la société            |
| `document.company.phone_number`      | String | Le numéro de téléphone de la société      |
| `document.company.peppol_identifier` | String | L'identifiant PEPPOL de la société        |

### Lignes du document

Voici les variables disponibles pour chaque objet du tableau `document.lines` :

| Nom                      | Type    | Description                           |
| ------------------------ | ------- | ------------------------------------- |
| `line.quantity`          | String  | La quantité de la ligne               |
| `line.unit_price`        | Decimal | Le prix unitaire de la ligne          |
| `line.vat_rate`          | Decimal | Le taux de TVA de la ligne            |
| `line.total_without_vat` | Decimal | Le  total HTVA de la ligne            |
| `line.total_with_vat`    | Decimal | Le total TVAC de la ligne             |
| `line.description`       | String  | La description de la ligne            |
| `line.divider?`          | Boolean | True si la ligne est un séparateur    |
| `line.product?`          | Boolean | True si la ligne a un produit associé |
| `line.product`           | Object  | Le produit associé à la ligne         |

### Produit d'une ligne du document

Voici les variables disponibles sur l'objet `line.product` :

| Nom                      | Type   | Description             |
| ------------------------ | ------ | ----------------------- |
| `line.product.name`      | String | Le nom du produit       |
| `line.product.reference` | String | La référence du produit |

### Les totaux de TVA du document

Voici les variables disponibles pour chaque objet du tableau `document.vat_totals` :

| Name                    | Type    | Description                     |
| ----------------------- | ------- | ------------------------------- |
| `vat_total.percentage`  | String  | Le pourcentage du total TVA     |
| `vat_total.base_amount` | Decimal | Le montant de base du total TVA |
| `vat_total.amount`      | Decimal | Le montant TVA du total TVA     |

### Numérotation de page

Utilisez cette syntaxe spécifique pour afficher le numéro de page actuel et le numéro total de page. Notez qu'il ne s'agit pas de balisage Liquid.

```
<p>Page $[page] of $[total]</p>
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.factures.com/systeme-de-themes/variables.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
