Passer au contenu principal
Ce guide vous accompagne dans la préparation d’un fichier CSV pour réussir votre import dans Qwoty. Suivez ces étapes dans l’ordre pour éviter les erreurs.

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

Pour des volumes plus importants, répartissez les données dans plusieurs fichiers ou utilisez l’API Qwoty.

​
Étape 2 : télécharger le modèle

C’est l’étape la plus importante. Le modèle indique les noms de colonnes et le format exacts attendus par Qwoty.
  1. Ouvrez Paramètres › Données › Import & Export.
  2. Cliquez sur Produits ou Prix.
  3. Cliquez sur Télécharger le modèle.
  4. Conservez les en-têtes et remplacez les lignes d’exemple par vos données.
Pour mettre à jour des enregistrements existants, exportez-les d’abord (Exporter CSV) au lieu de partir du modèle. L’export contient les ID dont Qwoty a besoin pour faire correspondre chaque ligne, et ses noms de colonnes sont mappés automatiquement lorsque vous le réimportez.
Les prix sont créés automatiquement pour chaque produit dans vos grilles de prix. Pour les renseigner, partez toujours d’un export de vos prix. Consultez Importer des prix.

​
Étape 3 : supprimer les identifiants en double

Chaque enregistrement ne peut apparaître qu’une fois par fichier. Les doublons sont signalés comme erreurs de validation.

​
Étape 4 : formater correctement chaque type de champ

​
Champs texte

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

​
Champs numériques

  • Uniquement des chiffres (pas de texte, pas de symbole monétaire).
  • Utilisez un point pour les décimales : 1234.56.
  • Pas de séparateur de milliers (pas 1,234.56).

​
Champs booléens

Utilisez true ou false. Cela s’applique à des champs comme settings[is_active] et pay_as_you_go.

​
Champs enum (liste de choix)

Utilisez la valeur exacte attendue par Qwoty :
Les enums sont sensibles à la casse. Recurring est rejeté : utilisez recurring. Pour pricing_model, utilisez les libellés ci-dessus ou les valeurs internes flat, cost_based, percent, graduated, volume, none.

​
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 définie dans Paramètres › Workspace › Taxe (par exemple FR_200). Laissez la cellule vide pour ne définir aucune taxe par défaut.

​
Champs ID

  • Format : UUID, par exemple c776ee49-f608-4a77-8cc8-6fe96ae1e43f.
  • Produits : laissez product_id vide pour créer un produit ; renseignez-le pour mettre à jour un produit existant.
  • Prix : id est obligatoire. Utilisez l’UUID du prix issu d’un export, ou une clé de prix comme licence_pro.standard_eur.month.1.

​
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)

Qwoty utilise une notation entre crochets avec un index numérique pour les groupes de champs répétés. Les index commencent à 0 pour les paliers et à 1 pour les options.

​
Étape 5 : ajouter les colonnes de relation

L’ordre d’import compte.
  1. Créez les catalogues, catégories, grilles de prix et options de variante dans l’app.
  2. Importez les produits.
  3. Exportez, renseignez et importez les prix.

​
Étape 6 : vérifier que les champs personnalisés existent

L’import crée des enregistrements, pas des champs. Pour renseigner des champs personnalisés produit :
  1. Ouvrez Paramètres › Données › Modèle de données.
  2. Ouvrez l’objet Produits et créez les champs nécessaires.
  3. Dans votre CSV, nommez la colonne custom[<api_name>], en reprenant exactement le nom API du champ.
Consultez Modèle de données pour le guide complet sur les champs personnalisés.

​
Étape 7 : liste de contrôle finale

  • Le fichier est au format CSV, en UTF-8, sous 10 Mo et 10 000 lignes
  • Le séparateur de champs est une virgule , et le séparateur décimal un point .
  • Les cellules multivaleurs utilisent des virgules à l’intérieur, avec des guillemets autour de la cellule
  • Aucun identifiant en double (product_id, id)
  • Les champs booléens utilisent true ou false
  • Les champs enum utilisent les valeurs exactes indiquées à l’étape 4
  • Les champs personnalisés existent dans Paramètres › Données › Modèle de données
  • Les catalogues, catégories, grilles de prix et options de variante existent déjà
  • Les produits sont importés avant les prix

​
Erreurs courantes à éviter

​
Étapes suivantes

Importer des produits

Créer ou mettre à jour vos produits.

Importer des prix

Renseigner les prix de vos grilles de prix.

Modèle de données

Ajouter des champs personnalisés avant l’import si besoin.
Dernière modification le 27 octobre 2026