ZenotiHelp

Bulk Preferred Business Update β€” Partial Failure Reporting

ZTZenoti Docs Team Updated September 19, 2026 3 min readReference

When a bulk preferred business update for employees includes one or more selections that cannot be saved, Zenoti identifies the failed items and highlights the affected rows in the bulk preferred business UI so you can review and correct them without reprocessing the entire batch.

Audience: Administrators and managers who perform bulk preferred business updates for employees.


On this page


Before you begin

  • Your organization must have employees configured and accessible through Employee > Employees.
  • You must have the following permission to view grooming points data related to this operation:

Permission: Grooming Points (under View Employee Reports) β€” Required to access employee grooming points data associated with the bulk preferred business update. Grant it on the View Employee Reports row in the Employee Manager section of the security role (Configuration > Security > Security roles > the role > Permissions).

How partial failure reporting works

When you submit a bulk preferred business update, Zenoti processes each employee selection individually. If one or more selections cannot be saved β€” for example, because of a data conflict or an invalid combination of employee, center, or business β€” the system returns a response that identifies each failed item.

For each failed selection, the response includes:

  • The employee reference identifier
  • The center ID associated with the failed selection
  • The business reference identifier
  • A human-readable error message describing why the selection could not be saved

Zenoti uses this list of failed items to highlight the specific rows in the bulk preferred business UI. Rows that saved successfully are not affected. You can review the highlighted rows, correct the underlying issue, and resubmit only the affected selections.

Steps

View partial failure results after a bulk update

  1. Navigate to Employee > Employees.
  2. Perform a bulk preferred business update for the employees you want to configure.
  3. After the update completes, review the bulk preferred business UI for highlighted rows. Rows with errors are visually distinguished from rows that saved successfully.
  4. For each highlighted row, read the error message displayed alongside the row to understand why the selection could not be saved.
  5. Correct the employee, center, or business selection as indicated by the error message.
  6. Resubmit the corrected selections.

Note: Only the rows identified in the failed items list are highlighted. Successfully saved selections are not affected and do not need to be resubmitted.

Filter criteria

The bulk preferred business update partial failure report does not expose a standalone filter panel. Failed items are surfaced inline within the bulk preferred business UI immediately after the update operation completes. The following context is available for each failed row:

Context field Description
Employee The employee whose preferred business selection could not be saved.
Center The center ID associated with the failed selection.
Business The business associated with the failed selection.
Error message A human-readable description of why the selection failed.

Column descriptions

The following information is returned for each failed item in the bulk preferred business update response:

Field Description
Employee reference The unique identifier for the employee whose selection could not be saved.
Center ID The identifier of the center associated with the failed selection.
Business reference The identifier of the business that could not be assigned as the preferred business.
Error message A plain-language description of the reason the selection failed. Use this message to determine the corrective action required before resubmitting.
Was this article helpful?
Your feedback helps us improve our documentation.