Skip to main content
Ce guide vous accompagne dans la préparation de votre fichier CSV pour une importation réussie dans Qwoty. Suivez ces étapes dans l’ordre pour éviter les erreurs.

​
Étape 1 : Vérifier les exigences du fichier

Avant de commencer, assurez-vous que votre fichier respecte ces exigences : Pour les jeux de données de plus de 10 000 lignes, divisez-les en plusieurs fichiers ou utilisez l’API Qwoty.

​
Étape 2 : Télécharger le fichier exemple

C’est l’étape la plus importante. Le fichier exemple vous indique les noms de colonnes exacts et le format attendus par Qwoty.
  1. Ouvrez Paramètres → Données → Importer/Exporter des données.
  2. Sélectionnez l’objet que vous souhaitez importer : Produits maîtres, Produits ou Prix.
  3. Cliquez sur Télécharger le fichier exemple.
  4. Utilisez ce fichier comme modèle — conservez les en-têtes et remplacez les lignes d’exemple par vos données.
Conseil de pro : exportez d’abord quelques enregistrements existants plutôt que de partir du modèle vide. L’export vous donne de vrais exemples de la façon dont Qwoty formate les données, et les noms de colonnes sont mappés automatiquement lors de la réimportation.

​
Étape 3 : Supprimer les valeurs en double

Qwoty impose l’unicité sur certains champs. Les doublons provoquent des erreurs d’importation. Avant d’importer :
  1. Triez votre feuille de calcul par le champ unique.
  2. Supprimez ou fusionnez les lignes en double.
  3. Vérifiez les doublons qui existent déjà dans Qwoty en exportant d’abord.

​
Étape 4 : Formater chaque type de champ correctement

Les différents types de champs nécessitent des formats spécifiques. Voici la référence complète pour Qwoty.

​
Champs texte

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

​
Champs numériques

  • Chiffres uniquement (pas de texte).
  • Utilisez le point pour les décimales : 1234.56.
  • Pas de séparateur de milliers (pas 1,234.56).
  • Les nombres négatifs sont autorisés uniquement là où le schéma le permet (la plupart des champs de prix exigent des valeurs positives).

​
Champs booléens

Utilisez des minuscules : true ou false. Cela s’applique aux champs tels que settings[is_active].

​
Champs énumération (sélection)

Utilisez la valeur exacte attendue par Qwoty, y compris la casse. Énumérations courantes :
Les énumérations sont sensibles à la casse. flat est différent de Flat. recurring est différent de Recurring. Utilisez les valeurs exactes indiquées ci-dessus.

​
Champs date

Utilisez le format ISO 8601 :
  • YYYY-MM-DD — par exemple, 2026-04-25
  • YYYY-MM-DDTHH:MM:SSZ — pour les horodatages

​
Champs devise

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

​
Champs taxe (TVA)

Utilisez le format <CODE_PAYS>_<TAUX>. Exemples :

​
Champs ID

  • Facultatif : Qwoty génère automatiquement des UUID si aucun n’est fourni.
  • Format : UUID, par exemple c776ee49-f608-4a77-8cc8-6fe96ae1e43f.
  • Cas d’usage : Incluez l’ID pour mettre à jour des enregistrements existants au lieu d’en créer de nouveaux.

​
Champs multi-valeurs

Certains champs acceptent plusieurs valeurs dans une seule cellule, séparées par des virgules : Si une valeur dans la liste contient une virgule, encadrez toute la cellule avec des guillemets doubles : "category_one,category, with comma".

​
Champs indexés (niveaux, options)

Qwoty utilise une notation entre crochets avec un index numérique pour les groupes de champs répétés. Les index sont basés sur 0 pour les niveaux et basés sur 1 pour les options.
Ajoutez [1], [2], [3]… pour déclarer des lignes supplémentaires.

​
Étape 5 : Ajouter les colonnes de relation

Les objets Qwoty se référencent mutuellement via des champs spécifiques. Pour lier un enregistrement à son parent ou à un objet associé, renseignez la bonne colonne.
L’ordre d’importation est important !
  1. Produits maîtres en premier — ce sont les parents.
  2. Produits ensuite — ils référencent les produits maîtres.
  3. Prix en dernier — ils référencent à la fois les produits et les grilles tarifaires.
Les catalogues, catégories et grilles tarifaires doivent exister avant de commencer. Créez-les d’abord via l’interface.

​
Étape 6 : S’assurer que les champs personnalisés existent dans Qwoty

L’importation crée des enregistrements, pas des champs. Tout champ personnalisé que vous souhaitez renseigner doit déjà exister dans votre modèle de données. Avant d’importer :
  1. Ouvrez Paramètres → Données → Modèle de données.
  2. Sélectionnez l’objet (Client, Modèle de contrat — notez que les Produits et les Prix ne sont actuellement pas extensibles avec des champs personnalisés).
  3. Ajoutez les champs personnalisés dont vous avez besoin.
  4. Assurez-vous que l’en-tête de colonne dans votre CSV correspond exactement au nom d’API du champ.
Consultez la page Modèle de données pour le guide complet sur l’ajout de champs personnalisés.

​
Étape 7 : Liste de vérification finale

Avant de charger votre fichier, vérifiez :
  • Le fichier est au format CSV
  • L’encodage est UTF-8
  • Le séparateur de champs est la virgule ,
  • Le séparateur décimal est le point .
  • Les cellules multi-valeurs utilisent des virgules à l’intérieur, avec des guillemets autour de la cellule si nécessaire
  • Pas de valeurs en double dans les champs uniques (product_id, product_api_name, id)
  • Les champs booléens utilisent des minuscules true ou false
  • Les champs énumération utilisent la casse exacte indiquée à l’étape 4
  • Les dates utilisent le format ISO 8601
  • Tous les champs personnalisés existent dans Paramètres → Données → Modèle de données
  • Les produits maîtres sont importés avant les produits
  • Les produits sont importés avant les prix
  • Les catalogues, catégories et grilles tarifaires existent déjà dans l’espace de travail

​
Erreurs courantes à éviter

​
Étapes suivantes

Votre fichier est prêt. À présent :

Importer les produits maîtres

Commencez toujours ici.

Importer les produits

Une fois vos produits maîtres créés.

Importer les prix

Dernière étape — les prix référencent les produits et les grilles tarifaires.

Modèle de données

Ajoutez les champs personnalisés avant d’importer si nécessaire.