Sync status values
Use the Opportunity Product Sync Status field on a quote to understand the current state and outcome of the sync process between Salesforce and Zuora Billing.
The following values appear on the Opportunity Product Sync Status field on Quote:
| Status | Meaning |
|---|---|
| Not Started | Sync has never been run for this quote. |
| Queued | Sync is queued and will run shortly. |
| Sync Pending | Sync is currently running. |
| Completed | The last sync completed successfully. |
| Failed | The last sync failed. Review Opportunity Product Sync Error on the quote to identify the root cause. |
| Waiting for Charge Segments | Charge Segments do not yet exist. Run Order Preview on the quote, verify Charge Segments exist, then retry sync. |
| Blocked – Sent to Billing | The quote has been sent to Zuora Billing. This is expected behavior. Sync is blocked after billing submission to prevent data divergence. |
If sync fails with a field-level security or permission error, the user likely lacks Create/Edit or FLS on Opportunity Products or mapped fields. Grant the required object and field-level access via Profile or Permission Set.
If duplicate sync runs appear to occur, the system automatically deduplicates requests. This behavior is expected and safe.