> ## 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. # Modèle de données > Découvrez ce qu'est un modèle de données dans Qwoty et comment concevoir des champs personnalisés adaptés à votre activité. ## Qu'est-ce qu'un modèle de données ? Un modèle de données est la structure qui définit comment l'information est organisée dans votre CPQ. Considérez-le comme le **plan directeur** de vos données commerciales — vous le concevez une fois, puis vous le remplissez avec vos devis, produits, clients et contrats réels. Qwoty est livré avec un modèle de données complet prêt à l'emploi : Devis, Client, Produit, Modèle de contrat, Catalogue, Grille tarifaire, et une quarantaine d'autres objets. Mais chaque entreprise possède des données uniques — une date d'événement sur un devis, un nombre d'hectares sur un client, une variante de clause sur un contrat. Le modèle de données est l'endroit où vous étendez Qwoty pour y intégrer **vos** informations. ## Concepts clés ### Objets Les **objets** sont les principales catégories de données dans Qwoty. Chaque objet représente un type d'élément que vous suivez. Qwoty est livré avec des objets standard : * **Client** — entreprises et particuliers à qui vous vendez * **Devis** — propositions envoyées aux clients * **Produit** — articles de votre catalogue (avec produits maîtres et variantes) * **Modèle de contrat** — modèles réutilisables pour les contrats juridiques * **Catalogue**, **Grille tarifaire**, **Bundle**, **Remise** — structures de support pour votre offre * **Commande**, **Accord commercial** — ce qui est généré une fois un devis signé * **Approbation**, **Workflow** — les règles qui régissent votre processus commercial ### Champs Les **champs** sont les propriétés qui décrivent chaque objet. Ils stockent les informations réelles. Par exemple, l'objet **Client** possède des champs tels que : * Nom * Adresse * Secteur d'activité * Contacts liés (une relation vers l'objet Contact) Les champs ont différents **types** : texte, nombre, date, booléen, et d'autres encore. Vous pouvez ajouter des **champs personnalisés** aux objets gérables (Client, Devis, Produit, Modèle de contrat) pour capturer des données spécifiques à votre activité. ### Enregistrements Les **enregistrements** sont les entrées individuelles au sein d'un objet — les données réelles que votre équipe crée et utilise au quotidien. Par exemple : * "Acme Corp" est un **enregistrement** dans l'objet Client * "QUO-2026-0001" est un **enregistrement** dans l'objet Devis **Une analogie :** | Concept du modèle de données | Analogie du monde réel | | ---------------------------- | ---------------------------------------------------- | | **Objets** | Sections d'un livre (les catégories) | | **Champs** | Colonnes d'une feuille de calcul (les propriétés) | | **Enregistrements** | Lignes d'une feuille de calcul (les entrées réelles) | Vous concevez le modèle de données (objets + champs personnalisés) une fois, puis créez des milliers d'enregistrements dans cette structure. ## Pourquoi personnaliser votre modèle de données ? Chaque déploiement CPQ est différent. Personnaliser votre modèle de données vous permet d'adapter Qwoty à **votre** processus devis-revenus, plutôt que de contraindre votre activité dans un système rigide. **Exemples courants de champs personnalisés :** * Une **date d'événement** et un **nombre de participants** sur les devis pour une société de production événementielle * Un **nombre d'hectares** et un **type de culture** sur les clients pour une coopérative agricole * Une **variante de clause juridique** sur les contrats pour une opération commerciale multi-juridiction * Un **niveau de certification** ou un **identifiant réglementaire** sur les produits pour les secteurs réglementés Les champs personnalisés ne sont pas de simples étiquettes — ils circulent tout au long du cycle devis-revenus : ils apparaissent sur les devis et les Dealrooms (lorsqu'ils sont configurés pour s'afficher), alimentent les variables de contrat et se synchronisent avec votre CRM. ## Conseils pour concevoir votre modèle de données ### 1. Commencez avec les objets standard Qwoty fournit déjà Client, Devis, Produit, Modèle de contrat. La plupart des entreprises couvrent 80 % de leurs besoins en ajoutant quelques champs personnalisés à ces objets — sans créer de nouveaux objets. ### 2. Utilisez les champs pour les propriétés, pas de nouveaux objets Si quelque chose est simplement une caractéristique d'un objet existant, créez-en un **champ personnalisé**. **Utilisez les champs personnalisés pour :** * Les catégories et étiquettes (par exemple, `Type de client` sur Client avec les valeurs "Prospect", "Compte clé", "Partenaire") * Les valeurs de statut ou les étapes * Les attributs et propriétés (date d'événement, hectares, numéro de certification) ### 3. Définissez soigneusement la visibilité de vos champs Chaque champ personnalisé sur un objet possède trois propriétés qui déterminent où la valeur circule : * **Obligatoire** — le champ doit être rempli lors de la création * **Modifiable par le commercial** — les commerciaux peuvent modifier la valeur (sinon elle est en lecture seule après import ou saisie par un administrateur) * **Afficher pour le client** — le champ apparaît sur le devis et le Dealroom visibles par l'acheteur Un champ marqué "Afficher pour le client" fait partie de l'expérience acheteur. Un champ non affiché reste interne — utile pour les métadonnées d'exploitation commerciale ou comptables qui ne doivent pas être visibles par les clients. ### 4. Planifiez la synchronisation CRM en amont Si vous connectez Qwoty à un CRM (HubSpot, Salesforce, Pipedrive), chaque champ personnalisé peut être associé à un champ CRM avec trois directions de synchronisation : **Bidirectionnel**, **CRM → Qwoty**, ou **Qwoty → CRM**. Décidez quelle direction est pertinente avant de créer le champ — cela conditionne la manière dont votre équipe saisit les données. ### 5. Restez simple au départ Commencez avec des champs. N'en ajoutez de nouveaux que lorsque vous ressentez les limites — saisies répétées, données manquantes, ou un champ surchargé avec trop de valeurs possibles. ## Questions pour guider votre choix Posez-vous les questions suivantes : * S'agit-il simplement d'une propriété de quelque chose que je possède déjà ? * Tous mes clients, devis ou produits porteront-ils cette information ? * Voudrais-je que ce champ apparaisse sur le devis présenté aux acheteurs ? * Les commerciaux doivent-ils pouvoir le modifier, ou seulement les administrateurs ? * Doit-il se synchroniser avec mon CRM en temps réel ? Si la réponse est oui à la plupart de ces questions, vous avez trouvé un bon candidat pour un champ personnalisé. ## Accéder à votre modèle de données Cliquez sur **Paramètres** dans la barre latérale gauche. Dans la section **Données**, cliquez sur **Modèle de données**. Vous verrez la liste complète des objets avec leur badge **Standard** ou **Gérable**. Cliquez sur n'importe quel objet pour voir ses champs. Les objets gérables affichent un bouton **+ Nouveau** pour ajouter des champs personnalisés. Le Modèle de données n'apparaît pas dans les Paramètres ? L'accès est réservé aux administrateurs disposant de la permission **Données** activée. Contactez votre administrateur d'espace de travail si nécessaire — voir [Gérer les rôles](/user-guide/settings/users/manage-roles). ## Référence Concepts et règles qui définissent le comportement des champs personnalisés. Objets Standard et Gérables, et lesquels acceptent des champs personnalisés. Texte, Nombre, Date — à quoi sert chaque type. Obligatoire, Modifiable par le commercial, Afficher pour le client — contrôlez où circulent les valeurs. Directions de synchronisation et connexion des champs personnalisés à votre CRM. ## Guides pratiques Guides étape par étape pour ajouter des champs personnalisés aux quatre objets gérables. Ajoutez des champs affichés sur les devis — dates d'événement, codes projet, nombres de participants. Ajoutez des champs utilisés comme variables de contrat — clauses, avenants, juridictions. Ajoutez des champs pour les métadonnées du catalogue — certifications, capacités, attributs. Ajoutez des champs pour qualifier les clients — types, codes, identifiants réglementaires.