> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Anatomie d'un devis

> Comprendre la structure et les composants d'un devis Qwoty

{/* AUDIT NOTE: Conceptual reference doc — section names are logical groupings, not exact UI labels. UI panels observed: Customer, General Information, Quote (containing product sections, Taxes, Summary). Summary labels confirmed in app: "One-off total excl. tax.", "Total taxes", "Grand Total". */}

Un devis Qwoty est composé de plusieurs sections interconnectées qui définissent ce que vous vendez, comment c'est tarifé, et comment le client paiera. Comprendre l'anatomie d'un devis vous aide à construire des propositions précises et à résoudre les problèmes de tarification.

Chaque devis hérite de sa configuration de base depuis un modèle, mais vous pouvez personnaliser les sections individuelles pour chaque affaire.

## Composants principaux

Un devis est constitué de six sections principales :

* **En-tête** : informations client, métadonnées du devis, date d'expiration et statut global
* **Lignes** : produits, bundles et services vendus avec les quantités et la tarification
* **Logique de tarification** : remises, frais, taxes et modèle de tarification (unique, récurrent, basé sur l'usage)
* **Conditions de paiement** : fréquence de facturation, calendrier de paiement et options de versements
* **Résumé** : totaux ventilés par modèle de tarification et période
* **Variables de contrat** : données dynamiques utilisées pour remplir le document contractuel

Chaque section extrait des données de différentes sources dans Qwoty — catalogues, grilles tarifaires, modèles de conditions de paiement et fiches clients.

## Flux de structure d'un devis

```mermaid theme={null}
graph TD
    A[Template] --> B[Quote Header]
    A --> C[Line Items]
    A --> D[Payment Terms]
    A --> E[Contract Model]
    C --> F[Pricing Logic]
    F --> G[Summary]
    G --> H[Contract Variables]
    B --> H
    D --> H
    
    style A fill:#e3f2fd
    style G fill:#f3e5f5
    style H fill:#fff3e0
```

## Section en-tête

L'en-tête contient les informations d'identification et contrôle le cycle de vie du devis.

### Champs principaux de l'en-tête

| Champ             | Description                                   | Source                                         |
| ----------------- | --------------------------------------------- | ---------------------------------------------- |
| Numéro de devis   | Identifiant unique, généré automatiquement    | Système ou format personnalisé                 |
| Client            | Entreprise et contact recevant le devis       | Fiche client                                   |
| Date d'expiration | Date limite pour l'acceptation du client      | Valeur par défaut du modèle ou saisie manuelle |
| Statut            | Position actuelle dans le workflow du devis   | Géré par le système selon les actions          |
| Propriétaire      | Représentant commercial responsable du devis  | Attribution d'utilisateur                      |
| Devise            | Devise de tarification pour toutes les lignes | Modèle ou valeur par défaut du client          |

<Note>
  Vous ne pouvez pas modifier la devise après avoir ajouté des lignes à un devis.
</Note>

### Champs personnalisés

Vous pouvez ajouter des champs personnalisés à l'en-tête pour capturer des informations spécifiques à l'affaire, comme les noms de concurrents, le stade de l'affaire ou des notes internes. Les champs personnalisés sont disponibles en tant que variables de contrat.

## Section lignes

Les lignes définissent ce que le client achète. Chaque ligne fait référence à un produit du catalogue du devis et applique la tarification de la grille tarifaire assignée.

### Attributs des lignes

* **Produit** : l'article du catalogue vendu
* **Quantité** : nombre d'unités ou de licences
* **Modèle de tarification** : unique, récurrent (mensuel, annuel) ou basé sur l'usage
* **Prix unitaire** : prix de base issu de la grille tarifaire
* **Remise** : réduction en pourcentage ou en montant fixe
* **Prix net** : prix final après remises et avant taxes

### Bundles et relations parent-enfant

Les bundles apparaissent sous forme de lignes extensibles. Le bundle joue le rôle de parent avec des produits enfants imbriqués en dessous. Vous pouvez tarifer le bundle dans son ensemble ou tarifer les composants individuellement.

## Section logique de tarification

Cette section calcule les montants finaux en fonction des lignes, des remises et des frais supplémentaires.

### Composants de tarification

<CardGroup cols={2}>
  <Card title="Remises" icon="percent">
    Appliquez des remises au niveau de la ligne, du devis ou promotionnelles, en pourcentage ou en montants fixes
  </Card>

  <Card title="Frais" icon="file-invoice-dollar">
    Ajoutez des frais d'installation, des frais de mise en œuvre ou d'autres coûts ponctuels
  </Card>

  <Card title="Taxes" icon="receipt">
    Calculez la taxe de vente ou la TVA en fonction de la localisation du client et des règles fiscales des produits
  </Card>

  <Card title="Paliers progressifs" icon="chart-line">
    Planifiez des augmentations ou des diminutions de prix sur la durée du contrat
  </Card>
</CardGroup>

### Hiérarchie des remises

Les remises sont appliquées dans un ordre spécifique :

1. Remise au niveau de la ligne (appliquée en premier)
2. Remise de bundle (si la ligne fait partie d'un bundle)
3. Remise au niveau du devis (appliquée en dernier)

Chaque remise se compose sur le résultat de la remise précédente, et non sur le prix d'origine.

## Section conditions de paiement

Les conditions de paiement définissent quand et comment le client paie. Ces paramètres proviennent du modèle mais peuvent être remplacés par devis.

### Configurations de paiement courantes

| Configuration       | Cas d'usage                                            |
| ------------------- | ------------------------------------------------------ |
| Dû à la réception   | Facturation B2B standard                               |
| Net 30/60/90        | Paiement dû X jours après la facture                   |
| Versements          | Répartir le paiement en plusieurs échéances planifiées |
| Acompte + récurrent | Frais d'installation initiaux plus abonnement continu  |
| Prépaiement annuel  | Le client paie l'année complète en avance              |

<Tip>
  Utilisez les versements pour améliorer la vélocité des affaires sur les devis à haute valeur. Les clients sont plus susceptibles de s'engager lorsque le coût initial est moins élevé.
</Tip>

## Section résumé

Le résumé agrège tous les composants de tarification et affiche les totaux ventilés par modèle de tarification et période.

### Ventilations du résumé

* **Total ponctuel** : tous les frais initiaux incluant les frais, la mise en place et les produits ponctuels
* **Total récurrent** : montants des abonnements mensuels ou annuels
* **Première facture** : ce que le client paie initialement (ponctuel + première période récurrente)
* **Valeur du contrat** : valeur totale sur l'ensemble de la durée du contrat (TCV)
* **Valeur annuelle du contrat** : valeur annualisée pour les contrats pluriannuels (ACV)

Le résumé se met à jour automatiquement lorsque vous modifiez les lignes, les remises ou les conditions de paiement.

## Variables de contrat

Les variables sont des espaces réservés dans votre modèle de contrat qui extraient des données en direct depuis le devis, la fiche client et les paramètres de l'entreprise.

### Catégories de variables

<AccordionGroup>
  <Accordion title="Variables de devis">
    Référencez les données du devis comme `{{quote.total}}`, `{{quote.number}}`, `{{quote.start_date}}` ou `{{quote.end_date}}`.
  </Accordion>

  <Accordion title="Variables client">
    Insérez les détails du client comme `{{customer.name}}`, `{{customer.address}}`, `{{customer.billing_contact}}` ou des champs personnalisés.
  </Accordion>

  <Accordion title="Variables d'entreprise">
    Incluez les informations de votre entreprise comme `{{company.name}}`, `{{company.legal_entity}}` ou `{{company.support_email}}`.
  </Accordion>

  <Accordion title="Variables de ligne">
    Parcourez les produits avec `{{#line_items}}` pour générer des tableaux de produits dynamiques dans votre contrat.
  </Accordion>

  <Accordion title="Variables de champs personnalisés">
    Utilisez tout champ personnalisé ajouté à l'en-tête du devis comme variable dans votre contrat.
  </Accordion>
</AccordionGroup>

Les variables sont résolues lorsque vous publiez le devis et créez la Dealroom.

## Questions fréquentes

<AccordionGroup>
  <Accordion title="Puis-je changer le modèle après avoir créé un devis ?">
    Non. Le modèle est verrouillé lors de la création du devis. Pour utiliser un modèle différent, vous devez créer un nouveau devis. Vous pouvez cloner le devis existant pour conserver les lignes.
  </Accordion>

  <Accordion title="Que se passe-t-il pour la tarification lorsque je modifie la quantité ?">
    Le prix unitaire reste le même, sauf si des paliers de tarification volumétrique sont configurés dans la grille tarifaire. Le prix net est recalculé automatiquement en fonction de la nouvelle quantité.
  </Accordion>

  <Accordion title="Puis-je ajouter des produits de plusieurs catalogues ?">
    Non. Toutes les lignes doivent provenir du catalogue unique assigné au modèle du devis. Pour vendre des produits de catalogues croisés, créez un catalogue unifié ou utilisez plusieurs devis sous le même contrat.
  </Accordion>

  <Accordion title="Comment voir la ventilation d'un prix de bundle ?">
    Développez la ligne du bundle pour afficher les produits enfants et leurs prix individuels. Le total du bundle est égal à la somme de ses composants, sauf si vous avez appliqué une remise au niveau du bundle.
  </Accordion>
</AccordionGroup>

## En relation

<CardGroup cols={2}>
  <Card title="Créer des devis" icon="file-circle-plus" href="/user-guide/quotes/reference/lifecycle">
    Guide pas à pas pour construire votre premier devis
  </Card>

  <Card title="Cycle de vie d'un devis" icon="arrow-progress" href="/user-guide/quotes/reference/lifecycle">
    Comprendre les statuts et le workflow d'un devis
  </Card>

  <Card title="Présentation des modèles" icon="layer-group" href="/user-guide/templates/introduction">
    Comment les modèles contrôlent la configuration des devis
  </Card>

  <Card title="Variables de contrat" icon="brackets-curly" href="/user-guide/orders-contracts/how-tos/create-contract">
    Référence complète pour les champs contractuels dynamiques
  </Card>
</CardGroup>