Mappage des champs

​

Fonctionnement du mappage des champs

Lorsque vous importez un fichier CSV, Qwoty analyse vos colonnes et tente de les faire correspondre aux champs existants de l’objet cible.

​

Mappage automatique

Qwoty tente de faire correspondre les colonnes en se basant sur :

• Les noms d’en-tête de colonne (correspondances exactes ou similaires aux noms de champs de Qwoty)
• La détection du type de données (UUID, nombres, booléens, dates ISO)
• Les modèles de champs courants

​

Options de mappage manuel

Pour chaque colonne, vous pouvez :

• Mapper vers un champ — sélectionnez le champ Qwoty correspondant dans une liste déroulante à l’étape Mappage
• Ignorer cette colonne — ignorer entièrement la colonne (les données ne seront pas importées)

​

Compatibilité des types de champs

Tous les types de champs disponibles dans le modèle de données de Qwoty sont pris en charge pour l’importation. Vous pouvez également importer des valeurs id (ou product_id, selon l’objet) pour attribuer un UUID spécifique à de nouveaux enregistrements ou mettre à jour des enregistrements existants.

​

Exigences de format de données

Certains champs ont une syntaxe particulière. Nous recommandons de télécharger le fichier exemple depuis l’écran d’importation avant de préparer votre importation — il indique la syntaxe attendue pour chaque type de champ.

​

Champs texte

• Aucun formatage particulier requis
• Les espaces en début et en fin de valeur sont supprimés automatiquement
• Si une valeur contient une virgule, un saut de ligne ou des guillemets, encadrez la cellule de guillemets doubles : "Premium, Extra Large"

​

Champs numériques

• Chiffres uniquement
• Les décimales utilisent un point : 1234.56
• Pas de séparateurs de milliers (pas 1,234.56)
• Les nombres négatifs sont acceptés uniquement là où le champ le permet (la plupart des champs de prix exigent des valeurs positives)

​

Champs booléens

Utilisez les valeurs en minuscules true ou false — s’applique aux champs comme settings[is_active].

​

Champs de date

Utilisez la norme ISO 8601 :

• YYYY-MM-DD (recommandé) — par exemple, 2026-04-25
• YYYY-MM-DDTHH:MM:SSZ pour les horodatages

​

Champs de devise

Utilisez le code ISO 4217 à trois lettres : EUR, USD, GBP, JPY. N’utilisez pas le symbole (€, $) ni le nom complet.

​

Champs de taxe (TVA)

Utilisez le format <PAYS>_<TAUX> où le taux est exprimé sans virgule décimale (multiplié par 10) :

​

Champs d’énumération (sélection)

Utilisez la valeur exacte attendue par Qwoty, en respectant la casse. Énumérations courantes :

​

Champs à valeurs multiples

Certains champs acceptent plusieurs valeurs dans une même cellule, séparées par des virgules, avec la cellule encadrée de guillemets doubles :

​

Champs indexés (paliers, options, identifiants)

Qwoty utilise une notation entre crochets avec un index numérique pour les groupes de champs répétés. Deux conventions coexistent selon l’objet : Ajoutez [1], [2]… ou [0], [1]… selon le groupe de champs pour déclarer des lignes supplémentaires.

​

Champs ID

La spécification d’un ID lors de l’importation est facultative. Qwoty génère automatiquement un UUID si aucun n’est fourni. Cas d’utilisation pour le mappage d’une colonne ID :

• Définir un ID spécifique — choisissez l’UUID pour les enregistrements nouvellement créés
• Mettre à jour des enregistrements existants — faites correspondre les enregistrements existants pour les mettre à jour plutôt que de créer des doublons. Dans ce cas, mappez uniquement la colonne ID — ne la combinez pas avec d’autres champs uniques, afin de simplifier l’importation.

Si vous fournissez un ID, il doit être au format UUID (par exemple, c776ee49-f608-4a77-8cc8-6fe96ae1e43f).

​

Champs de relation

Pour lier des enregistrements à leur objet parent ou connexe, consultez la page Importer des relations.

​

Trouver les noms d’API

Pour les références aux Catalogues, Catégories et Grilles de prix, vous devez utiliser le nom d’API (et non le libellé d’affichage).

​

Comment trouver les noms d’API

1. Ouvrez Paramètres → Données → Modèle de données
2. Sélectionnez l’objet (Catalogue, Catégorie, Grille de prix)
3. Consultez le nom d’API affiché dans la colonne Nom d’API

Vous pouvez également exporter l’objet en premier — le CSV exporté inclut les noms d’API dans les colonnes appropriées.

​

Voir aussi