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

# Propriétés des champs

> Obligatoire, Modifiable par le commercial et Afficher pour le client — contrôlez où les valeurs des champs personnalisés circulent.

Lorsque vous créez un champ personnalisé dans **Paramètres → Données → Modèle de données**, vous définissez son nom, son nom d'API et son type de données. Mais le **comportement** du champ sur chaque objet — s'il est obligatoire, qui peut le modifier, qui le voit — est configuré séparément, sur l'objet lui-même.

Cette page explique les trois propriétés que Qwoty propose et comment les combiner pour les cas d'usage les plus courants.

## La section Champs personnalisés sur chaque objet

Une fois qu'un champ personnalisé existe dans le Modèle de données, il apparaît dans la section **Champs personnalisés** de chaque enregistrement de l'objet correspondant (ou du Template concerné, pour un Devis). Pour chaque champ, vous voyez :

* Un **interrupteur** pour activer ou désactiver le champ sur cet objet
* Trois cases à cocher : **Obligatoire**, **Modifiable par le commercial**, **Afficher pour le client**
* La zone de saisie du champ (champ texte, nombre ou sélecteur de date) pour entrer la valeur

<Tip>
  Si un champ personnalisé n'apparaît pas sur l'objet après sa création, vérifiez que son interrupteur est **activé** dans la section Champs personnalisés. Désactiver l'interrupteur masque le champ dans les formulaires tout en conservant sa définition intacte.
</Tip>

## Les trois propriétés

### Obligatoire

Lorsqu'elle est activée, le champ **doit être renseigné** avant d'enregistrer l'objet (ou, pour les champs pilotés par un Template, avant que le devis puisse être soumis).

**Utilisez Obligatoire lorsque :**

* L'absence de valeur bloquerait des processus en aval (par exemple, une `Date de livraison` requise par votre entrepôt)
* La conformité ou la génération de contrat en dépend (un champ `Juridiction` pour les modèles juridiques)
* Votre reporting nécessite que le champ soit renseigné pour produire des KPIs pertinents

**N'utilisez pas Obligatoire lorsque :**

* Le champ ne s'applique qu'à certains enregistrements (un champ `Hectares` pertinent pour les clients agricoles mais pas pour les clients retail)
* La valeur est renseignée plus tard dans le cycle de vente (une `Date de signature` que vous ne pouvez renseigner qu'à la signature)

### Modifiable par le commercial

Lorsqu'elle est activée, les commerciaux peuvent modifier la valeur du champ. Lorsqu'elle est désactivée, le champ est **en lecture seule** pour les commerciaux — généralement renseigné par un administrateur, une intégration ou une importation.

**Utilisez "Modifiable par le commercial" lorsque :**

* Les commerciaux sont propriétaires de la valeur (une `Date d'événement` qu'ils collectent auprès du client)
* Le champ fait partie du flux de travail du commercial

**Désactivez "Modifiable par le commercial" lorsque :**

* La valeur provient de votre CRM et ne doit pas être écrasée par erreur
* Seuls les administrateurs doivent définir la valeur (un `Niveau de remise` lié à des conditions commerciales négociées)
* La valeur est calculée par une intégration

<Info>
  "Modifiable par le commercial" contrôle l'expérience du **commercial**. Les administrateurs peuvent toujours modifier les champs personnalisés quel que soit ce paramètre.
</Info>

### Afficher pour le client

Lorsqu'elle est activée, le champ apparaît sur le devis côté acheteur et dans le Dealroom. Le client voit le libellé et la valeur du champ aux côtés des lignes, des dates et des totaux.

**Utilisez "Afficher pour le client" lorsque :**

* L'acheteur a besoin de la valeur pour prendre une décision (une `Date d'événement` pour qu'il puisse confirmer la planification)
* La valeur fait partie des conditions commerciales (`Effectif`, `Fenêtre de livraison`)
* L'information est destinée à être transparente

**N'utilisez pas "Afficher pour le client" lorsque :**

* Le champ est une métadonnée interne (un `Code responsable de compte`, une `Région de vente`)
* Il n'est utilisé qu'à des fins de reporting ou de comptabilité (un `Code comptable`)
* Partager la valeur exposerait la logique tarifaire interne

## Combinaisons courantes

Ces combinaisons couvrent la plupart des configurations :

| Combinaison                        | Obligatoire  | Modifiable par le commercial | Afficher pour le client | Exemple                                             |
| ---------------------------------- | ------------ | ---------------------------- | ----------------------- | --------------------------------------------------- |
| **Visible client, obligatoire**    | ✓            | ✓                            | ✓                       | Date d'événement sur un devis                       |
| **Visible client, optionnel**      | —            | ✓                            | ✓                       | Instructions spéciales                              |
| **Note interne commercial**        | —            | ✓                            | —                       | Contexte de l'affaire par le commercial             |
| **Visible client, contrôlé admin** | —            | —                            | ✓                       | Niveau de remise négocié affiché au client          |
| **Métadonnée admin uniquement**    | —            | —                            | —                       | Code responsable de compte, compte comptable        |
| **Lecture seule synchronisée CRM** | selon le cas | —                            | selon le cas            | Secteur d'activité du client importé depuis HubSpot |

## Comment un champ apparaît selon le profil

Les trois propriétés déterminent ce que chaque profil voit :

* **L'administrateur** — voit et modifie chaque champ personnalisé, quelles que soient les propriétés
* **Le commercial** — voit chaque champ actif ; ne peut modifier que ceux avec **Modifiable par le commercial** ✓
* **Le client** — voit uniquement les champs avec **Afficher pour le client** ✓ dans le Dealroom publié

Un champ personnalisé peut transporter des informations qui circulent à travers les trois profils, ou rester interne. La combinaison est à votre discrétion.

## Badge d'affichage dans la vue client

Lorsqu'un champ est défini sur **Afficher pour le client**, il apparaît dans le Dealroom avec un badge violet **Affichage** (visible en mode aperçu administrateur). Ce badge confirme que le champ sera visible par l'acheteur lorsque le devis sera publié.

<Note>
  Le badge Affichage n'apparaît que dans l'aperçu administrateur pour rappeler à votre équipe quels champs sont exposés. Le client ne voit pas le badge — il voit le libellé et la valeur du champ mis en forme comme le reste du devis.
</Note>

## Modifier les propriétés ultérieurement

Vous pouvez modifier l'une des trois propriétés à tout moment. Les modifications prennent effet pour les **nouveaux** enregistrements et l'état **publié** des enregistrements existants :

* Activer **Obligatoire** ne bloque pas rétroactivement les enregistrements existants — uniquement les enregistrements et soumissions futurs
* Activer **Afficher pour le client** republie le champ dans les Dealrooms existants lors de la prochaine mise à jour du devis
* Désactiver **Modifiable par le commercial** rend immédiatement le champ en lecture seule pour les commerciaux

<Warning>
  Désactiver entièrement l'interrupteur du champ (dans la section Champs personnalisés) masque le champ de tous les formulaires mais **conserve les valeurs enregistrées**. Le réactiver restaure le champ avec ses valeurs intactes.
</Warning>

## Voir aussi

<CardGroup cols={2}>
  <Card title="Types de champs" icon="font" href="/user-guide/data-model/reference/field-types">
    Texte, Nombre, Date — les trois types de données disponibles.
  </Card>

  <Card title="Mapping CRM" icon="arrows-rotate" href="/user-guide/data-model/reference/crm-mapping">
    Configurez le sens de synchronisation et le champ CRM pour chaque champ personnalisé.
  </Card>

  <Card title="Créer un champ personnalisé de Devis" icon="file-invoice-dollar" href="/user-guide/data-model/how-tos/create-quote-custom-field">
    Exemple pratique combinant les trois propriétés.
  </Card>

  <Card title="Gérer les rôles" icon="user-shield" href="/user-guide/settings/users/manage-roles">
    Qui peut modifier le modèle de données et les champs d'objet.
  </Card>
</CardGroup>
