Resolving Validation Failures
BETA

Validation failures occur when PMS data does not meet Zentra’s requirements. These records cannot be imported until the issue is resolved. This section explains common validation errors and how to fix them.

Common Validation Errors

Error
Cause
Solution
Missing first name
First name field empty in PMS
Add first name in PMS
Missing last name
Last name field empty in PMS
Add last name in PMS
Invalid email format
Email not in valid format
Correct email in PMS
Duplicate email
Email already exists in Zentra
Resolve the email conflict (see Resolving Duplicate Residents above)
Unmatched unit
Unit not matched to a Zentra Device
Contact Zentra support to add the unit match
Missing unit
Unit field empty in PMS
Assign unit in PMS

Viewing Error Details

When you click on a validation failure:
  1. The specific field and error displays
  2. The current value (if any) is shown
  3. Suggested fixes are provided

Resolution Options

Fix in PMS (Recommended)
The best solution is to correct the data in your PMS:
  1. Note the specific error and field.
  2. Update the record in your PMS.
  3. Run a sync in Zentra.
  4. The corrected record will import successfully.
This ensures your PMS data is accurate and prevents future issues.
Skip
Leave the item in the queue for later review:
  1. Click
    Skip
    .
  2. The item remains in the queue.
  3. It will reappear on each sync until resolved.

Unmatched Unit Errors

If the error is “Unmatched unit,” the PMS unit is not linked to a Zentra Device. There is no self-service editor for unit matches in this beta:
  1. Contact Zentra support with the PMS unit name or ID and the Zentra Device it should be matched to.
  2. Once support adds the match, run a sync – the record will now import.
For units that need to grant access to more than one door, see the Modifying Unit Matches section below on this page for the supported User Group workaround.

Duplicate Email Errors

If a PMS resident has the same email as an existing Zentra user:
  • This usually indicates a duplicate match, not a validation error
  • The record may appear as both a validation error and a duplicate
  • Resolve the email conflict first (Resolving Duplicate Residents above ) – the validation error will clear

Data Quality Best Practices

To minimize validation errors:
  • Clean up PMS data before enabling integration
  • Ensure all residents have complete names
  • Verify email addresses are valid
  • Confirm unit assignments are current
  • Remove test or placeholder records from PMS

Persistent Errors

If an error persists after correcting data:
  1. Verify the change saved in your PMS.
  2. Run a manual sync in Zentra.
  3. Check if the record now imports correctly.
  4. If still failing, check for other validation issues.
Some records may have multiple errors that must all be fixed.