Skip to content
Log in

▶️ Find and resolve sync errors

On this page

Step 1: Where to find sync errors

  1. In the StoreConnect Console, click the Setup button in the header actions bar.

  2. Under Synchronization, click Manage sync errors.

  3. This opens the Sync Error Tool, which shows any current synchronisation 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 the Sync Error Tool.

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 the Sync Error Tool (Setup > Synchronization > Manage sync errors).

  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.

Was this article helpful?

Was this article helpful?