Passer au contenu principal

​
Validation avant import

Après le chargement de votre fichier et le mapping de ses colonnes, Qwoty valide vos données avant de les importer. Vous pouvez ainsi repérer et corriger les erreurs sans toucher à vos données existantes.

​
Fonctionnement

L’assistant d’import signale les erreurs à chaque étape :
1

Upload

Déposez votre fichier CSV. Qwoty rejette les fichiers qui ne sont pas au format .csv, qui dépassent 10 Mo ou 10 000 lignes, qui n’ont pas d’en-têtes ou qui ne peuvent pas être lus.
2

Mapping

Associez chaque en-tête à un champ Qwoty. Si une colonne obligatoire n’est pas mappée, l’écran liste les colonnes manquantes et vous ne pouvez pas continuer.
3

Confirmation

Qwoty valide chaque ligne. Le récapitulatif affiche :
  • Le nombre d’enregistrements à importer
  • Le nombre de variantes dans le fichier (pour les produits)
  • Le nombre de lignes comportant des erreurs de validation, avec un bouton Télécharger les lignes en erreur
Les erreurs ne bloquent pas les lignes valides. Revenez en arrière pour corriger votre fichier, ou cliquez sur Lancer l’import pour importer les lignes valides.
4

Résultat

Qwoty traite le fichier et affiche les lignes importées et les lignes en échec, réparties entre erreurs de validation et erreurs serveur (contraintes de base de données ou règles métier). Cliquez sur Télécharger les lignes non importées pour obtenir un CSV des échecs.

​
Fichiers d’erreurs

Télécharger les lignes en erreur (étape Confirmation) et Télécharger les lignes non importées (étape Résultat) renvoient tous deux un CSV avec vos colonnes, plus une colonne erreur qui explique pourquoi chaque ligne a échoué. Corrigez les lignes et importez à nouveau ce fichier : il ne contient que les lignes en échec.

​
Types d’erreurs courants

​
Identifiants en double

Cause : le même product_id ou id de prix apparaît deux fois dans le fichier, ou un product_api_name est déjà utilisé par un autre produit. Solution :
  • Supprimez ou fusionnez les lignes en double
  • Modifiez le product_api_name, ou renseignez product_id pour mettre à jour le produit existant
Consultez Contraintes d’unicité.

​
Format invalide

Cause : une valeur ne correspond pas au format attendu : UUID invalide, valeur hors de la liste autorisée, pourcentage en dehors de la plage 0–100, texte dans une colonne numérique. Solution : modifiez la cellule. Consultez Mapping des champs pour le format de chaque type de champ. Erreurs fréquentes :
  • settings[recurrence_type] = monthly au lieu de recurring
  • pricing_model = Tiered au lieu de Graduated Tiered ou Volume Tiered
  • amount = 1,234.00 (séparateur de milliers)
  • percent = 0.2 alors que vous vouliez 20 %

​
Champs obligatoires manquants

Cause : une colonne obligatoire (settings[recurrence_type] pour les produits, id et pricing_model pour les prix) est vide sur une ligne, ou un prix Volume ou Échelonné n’a pas de premier palier. Solution : renseignez la valeur, ou supprimez la ligne de votre fichier.

​
Enregistrement introuvable

Cause : l’enregistrement référencé n’existe pas : un product_id ou un id de prix absent de votre workspace, une clé de prix dont le produit, la grille de prix ou la fréquence de facturation ne correspond pas, ou une option de variante qui n’a pas été créée. Solution :
  • Créez d’abord les enregistrements référencés (consultez Relations à l’import)
  • Ou corrigez la référence pour qu’elle corresponde à un enregistrement existant

​
Valeurs incohérentes

Cause : des lignes appartenant au même produit portent des valeurs incohérentes (par exemple, un settings[recurrence_type] différent). Solution : utilisez les mêmes valeurs sur toutes les lignes d’un même produit.

​
Colonnes inconnues

Une colonne qui ne correspond à aucun champ Qwoty est ignorée. Mappez-la manuellement à l’étape Mapping si elle doit être importée.

​
Erreurs de permission

Cause : votre rôle n’est pas autorisé à modifier un champ. Solution : demandez à l’administrateur de votre workspace de vérifier les permissions de votre rôle.

​
Conseils pour limiter les erreurs

  1. Partez du modèle ou d’un export : il indique les en-têtes de colonnes et les formats exacts
  2. Nettoyez d’abord vos données : supprimez les lignes vides, corrigez les fautes de frappe, normalisez les valeurs d’enum
  3. Importez dans le bon ordre : catalogues et options dans l’app, puis produits, puis prix
  4. Testez avec un petit lot avant d’importer des milliers de lignes
  5. Recherchez les doublons avant le chargement : triez votre fichier par la colonne d’identifiant

​
Ressources associées

Mapping des champs

Exigences de format pour chaque type de champ.

Contraintes d'unicité

Quels identifiants créent ou mettent à jour des enregistrements.

Relations à l'import

Le bon ordre d’import pour éviter les erreurs de relation.

Préparer votre CSV

Guide de préparation pas à pas.
Dernière modification le 27 octobre 2026