Importer et exporter des prix

Dans Qwoty, les prix sont créés automatiquement : chaque fois qu’une grille de prix est configurée, tous les produits concernés reçoivent une entrée de prix. Votre rôle consiste à renseigner les valeurs, pas à créer les entrées de toutes pièces. Lorsque vous créez une grille de prix, Qwoty génère automatiquement une entrée de prix par produit et par période de facturation, toutes réglées sur None. Ces entrées ont déjà un id. Le processus export puis réimport est donc le même, que vous configuriez les prix pour la première fois ou que vous mettiez à jour des prix existants. Le processus standard est le suivant : exporter vos prix existants → modifier le CSV → le réimporter. La colonne id est la clé utilisée par Qwoty pour faire correspondre les lignes ; tous les autres champs sont mis à jour sur place. Elle contient soit l’UUID du prix, soit une clé de prix construite à partir des noms API du produit et de la grille de prix (voir Identifier un prix par sa clé).

Vous avez besoin des permissions Importer CSV et Exporter CSV dans le bloc Applications de votre rôle. Les grilles de prix doivent déjà exister pour que vous puissiez configurer leurs prix.

Accès

Allez dans Paramètres › Données › Import & Export, puis cliquez sur Prix. La page comporte deux panneaux : Import (Télécharger le modèle, Voir la documentation, Télécharger le fichier) et Export (téléchargement de vos données actuelles). Vous pouvez aussi partir de la liste des grilles de prix : dans Produits et prix › Grille de prix, utilisez Importer des prix ou Exporter les prix.

Mettre à jour les prix

Exporter vos prix actuels

Dans le panneau Export, choisissez ce que vous voulez télécharger :

Toutes les données : tous les prix de toutes les grilles de prix
Filtrer par grille tarifaire : une grille de prix à la fois

Cliquez sur Exporter CSV. Le fichier contient une ligne par prix, avec la colonne id déjà remplie pour chaque entrée existante.

Modifier le CSV

Ouvrez le fichier dans votre tableur et renseignez ou mettez à jour les colonnes de prix. Les colonnes suivantes sont fournies à titre de contexte, en lecture seule : elles identifient ce que représente chaque ligne et ne doivent pas être modifiées :

id, product_api_name, pricebook_api_name, currency_code, type, period_unit, period

Les colonnes que vous configurez sont : pricing_model, amount, percent, percent[multiplier], cost, floor_price, vat_code, engagement_type, period_duration_month, pay_as_you_go, identifiers[*] et les colonnes de paliers.Les lignes dont pricing_model est vide (ou None) sont des prix en attente de configuration. Définissez le modèle et les colonnes de montant correspondantes pour ces lignes.

N’ajoutez pas de nouvelles lignes. Les prix sont créés automatiquement lors de la configuration des grilles de prix : les lignes absentes de l’export ne correspondent à aucun prix existant et seront rejetées à l’import.

Réimporter le fichier

Dans le panneau Import, cliquez sur Télécharger le fichier et déposez votre CSV modifié.L’assistant d’import se déroule en quatre étapes : Upload → Mapping → Confirmation → Résultat. Vérifiez l’écran de mapping pour vous assurer que les colonnes sont correctement associées, puis cliquez sur Lancer l’import. Si certaines lignes échouent, cliquez sur Télécharger les lignes non importées à l’étape Résultat.

Une fois l’import terminé, vos prix sont actifs dans les grilles de prix correspondantes. Ouvrez une grille de prix pour vérifier les modifications.

Identifier un prix par sa clé

Au lieu de l’UUID du prix, la colonne id accepte une clé construite à partir des noms API, séparés par des points :

Prix	Format de la clé	Exemple
Ponctuel	`<product_api_name>.<pricebook_api_name>`	`onboarding.standard_eur`
Récurrent	`<product_api_name>.<pricebook_api_name>.<period_unit>.<period>`	`licence_pro.standard_eur.month.1`

product_api_name et pricebook_api_name sont les valeurs des colonnes d’export du même nom.
period_unit vaut day, week, month ou year ; period est le nombre d’unités par cycle (1 = mensuel, 3 = trimestriel).
Un produit récurrent a un prix par période de facturation dans chaque grille de prix : sa clé doit donc inclure la période.

id,pricing_model,amount
onboarding.standard_eur,Flat,1500
licence_pro.standard_eur.month.1,Flat,49
licence_pro.standard_eur.year.1,Flat,490

La clé cible uniquement des prix existants : elle n’en crée pas de nouveaux. Chaque prix ne peut apparaître qu’une fois par fichier, que ce soit par son UUID ou par sa clé.

Les six modèles de tarification

Chaque ligne déclare son modèle dans la colonne pricing_model. Les colonnes obligatoires dépendent du modèle.

Modèle	À utiliser pour
`Flat`	Un montant fixe : le cas le plus courant
`Cost based`	Un prix de vente calculé en multipliant le coût par un multiplicateur
`Percent`	Un pourcentage d’une valeur de référence, calculé au moment du devis
`Graduated Tiered`	Chaque palier s’applique progressivement aux volumes compris dans ce palier
`Volume Tiered`	Toute la quantité est tarifée au palier correspondant au total
`None`	Prix à compléter : le montant est saisi manuellement au moment du devis

Les valeurs de pricing_model sont sensibles à la casse. Utilisez les libellés exactement tels qu’exportés (Flat, Cost based, Percent, Graduated Tiered, Volume Tiered, None) ou les valeurs internes (flat, cost_based, percent, graduated, volume, none). Toute autre valeur est rejetée.

Référence des colonnes CSV

Colonne	Obligatoire	Type	Description
`id`	✱	UUID ou clé	ID du prix, ou clé de prix comme `licence_pro.standard_eur.month.1`. Sert à retrouver le prix existant à l’import.
`product_api_name`	—	Texte	Contexte en lecture seule. Le nom API du produit associé.
`pricebook_api_name`	—	Texte	Contexte en lecture seule. Le nom API de la grille de prix associée.
`currency_code`	—	Texte	Contexte en lecture seule. Code ISO 4217 (`EUR`, `USD`, `GBP`…).
`type`	—	Enum	Contexte en lecture seule. `one-time` ou `recurring`.
`period_unit`	—	Enum	Contexte en lecture seule. Unité de la période de facturation (`day`, `week`, `month`, `year`).
`period`	—	Nombre	Contexte en lecture seule. Nombre d’unités de période par cycle (`1` = mensuel, `3` = trimestriel).
`pricing_model`	✱	Enum	`Flat`, `Cost based`, `Percent`, `Graduated Tiered`, `Volume Tiered`, `None`.
`vat_code`	—	Texte	Nom API d’une taxe définie dans Paramètres › Workspace › Taxe (par exemple `FR_200`). Définit la taxe par défaut du prix. Laissez vide pour ne définir aucune taxe par défaut.
`floor_price`	—	Nombre	Prix minimum autorisé (garde-fou lors de l’application de remises).
`amount`	✱ si `Flat`	Nombre	Le prix unitaire fixe.
`percent`	✱ si `Percent`	Nombre	La valeur du pourcentage, entre 0 et 100 (`8.95` = 8,95 %).
`percent[multiplier]`	✱ si `Cost based`	Nombre	Multiplicateur appliqué au coût. Également accepté sous le nom `cost_multiplier`.
`percent[perimeter]`	—	Texte	Périmètre auquel s’applique le pourcentage (par exemple `product`).
`percent[externals_id]`	—	UUID	ID de référence de la cible du pourcentage.
`cost`	—	Nombre	Coût de l’article, utilisé pour le calcul de la marge et comme base des prix `Cost based`.
`pay_as_you_go`	—	Booléen	`true` pour une facturation à l’usage, dont le montant est calculé au moment de la consommation.
`engagement_type`	—	Enum	`forever` (sans fin) ou `fixed` (période d’engagement).
`period_duration_month`	—	Nombre	Durée d’engagement par défaut en mois (entier positif). À utiliser avec `engagement_type` = `fixed`.
`identifiers[erp]`	—	Texte	Référence ERP externe de ce prix.
`identifiers[crm]`	—	Texte	Référence CRM externe de ce prix.
`identifiers[accounting]`	—	Texte	Référence comptable externe de ce prix.
`tiers[starting_unit][N]`	✱ si paliers	Nombre	Borne inférieure du palier N (incluse). N commence à 0 : `[0]`, `[1]`, `[2]`…
`tiers[ending_unit][N]`	—	Nombre	Borne supérieure du palier N (incluse). Laissez vide pour « sans limite supérieure ».
`tiers[price][N]`	✱ si paliers	Nombre	Prix unitaire du palier N.
`tiers[flat_fee][N]`	—	Nombre	Frais fixes facultatifs ajoutés au palier N.

Les index des paliers commencent à 0 : le premier palier est tiers[starting_unit][0], le deuxième tiers[starting_unit][1], et ainsi de suite.

Exemples par modèle de tarification

Flat ponctuel

Un montant fixe par unité, avec un coût de référence interne pour le suivi de la marge :

id,currency_code,type,pricing_model,vat_code,floor_price,amount,cost
a3b97966-...,EUR,one-time,Flat,FR_200,13900,14900,8700

Flat récurrent (mensuel, sans engagement)

Un abonnement mensuel fixe sans période d’engagement :

id,currency_code,type,pricing_model,vat_code,amount,period_unit,period,engagement_type
bf56bdd5-...,EUR,recurring,Flat,FR_200,0,month,1,forever

Flat récurrent (annuel, engagement fixe)

Un prix annuel avec un engagement de 12 mois :

id,currency_code,type,pricing_model,vat_code,amount,period_unit,period,engagement_type,period_duration_month
d1b65444-...,EUR,recurring,Flat,FR_200,1100,year,1,fixed,12

Cost based

Le prix de vente est calculé comme cost × percent[multiplier]. Un floor_price fixe le minimum :

id,currency_code,type,pricing_model,vat_code,floor_price,cost,percent[multiplier]
dcc190c5-...,EUR,one-time,Cost based,FR_200,10,8,2

Percent

Un pourcentage du prix d’un produit de référence, calculé au moment du devis :

id,currency_code,type,pricing_model,vat_code,percent,percent[perimeter],percent[externals_id],period_unit,period,engagement_type
5a68792e-...,EUR,recurring,Percent,FR_200,8.95,product,b150e52a-...,month,1,forever

Graduated tiered

Les 10 premières unités à 49 €, toutes les suivantes à 39 € :

id,currency_code,type,pricing_model,vat_code,period_unit,period,tiers[starting_unit][0],tiers[ending_unit][0],tiers[price][0],tiers[flat_fee][0],tiers[starting_unit][1],tiers[ending_unit][1],tiers[price][1],tiers[flat_fee][1]
ac06fe31-...,EUR,recurring,Graduated Tiered,FR_200,month,1,1,10,49,0,11,,39,0

Pour 15 unités : 10 × €49 + 5 × €39 = €685.

Volume tiered

Toute la quantité est tarifée au palier correspondant au volume total :

id,currency_code,type,pricing_model,vat_code,tiers[starting_unit][0],tiers[ending_unit][0],tiers[price][0],tiers[flat_fee][0],tiers[starting_unit][1],tiers[ending_unit][1],tiers[price][1],tiers[flat_fee][1]
...,EUR,one-time,Volume Tiered,FR_200,1,100,6.00,0,101,,5.00,0

Pour 150 unités : 150 × €5.00 = €750 (tout au palier correspondant à 150).

None (prix à compléter)

Le produit apparaît dans la grille de prix mais n’a pas de prix configuré. Les commerciaux saisissent le montant manuellement sur chaque devis :

id,currency_code,type,pricing_model,vat_code
5f7efcbd-...,EUR,one-time,None,FR_200

Dépannage

Échec de l'import : modèle invalide

pricing_model est sensible à la casse. Utilisez les libellés exportés (Flat, Cost based, Percent, Graduated Tiered, Volume Tiered, None) ou les valeurs internes (flat, cost_based, percent, graduated, volume, none).

Échec de l'import : id non reconnu

La colonne id doit contenir un UUID existant dans votre workspace, ou une clé de prix valide. Seules les lignes issues d’un export de votre propre workspace sont valides. Ne copiez pas d’ID depuis un autre workspace et n’en créez pas manuellement.

Échec de l'import : produit, grille de prix ou fréquence de facturation introuvable

Avec une clé de prix, chaque partie doit correspondre à votre workspace : product_api_name et pricebook_api_name exactement comme dans l’export, et une fréquence de facturation (month.1, year.1…) existant dans Produits et prix › Options de produits › Fréquence de paiement. Un produit ponctuel n’a pas de période : utilisez uniquement product.pricebook.

Échec de l'import : plusieurs prix correspondent à cette clé

La clé correspond à plus d’un prix. Pour cette ligne, utilisez plutôt l’UUID du prix issu de l’export.

Prix Volume ou Échelonné rejeté

Au moins un palier est obligatoire pour ces modèles : renseignez tiers[starting_unit][0] et tiers[price][0], puis ajoutez [1], [2]… pour les paliers suivants.

La taxe par défaut n'est pas appliquée

vat_code doit correspondre exactement au nom API d’une taxe de Paramètres › Workspace › Taxe. Une valeur qui ne correspond à aucune taxe laisse le prix sans taxe par défaut.

Un prix à durée déterminée n'affiche pas de durée d'engagement

Lorsque engagement_type vaut fixed, renseignez aussi period_duration_month avec le nombre de mois (par exemple 12 pour un engagement de 12 mois).

Un prix en pourcentage donne des résultats inattendus

La colonne percent attend un nombre entre 0 et 100, pas une fraction : 8.95 signifie 8,95 %, et non 0,0895. Combinez-la avec floor_price pour fixer un montant minimum.

Ressources associées

Référence des types de tarification

Présentation détaillée de chaque modèle de tarification et de ses cas d’usage.

Créer une grille de prix

Configurer la grille de prix avant d’exporter ses prix pour les renseigner.

Importer des produits

Les produits doivent exister avant de pouvoir configurer leurs prix.

Préparer votre CSV

Règles de formatage communes à tous les imports Qwoty.

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 et exporter des prix

Accès

Mettre à jour les prix

Identifier un prix par sa clé

Les six modèles de tarification

Référence des colonnes CSV

Exemples par modèle de tarification

Flat ponctuel

Flat récurrent (mensuel, sans engagement)

Flat récurrent (annuel, engagement fixe)

Cost based

Percent

Graduated tiered

Volume tiered

None (prix à compléter)

Dépannage

Ressources associées

Référence des types de tarification

Créer une grille de prix

Importer des produits

Préparer votre CSV

​Accès

​Mettre à jour les prix

​Identifier un prix par sa clé

​Les six modèles de tarification

​Référence des colonnes CSV

​Exemples par modèle de tarification

​Flat ponctuel

​Flat récurrent (mensuel, sans engagement)

​Flat récurrent (annuel, engagement fixe)

​Cost based

​Percent

​Graduated tiered

​Volume tiered

​None (prix à compléter)

​Dépannage

​Ressources associées

Référence des types de tarification

Créer une grille de prix

Importer des produits

Préparer votre CSV

Accès

Mettre à jour les prix

Identifier un prix par sa clé

Les six modèles de tarification

Référence des colonnes CSV

Exemples par modèle de tarification

Flat ponctuel

Flat récurrent (mensuel, sans engagement)

Flat récurrent (annuel, engagement fixe)

Cost based

Percent

Graduated tiered

Volume tiered

None (prix à compléter)

Dépannage

Ressources associées