Produits et tarifs

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, le connecteur repère les différences entre ces objets Salesforce et détermine lequel utiliser. Si les données PricebookEntry diffèrent des données OrderItem, le connecteur utilise le OrderItem pour créer le tarif Stripe. Sinon, le connecteur utilise le paramètre PricebookEntry.

Réutiliser les tarifications Stripe

Le Stripe Billing Connector for Salesforce CPQ réutilise les tarifs créés à partir d’un PricebookEntry précédemment synchronisé via le connecteur. Pour les tarifs générés à l’aide du OrderItem, le connecteur crée un nouveau tarif. Vous ne pouvez pas réutiliser des postes de commande car ils sont uniques, mais vous pouvez réutiliser des entrées du catalogue 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

Le connecteur 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.

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é, le connecteur crée un tarif sous licence dans Stripe.
• Tarifs à la consommation ou à l’utilisation : si le champ Type de facturation (SBQQ_BillingType_c) dans Salesforce est défini sur « Arrears », le connecteur crée un tarif à la consommation ou à l’utilisation.
• Tarifs sous forme décimale : si la valeur décimale de votre tarif comporte plus de 12 décimales, le connecteur 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)

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, le connecteur mappe les données à partir des objets Salesforce suivants :

• OrderLine : si les données OrderLine diffèrent de l’objet PricebookEntry correspondant, le connecteur 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, le connecteur 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.

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.

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.

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 du connecteur :

• 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 avez la possibilité de personnaliser le tarif unitaire d’un produit sur un devis. Dans ce cas, les informations du tarif associé et du produit figurant sur la commande activée seront différentes. Le connecteur 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, le connecteur 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.