--- title: "Troubleshoot ROLLER Connect for Salesforce" slug: "troubleshoot-roller-connect-for-salesforce" description: "Troubleshoot ROLLER Connect for Salesforce with this guide, covering sync issues, record saving, and integration tips for seamless operations." updated: 2026-09-22T18:12:14Z published: 2026-09-22T18:12:14Z canonical: "mysupport.roller.software/troubleshoot-roller-connect-for-salesforce" --- > ## Documentation Index > Fetch the complete documentation index at: https://mysupport.roller.software/llms.txt > Use this file to discover all available pages before exploring further. # Troubleshoot ROLLER Connect for Salesforce If a sync hasn't landed, a record won't save, or something in Salesforce doesn't look right, start here. Each answer tells you what caused it, what to do, and how to check it worked. > [!NOTE] > This guide covers ROLLER Connect for Salesforce, the integration between ROLLER and your Salesforce org, across the **ROLLER Connect – CRM** and **ROLLER Connect – Groups & Events** modules. To learn more, contact your customer success manager or the [support team](/v1/docs/contact-roller-support). > > If you're troubleshooting ROLLER Connect for printing — the app that connects receipt printers and hardware to ROLLER POS — see [ROLLER Connect: Receipt printing troubleshooting](/v1/docs/receipt-printing-troubleshooting-roller-connect) instead. ## Common symptoms Find your symptom, then go to the answer. | Symptom | Go to | | --- | --- | | Salesforce records look out of date | [Salesforce records look out of date (failed sync)](/docs/troubleshoot-roller-connect-for-salesforce#check-whether-a-sync-has-failed) | | A sync failed while I was creating an Opportunity | [A sync failed while I was creating an Opportunity](/docs/troubleshoot-roller-connect-for-salesforce#a-sync-failed-while-creating-an-opportunity) | | A product isn't in the list when I add products to an Opportunity | [Products missing from an Opportunity](/docs/troubleshoot-roller-connect-for-salesforce#products-missing-from-an-opportunity) | | I can't edit a guest, booking or Order record in Salesforce | [A record won't save or edit (locked records)](/docs/troubleshoot-roller-connect-for-salesforce#locked-records) | | A resource block disappeared after I saved it | [A group event block didn't save as expected](/docs/troubleshoot-roller-connect-for-salesforce#group-event-bookings) | | I selected All day but not every hour was reserved | [A group event block didn't save as expected](/docs/troubleshoot-roller-connect-for-salesforce#group-event-bookings) | | The Opportunity doesn't show the resources I just added | [A group event block didn't save as expected](/docs/troubleshoot-roller-connect-for-salesforce#group-event-bookings) | | The line item date didn't change when I moved the block | [Expected behavior](/docs/troubleshoot-roller-connect-for-salesforce#expected-behavior) | | The payment amount doesn't match the event total | [Expected behavior](/docs/troubleshoot-roller-connect-for-salesforce#expected-behavior) | | The booking total shows $0.00 after I reserved dates | [Expected behavior](/docs/troubleshoot-roller-connect-for-salesforce#expected-behavior) | | Some of the dates I wanted weren't available | [Expected behavior](/docs/troubleshoot-roller-connect-for-salesforce#expected-behavior) | | The availability search returned nothing | [Expected behavior](/docs/troubleshoot-roller-connect-for-salesforce#expected-behavior) | ## Salesforce records look out of date (failed sync) Start here whenever Salesforce records look stale. The **ROLLER Setup** page shows sync health for every connected venue. From Salesforce: 1. Open the **App Launcher**. 2. Search for **ROLLER**. 3. Select the **ROLLER Connect – Venue Setup** app. It opens on the **ROLLER Setup** tab. ![Confirms you've opened the right page in Salesforce, with the ROLLER Setup tab and venue connections in view.](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(37).png) A Salesforce permission controls who can open this page. Where you can't see it, contact your Salesforce administrator. The page reports failures in two places: - The **header row** carries the total failed events across all your connected venues. - The **Venue connections** table carries a **Status** for each venue — **Ready** where it's current, a count such as **2 webhooks failed**, or a message such as **Bulk export callback timeout**. ![Shows where failed event counts and each venue's Status appear, so you can tell whether a sync has failed.](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(36).png) ### How do I retry a failed sync? On the **ROLLER Setup** page, select **Reprocess** in the header row. This queues every failed event across all your venues at once rather than one venue at a time, and the page confirms how many were queued. **Reprocess** is unavailable when the failed count is zero. ![Locates the Reprocess control used to queue failed events again, and the confirmation of how many were queued.](https://cdn.us.document360.io/23700755-951c-4b69-8afe-ec8b33c6c689/Images/Documentation/image(38).png) To confirm it's fixed, check that the failed count in the header row returns to zero and each venue's **Status** reads **Ready**. Where the failed count doesn't clear after reprocessing, see [When to contact ROLLER support](/docs/troubleshoot-roller-connect-for-salesforce#escalate-to-support). ### A sync failed while I was creating an Opportunity When a sync fails as you create an Opportunity, it's flagged on the **ROLLER Sync Status** field on the record rather than in the failed event count on the **ROLLER Setup** page. Open the Opportunity and check **ROLLER Sync Status** to see what failed. To confirm it's fixed, check that **ROLLER Sync Status** no longer reports a failure on the record. Where it doesn't clear, see [When to contact ROLLER support](/docs/troubleshoot-roller-connect-for-salesforce#escalate-to-support). ## Products missing from an Opportunity ### Why aren't my products showing when I add them to an Opportunity? Products sync from ROLLER to Salesforce, but they're not added to your Salesforce **Price Book** automatically. A product that isn't in the Price Book won't appear when you add products to an Opportunity. Add the missing products to your Price Book manually, or in bulk using the product sync tool in Salesforce. To confirm it's fixed, open the Opportunity, select **Add Products**, and check that the product now appears in the list. To learn more, see [Sync ROLLER guest and booking data to Salesforce](/v1/docs/sync-roller-guest-and-booking-data-to-salesforce). ## A record won't save or edit (locked records) ROLLER owns guest and booking data, and it flows one way into Salesforce. Records are locked in Salesforce to stop the two systems disagreeing, so the change almost always needs to be made in the system that owns it. ### Why can't I edit a synced record in Salesforce? Synced records are locked to prevent conflicts. Make the change in ROLLER and it flows through to Salesforce. To confirm, refresh the Salesforce record and check that the updated value appears. ### Why can't I edit the Order after Closed Won? Orders are read-only by design, so booking data stays clean. To change a confirmed event, edit the Opportunity rather than the Order. To confirm, check that the Order reflects the change you made on the Opportunity. ### Why is the standalone Reservations Calendar read-only? The standalone tab is a cross-venue reference view for browsing availability. Create and edit bookings from the **Reservations Calendar** on an Opportunity. ## A group event block didn't save as expected ### My resource block failed to save. What happened? The calendar releases the reservation it created, usually because ROLLER rejected the request when the resource was no longer available. 1. Check the error message at the top of the calendar. 2. Try again with a different resource or time slot. To confirm it's fixed, refresh the page and check that the block appears on the calendar. ### Why weren't all hours reserved when I selected All day? Only the hours visible on the calendar are reserved. Where you take bookings outside your normal operating hours, those hours need to be visible before you place the block. 1. Select the settings icon (gear) in the calendar header. 2. Set **Calendar Start and End Time** to cover the hours you take bookings. 3. Place the block again. To confirm it's fixed, check that the saved block spans the full range you selected. To learn more, see [Manage group event sales in Salesforce](/v1/docs/manage-group-event-sales-in-salesforce). ### Why doesn't my Opportunity show the resources I just added? The page doesn't refresh automatically after you add or edit resource blocks. Refresh the page. To confirm, check that **Event Start Date** and **Event End Date** show the dates you selected, and that the calendar shows the block. ## Expected behavior These look like problems and aren't. ### Why hasn't the line item date changed after I moved the block dates? That's expected. **Event Start Date** and **Event End Date** on the Opportunity update when you change a resource block's dates, but the date on the **Opportunity Line Item** doesn't. ### Why doesn't the payment amount match the event total? The amount shown at payment is before card fees. Once the payment goes through, the fees populate the **Fees** field and **ROLLER Total (inc. Tax)** updates. To confirm, check **Fees** and **ROLLER Total (inc. Tax)** on the Opportunity after the payment completes. ### Why does the booking total show $0.00? That's expected where you've reserved dates but haven't yet added the product the guest is paying for. The products that hold the resources carry no value of their own, so the total stays at $0.00 until you add the one that charges for the dates. To learn more, see [Reserve a resource across multiple days in Salesforce](/v1/docs/reserve-a-resource-across-multiple-days-in-salesforce). ### Some of my dates aren't available. Can I reserve the rest? Not in the same search. Narrow the date range or deselect the days that fell short, select **Check Availability** again, then reserve the dates that are free. To learn more, see [Reserve a resource across multiple days in Salesforce](/v1/docs/reserve-a-resource-across-multiple-days-in-salesforce). ### Nothing came back available. Is the search broken? No. Where the summary reads 0 fully available, every date you asked for is taken at those times for that many resources. Lower **Resources Needed**, move the times, or choose different days, then select **Check Availability** again. To learn more, see [Reserve a resource across multiple days in Salesforce](/v1/docs/reserve-a-resource-across-multiple-days-in-salesforce). ## When to contact ROLLER support Contact your customer success manager or the [support team](/v1/docs/contact-roller-support) where: - The failed event count doesn't clear after you reprocess. - Data isn't syncing and the ROLLER Setup page shows no failures. - You see unexpected behavior in the integration that isn't covered above. > [!NOTE] > When you contact support, include the venue name, the **Status** message shown in the **Venue connections** table on the **ROLLER Setup** page (see [Salesforce records look out of date](/docs/troubleshoot-roller-connect-for-salesforce#check-whether-a-sync-has-failed) for how to open it), and roughly when you last saw correct data in Salesforce. That's what support needs to trace the failed events. Salesforce itself is outside ROLLER's support scope. Configuration, user permissions, page layouts, custom fields and anything else not related to the integration go to your Salesforce administrator or Salesforce support. Where you're not sure which side the problem sits on, contact the [support team](/v1/docs/contact-roller-support) and they'll help identify it. ## Related - [Get started with ROLLER Connect for Salesforce (on request)](/get-started-with-roller-connect-for-salesforce.md) - [Sync ROLLER guest and booking data to Salesforce (on request)](/sync-roller-guest-and-booking-data-to-salesforce.md) - [Manage group event sales in Salesforce (on request)](/manage-group-event-sales-in-salesforce.md) - [How data flows between ROLLER and Salesforce](/how-data-flows-between-roller-and-salesforce.md) - [ROLLER Connect for Salesforce FAQs](/roller-connect-for-salesforce-faqs.md)