> ## Documentation Index > Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt > Use this file to discover all available pages before exploring further. # Migration des données > Importez et exportez vos données produit, produit maître et prix via des fichiers CSV. Importez et exportez vos données de catalogue dans Qwoty à l'aide de fichiers CSV — un moyen rapide d'intégrer une liste de produits existante, un tarif ou une arborescence de variantes dans votre espace de travail sans écrire une seule ligne de code. ## Méthodes d'importation Qwoty prend en charge deux méthodes principales pour importer des données : | Méthode | Idéale pour | Limite de volume | | -------------- | ------------------------------------------------------------------------ | ----------------------------------- | | **Import CSV** | Migrations standard, mises à jour groupées périodiques | Jusqu'à \~10 000 lignes par fichier | | **API** | Migrations à grande échelle, synchronisations continues, automatisations | Illimitée | Pour les jeux de données très volumineux ou les synchronisations récurrentes depuis votre ERP ou CRM, utilisez l'[API REST Qwoty](https://docs.qwoty.io). L'importateur CSV est la solution la plus rapide pour les migrations ponctuelles et les mises à jour groupées gérées par les administrateurs. ## Principes de base de l'import CSV Vous pouvez importer des données pour trois objets : **Produits maîtres**, **Produits** et **Prix**. Chaque fichier doit contenir **un seul type d'objet**. **Les champs doivent exister avant l'importation.** Le téléversement d'un CSV crée des enregistrements, mais ne crée pas de champs. Si vous avez besoin de champs personnalisés, créez-les au préalable sous **Paramètres → Données → Modèle de données**. Consultez la page [Modèle de données](/user-guide/data-model/introduction) pour plus de détails. ### Étapes 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** pour obtenir un modèle avec les bonnes colonnes. 4. Mettez en forme votre fichier (voir [Préparer vos fichiers CSV](/user-guide/data-migration/how-tos/prepare-csv-files)). 5. Cliquez sur **Importer**, déposez votre fichier et suivez l'assistant en 4 étapes : **Téléversement → Correspondance → Confirmation → Résultat**. 6. Examinez les erreurs de validation à l'étape de confirmation. Les erreurs ne bloquent pas les lignes valides. 7. Après l'importation, téléchargez les lignes non importées si certaines ont échoué, et corrigez-les dans votre fichier source. ## Importer des relations entre objets Les objets Qwoty se référencent mutuellement : * Un **Produit** appartient à un **Produit maître** (via `parent_product_api_name` ou `product_parent_id`) * Un **Prix** appartient à la fois à un **Produit** et à un **Tarif** * Un **Produit** est rattaché à un ou plusieurs **Catalogues** et **Catégories** Vous référencez les enregistrements liés par leur identifiant unique — l'`id` (UUID) ou l'`api_name` (un identifiant stable et lisible que vous contrôlez). **L'ordre d'importation est important.** Importez toujours les objets dans cet ordre, car le "parent" doit exister avant que l'"enfant" puisse le référencer : 1. **Produits maîtres** — en premier 2. **Produits** — en deuxième (en référençant leur maître) 3. **Prix** — en dernier (en référençant les produits et les tarifs) Les catalogues, catégories et tarifs doivent déjà exister dans votre espace de travail avant de commencer. Créez-les via l'interface ou en amont dans votre plan de migration. Consultez [Importer des relations](/user-guide/data-migration/reference/import-relations) pour plus de détails sur le fonctionnement des colonnes de relation. ## Exporter des données Chaque écran d'importation permet également l'exportation. Utilisez la section **Exporter** sur la même page pour télécharger vos données actuelles au format CSV — utile pour : * Sauvegarder avant une mise à jour groupée * Transférer des données d'un environnement sandbox vers un espace de travail de production * Éditer dans un tableur puis réimporter avec `id` renseigné sur chaque ligne pour mettre à jour les enregistrements existants Les filtres s'appliquent : pour les produits, vous pouvez limiter l'export à un catalogue spécifique. Pour les prix, vous pouvez le limiter à un tarif spécifique. ## Permissions L'importation et l'exportation de données nécessitent des permissions spécifiques sur le bloc **Applications** de votre rôle : * **Importer CSV** — requise pour accéder à l'écran d'importation * **Exporter CSV** — requise pour télécharger les exports Contactez l'administrateur de votre espace de travail si ces permissions sont manquantes. Consultez [Gérer les rôles](/user-guide/settings/users/manage-roles) pour le modèle de permissions complet. ## Référence Concepts et règles applicables à chaque importation. Formats de fichiers, encodage et bonnes pratiques CSV. Comment Qwoty fait correspondre vos colonnes CSV à ses champs. Quels champs sont uniques et comment Qwoty déduplique les données. Comment lier des enregistrements à leurs parents lors de l'importation. Erreurs de validation et comment les corriger. ## Guides pratiques Instructions pas à pas pour les quatre importations courantes. Mettez en forme vos données correctement avant l'importation. Commencez toujours ici — les maîtres sont les parents que les produits référencent. Importez des produits rattachés à des produits maîtres et des catalogues. Ajoutez des prix à un tarif — six modèles de tarification pris en charge.