How do I resolve Salesforce sync issues for API-created invoices?

Problem Statement

Some invoices in Chargebee do not sync to Salesforce even when they are created and paid successfully in Chargebee. This often happens when the Salesforce product linked to the Chargebee item is not fully mapped (for example, missing values in CB_item_family or Product_type).

Solution

Ensure the Salesforce product for the Chargebee item is fully mapped. Missing values in CB_item_family or Product_type prevent Chargebee from syncing item prices, subscriptions, and invoices to Salesforce. After you update the mapping, re-sync the related records.

Configuration Steps

1. In Salesforce, open the product associated with the item that is not syncing.
2. Find the fields CB_item_family and Product_type.
3. Enter values that match the item configuration in Chargebee.
4. Save the product record.
5. In Chargebee, re-sync the related item prices, subscriptions, and invoices.

Additional Information

• Products with the same product code must have correct Chargebee mappings in Salesforce.
• If the product exists in Salesforce but is unmapped, newly created invoices will not sync.
• After the mapping fields are updated, associated invoice and subscription syncs should work as expected.