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.
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 :
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
1
Ouvrir le modèle de données
Accédez à Paramètres → Données → Modèle de données et cliquez sur l’objet Produit.
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 pour Hectares
- Nom :
Hectares - Nom API : Qwoty génère
hectares. Modifiez-le si nécessaire. - Type de données : sélectionnez
Nombre
4
Enregistrer et recommencer
Cliquez sur Enregistrer, puis créez
Niveau de certification avec le type Texte de la même façon.Deux nouveaux champs apparaissent dans la liste des champs de l’objet Produit avec le badge Personnalisé.
É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.1
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.
2
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.
3
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.
4
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é pourNiveau 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
5
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 si vous avez de nombreux produits.6
Enregistrer le produit
Cliquez sur Enregistrer.
Vos produits portent les nouveaux champs personnalisés. Ils apparaissent sur les devis à chaque fois que le produit est ajouté en tant que ligne.
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).1
Ouvrir l'intégration
Accédez à Paramètres → Développeurs → Intégration et cliquez sur votre système connecté (CRM ou ERP).
2
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.3
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
4
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
5
Enregistrer les modifications
Cliquez sur Enregistrer les modifications en bas de la page.
Vos champs produits se synchronisent désormais entre Qwoty et votre CRM ou ERP. Les mises à jour se propagent au prochain cycle de synchronisation.
Champs personnalisés Produit courants
Au-delà de l’agriculture, voici les cas d’usage qui reviennent fréquemment :Résolution des problèmes
Le champ n'apparaît pas dans la vue détaillée du produit
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.
Mon champ apparaît sur le Produit mais pas sur la ligne du devis
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.
L'importation CSV n'a pas alimenté le champ
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 pour la référence complète des colonnes.
Le CRM ne liste pas de champ produit compatible
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.
Ressources associées
Types de champs
Choisissez le bon type pour votre attribut produit.
Importer des produits
Alimentez en masse les champs personnalisés via CSV.
Produits
Gérez votre catalogue de produits.
Mappage CRM
Directions de synchronisation et compatibilité des champs CRM.