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}}.
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
1
Ouvrir 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.
2
Cliquer sur + Nouveau
En haut à droite de la liste des champs, cliquez sur + Nouveau pour ouvrir le formulaire de création de champ.
3
Renseigner les informations générales
- 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
4
Enregistrer
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.1
Ouvrir le modèle de contrat
Accédez à Documents → Modèle de contrat et ouvrez le modèle de contrat que vous souhaitez configurer (par exemple,
Contrat de vente standard).2
Trouver la section Champs personnalisés
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.3
Activer le bouton bascule
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.
4
Configurer les propriétés
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)
5
Définir une valeur par défaut (optionnel)
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.6
Enregistrer le modèle de contrat
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 :É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.1
Ouvrir votre intégration CRM
Accédez à Paramètres → Développeurs → Intégration et cliquez sur votre CRM connecté.
2
Trouver la section de mapping des champs personnalisés
Faites défiler jusqu’au mapping des champs personnalisés. Le champ Modèle de contrat apparaît sous la forme
Personnalisé : Juridiction.3
Choisir une direction de synchronisation
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
4
Sélectionner le champ CRM correspondant
Sélectionnez le champ CRM qui contient la valeur de juridiction. Types compatibles : Texte, Liste de sélection, Menu déroulant.
5
Enregistrer les modifications
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 :Résolution des problèmes
La variable {{contract.jurisdiction}} est vide dans le contrat généré
La variable {{contract.jurisdiction}} est vide dans le contrat généré
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).
Le champ est sur le modèle de contrat mais n'apparaît pas sur les contrats
Le champ est sur le modèle de contrat mais n'apparaît pas sur les contrats
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.
Les commerciaux voient le champ mais leur saisie n'est pas enregistrée
Les commerciaux voient le champ mais leur saisie n'est pas enregistrée
La case Modifiable par le commercial est décochée. Activez-la sur le modèle de contrat.
Mon CRM n'affiche pas de champ compatible
Mon CRM n'affiche pas de champ compatible
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
Propriétés des champs
Obligatoire, Modifiable, Afficher — les trois contrôles qui définissent le comportement.
Modèles de contrat
Comment les variables, les blocs de contenu et les modèles de contrat s’articulent.
Créer un champ personnalisé de devis
Le même processus, appliqué aux devis.
Mapping CRM
Directions de synchronisation et compatibilité des champs CRM.