Passer au contenu principal

​
Vue d’ensemble

Un import CSV peut lier les enregistrements qu’il crée ou met à jour à des enregistrements qui existent déjà dans votre workspace. Relations prises en charge :
  • Produit → Catalogue (un produit peut appartenir à plusieurs catalogues)
  • Produit → Catégorie (un produit peut appartenir à plusieurs catégories)
  • Variante de produit → Valeurs d’option de variante (par exemple la taille m)
  • Prix → Produit et grille de prix (chaque prix appartient à un produit dans une grille de prix)
Vous n’importez pas les produits maîtres séparément : chaque nouvelle ligne de produit crée le produit et sa variante par défaut.

​
Fonctionnement des relations

​
Relations plusieurs-à-plusieurs

Les relations produits-catalogues et produits-catégories sont de type plusieurs-à-plusieurs. Listez les noms API dans une même cellule, séparés par des virgules, la cellule étant entourée de guillemets doubles : À la création, un produit est aussi toujours lié au catalogue par défaut du workspace. À la mise à jour, les liens vers les catalogues ne sont remplacés que si catalog_api_names est mappé. Les noms de catalogue qui ne correspondent à aucun catalogue sont ignorés.

​
Options de variante

Utilisez des paires de colonnes options[N][name] (nom API de l’option, par exemple size) et options[N][value] (nom API de la valeur, par exemple m). N commence à 1. L’option et ses valeurs doivent déjà exister dans Produits et prix › Options de produits : l’import ne les crée pas.

​
Prix

Les prix ne sont pas créés par l’import : Qwoty génère un prix par produit (et par fréquence de facturation pour les produits récurrents) dans les grilles de prix des catalogues du produit. La colonne id cible un prix existant par :
  • Son UUID, issu d’un export
  • Ou sa clé : product_api_name.pricebook_api_name pour un prix ponctuel, suivi de .period_unit.period pour un prix récurrent (par exemple licence_pro.standard_eur.month.1)

​
Lier des enregistrements pendant l’import

1

Créer les enregistrements référencés

Créez d’abord vos catalogues, catégories, grilles de prix et options de variante dans l’app. L’import échoue ou ignore les liens vers des enregistrements inexistants.
2

Renseigner les colonnes de relation

3

Mapper les colonnes

À l’étape Mapping, vérifiez que chaque colonne de relation est associée à son champ (par exemple catalog_api_names → Catalog API Names (comma-separated)).
Les noms API doivent correspondre exactement à l’enregistrement référencé : pas d’espaces ni de caractères en trop.

​
Règle d’ordre d’import

L’enregistrement référencé doit exister en premier.
  1. Catalogues, catégories, grilles de prix, options de variante : créez-les dans l’app.
  2. Produits : importez-les. Qwoty génère leurs prix.
  3. Prix : exportez-les, renseignez les valeurs et réimportez-les.

​
Ressources associées

Contraintes d'unicité

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

Mapping des champs

Exigences de format des colonnes de relation.

Importer des produits

Commencez votre migration ici.

Importer des prix

Dernière étape : renseigner les prix.
Dernière modification le 27 octobre 2026