Source: https://vaultcrmhelp.veeva.com/doc/Content/CRM_topics/Getting_Started/MobileDeviceSetup/Sync/HandlingSyncErrors.htm

## Handling Sync Errors

Sync errors prevent users from syncing their devices and can occur in a variety of ways. When encountering a sync error, it is important to identify the cause and make the appropriate correction.

When users encounter a sync error, a modal displays informing them a sync error occurred. After selecting OK, the Errors tab displays. This lists an error for each record causing the greater sync error, along with an action list to correct the error.

Some sync errors cannot be fixed and must be cleared.

Common sync errors include:

* Insufficient object or field permissions
* Loss of visibility to a field, record, or object due to territory or field permission updates
* Inability to merge updates from a mobile device with updates from Vault
* Inability to delete a record due to object permission updates
* Any object which can be locked to prevent further updates
* Call backdate limits

**Who can use this feature?**

* Business Admin Users (Browser)
* [Use undo and undelete in the errors tab](#ErrorsTab)
* End Users (iPad)
* [Clear client sync errors](#ClearClientSyncErrors)
* [Use forced full refresh](#ForcedFullRefresh)
* [Send sync files to Veeva](#Sending)
* Users do not require an additional license

### Configuring Sync Error Handling for

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users](#)

Business admin users can handle sync errors by clearing client sync errors, forcing a full refresh, or sending sync files to Veeva for further review.

#### Configuring Clear Client Sync Errors

To configure this feature, grant business admin users Edit permission to the **clear\_client\_sync\_errors\_\_v** field on the user\_\_sys object.

#### Configuring Forced Full Refresh

To configure this feature:

1. Navigate to **Admin > Users & Groups > Permission Sets**.
2. Select the appropriate permissions set.
3. Navigate to **Objects > User**.
4. Grant business admin users Edit field permission to the **force\_full\_refresh\_\_v** field.

#### Configuring Sending Sync Files to Veeva

To configure this feature:

1. Navigate to **Admin > Users & Groups > Permission Sets**.
2. Select the appropriate permissions set.
3. Navigate to **Objects > User**.
4. Grant business admin users Edit permission to the **upload\_vtrans\_\_v** field.

### Using Undo and Undelete in the Errors Tab as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)End Users](#)

End users can undo or undelete changes causing sync errors. If an update to an existing record causes a sync error, the user has the option to undo that change during the next incremental sync, where the whole object table is refreshed.

If the user deletes a record offline, but does not have sufficient privileges to delete it on the server, the user can resolve the error by undeleting the record. This triggers a database refresh during the next incremental sync to ensure all relationships to the deleted record are also restored.

### Clearing Client Sync Errors as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users, End Users](#)

If there is a pending upload for a record when a sync error occurs, the error cannot be resolved by undoing or undeleting records. Instead, users can clear client sync errors from the most recent sync. This allows users to remove any persisting errors they are unable to fix.

To prevent data loss, contact [Support](https://support.veeva.com/hc/en-us) for assistance when clearing client sync errors.

Select the clear\_client\_sync\_errors\_\_v checkbox on the appropriate user\_\_sys record. Ensure all sync errors on the device are not fixable and must be cleared. The next time end user syncs, the errors on the device from the previous sync are cleared. The clear\_client\_sync\_errors\_\_v checkbox is automatically deselected on the user\_\_sys record after the end users clears the errors. To clear errors again in the future, select the checkbox again

If the end user performs a forced full refresh after clearing the errors, the device’s database resets to match the data from Vault CRM online.

### Using Forced Full Refresh as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users](#)

Instead of directing an end user to perform a database refresh, business admin users can select the forced\_full\_sync\_\_v checkbox on the appropriate user\_\_sys record so the next time the end user syncs, the device automatically performs the database refresh.

Select the force\_full\_refresh\_\_v checkbox field on the appropriate user\_\_sys record. The next time the end user syncs, a forced full refresh automatically occurs.

If the end user has Edit permission to the force\_full\_refresh\_\_v checkbox field, the field is automatically deselected after a forced full refresh occurs. Otherwise, a forced full refresh occurs every time the end user syncs.

### Sending Sync Files to Veeva as

[![Closed](../../../../../Skins/Default/Stylesheets/Images/transparent.gif)Business Admin Users](#)

Sync files can be sent to Veeva Support remotely. This enables easier troubleshooting and data restoration if necessary.

Select the upload\_vtrans\_\_v checkbox on the appropriate user\_\_sys record. The next time the end user syncs, the sync files are automatically sent to Veeva. The checkbox is automatically deselected after this action.

### Related Topics

[Downloading Activity Logs for Troubleshooting](ActivityLogs.htm)

[Tracking Sync Activity](TrackSyncActivity.htm)

[Using the Sync Widget](SyncWidget.htm)