▶️ Find and resolve sync errors

Step 1: Where to Find Sync Errors

  1. In the StoreConnect app in Salesforce, scroll down and open StoreConnect Sync at the bottom of the navigation menu.

  2. This will show you any current synchronization errors.

    • You can also access this via the App Launcher by searching for Sync Errors.

Step 2: Simulating an Example Error (for learning purposes)

To simulate a sync error:

  1. Go to Object Manager in Salesforce setup.

  2. Edit the Order object.

  3. Add a new custom field (e.g., text field).

  4. Set this field as Required.

  5. Leave it hidden from the page layout so it can't be filled in during a normal order.

Now when you place a test order through your website:

  • The sync will fail due to the missing required field.

  • A new sync error will appear in StoreConnect Sync.


Step 3: Review the Sync Error Details

  1. Open the sync error record from the list.

  2. Use the dropdown arrow → select Wrap Text to view the full error message.

  3. Click the Information icon next to the error for a suggested fix.

In our example, the message might say: “Required field 'Let’s create trouble__c' not populated.”


Step 4: Fix the Underlying Issue

You have several options to resolve the problem:

  • Remove the “Required” status from the problematic field.

  • Assign a default value so it’s always filled in automatically.

  • Manually update the affected records to include valid values.

In our scenario:

  • Go back to Setup → Object Manager → Order → Fields.

  • Edit the custom field.

  • Deselect "Required" or add a default value.

  • Click Save.


Step 5: Resync the Error Records

  1. Return to StoreConnect Sync.

  2. Select all the errored records.

  3. Click the Resync button.

If the issue is resolved, the records will now sync successfully. Your sync error list should now be empty.


Step 6: Confirm Successful Synchronization

  • Refresh the orders list view or relevant object list.

  • Verify that the previously failing records are now fully synced and visible.