> ## 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. # Créer un champ personnalisé de contrat > Ajoutez un champ personnalisé à un modèle de contrat — utilisé comme variable de contrat et synchronisé avec votre CRM. Un champ personnalisé de contrat capture des informations propres à vos modèles juridiques — par exemple, une variante de clause, une juridiction, une date d'entrée en vigueur ou un minimum garanti. Le champ apparaît sur les enregistrements de contrat, peut être référencé comme variable dans le texte du contrat et se synchronise optionnellement avec votre CRM. Ce guide parcourt le cycle de vie complet en trois étapes. Vous devez disposer du rôle **Admin** avec l'autorisation **Données → Lecture et écriture**. Le mapping CRM nécessite également l'accès **Développeurs**. ## Ce que vous allez créer Dans cet exemple, vous allez ajouter un champ **Juridiction** sur le modèle de contrat — un champ Texte qui pilote une variante de clause dans vos modèles de contrat. Les commerciaux le sélectionneront lors de la création du devis, et il apparaîtra dans le contrat via une variable `{{contract.jurisdiction}}`. | Champ | Type | Objectif | | --------------- | ----- | -------------------------------------------- | | **Juridiction** | Texte | Pays ou état sous lequel le contrat est régi | Le champ sera **obligatoire**, **modifiable par les commerciaux** et **non affiché au client** (c'est un marqueur interne pour les opérations juridiques — le client voit le texte de clause résolu dans le contrat, pas le nom de la variable). ## Étape 1 : Créer le champ dans le modèle de données Accédez à **Paramètres → Données → Modèle de données** et cliquez sur l'objet **Modèle de contrat**. En haut à droite de la liste des champs, cliquez sur **+ Nouveau** pour ouvrir le formulaire de création de champ. * **Nom** : `Juridiction` * **Nom API** : Qwoty génère automatiquement `juridiction`. Modifiez-le si vous avez besoin d'un identifiant spécifique (par exemple, `juridiction_applicable`). * **Type de données** : sélectionnez `Texte` Cliquez sur **Enregistrer** en haut à droite. Le nouveau champ apparaît dans la liste des champs de l'objet Modèle de contrat avec le badge **Personnalisé**. Le champ existe dans le modèle de données. Configurez ensuite son comportement sur chaque enregistrement de modèle de contrat. ## Étape 2 : Configurer le champ sur le modèle de contrat Le champ existe, mais il n'apparaît encore sur aucun contrat. Activez-le sur les modèles de contrat concernés et configurez les trois propriétés. Accédez à **Documents → Modèle de contrat** et ouvrez le modèle de contrat que vous souhaitez configurer (par exemple, `Contrat de vente standard`). Faites défiler jusqu'à la section **Champs personnalisés**. Le champ `Juridiction` que vous venez de créer apparaît, avec un bouton bascule et trois cases à cocher. Cliquez sur le bouton bascule pour activer le champ. Le bouton s'assombrit — le champ fait désormais partie de chaque contrat généré depuis ce modèle. Cochez les cases correspondant à vos besoins : * **Obligatoire** ✓ — le contrat ne peut pas être généré sans juridiction * **Modifiable par le commercial** ✓ — les commerciaux sélectionnent la valeur lors de la création du devis * **Afficher au client** — laissez décoché (la juridiction est interne — c'est le texte de clause résolu que le client voit) Si la plupart de vos contrats partagent la même juridiction, définissez une valeur par défaut (par exemple, `France`). Les commerciaux peuvent la remplacer par affaire. Cliquez sur **Enregistrer**. ### Utiliser le champ dans le texte du contrat Maintenant que le champ est actif, vous pouvez le référencer comme variable dans le corps du modèle de contrat : ``` Le présent Accord est régi par les lois de {{contract.jurisdiction}}. Tout litige sera réglé devant les tribunaux de {{contract.jurisdiction}}. ``` Lorsque le contrat est généré, la variable est résolue avec la valeur saisie par le commercial. Combinez-la avec des blocs conditionnels (si votre éditeur de contrat les prend en charge) pour substituer des clauses entières en fonction de la valeur : ``` {{#if contract.jurisdiction == "France"}} ... clause d'arbitrage spécifique à la France ... {{else if contract.jurisdiction == "Germany"}} ... clause d'arbitrage spécifique à l'Allemagne ... {{/if}} ``` Associez les champs personnalisés aux blocs de contenu ([Documents → Blocs de contenu](/user-guide/documents/reference/content-blocks)) pour des sections de contrat réutilisables qui dépendent de la valeur du champ. ## Étape 3 : Synchroniser avec votre CRM (optionnel) Si votre CRM suit les métadonnées de contrat (ce qui est souvent le cas dans les secteurs réglementés), mappez le champ Juridiction vers un champ CRM correspondant. Accédez à **Paramètres → Développeurs → Intégration** et cliquez sur votre CRM connecté. Faites défiler jusqu'au mapping des champs personnalisés. Le champ Modèle de contrat apparaît sous la forme `Personnalisé : Juridiction`. Ouvrez le menu déroulant de direction et choisissez : * **Bidirectionnel** — si votre équipe juridique met également à jour la juridiction dans le CRM * **Qwoty → CRM** — typique : la valeur est définie lors de la création du devis et transmise à l'enregistrement CRM * **CRM → Qwoty** — si la juridiction est déterminée en amont par vos workflows CRM Sélectionnez le champ CRM qui contient la valeur de juridiction. Types compatibles : Texte, Liste de sélection, Menu déroulant. Cliquez sur **Enregistrer les modifications** en bas de la page. La juridiction de votre contrat circule désormais entre Qwoty et votre CRM, et est également résolue comme variable dans les contrats générés. ## Champs personnalisés de contrat courants Au-delà de la Juridiction, voici des cas d'usage fréquents : | Champ | Type | Pourquoi | | ------------------------------------------ | -------------------------- | ---------------------------------------------------------------------- | | **Date d'entrée en vigueur** | Date | Quand le contrat prend effet (diffère souvent de la date de signature) | | **Indicateur de reconduction automatique** | Texte (ou booléen à venir) | Déclenche une clause de renouvellement différente | | **Délai de préavis (mois)** | Nombre | Utilisé dans les clauses de résiliation | | **Plafond de responsabilité** | Nombre | Plafond d'indemnisation négocié | | **Droit applicable** | Texte | Combiné avec la Juridiction pour les contrats transfrontaliers | | **Référence juridique externe** | Texte | Numéro de ticket ou de dossier du conseil interne | ## Résolution des problèmes Soit le champ est vide sur l'enregistrement du contrat, soit le nom de la variable ne correspond pas au nom API. Ouvrez le contrat et vérifiez que le champ est renseigné. Assurez-vous que la variable utilise exactement le nom API du champ (sensible à la casse). Vérifiez que le bouton bascule est **activé** dans la section Champs personnalisés du modèle de contrat. Les boutons bascule désactivés masquent le champ dans les formulaires. La case **Modifiable par le commercial** est décochée. Activez-la sur le modèle de contrat. Ajoutez d'abord un champ personnalisé côté CRM (Texte ou Liste de sélection pour la Juridiction), puis actualisez la section de mapping de l'intégration. ## Voir aussi Obligatoire, Modifiable, Afficher — les trois contrôles qui définissent le comportement. Comment les variables, les blocs de contenu et les modèles de contrat s'articulent. Le même processus, appliqué aux devis. Directions de synchronisation et compatibilité des champs CRM.