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

> Ajoutez un champ personnalisé aux produits — pour les métadonnées du catalogue, les certifications ou les attributs techniques.

Un champ personnalisé Produit capture des attributs spécifiques à votre catalogue — par exemple, des hectares pour un produit agricole, un niveau de certification pour un bien réglementé, ou une capacité technique pour un équipement industriel. Le champ apparaît sur chaque fiche produit, peut être filtré et trié dans les vues du catalogue, et se synchronise optionnellement avec votre CRM ou ERP.

Ce guide vous accompagne tout au long du cycle de vie en trois étapes.

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

## Ce que vous allez créer

Dans cet exemple, vous allez ajouter deux champs personnalisés à un catalogue produits utilisé par une coopérative agricole :

| Champ                       | Type   | Objectif                                                                |
| --------------------------- | ------ | ----------------------------------------------------------------------- |
| **Hectares**                | Nombre | Surface couverte par le produit (ex. : un engrais ou une semence)       |
| **Niveau de certification** | Texte  | Certification réglementaire ou qualité (ex. : `Bio`, `AOC`, `ISO 9001`) |

Les deux seront **modifiables par les commerciaux** et **affichés au client** afin qu'il puisse confirmer la certification sur son devis.

## É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 **Produit**.
  </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 Hectares">
    * **Nom** : `Hectares`
    * **Nom API** : Qwoty génère `hectares`. Modifiez-le si nécessaire.
    * **Type de données** : sélectionnez `Nombre`
  </Step>

  <Step title="Enregistrer et recommencer">
    Cliquez sur **Enregistrer**, puis créez `Niveau de certification` avec le type `Texte` de la même façon.
  </Step>
</Steps>

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

<Tip>
  Les champs personnalisés sur Produit apparaissent également dans le mappage d'**importation CSV des produits**. Lors de la migration de données depuis un système externe, vos colonnes CSV peuvent alimenter ces champs automatiquement. Voir [Importer des produits](/user-guide/data-migration/how-tos/import-products).
</Tip>

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

Les champs personnalisés sur Produit se comportent légèrement différemment de ceux sur Devis : ils ne sont pas conditionnés par un modèle — ils apparaissent directement sur chaque fiche produit une fois activés.

<Steps>
  <Step title="Ouvrir un produit">
    Accédez à **Catalogue & Produits → Produits** et ouvrez n'importe quel produit (ou créez-en un nouveau). Les nouveaux champs apparaissent dans la vue détaillée du produit.
  </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. Le bouton bascule devient foncé — le champ est maintenant actif sur ce produit.
  </Step>

  <Step title="Configurer les propriétés">
    Pour notre cas d'usage agricole, cochez :

    * **Obligatoire** : laissez **décoché** pour `Hectares` (pertinent uniquement sur les produits liés aux terres) et **coché** pour `Niveau de certification` (toujours requis pour la traçabilité réglementaire)
    * **Modifiable par le commercial** ✓ — les commerciaux peuvent avoir besoin de remplacer la valeur pour des commandes spéciales
    * **Afficher au client** ✓ — les deux champs font partie du contexte commercial de l'acheteur
  </Step>

  <Step title="Définir les valeurs par produit">
    Saisissez les valeurs : `Hectares = 0,5` pour un engrais par paquet, `Niveau de certification = Bio` pour les produits éligibles. Répétez l'opération par fiche, ou importez les valeurs via [CSV](/user-guide/data-migration/how-tos/import-products) si vous avez de nombreux produits.
  </Step>

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

<Check>
  Vos produits portent les nouveaux champs personnalisés. Ils apparaissent sur les devis à chaque fois que le produit est ajouté en tant que ligne.
</Check>

### Ce que voit le client

Lorsqu'un commercial ajoute le produit à un devis et publie le Dealroom, l'acheteur voit le niveau de certification aux côtés de la ligne. Cela fonctionne sans configuration supplémentaire — tant que **Afficher au client** est coché, le champ accompagne le produit.

## Étape 3 : Synchroniser avec votre CRM ou ERP (optionnel)

Les champs personnalisés Produit correspondent souvent à des attributs déjà suivis dans votre ERP (pour la comptabilité et les stocks) ou dans votre CRM (pour le contexte commercial).

<Steps>
  <Step title="Ouvrir l'intégration">
    Accédez à **Paramètres → Développeurs → Intégration** et cliquez sur votre système connecté (CRM ou ERP).
  </Step>

  <Step title="Trouver la section de mappage des champs personnalisés">
    Faites défiler jusqu'au mappage des produits. Les champs apparaissent sous la forme `Personnalisé : Hectares` et `Personnalisé : Niveau de certification`.
  </Step>

  <Step title="Choisir une direction de synchronisation">
    Ouvrez le menu déroulant de direction pour chaque champ :

    * **CRM → Qwoty** — typique pour les données maîtres produits : l'ERP ou le PIM est la source de vérité, Qwoty reçoit les mises à jour
    * **Qwoty → CRM** — lorsque Qwoty est le système de référence du catalogue
    * **Bidirectionnel** — lorsque les deux systèmes doivent rester synchronisés modification par modification
  </Step>

  <Step title="Sélectionner le champ correspondant">
    Choisissez le champ dans le système connecté. Types compatibles :

    * Nombre → Nombre, Entier, Décimal, Monétaire
    * 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.
  </Step>
</Steps>

<Check>
  Vos champs produits se synchronisent désormais entre Qwoty et votre CRM ou ERP. Les mises à jour se propagent au prochain cycle de synchronisation.
</Check>

## Champs personnalisés Produit courants

Au-delà de l'agriculture, voici les cas d'usage qui reviennent fréquemment :

| Champ                            | Type   | Pourquoi                                                                      |
| -------------------------------- | ------ | ----------------------------------------------------------------------------- |
| **Capacité technique**           | Nombre | Puissance, débit, dimensions pour les équipements industriels                 |
| **Numéro de certification**      | Texte  | Identifiant réglementaire (marquage CE, FDA, REACH)                           |
| **Référence fabricant**          | Texte  | Lorsque votre référence diffère de celle du fabricant                         |
| **Délai de livraison (jours)**   | Nombre | Jours entre la commande et la livraison — guide les promesses des commerciaux |
| **Classe d'expédition**          | Texte  | Dangereux, fragile, hors gabarit — alimente la logique d'expédition           |
| **Quantité minimum de commande** | Nombre | Appliquée au moment du devis                                                  |
| **URL de la fiche technique**    | Texte  | Lien vers un PDF de spécifications complet du produit                         |

## Résolution des problèmes

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

  <Accordion title="Mon champ apparaît sur le Produit mais pas sur la ligne du devis">
    Les champs personnalisés sur Produit accompagnent le produit sur le devis, mais uniquement si **Afficher au client** est coché sur le produit. Activez la case à cocher et republiez le devis.
  </Accordion>

  <Accordion title="L'importation CSV n'a pas alimenté le champ">
    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 produits](/user-guide/data-migration/how-tos/import-products) pour la référence complète des colonnes.
  </Accordion>

  <Accordion title="Le CRM ne liste pas de champ produit compatible">
    Ajoutez d'abord le champ correspondant côté CRM, puis actualisez la section de mappage de l'intégration.
  </Accordion>
</AccordionGroup>

## Ressources associées

<CardGroup cols={2}>
  <Card title="Types de champs" icon="font" href="/user-guide/data-model/reference/field-types">
    Choisissez le bon type pour votre attribut produit.
  </Card>

  <Card title="Importer des produits" icon="file-import" href="/user-guide/data-migration/how-tos/import-products">
    Alimentez en masse les champs personnalisés via CSV.
  </Card>

  <Card title="Produits" icon="box" href="/user-guide/catalog/introduction">
    Gérez votre catalogue de produits.
  </Card>

  <Card title="Mappage CRM" icon="arrows-rotate" href="/user-guide/data-model/reference/crm-mapping">
    Directions de synchronisation et compatibilité des champs CRM.
  </Card>
</CardGroup>