Migration des données

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 : Pour les jeux de données très volumineux ou les synchronisations récurrentes depuis votre ERP ou CRM, utilisez l’API REST Qwoty. 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 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).
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). Consultez Importer des 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 pour le modèle de permissions complet.

​

Référence

Concepts et règles applicables à chaque importation.

​

Guides pratiques

Instructions pas à pas pour les quatre importations courantes.