Mapping des champs

​

Fonctionnement du mapping

À l’étape Mapping de l’assistant d’import, Qwoty liste chaque en-tête de votre fichier (En-tête de votre fichier) et le champ auquel il est associé (Correspond à).

​

Mapping automatique

Qwoty associe automatiquement une colonne lorsque son en-tête correspond exactement au nom de colonne du modèle (par exemple inventory[sku]) ou à un alias connu (par exemple sku, api_name, description). Les correspondances partielles ne sont jamais utilisées : parent_product_name n’est donc pas associé à product_name. Les colonnes de champs personnalisés produit nommées custom[<api_name>] sont associées automatiquement lorsque le nom API existe dans votre modèle de données.

​

Mapping manuel

Pour chaque colonne, vous pouvez :

• L’associer à un champ : choisissez un champ dans la liste Correspond à (les champs sont regroupés, par exemple Informations principales, Paramètres, Expédition)
• Ignorer cette colonne : la colonne n’est pas importée

Les colonnes obligatoires sont signalées. Vous ne pouvez pas continuer tant qu’elles ne sont pas toutes mappées. Chaque champ Qwoty n’accepte qu’une seule colonne source.

​

Exigences de format des données

Téléchargez le modèle depuis l’écran d’import avant de préparer votre fichier : il indique la syntaxe attendue pour chaque colonne.

​

Champs texte

• Aucun formatage particulier
• Si une valeur contient une virgule, un saut de ligne ou un guillemet, entourez la cellule de guillemets doubles : "Premium, Extra Large"

​

Champs numériques

• Uniquement des chiffres
• Les décimales utilisent un point : 1234.56
• Pas de séparateur de milliers (pas 1,234.56)
• Les pourcentages sont des nombres entre 0 et 100 (8.95 = 8,95 %)

​

Champs booléens

Utilisez true ou false, pour des champs comme settings[is_active] et pay_as_you_go.

​

Champs date

Pour les champs personnalisés de type date, utilisez le format ISO 8601 : YYYY-MM-DD, par exemple 2026-04-25.

​

Champs de taxe

vat_code attend le nom API d’une taxe de Paramètres › Workspace › Taxe (par exemple FR_200).

​

Champs enum (liste de choix)

​

Champs multivaleurs

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

​

Champs indexés (paliers, options)

​

Champs ID

• Produits : product_id est facultatif. Laissez-le vide pour créer un produit, ou indiquez l’UUID d’une variante existante pour la mettre à jour.
• Prix : id est obligatoire. Il accepte l’UUID du prix ou une clé de prix (product_api_name.pricebook_api_name, suivi de .period_unit.period pour les prix récurrents).

Les UUID ont la forme c776ee49-f608-4a77-8cc8-6fe96ae1e43f.

​

Champs de relation

Pour lier des enregistrements à des catalogues, des catégories ou des valeurs d’option, consultez Relations à l’import.

​

Trouver les noms API

Les références aux catalogues, catégories, grilles de prix et options de variante utilisent des noms API, pas les libellés affichés. Vous les trouvez :

• Sur la page de chaque enregistrement dans Produits et prix (Catalogue, Grille de prix, Options de produits)
• Dans un export : les exports de produits et de prix incluent catalog_api_names, category_api_names, product_api_name et pricebook_api_name

​

Ressources associées