Gestion des erreurs

Découvrez comment gérer les erreurs lors de la synchronisation des enregistrements Salesforce à l'aide du connecteur.

Si vous rencontrez des erreurs lors de l’utilisation du Stripe Billing Connector for Salesforce CPQ, utilisez la liste suivante pour identifier et résoudre les erreurs. Dans la plupart des cas, vous devez modifier les données de l’enregistrement Salesforce et resynchroniser manuellement l’enregistrement pour réparer l’erreur.

Erreurs de données

Le tableau ci-dessous répertorie les erreurs que vous pouvez rencontrer lors de la synchronisation des commandes Salesforce et la manière de les résoudre.

Erreur	Description	Recommandation
Valeur de champ non prise en charge pour `days_until_due`.	La valeur du champ mappé pour `days_until_due` doit être un nombre entier ou une valeur `CPQ Payment Term` prise en charge.	Remplacez la valeur du champ mappé pour `days_until_due` par un nombre entier ou une valeur `CPQ Payment Term` prise en charge (par exemple, Net-15, Net-30, Net-45, Net-60 ou Net-90).
Les mappages requis étaient vides pour l’objet Stripe.	Le connecteur requiert des champs spécifiques sur la commande et les postes de la commande.	Accédez à l’application Stripe Billing dans Salesforce et ouvrez le mappeur de données. Assurez-vous que tous les champs obligatoires sous `Subscription Schedule`, `Subscription Item` et `Price Order Item` sont définis.
La ligne de commande a été supprimée ou n’a pas été activée.	Les champs du poste de commande indiquent qu’il a été supprimé ou qu’il n’est pas activé.	Vérifiez que tous les postes de la commande sont activés et non supprimés.
Le connecteur a tenté de synchroniser la demande de modification lorsque la demande initiale a été ignorée, car elle ne correspondait pas aux filtres de synchronisation personnalisés.	Vous pouvez spécifier des filtres de demande personnalisés dans l’application Stripe Billing dans Salesforce. Ces filtres déterminent s’il faut ou non synchroniser la demande Salesforce.	Vous ne pouvez pas synchroniser les demandes de modification Salesforce avant d’avoir synchronisé la demande Salesforce initiale correspondante. Cette erreur indique que la demande Salesforce initiale n’a pas pu être synchronisée, car elle n’a pas satisfait les critères de filtre de demande, même si la demande de modification Salesforce a abouti.

Erreurs de modification

Le tableau ci-dessous répertorie les erreurs liées aux demandes de modification et vous explique comment les résoudre.

Erreur	Description	Recommandation
Les demandes de modification doivent prendre fin en même temps que la demande initiale.	La demande de modification Salesforce doit se terminer à la même date que la demande Salesforce initiale.	Mettez à jour la demande de modification Salesforce de façon à ce que la date de fin coïncide avec la demande initiale. Cela se produit généralement lorsque vous mettez à jour la durée de l’abonnement.
L’abonnement Stripe pour la commande permanente a déjà été annulé et ne peut pas être modifié.	Le connecteur a synchronisé une demande de modification Salesforce permanente qui tente de modifier un abonnement Stripe annulé.	La demande de modification Salesforce ne peut pas être synchronisée.
La planification d’abonnement Stripe a déjà été annulée et ne peut pas être modifiée.	Le connecteur a synchronisé une demande de modification Salesforce qui tente de modifier une planification d’abonnement Stripe annulée.	La demande de modification Salesforce ne peut pas être synchronisée.
Les demandes de modifications doivent débuter le même jour du mois que la demande initiale. Activez la fonctionnalité pour les modifications hors anniversaires afin de synchroniser les modifications n’importe quel jour du mois.	La demande de modification Salesforce débute un autre jour du mois que la demande initiale.	Mettez à jour la demande de modification Salesforce de façon à ce qu’elle débute le même jour du mois que la demande Salesforce initiale, ou contactez le service d’assistance pour activer les modifications hors anniversaire sur votre compte.
La durée de l’abonnement de la demande de modification ne correspond pas à un nombre de mois entiers entre la date de début et la date de fin.	Cela se produit lorsqu’une modification hors anniversaire est synchronisée et que la durée d’abonnement du devis est inattendue.	Modifiez la durée de l’abonnement pour la demande de modification Salesforce afin qu’elle corresponde à un nombre de mois entiers compris entre la date de début et la date de fin de la demande Salesforce.
Impossible de trouver la planification d’abonnement Stripe correspondante pour la demande de modification.	Une demande de modification Salesforce modifie une demande Salesforce initiale précédemment synchronisée. Cette erreur indique que la planification d’abonnement Stripe correspondante qui a été créée lors de la synchronisation de la demande Salesforce initiale est introuvable, car elle a été supprimée.	La demande de modification Salesforce ne peut pas être synchronisée.
Les demandes de modification au prorata du back-end ne sont pas prises en charge.	Une demande de modification Salesforce modifie une demande initiale qui a été calculée au prorata du back-end, mais dont les dates de début ne correspondent pas.	Le connecteur ne prend pas en charge ce cas d’usage. Contactez le service d’assistance pour les prochaines étapes.

Erreurs de devis

Le tableau ci-dessous répertorie les erreurs liées aux devis CPQ et vous explique comment les résoudre.

Erreur	Description	Recommandation
Aucun devis CPQ n’est associé à la commande Salesforce. Les commandes transmises à Stripe doivent être associées à un devis CPQ.	Toutes les commandes Salesforce nécessitent un devis CPQ correspondant. Cette erreur indique que le connecteur n’a pas pu trouver de devis correspondant.	Générez à nouveau la commande Salesforce à partir d’un devis Salesforce CPQ.
Impossible de trouver le devis Salesforce CPQ initial associé à la modification de commande.	Toutes les commandes Salesforce synchronisées par le connecteur doivent être associées à un devis Salesforce CPQ.	Générez à nouveau la commande Salesforce à partir d’un devis Salesforce CPQ.
Vous ne pouvez pas spécifier la durée de l’abonnement sous forme de valeur décimale.	La durée de l’abonnement correspond à la durée du contrat en nombre de mois. Elle ne peut pas être une valeur décimale.	Remplacez la durée de l’abonnement mappée par un nombre entier.
La fréquence de facturation n’est pas une option `CPQ Billing Frequency` prise en charge.	CPQ prend en charge les valeurs Mensuel, Trimestriel, Semestriel et Annuel pour le champ `SBQQ__BillingFrequency__c`.	Définissez la valeur du champ `CPQ Billing Frequency` sur `Monthly`, `Quarterly`, `Semiannual` ou `Annual`.

Erreurs tarifaires

Le tableau ci-dessous répertorie les erreurs liées aux tarifs et vous explique comment les résoudre.

Erreur	Description	Recommandation
Un tarif Stripe correspondant au tarif Salesforce a été trouvé, mais les données tarifaires ont été modifiées.	L’entrée du catalogue de prix de Salesforce associée au poste de commande a déjà été synchronisée et les données tarifaires Stripe correspondantes ont été modifiées.	Effacez l’ID Stripe de l’entrée du catalogue de prix de Salesforce et resynchronisez la commande Salesforce. Il en résulte un nouveau tarif Stripe pour l’entrée du catalogue de prix.
Plusieurs planifications de consommation sont liées à un catalogue de prix, mais il ne peut y avoir qu’une seule planification.	Le connecteur a trouvé plusieurs planifications de consommation liées à un catalogue de prix, alors qu’il ne peut y en avoir qu’une.	Supprimez l’une des planifications de consommation associées à l’entrée du catalogue de prix.
La durée de l’abonnement ne peut pas être une valeur décimale.	La durée de l’abonnement correspond à la durée du contrat en nombre de mois. Elle ne peut pas être une valeur décimale.	Remplacez la durée d’abonnement par un nombre entier.
Vous avez indiqué une valeur décimale pour la limite du niveau supérieur, mais les limites des niveaux de consommation doivent être des nombres entiers.	Le connecteur a trouvé une valeur décimale pour la limite supérieure du taux de consommation de Salesforce.	Remplacez la valeur du niveau de consommation de Salesforce par un nombre entier.
La méthode de tarification basée sur le taux de consommation n’est pas prise en charge.	Le champ `SBQQ__PricingMethod__c` accepte les valeurs `PerUnit` ou `FlatFee`.	Définissez la valeur du champ `SBQQ__PricingMethod__c` sur `PerUnit` ou `FlatFee`.
Le type de planification de la consommation n’est pas pris en charge.	Le champ`Consumption Schedule Type` accepte les valeurs `Range` ou `Slab`.	Définissez le champ `Consumption Schedule Type` sur `Range` ou `Slab`.
Le champ `unit_amount_decimal` ne peut pas être vide pour les objets de tarif Stripe.	Le connecteur a trouvé une valeur vide pour la valeur Salesforce mappée, et les tarifs ne peuvent être vides.	Remplacez la valeur Salesforce mappée par un nombre entier positif.
Valeur de `billing_scheme` inattendue sur le tarif Stripe.	Le plan de facturation n’est pas défini sur une valeur valide.	Définissez le système de facturation sur `per_unit` ou `tiered`.
La période de tarification n’est pas prise en charge.	La période de tarification n’est pas définie sur une valeur valide.	Définissez l’intervalle de tarification sur `Month` ou `Year`.

Erreurs de produit

Le tableau ci-dessous répertorie les erreurs liées aux produits Salesforce et explique comment les résoudre.

Erreur	Description	Recommandation
Le type de facturation du produit n’est pas une option `CPQ Product Billing Type` prise en charge.	Le type de facturation du produit (`SBQQ__BillingType__c`) peut être défini sur `Advance` ou `Arrears`.	Définissez le champ `SBQQ__BillingType__c` du produit sur `Advance` ou `Arrears`.
L’ajout de produits Salesforce renouvelables aux commandes permanentes n’est pas pris en charge.	Les produits Salesforce CPQ peuvent être renouvelables ou permanents.	Le connecteur ne prend pas en charge les deux types de produits dans une même commande Salesforce. Pour synchroniser la commande Salesforce, vous devez supprimer l’un des postes de la commande.

Erreurs de résiliation

Le tableau ci-dessous répertorie les erreurs liées aux demandes de résiliation et vous explique comment les résoudre.

Erreur	Description	Recommandation
Une demande de résiliation est en cours de traitement, mais d’autres modifications sont en attente.	Le connecteur traite une demande de résiliation qui annule la planification de l’abonnement, mais il reste d’autres demandes de modification à traiter.	Pour résilier une commande Salesforce, vous devez supprimer ou désactiver toute demande de modification activée après la résiliation. Afin de modifier une commande Salesforce avant de la résilier, supprimez ou désactivez la commande Salesforce résiliée pour que la demande de modification soit traitée, puis synchronisez la commande Salesforce résiliée.
La quantité de la résiliation est supérieure à la quantité globale du poste de commande.	Vous tentez de réduire la quantité d’un poste de commande d’une quantité supérieure à la quantité existante, ce qui entraîne une quantité négative.	Définissez la quantité du poste de commande sur zéro ou plus.