Produits et tarifs

Pour comprendre comment synchroniser vos produits et tarifs entre Salesforce et Stripe.

Lorsque vous créez des produits et des tarifs dans Salesforce, ils ne sont pas synchronisés immédiatement avec Stripe. La synchronisation a lieu lorsqu’ils sont utilisés dans une commande activée. Vous n’avez pas besoin de créer manuellement ces informations dans Stripe.

Salesforce est la principale source d’informations sur les produits et les tarifs. Cela signifie que tous les tarifs, descriptions de produits, unités de gestion des stocks et autres sont synchronisés de Salesforce à Stripe. Les modifications que vous apportez à ces données dans Stripe ne modifient pas les produits et tarifs associés dans Salesforce. De plus, si vous activez une nouvelle commande dans Salesforce en utilisant les informations de produit ou de prix mises à jour, cette action met à jour les modifications correspondantes effectuées dans Stripe.

Créer des tarifs

Les données tarifaires peuvent provenir du OrderItem de Salesforce ou du PricebookEntry associé. Lors de la création du tarif Stripe, l’application recherche les différences entre ces objets Salesforce et décide lequel utiliser. Si les données PricebookEntry diffèrent des données OrderItem, l’application utilise le OrderItem pour créer le tarif Stripe. Dans le cas contraire, l’application utilise le PricebookEntry.

Réutiliser les tarifications Stripe

L’application Stripe Billing pour Salesforce CPQ réutilise les tarifs créés à partir d’un PricebookEntry précédemment synchronisé dans l’application. L’application crée un nouveau tarif pour les tarifs générés à l’aide du OrderItem. Vous ne pouvez pas réutiliser des postes de commande, car ils sont uniques, mais vous pouvez réutiliser des entrées de votre catalogue tarifaire pour plusieurs postes de commande. Dans les deux cas, l’ID de tarif Stripe correspondant est réécrit dans l’objet Salesforce.

Mappages de champs pour des produits

L’application Stripe Billing pour Salesforce CPQ crée un produit dans Stripe même s’il n’y a pas de données pertinentes dans Salesforce. Tous les champs de produit sont facultatifs.

Champ Salesforce (objet Product2)	Produit Stripe
Nom	Name
Description	Description

Mappages de champs pour des tarifs

Le connecteur prend en charge les types de tarifs suivants dans Stripe :

Tarifs sous licence : si le champ Type de facturation (SBQQ_BillingType_c) dans Salesforce est défini sur Aucun ou sur Avancé, l’application crée un tarif sous licence dans Stripe.
Tarifs à la consommation ou à l’usage : si le champ Type de facturation (SBQQ_BillingType_c) dans Salesforce est défini sur Arrears, l’application crée un tarif à la consommation ou à l’usage.
Tarifs sous forme décimale : si la valeur décimale de votre tarif comporte plus de 12 décimales, l’application arrondit votre tarif à 12 décimales.
Tarifs ponctuels et récurrents : le connecteur traite tout produit doté de champs d’abonnement remplis comme un produit à tarif récurrent. Les tarifs à la consommation doivent être récurrents, mais les tarifs évolutifs peuvent être ponctuels. Si vous souhaitez créer un tarif ponctuel, ne définissez pas les champs suivants sur le produit Salesforce :
- Tarification de l’abonnement (SBQQ__SubscriptionPricing__c)
- Type d’abonnement (SBQQ__SubscriptionType__c)
- Durée d’abonnement (SBQQ__SubscriptionTerm__c)
- Fréquence de facturation (SBQQ__BillingFrequency__c)

Champ Salesforce (objet PricebookEntry)	Tarif Stripe	Notes
Produit	Product	Mappe l’objet Stripe `Product` associé aux objets Salesforce `Product` et `Pricebook` avec l’objet `Price` correspondant dans Stripe.
Description	Description
Prix unitaire	Unit amount decimal	Représente le montant facturé au client à la fréquence spécifiée dans le champ `Billing Frequency`.
Fréquence de facturation	Recurring, interval count	Obligatoire pour les tarifs récurrents uniquement. Les valeurs prises en charge sont notamment mensuelles, trimestrielles, semestrielles et annuelles. Ces valeurs correspondent au nombre entier équivalent.
Type de facturation	Recurring, usage type	Obligatoire pour les tarifs récurrents uniquement. La valeur « Arrears » correspond à une facturation à la consommation. La valeur « Advanced » correspond à une tarification sous licence.
Paramètre de l’unité de durée globale CPQ	Recurring, interval	Obligatoire pour les tarifs récurrents uniquement. Ce paramètre est défini lors de la configuration et ne correspond pas à un mappage au niveau du champ.
Devise	Currency	Si votre organisation Salesforce a activé l’option multidevise, nous mappons le `CurrencyIsoCode` du `PricebookEntry` sur une devise Stripe. Dans le cas contraire, nous utilisons la devise par défaut définie lors de la configuration.

Tarification échelonnée avec planifications de consommation

Vous pouvez configurer la tarification échelonnée dans Stripe en définissant une planification de consommation Salesforce (et les tarifs associés) pour les produits dans Salesforce. Stripe utilise la planification de consommation pour associer une tarification échelonnée aux postes facturés à la consommation ou sous licence. Vous ne pouvez utiliser qu’une seule planification de consommation par ligne de commande.

Stripe Billing nécessite un niveau illimité, c’est-à-dire un taux de consommation sans valeur pour la limite supérieure. Le connecteur n’utilise pas l’ordre de traitement sur un taux de consommation, ni la durée de facturation et l’unité de durée de facturation sur la planification de consommation associée au produit de la commande. Le connecteur utilise plutôt la fréquence de facturation et la durée de l’abonnement sur la ligne de commande.

Pour la tarification échelonnée, l’application mappe les données des objets Salesforce suivants :

OrderLine : si les données OrderLine diffèrent de l’objet PricebookEntry correspondant, l’application utilise les données OrderLine et crée un nouvel objet Price dans Stripe.
PricebookEntry : le connecteur utilise cette valeur si les données tarifaires correspondent à OrderLine et que la planification de consommation et les données tarifaires ne sont pas personnalisées par client.
Consumption Schedule : bien que Salesforce vous autorise à associer plusieurs planifications de consommation à un même produit, l’application ne prend en charge qu’une seule planification de consommation par ligne de commande.
Consumption Rate : le connecteur utilise le tarif associé à une planification de consommation pour définir chaque entrée de niveau dans le tarif Stripe. Vous pouvez définir plusieurs tarifs pour une même planification de consommation.

Remarque

Vous ne pouvez pas personnaliser le mappage des champs pour générer la configuration de tarification échelonnée dans Stripe, ni utiliser des champs personnalisés pour les paliers tarifaires.

Si vous personnalisez la planification de consommation et le taux de consommation par client, Stripe crée un nouvel objet Price pour représenter la tarification personnalisée. Le nouveau tarif apparaît dans le champ ID Stripe de l’objet Order Line dans Salesforce.

Pour définir un mappage pour la tarification échelonnée, ajoutez l’attribut PricebookEntry suivant au mappage des champs de vos tarifs. Ces champs sont obligatoires.

Champ Salesforce (objet PricebookEntry)	Tarif Stripe	Notes
	Billing scheme	Défini sur « tiered » lorsqu’une ligne de commande dans Salesforce est associée à une planification de consommation.

Planification de consommation Salesforce	Tarif Stripe	Notes
Type	Tiers mode	Le type Par palier correspond à une tarification évolutive. Le type Plage correspond à une tarification au volume.

Chaque taux de consommation associé à une planification de consommation génère une entrée de niveau supplémentaire dans l’objet Stripe Price. Ces champs sont obligatoires.

Taux de consommation Salesforce	Tarif Stripe	Notes
Limite supérieure	Tiers, Up to	Stripe n’a pas de limite inférieure et part du principe que la valeur de la limite inférieure du premier niveau est fixée à zéro. Si cette valeur est vide dans Salesforce, Stripe utilise la valeur inférieure pour indiquer qu’il n’existe pas de limite pour la limite supérieure.
Méthode de tarification		Une valeur unitaire indique à l’application d’utiliser le champ `unit_amount_decimal` lors du mappage du tarif. Si la valeur est forfaitaire, l’application utilise le champ `flat_amount_decimal` pour le tarif.
Tarif	Tiers, Flat amount decimal ou Unit amount decimal	Le type de tarification utilisé dépend du champ `Pricing Method`.

Synchroniser manuellement des produits et des tarifs

Lorsque vous effectuez des tests dans un environnement de sandbox Salesforce, vous pouvez synchroniser manuellement l’intégralité de votre catalogue de produits pour l’examiner dans votre compte de test Stripe. La synchronisation manuelle respecte les filtres de produits et de tarifs que vous définissez.

Utilisez les boutons suivants dans la section Paramètres de l’application :

Synchroniser tous les produits : synchronise tous les produits (mais pas leurs tarifs) avec votre compte de test Stripe, quelle que soit la date de leur dernière mise à jour. Cette opération a lieu en arrière-plan et peut prendre quelques minutes. Si vous supprimez des produits dans Salesforce, ils ne sont pas supprimés ni archivés dans Stripe.
Synchroniser tous les catalogues de prix : synchronisez manuellement un PricebookEntry avec votre compte Stripe test en saisissant l’identifiant de l’enregistrement dans la fonctionnalité de synchronisation manuelle. Cette opération a lieu en arrière-plan. Si vous supprimez des produits ou des tarifs dans Salesforce, ils ne sont pas supprimés ni archivés dans Stripe. Une fois que vous avez créé un tarif et défini une fréquence de facturation récurrente dans Stripe, vous ne pouvez pas mettre à jour ces paramètres ni les synchroniser depuis Salesforce. Toute tentative de ce type entraîne des erreurs de synchronisation.

Si vous avez déjà synchronisé un produit ou un tarif avec votre compte Stripe et souhaitez effectuer une nouvelle synchronisation, vous pouvez supprimer le contenu du champ ID Stripe de l’objet Salesforce de votre compte Salesforce, puis effectuer une nouvelle synchronisation pour créer une nouvelle ressource dans Stripe.

Personnaliser les tarifs des produits sur des commandes

Dans Salesforce CPQ, vous pouvez éventuellement personnaliser le prix unitaire d’un produit sur un devis. Si vous personnalisez le tarif, les informations seront différentes du tarif associé au produit figurant sur la commande activée. Dans ce cas, l’application crée un tarif unique dans Stripe pour représenter le tarif personnalisé. L’ID du tarif Stripe apparaît dans le champ ID Stripe de la commande.

Lorsque vous créez un mappage de données avec un tarif personnalisé pour une commande, le tarif apparaît au niveau de l’objet Order Line et non au niveau de Pricebook Entry dans Salesforce. La tarification est considérée comme personnalisée si l’un des champs associés (par exemple, les champs récurrents, le montant ou la devise) diffère entre le prix du catalogue de prix et le prix de la ligne de commande.

Prise en charge de plusieurs devises

Si votre organisation Salesforce a activé l’option multidevise, l’application mappe le CurrencyIsoCode dans PricebookEntry sur la devise Stripe équivalente lors de la création du tarif Stripe. Ainsi, les factures suivantes seront facturées dans la devise appropriée.

Lorsque vous facturez dans plusieurs devises, tenez compte des points suivants :

Plusieurs devises par client Stripe

Stripe prend en charge une devise active par client. Ainsi, chaque client Stripe ne peut avoir plusieurs abonnements actifs libellés dans des devises différentes. Par exemple, si un client a un abonnement actif facturé en USD, vous devez attendre la fin de cet abonnement avant de créer un nouvel abonnement dans une autre devise (par exemple, GBP).

Modifications de commande

Toutes les modifications de commande Salesforce doivent utiliser la même devise que la commande d’origine. Les commandes et les modifications de commande ne peuvent pas comporter plusieurs devises parmi les postes de commande.

Taux de change

Le connecteur ne gère pas la conversion des devises. Il transmet simplement le tarif et les deux devises figurant dans PricebookEntry.