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

# Objets

> Objets Standard vs Gérables, et lesquels acceptent des champs personnalisés.

## Qu'est-ce qu'un objet ?

Un **objet** est une catégorie de données dans Qwoty — un type d'élément avec lequel votre équipe travaille. Chaque objet possède un schéma fixe de champs système ainsi que, pour certains d'entre eux, des champs personnalisés que vous ajoutez pour correspondre à votre activité.

Lorsque vous ouvrez **Paramètres → Données → Modèle de données**, vous voyez la liste complète des objets. Chacun porte un badge qui indique si vous pouvez l'étendre.

## Standard vs Gérable

Qwoty répartit les objets en deux catégories :

| Type         | Ce que vous pouvez faire                                                                                                                                    |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Standard** | Consulter les champs uniquement. Le schéma est verrouillé pour maintenir la cohérence du comportement principal de Qwoty dans tous les espaces de travail.  |
| **Gérable**  | Consulter les champs **et** ajouter des champs personnalisés. Les quatre objets les plus susceptibles de contenir des données spécifiques à votre activité. |

### Objets Gérables (4)

Ce sont les objets sur lesquels vous pouvez ajouter des champs personnalisés :

| Objet                     | Pourquoi il est gérable                                                                   | Champs personnalisés courants                                             |
| ------------------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **Client**                | Chaque entreprise qualifie ses clients différemment                                       | Type de client, responsable de compte, segment, identifiant réglementaire |
| **Devis** (via le Modèle) | Les devis portent des données spécifiques à l'affaire, propres à votre processus de vente | Date d'événement, code projet, date de livraison souhaitée                |
| **Produit**               | Les produits varient considérablement selon les secteurs                                  | Hectares, niveau de certification, spécifications techniques              |
| **Modèle de contrat**     | Les contrats comportent des clauses et des variables propres à vos modèles juridiques     | Variante de clause, avenant, texte spécifique à la juridiction            |

### Objets Standard

Les objets restants utilisent un schéma fixe. Vous pouvez consulter leurs champs et les intégrer, mais vous ne pouvez pas y ajouter directement des champs personnalisés :

Adresse, Approbation, Fréquence de facturation, Bundle, Unité commerciale, Catalogue, Contact, Bloc de contenu, Segment client, Remise, Intégration, Commande, Moyen de paiement, Condition de paiement, Catalogue de prix, Accord commercial, Taxe, Modèle, Workflow.

<Info>
  Même si le Devis est présenté comme un objet gérable via son Modèle, la **Commande** qui suit un devis signé est Standard. Les données de la commande sont issues du Devis au moment de la signature — vous ne personnalisez pas directement le schéma de la Commande.
</Info>

## Comment savoir si un objet accepte des champs personnalisés

Ouvrez **Paramètres → Données → Modèle de données** et regardez le badge situé à côté du nom de chaque objet :

* Badge **Standard** → aucun champ personnalisé ne peut être ajouté
* Badge **Gérable** → vous pouvez ajouter des champs personnalisés via **+ Nouveau** en haut de la liste des champs

Dans un objet gérable, les champs système affichent un badge **Système** dans la colonne **Type** (lecture seule). Les champs que vous ajoutez affichent un badge **Personnalisé** avec un accès API **Accessible en écriture**.

## Pourquoi certains objets sont Standard

Les objets Standard alimentent le comportement principal de Qwoty — tarification, taxation, approbations, commandes. Leurs schémas sont verrouillés car :

* **Cohérence** — chaque espace de travail les gère de la même façon, de sorte que les intégrations et les exports restent prévisibles
* **Stabilité** — ajouter un champ sur un objet principal risquerait de perturber le calcul des devis, la génération des contrats ou la génération des commandes
* **Performance** — les objets système sont fortement indexés pour des requêtes rapides ; des champs personnalisés sur ceux-ci dégraderaient la vitesse de recherche

Lorsque vous avez besoin de données sur un objet Standard, la convention est de les placer sur l'objet Gérable associé. Par exemple : un **Bundle** est Standard, mais le **Produit** inclus dans ce Bundle est Gérable — ajoutez le champ personnalisé sur le Produit, pas sur le Bundle.

## En relation

<CardGroup cols={2}>
  <Card title="Types de champs" icon="font" href="/user-guide/data-model/reference/field-types">
    Les trois types de données disponibles lors de l'ajout d'un champ personnalisé.
  </Card>

  <Card title="Propriétés des champs" icon="sliders" href="/user-guide/data-model/reference/field-properties">
    Obligatoire, Modifiable, Affichage — contrôlez le comportement d'un champ sur chaque objet.
  </Card>

  <Card title="Présentation du modèle de données" icon="diagram-project" href="/user-guide/data-model/introduction">
    Les concepts qui sous-tendent le modèle de données Qwoty.
  </Card>

  <Card title="Gérer les rôles" icon="user-shield" href="/user-guide/settings/users/manage-roles">
    Contrôlez qui peut modifier le modèle de données.
  </Card>
</CardGroup>