> ## 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é Client

> Ajoutez un champ personnalisé aux clients — pour la segmentation, les identifiants réglementaires ou les attributs synchronisés avec votre CRM.

Un champ personnalisé Client capture des attributs spécifiques à votre base de comptes — par exemple, un type de client, un identifiant réglementaire, une attribution de responsable de compte ou une région commerciale. Le champ apparaît sur chaque fiche client, peut être filtré dans les vues clients et, surtout, se synchronise avec votre CRM, où résident généralement les données maîtres clients.

Ce guide décrit le cycle de vie complet en trois étapes.

<Note>
  Vous devez disposer du rôle **Admin** avec l'autorisation **Données → Lecture & Écriture**. Le mapping CRM nécessite également l'accès **Développeurs**.
</Note>

## Ce que vous allez construire

Dans cet exemple, vous allez ajouter deux champs personnalisés utilisés pour qualifier les clients :

| Champ              | Type  | Objectif                                                      |
| ------------------ | ----- | ------------------------------------------------------------- |
| **Type de client** | Texte | `Prospect`, `Compte clé`, `Partenaire`, `Revendeur`           |
| **Numéro de TVA**  | Texte | Identifiant fiscal légal pour la facturation transfrontalière |

Les deux seront **modifiables par les commerciaux**, **non affichés au client** (ce sont des qualificatifs internes, pas des données visibles par l'acheteur), et **synchronisés de manière bidirectionnelle avec votre CRM** car les données maîtres clients sont partagées entre les deux systèmes.

## Étape 1 : Créer le champ dans le modèle de données

<Steps>
  <Step title="Ouvrir le modèle de données">
    Accédez à **Paramètres → Données → Modèle de données** et cliquez sur l'objet **Client**.
  </Step>

  <Step title="Cliquer sur + Nouveau">
    En haut à droite de la liste des champs, cliquez sur **+ Nouveau** pour ouvrir le formulaire de création de champ.
  </Step>

  <Step title="Renseigner les informations générales pour Type de client">
    * **Nom** : `Type de client`
    * **Nom API** : Qwoty génère `customer_type`. Modifiez-le si vous avez besoin d'un identifiant différent.
    * **Type de données** : sélectionnez `Texte`
  </Step>

  <Step title="Enregistrer et recommencer">
    Cliquez sur **Enregistrer**, puis créez `Numéro de TVA` avec le type `Texte` de la même manière.
  </Step>
</Steps>

<Check>
  Deux nouveaux champs apparaissent dans la liste des champs de l'objet Client avec le badge **Personnalisé**.
</Check>

## Étape 2 : Configurer le champ sur le client

Comme pour le Produit, les champs personnalisés Client apparaissent sur chaque fiche client une fois activés — ils ne sont pas conditionnés par un modèle.

<Steps>
  <Step title="Ouvrir un client">
    Accédez à **Clients** et ouvrez n'importe quelle fiche client (ou créez-en une nouvelle). Les nouveaux champs apparaissent dans la vue détaillée du client.
  </Step>

  <Step title="Trouver la section Champs personnalisés">
    Faites défiler jusqu'à la section **Champs personnalisés**. Les deux champs apparaissent avec un bouton bascule et trois cases à cocher.
  </Step>

  <Step title="Activer le bouton bascule">
    Cliquez sur le bouton bascule de chaque champ pour l'activer.
  </Step>

  <Step title="Configurer les propriétés">
    Pour notre cas d'usage de qualification client :

    * **Obligatoire** : cochez pour `Type de client` (la segmentation doit toujours être renseignée), décochez pour `Numéro de TVA` (pertinent uniquement pour le B2B / transfrontalier)
    * **Modifiable par le commercial** ✓ — les commerciaux maintiennent les qualifications clients lors de l'intégration
    * **Afficher au client** — laissez **décoché**. Ces champs sont internes — le client n'a pas besoin de voir comment vous le qualifiez
  </Step>

  <Step title="Définir les valeurs par client">
    Saisissez les valeurs pour les clients existants, ou importez les données via CSV si vous en avez beaucoup. Les champs clients sont couramment renseignés en masse lors de la migration depuis un CRM existant.
  </Step>

  <Step title="Enregistrer le client">
    Cliquez sur **Enregistrer**.
  </Step>
</Steps>

<Check>
  Vos clients disposent des nouveaux champs. Ils alimentent les rapports (filtrables dans les vues clients) et deviennent disponibles pour la synchronisation CRM.
</Check>

## Étape 3 : Synchroniser avec votre CRM (recommandé)

Les champs personnalisés Client représentent le **cas d'usage n°1 pour la synchronisation CRM**. Le CRM est généralement la source de vérité pour les données maîtres clients, et Qwoty a besoin de la même vision pour prendre des décisions de devis intelligentes.

<Steps>
  <Step title="Ouvrir votre intégration CRM">
    Accédez à **Paramètres → Développeurs → Intégration** et cliquez sur votre CRM connecté.
  </Step>

  <Step title="Trouver la section de mapping des champs personnalisés">
    Faites défiler jusqu'au mapping client. Les champs apparaissent sous la forme `Personnalisé : Type de client` et `Personnalisé : Numéro de TVA`.
  </Step>

  <Step title="Choisir une direction de synchronisation">
    Pour les données maîtres clients, nous recommandons fortement :

    * **Type de client** → **Bidirectionnel** — les deux systèmes ont besoin de la même segmentation, et l'un ou l'autre peut être modifié
    * **Numéro de TVA** → **CRM → Qwoty** — généralement géré par les équipes sales-ops dans le CRM ; Qwoty doit seulement le lire

    Évitez **Qwoty → CRM** pour les données maîtres clients, sauf si Qwoty est vraiment la source de vérité pour ce champ (cas rare).
  </Step>

  <Step title="Sélectionner le champ CRM correspondant">
    Sélectionnez le champ correspondant dans le CRM :

    * HubSpot : une propriété Texte sur une ligne ou Liste déroulante sur l'objet Entreprise
    * Salesforce : un champ Liste de sélection ou Texte sur le compte
    * Pipedrive : un champ Option unique ou Texte libre sur l'Organisation

    Types compatibles : Texte → Texte, Liste de sélection, Liste déroulante.
  </Step>

  <Step title="Enregistrer les modifications">
    Cliquez sur **Enregistrer les modifications** en bas de la page. La synchronisation démarre au prochain cycle.
  </Step>
</Steps>

<Check>
  Les types de clients et les numéros de TVA se synchronisent désormais entre Qwoty et votre CRM. Les nouveaux clients ajoutés dans l'un ou l'autre système apparaissent dans l'autre en quelques secondes.
</Check>

## Champs personnalisés Client courants

Au-delà du type et de la TVA, voici des champs qui reviennent fréquemment :

| Champ                         | Type                       | Direction de sync (typique) |
| ----------------------------- | -------------------------- | --------------------------- |
| **Responsable de compte**     | Texte (ou relation future) | Bidirectionnel              |
| **Secteur d'activité**        | Texte                      | CRM → Qwoty                 |
| **Chiffre d'affaires annuel** | Nombre                     | CRM → Qwoty                 |
| **Région / Territoire**       | Texte                      | Bidirectionnel              |
| **Code NAICS / SIC**          | Texte                      | CRM → Qwoty                 |
| **Indicateur stratégique**    | Texte (ou booléen futur)   | Bidirectionnel              |
| **Date du dernier QBR**       | Date                       | CRM → Qwoty                 |

<Tip>
  Lors d'une migration depuis un autre CRM, commencez par lister toutes les propriétés personnalisées sur l'objet client/entreprise dans ce CRM, puis créez les champs correspondants dans Qwoty avant d'importer les données clients. L'import renseignera les champs automatiquement. Voir [Importer des clients](/user-guide/customers/how-tos/import-csv).
</Tip>

## Dépannage

<AccordionGroup>
  <Accordion title="Le champ n'apparaît pas dans la vue détaillée du client">
    Actualisez la page. S'il est toujours absent, vérifiez que le bouton bascule est **activé** dans la section Champs personnalisés.
  </Accordion>

  <Accordion title="L'import CSV n'a pas renseigné mon champ personnalisé Client">
    Vérifiez que l'en-tête de colonne dans votre CSV correspond exactement au **Nom API** du champ (sensible à la casse). Consultez [Importer des clients](/user-guide/customers/how-tos/import-csv) pour la référence complète des colonnes.
  </Accordion>

  <Accordion title="Mon type de champ CRM est 'sélection multiple' mais le type Texte de Qwoty n'accepte pas les valeurs séparées par des virgules">
    Le type Texte de Qwoty stocke la valeur telle quelle. Si votre CRM envoie `Stratégique, Renouvellement, Risque`, Qwoty stocke cette chaîne entière. Vous pouvez soit analyser les valeurs dans vos workflows CRM avant la synchronisation, soit créer plusieurs champs Texte dans Qwoty pour chaque étiquette.
  </Accordion>

  <Accordion title="La synchronisation bidirectionnelle écrase parfois les modifications">
    La synchronisation bidirectionnelle utilise le principe du dernier écrit gagne. Si deux utilisateurs modifient le même champ dans les deux systèmes au cours d'une même fenêtre de synchronisation, la dernière écriture l'emporte. Pour éviter les conflits, décidez quel système est canonique pour les champs à fort enjeu et utilisez une synchronisation unidirectionnelle (CRM → Qwoty ou Qwoty → CRM) à la place.
  </Accordion>

  <Accordion title="Un client a été créé dans le CRM mais n'apparaît pas dans Qwoty">
    Vérifiez que la synchronisation **CRM → Qwoty** est active, que le webhook CRM se déclenche (visible dans **Paramètres → Développeurs → Webhook**) et que l'intégration dispose d'un accès en lecture sur l'objet Entreprise / Compte. Les nouveaux enregistrements apparaissent généralement en quelques secondes.
  </Accordion>
</AccordionGroup>

## Ressources associées

<CardGroup cols={2}>
  <Card title="Clients" icon="users" href="/user-guide/customers/introduction">
    Gérez votre base clients.
  </Card>

  <Card title="Importer des clients" icon="file-import" href="/user-guide/customers/how-tos/import-csv">
    Renseignez les champs personnalisés en masse via CSV.
  </Card>

  <Card title="Mapping CRM" icon="arrows-rotate" href="/user-guide/data-model/reference/crm-mapping">
    Toutes les directions de synchronisation et les règles de compatibilité.
  </Card>

  <Card title="Intégration CRM" icon="plug" href="/user-guide/settings/integrations/crm">
    Connectez HubSpot, Salesforce ou Pipedrive.
  </Card>
</CardGroup>