Commandes d'abonnement

Pour comprendre la synchronisation de vos commandes d'abonnement entre Salesforce et Stripe.

Le connecteur Stripe Billing pour Salesforce CPQ crée une planification d’abonnement dans Stripe pour chaque commande activée dans Salesforce ayant un type d’abonnement défini. Dans une commande Salesforce, chaque ligne de commande crée un poste d’abonnement (pour un produit récurrent) ou un poste de facture dans Stripe. Les lignes de commande ne peuvent pas être fractionnées en plusieurs postes dans Stripe.

Par défaut, chaque planification d’abonnement dans Stripe n’est pas automatiquement renouvelée. Pour renouveler un abonnement, effectuez l’une des actions suivantes :

Créez une modification de commande avec une nouvelle date de début et un nouvelle durée d’abonnement.
Configurez votre intégration de façon à renouveler automatiquement tous les abonnements.

Remarque

L’objet de devis « natif » - distinct de l’objet de CPQ Quote - n’est pas utilisé dans Salesforce. Le connecteur utilise les commandes générées à partir de l’objet CPQ Quote.

Déterminer les commandes à synchroniser

Toutes les 90 secondes, le connecteur recherche dans Salesforce les commandes mises à jour depuis la dernière synchronisation réussie.

Le connecteur tente de synchroniser toutes les commandes qui remplissent les conditions suivantes :

L’état de la commande est défini sur « activated ». Vous pouvez supprimer ou personnaliser cette condition par défaut.
Le type de la commande est défini sur « new ».
Au moins une des lignes de commande est un produit d’abonnement. Cela signifie qu’elle est définie sur SBQQ_SubscriptionType_c.

Si toutes les lignes de commande correspondent à des achats ponctuels, le connecteur crée une facture ponctuelle plutôt qu’un abonnement.

Dates de commande

Lorsque vous configurez le connecteur, vous pouvez choisir une date de remplissage pour les commandes. Seules les commandes créées après cette date sont synchronisées avec Stripe.

Vous pouvez antidater les dates de début d’abonnement, c’est-à-dire la date de début de commande utilisée dans Stripe. Pour éviter les erreurs lors de l’activation de la commande, vous devez fournir une date de début sur le devis et la commande associée.

Vous pouvez éventuellement indiquer une date de fin de période d’essai. Si vous ne le faites pas, le client ne bénéficiera pas d’une période d’essai.

Conditions de synchronisation des commandes

Vous pouvez ajouter des conditions personnalisées aux conditions de synchronisation par défaut. Ces conditions sont décrites à l’aide de la syntaxe SOQL standard.

Pour ajouter des conditions personnalisées ou supprimer des conditions par défaut, accédez à **Configuration de Stripe Billing ** > Préférences de synchronisation > Conditions de synchronisation de commande personnalisées.

Limites

Le connecteur ne peut pas synchroniser les commandes comportant plus de 100 postes récurrents. Une erreur apparaît dans Salesforce si une commande comporte plus de 100 lignes récurrentes.

Vous devez spécifier les quantités sous la forme d’un nombre entier dans Salesforce. Stripe n’accepte pas les valeurs à décimale. Une erreur s’affiche dans Salesforce si une commande comporte une quantité à décimale.

Tous les postes d’une commande doivent posséder le même nombre et type de périodes. Par défaut, le nombre de périodes est mappé à partir du champ Billing Frequency. Le type de période est soit quotidien, soit mensuel. Stripe ne vous permet pas de définir plusieurs fréquences de facturation pour une même commande. En d’autres termes, vous ne pouvez pas facturer l’un des postes d’une commande tous les deux mois et un autre tous les mois.

Exclure des postes de facture

Par défaut, tous les postes (y compris les postes dont la valeur est nulle) sont synchronisés de Salesforce vers Stripe. Vous pouvez choisir d’exclure certains postes de la planification d’abonnement créée dans Stripe. Par exemple, les postes donnés uniquement à titre informatif peuvent être exclus si vous ne souhaitez pas qu’ils apparaissent sur la facture récurrente dans Stripe.

Pour exclure des postes de facture, définissez le champ Skip Line Item in Stripe sur true.

Lorsque ce champ est défini sur true, le connecteur ignore le poste de commande et celui-ci est exclu des postes de la phase de planification d’abonnement dans Stripe. Le nom du champ interne est Skip_Line_Item__c (le préfixe du package compris).

Mappage de planifications d’abonnement

Une commande activée dans Salesforce entraîne la création d’une planification d’abonnement dans Stripe. Les champs sont mappés comme suit.

Champ de la commande Salesforce	Champ de la planification d’abonnement Stripe	Notes
Quote, Start date (`SBQQ_StartDate_c`)	Start date
Quote, Subscription term	Phases, Iterations
	End behavior	La valeur par défaut est définie sur `cancel`. Si vous souhaitez que l’abonnement se renouvelle automatiquement, vous pouvez configurer ce mappage dans l’outil de mappage des données.
Payment term (`SBQQ_PaymentTerm_c`)	Paramètres par défaut, Invoice_settings, Days until due

Mappage des postes de facture

Chaque poste d’une commande activée dans Salesforce est mappée comme suit. Ces champs sont obligatoires.

Si le tarif unitaire d’un poste de commande est différent du tarif unitaire du catalogue, le connecteur utilise le tarif du poste de commande et crée un nouveau tarif Stripe.

Champ Salesforce (objet OrderItem)	Champ du poste Stripe	Notes
Pricebook Entry, UnitPrice	Price	Le tarif Stripe contient le montant unitaire exact indiqué dans le poste du catalogue de prix. Si vous utilisez un champ personnalisé pour représenter le tarif récurrent facturé au client, vous pouvez configurer ce mappage.
OrderItem, UnitPrice	Price	Le tarif Stripe contient le montant unitaire exact indiqué sur le poste de commande. Si vous utilisez un champ personnalisé pour représenter le tarif récurrent facturé au client, vous pouvez configurer ce mappage.
Quantity (`OrderItem.SBQQ_OrderedQuantity_c`)	Quantity	Vous devez spécifier la quantité sous la forme d’un nombre entier. Sinon, la quantité est définie sur `1` par défaut et le tarif est ajusté pour correspondre au montant net du coût du poste. Si le type de facturation est `arrears` (facturation à la consommation), la quantité n’est pas définie sur le poste. À la place, vous devez déclarer la quantité à Stripe avant la fin de la période de facturation du client.

Modifications d’abonnements

Vous ne pouvez pas modifier une commande activée dans Salesforce. Les modifications que vous apportez à une commande dans Salesforce ne sont pas synchronisées avec Stripe. Pour modifier ou annuler partiellement un abonnement en cours de cycle, vous pouvez utiliser une modification de commande.

Par défaut, les planifications d’abonnement ne sont pas renouvelées automatiquement. Pour mettre à jour les informations de renouvellement, créez une modification de commande associée au contrat d’origine.

Vous pouvez également choisir de renouveler automatiquement cette fonctionnalité par défaut, ou gérer la logique de renouvellement directement dans Stripe.