Importer des produits

L’import de produits crée les articles vendables de votre catalogue, ou met à jour les articles existants. Chaque ligne correspond à une variante de produit :

Ligne sans product_id : Qwoty crée un nouveau produit et sa variante par défaut. Inutile de créer d’abord le produit (maître) : l’import s’en charge.
Ligne avec product_id : Qwoty met à jour cette variante existante et son produit.

Vous avez besoin de la permission Importer CSV dans le bloc Applications de votre rôle. Les catalogues, catégories et options de variante que vous référencez doivent déjà exister.

Ouvrir l’import

Ouvrir Import & Export

Allez dans Paramètres › Données › Import & Export et cliquez sur Produits.

Télécharger le modèle

Cliquez sur Télécharger le modèle pour obtenir un CSV avec toutes les colonnes prises en charge et quelques lignes d’exemple.

Charger votre fichier

Cliquez sur Télécharger le fichier et déposez votre CSV. L’assistant se déroule en quatre étapes : Upload → Mapping → Confirmation → Résultat.

Vérifier le mapping

Chaque colonne de votre fichier est associée à un champ Qwoty (groupes Informations principales, Paramètres, Inventaire, Identifiants externes, Expédition, Comptabilité, Champs personnalisés). Choisissez Ignorer cette colonne pour les colonnes que vous ne voulez pas importer.

Confirmer et importer

Vérifiez le nombre de produits et de variantes, téléchargez les lignes en erreur s’il y en a, puis cliquez sur Lancer l’import.

L’étape Résultat indique combien de produits ont été importés. Si certaines lignes ont échoué, cliquez sur Télécharger les lignes non importées pour les récupérer avec le motif dans une colonne erreur.

Référence des colonnes CSV

Colonne	Obligatoire	Type	Description
`product_id`	—	UUID	Laissez vide pour créer un produit. Indiquez l’UUID d’une variante existante (issu d’un export) pour la mettre à jour.
`product_name`	—	Texte	Nom du produit. À la création, il est utilisé à la fois pour le produit et pour sa variante par défaut.
`product_api_name`	—	Texte	Identifiant API stable. Ne doit pas déjà exister sur un autre produit.
`reference`	—	Texte	Référence interne.
`product_description`	—	Texte	Description affichée sur les devis et dans la Dealroom.
`primary_image_id`	—	UUID	UUID d’une image déjà chargée dans la médiathèque.
`settings[recurrence_type]`	✱	Enum	`one_off` ou `recurring`.
`settings[is_active]`	—	Booléen	`true` ou `false`.
`settings[product_type]`	—	Enum	Par exemple `finished_good`, `component`, `accessory`, `consumable`, `service`, `consulting`, `training`, `subscription`, `licence`, `rental`, `support`, `one_time_fee`.
`settings[unit_of_measure]`	—	Texte	Unité affichée (par exemple `unit`, `license`, `hour`).
`settings[language_code]`	—	Enum	`en`, `fr`, `de`, `es`, `it` ou `pt`.
`settings[unit_per_pack]`	—	Nombre	Unités par pack, en cas de vente par pack.
`catalog_api_names`	—	Texte	Noms API des catalogues, séparés par des virgules.
`category_api_names`	—	Texte	Noms API des catégories, séparés par des virgules.
`inventory[sku]`	—	Texte	SKU de la variante.
`identifiers[erp]`, `identifiers[crm]`, `identifiers[accounting]`	—	Texte	Identifiants externes.
`accounting[ledger_account]`	—	Texte	Code du compte comptable.
`shipping[weight]`, `shipping[height]`, `shipping[length]`, `shipping[width]`	—	Nombre	Dimensions d’expédition.
`shipping[weight_unit]`, `shipping[length_unit]`	—	Texte	Unités des dimensions (le formulaire produit utilise `kg` / `lbs` et `cm` / `inch`).
`shipping[country_of_origin]`	—	Texte	Code pays ISO à 2 lettres (`FR`, `DE`).
`shipping[harmonized_system_code]`	—	Texte	Code du Système harmonisé (SH).
`options[N][name]`, `options[N][value]`	—	Texte	Noms API d’une option de variante existante et de l’une de ses valeurs (par exemple `size` / `m`). `N` commence à 1.
`custom[<api_name>]`	—	Texte, nombre ou date	Valeur d’un champ personnalisé produit. Le nom API doit exister dans Paramètres › Données › Modèle de données.

Lorsque catalog_api_names ou category_api_names contiennent plusieurs valeurs, entourez la cellule de guillemets doubles : "france,partner_pricing". Sans les guillemets, la virgule à l’intérieur de la cellule casse la ligne.

Catalogues et prix

À la création, Qwoty lie le produit aux catalogues listés dans catalog_api_names et toujours au catalogue par défaut du workspace, puis génère les entrées de prix correspondantes. Les noms API de catalogue inexistants sont ignorés. À la mise à jour, les liens vers les catalogues ne sont remplacés que si la colonne catalog_api_names est mappée. Après l’import des produits, renseignez leurs prix avec l’import de prix.

Options de variante

Les colonnes options[N][...] lient une variante à des valeurs d’option qui existent déjà dans Produits et prix › Options de produits. L’import ne crée ni options ni valeurs. Si une option ou une valeur est introuvable, l’étape Résultat signale une erreur pour cette ligne.

Scénarios courants

Créer des produits simples

product_id,product_name,product_api_name,settings[recurrence_type],catalog_api_names,inventory[sku]
,Wireless Mouse,wireless_mouse,one_off,france,SKU-001
,USB-C Cable,usb_c_cable,one_off,france,SKU-002
,Support Plan,support_plan,recurring,france,SKU-003

Mettre à jour des produits existants

Exportez d’abord vos produits (panneau Export › Exporter CSV) pour obtenir leur product_id, puis importez uniquement les colonnes à modifier :

product_id,product_name,inventory[sku]
6ddb0e85-1d1e-4c11-b45d-c9c7ff7c62e8,Wireless Mouse Pro,SKU-001-PRO
9b7ccfa9-1234-5678-aabb-c0ffee123456,USB-C Cable v2,SKU-002-V2

Seules les colonnes mappées sont mises à jour. Les autres champs restent inchangés.

Dépannage

recurrence_type invalide

Les seules valeurs acceptées pour settings[recurrence_type] sont one_off et recurring (en minuscules, avec un tiret bas).

Le produit n'est pas dans le catalogue attendu

Vérifiez les noms API des catalogues dans Produits et prix › Catalogue. Les noms qui ne correspondent à aucun catalogue existant sont ignorés. Pour plusieurs catalogues, entourez la cellule de guillemets doubles : "france,partner_pricing".

primary_image_id est rejeté

L’UUID doit être un UUID valide d’une image de votre médiathèque. Chargez d’abord vos images, puis exportez la liste de vos médias pour obtenir leurs UUID.

Le nom technique généré existe déjà

Un autre produit utilise déjà ce product_api_name. Modifiez la valeur dans votre fichier, ou renseignez product_id pour mettre à jour le produit existant.

Définition ou valeur d'option introuvable

Créez d’abord l’option de variante et ses valeurs dans Produits et prix › Options de produits, puis utilisez leurs noms API dans options[N][name] et options[N][value].

Mon champ booléen a renvoyé une erreur

Utilisez true ou false.

Étapes suivantes

Importer des prix

Maintenant que les produits existent, renseignez leurs prix.

Préparer votre CSV

Règles de formatage communes.

Catalogues

Gérer l’emplacement des produits.

Options de produits

Créer les catégories et options de variante référencées par votre import.

Devis

Catalogue & Produits

Clients

Templates

Approbations & Workflows

Dealroom

Documents & Modèles

Paramètres (Admin)

Migration de données

Modèle de données

Dépannage

Importer des produits

Ouvrir l’import

Référence des colonnes CSV

Catalogues et prix

Options de variante

Scénarios courants

Créer des produits simples

Mettre à jour des produits existants

Dépannage

Étapes suivantes

Importer des prix

Préparer votre CSV

Catalogues

Options de produits

​Ouvrir l’import

​Référence des colonnes CSV

​Catalogues et prix

​Options de variante

​Scénarios courants

​Créer des produits simples

​Mettre à jour des produits existants

​Dépannage

​Étapes suivantes

Importer des prix

Préparer votre CSV

Catalogues

Options de produits

Ouvrir l’import

Référence des colonnes CSV

Catalogues et prix

Options de variante

Scénarios courants

Créer des produits simples

Mettre à jour des produits existants

Dépannage

Étapes suivantes