Error handling
Beta

Learn how to handle errors when syncing Salesforce records using the connector.

If you encounter errors when syncing records from Salesforce into Stripe, use the following list to identify and resolve the errors. In most cases, you must modify the Salesforce record data and manually resync the record to recover from the error.

Data errors

The table below contains the errors you might encounter when syncing Salesforce orders and how to resolve them.

Error	Description	Recommendation
Unsupported field value for `days_until_due`.	The mapped field value for `days_until_due` must be an integer or supported CPQ Payment Term value.	Update the mapped field value for `days_until_due` with an integer or a supported CPQ Payment Term value (for example, Net-15, Net-30, Net-45, Net-60, or Net-90).
Required mappings were empty for the Stripe object.	Connector requires specific fields on the Order and Order Items.	Navigate to the Stripe Billing app in Salesforce and open the Data Mapper. Make sure all required fields under Subscription Schedule, Subscription Item, and Price Order Item are set.
The order line is deleted or not activated.	The order item’s fields indicate that it was deleted or not activated.	Verify that all order items are activated and not deleted.
The connector attempted to sync the amendment order when the initial order was skipped, because it didn’t match custom sync filters.	You can specify custom order filters in the Stripe Billing app in Salesforce. These filters determine whether or not to sync the Salesforce order.	You can’t sync amendment Salesforce orders before syncing the corresponding initial Salesforce order. This error indicates that the initial Salesforce order failed to sync because it didn’t pass the order filter criteria, even though the amendment Salesforce order passed.

Amendment errors

The table below contains the errors related to amendment orders and how to resolve them.

Error	Description	Recommendation
Order amendments must coterminate with the initial order.	The Salesforce amendment order must end on the same date as the initial Salesforce order.	Update the Salesforce order amendment so that the end date coterminates with the initial order. This likely occurs when you update the subscription term.
The Stripe subscription for the evergreen order has already been cancelled and can’t be modified.	The CPQ connector synced an evergreen Salesforce amendment order that’s attempting to amend a cancelled Stripe subscription.	The Salesforce amendment order can’t and won’t be synced.
The Stripe subscription schedule has already been cancelled and can’t be modified.	The CPQ connector synced a Salesforce amendment order that’s attempting to amend a cancelled Stripe subscription schedule.	The Salesforce amendment order can’t and won’t be synced.
Amendment orders must start on the same day of the month as the initial order. Enable the feature for non-anniversary amendments to sync amendments on any day of the month.	The Salesforce amendment order starts on a different day of the month than the initial order.	Update the Salesforce amendment order to start on the same day of the month as the initial Salesforce order, or contact support to enable non-anniversary amendments in your account.
The amendment order subscription term doesn’t equal a number of whole months between the start and end date.	This occurs when a non-anniversary amendment is synced and the subscription term for the quote is unexpected.	Update the subscription term for the Salesforce amendment order to be a number of whole months between the start and end date of the Salesforce order.
Unable to find the corresponding Stripe subscription schedule for the amendment order.	An amendment Salesforce order modifies an initial Salesforce order that was previously synced. This error indicates that the corresponding Stripe subscription schedule that was created when the initial Salesforce order was synced can’t be found because it was deleted.	The Salesforce amendment order can’t and won’t be synced.
The backend prorated order amendment case isn’t supported.	A Salesforce amendment order modifies an initial order that was backend prorated, but the start dates don’t align.	The connector doesn’t support this use case. Contact support for next steps.

Quote errors

The table below contains the errors related to CPQ quotes and how to resolve them.

Error	Description	Recommendation
There’s no CPQ quote associated with the Salesforce order. Orders pushed to Stripe must have a related CPQ quote.	All Salesforce orders need a corresponding CPQ quote. This error indicates that the connector couldn’t find a corresponding quote.	Regenerate the Salesforce order from a Salesforce CPQ quote.
Unable to find the initial Salesforce CPQ quote associated with the order amendment.	All Salesforce orders that are synced through the connector need an associated Salesforce CPQ quote.	Regenerate the Salesforce order from a Salesforce CPQ quote.
You can’t specify the subscription term as a decimal value.	The subscription term represents the contract duration in number of months. This value can’t be a decimal.	Update the mapped subscription term with a whole number.
Billing frequency isn’t a supported CPQ Billing Frequency option.	CPQ supports Monthly, Quarterly, Semiannual, and Annual as values for the `SBQQ__BillingFrequency__c` field.	Update the CPQ Billing Frequency field value to Monthly, Quarterly, Semiannual, or Annual.

Price errors

The table below contains the errors related to prices and how to resolve them.

Error	Description	Recommendation
Found a corresponding Stripe price for the Salesforce price, but the price data has changed.	The Salesforce pricebook entry that’s linked to the order item was previously synced, and the corresponding Stripe price data has changed.	Clear the Stripe ID from the Salesforce pricebook entry and resync the Salesforce order. This results in a newly created Stripe price for the pricebook entry.
More than one consumption schedule is linked to a pricebook, but there can only be one.	The connector found more than one consumption schedule linked to a pricebook, when there can only be one.	Delete one of the consumption schedules attached to the pricebook entry so there’s only one.
The subscription term can’t be a decimal value.	The subscription term represents the contract duration in number of months. This value can’t be a decimal.	Update the mapped subscription term to a whole number.
A decimal value was provided for the upper tier bound, but consumption rate tier bounds must be integers.	The connector found a decimal value for the upper tier bound of the Salesforce consumption rate.	Update the tier bound for the Salesforce consumption rate to an integer.
The pricing method on the consumption rate isn’t supported.	The `SBQQ__PricingMethod__c` field can be either PerUnit or FlatFee.	Update the `SBQQ__PricingMethod__c` field value to either PerUnit or FlatFee.
The consumption schedule type isn’t supported.	The Consumption Schedule Type field can be either Range or Slab.	Update the Consumption Schedule Type to either Range or Slab.
The `unit_amount_decimal` field can’t be empty for Stripe price objects.	The connector found an empty value for the mapped Salesforce value, and prices can’t be empty.	Update the the mapped Salesforce value to a positive integer.
Unexpected billing_scheme value on Stripe price.	The billing scheme isn’t set to a valid value.	The billing scheme can be either per_unit or tiered.
The pricing interval isn’t supported.	The pricing interval isn’t set to a valid value.	The connector supports Month and Year as values for the pricing interval.

Product errors

The table below contains the errors related to Salesforce products and how to resolve them.

Error	Description	Recommendation
Product billing type isn’t a supported CPQ Product Billing Type option.	The product billing type (`SBQQ__BillingType__c`) can be either Advance or Arrears.	Update the product’s `SBQQ__BillingType__c` field to one of the supported values: Advance or Arrears.
Adding Salesforce products with a ‘Renewable’ type to evergreen orders isn’t supported.	Salesforce CPQ products can be either Renewable or Evergreen.	The connector doesn’t support both product types in a single Salesforce order. To sync the Salesforce order, you must remove one of the order items.

Termination errors

The table below contains the errors related to termination orders and how to resolve them.

Error	Description	Recommendation
A termination order is processing, but more amendments are queued.	The connector is processing a termination order that will cancel the subscription schedule, but there are more amendment orders to process.	To terminate a Salesforce order, you must delete or deactivate any amendment orders that are activated after the termination order. If you want to amend a Salesforce order before terminating it, delete or deactivate the termination Salesforce order so the amendment order is processed and then sync the termination Salesforce order.
Termination quantity is greater than the aggregate quantity for the order item.	You’re attempting to reduce an order item’s quantity by more than the existing quantity, resulting in a negative quantity.	Update the order item quantity to zero or more.

Error handlingBeta