None. Ces entrées possèdent déjà un id. Le flux export-puis-réimport est donc identique que vous configuriez des prix pour la première fois ou que vous mettiez à jour des prix existants.
Le flux de travail standard est le suivant : exporter vos prix existants → modifier le CSV → le réimporter. La colonne id est la seule clé utilisée par Qwoty pour faire correspondre les lignes ; tous les autres champs sont mis à jour directement.
Vous devez disposer du rôle Admin pour accéder à Import & Export. Les catalogues tarifaires doivent déjà exister avant de pouvoir configurer leurs prix.
Accès
Naviguez vers Paramètres → Import & Export, puis sélectionnez la section Prix. La page comporte deux panneaux : Import (téléversement d’un CSV) et Export (téléchargement de vos données actuelles).Mettre à jour les prix
1
Exporter vos prix actuels
Dans le panneau Export, choisissez ce que vous souhaitez télécharger :
- Toutes les données — tous les prix de l’ensemble des catalogues tarifaires
- Filtrer par catalogue tarifaire — un catalogue tarifaire à la fois
- Filtrer par catalogue — tous les prix des produits d’un catalogue donné
id pré-remplie pour chaque entrée existante.2
Modifier le CSV
Ouvrez le fichier dans votre tableur et renseignez ou mettez à jour les colonnes de tarification. Les colonnes suivantes sont en lecture seule — elles identifient ce que chaque ligne représente et ne doivent pas être modifiées :
id,product_api_name,pricebook_api_name,currency_code,type,period_unit,period
pricing_model, amount, percent, cost, floor_price, vat_code, engagement_type, period_duration_month, pay_as_you_go, identifiers[*], et les colonnes de paliers.Les lignes dont le pricing_model est vide (ou None) sont des prix fictifs en attente de configuration. Définissez le modèle et les colonnes de montant correspondantes pour ces lignes.3
Réimporter le fichier
Dans le panneau Import, cliquez sur Téléverser un fichier et déposez votre CSV modifié.L’assistant d’import se déroule en quatre étapes : Téléversement → Correspondance → Confirmation → Résultat. Vérifiez l’écran de correspondance avant de confirmer afin de vous assurer que les colonnes sont correctement associées.
Une fois l’import terminé, vos prix sont actifs dans les catalogues tarifaires correspondants. Ouvrez un catalogue tarifaire pour vérifier les modifications.
Les six modèles de tarification
Chaque ligne déclare son modèle dans la colonnepricing_model. Les colonnes requises dépendent du modèle.
Référence des colonnes CSV
Les index de paliers sont basés sur 0 : le premier palier est
tiers[starting_unit][0], le deuxième est tiers[starting_unit][1], et ainsi de suite.Exemples par modèle de tarification
Paiement unique fixe
Un montant fixe par unité, avec une référence de coût interne pour le reporting des marges :Récurrent fixe (mensuel, sans terme)
Un abonnement mensuel fixe sans période d’engagement :Récurrent fixe (annuel, engagement fixe)
Un prix annuel avec un engagement de 12 mois :Basé sur le coût
Le prix de vente est calculé comme le coût défini du produit × le multiplicateur danscost. Un floor_price fixe le minimum :
Pourcentage
Un pourcentage du prix d’un produit de référence, calculé au moment du devis :Paliers progressifs
Les 10 premières unités à 49 €, tout ce qui est au-dessus à 39 € :10 × 49 € + 5 × 39 € = 685 €.
Paliers par volume
La quantité totale est tarifée au palier correspondant au volume total :150 × 5,00 € = 750 € (tout au palier correspondant à 150).
None (fictif)
Le produit apparaît dans le catalogue tarifaire mais ne possède pas de prix configuré. Les commerciaux renseignent le montant manuellement sur chaque devis :Résolution des problèmes
Import échoué : pricing_model inconnu
Import échoué : pricing_model inconnu
pricing_model est sensible à la casse. Utilisez exactement : Flat, Cost based (avec une espace), Percent, Graduated Tiered, Volume Tiered, None. Les variantes en minuscules ou avec des underscores (cost_based) sont rejetées.Import échoué : id non reconnu
Import échoué : id non reconnu
La colonne
id doit contenir un UUID existant dans votre espace de travail. Seules les lignes issues d’un export de votre propre espace de travail sont valides. Ne copiez pas d’identifiants provenant d’un autre espace de travail et n’en créez pas manuellement.Les paliers sont importés dans le mauvais ordre
Les paliers sont importés dans le mauvais ordre
Qwoty ordonne les paliers par valeur de
tiers[starting_unit][N], et non par position d’index. Assurez-vous que tiers[starting_unit][0] est la valeur la plus petite. Les plages qui se chevauchent déclenchent une erreur de validation.vat_code est rejeté
vat_code est rejeté
Utilisez le format
vat_<pays>_<taux>, entièrement en minuscules, avec le taux exprimé en nombre sans décimale : vat_fr_200 pour 20 %, vat_fr_055 pour 5,5 %, vat_de_190 pour 19 %. Laissez la cellule vide lorsqu’aucune TVA ne s’applique.Le prix à durée déterminée n'affiche aucune durée d'engagement
Le prix à durée déterminée n'affiche aucune durée d'engagement
Lorsque
engagement_type est fixed, vous devez également renseigner period_duration_month avec le nombre de mois (ex. 12 pour un engagement de 12 mois). Laisser ce champ vide avec engagement_type = fixed entraîne son ignorance.Le prix en pourcentage produit des résultats inattendus
Le prix en pourcentage produit des résultats inattendus
La colonne
percent prend un nombre, et non une fraction : 8.95 signifie 8,95 %, et non 0,0895. Combinez avec floor_price pour définir un montant minimum.Ressources associées
Référence des types de tarification
Présentation conceptuelle approfondie de chaque modèle de tarification et de son cas d’usage.
Créer un catalogue tarifaire
Configurez le catalogue tarifaire avant d’exporter ses prix pour les paramétrer.
Importer des produits
Les produits doivent exister avant que leurs prix puissent être configurés.
Préparer votre CSV
Règles de mise en forme universelles pour tous les imports Qwoty.