Understand conflict resolution
When you drag, resize, or paste an appointment in the Appointment Book, Zenoti checks the move against 18 types of scheduling conflicts before saving the change. This article explains what each conflict type means and how the system responds.
Audience: Front desk staff who reschedule or move appointments and need to understand conflict alerts.
Before you begin
- Conflict checks apply to all drag-drop, resize, and clipboard paste operations.
- Some conflicts are hard blocks (you cannot proceed) and others are warnings (you can choose to override).
- Equipment-capacity conflict behavior β whether the move is blocked or produces an overridable warning β depends on the Allow booking beyond capacity checkbox on the individual equipment record, not on any center-level booking-restrictions setting.
Conflict types and behaviors
Zenoti checks every scheduling operation against the following conflict types:
| Conflict | What it means | Behavior |
|---|---|---|
| Therapist busy | The provider already has another appointment at the target time. | Blocked β the appointment reverts to its original position. |
| Room busy | The room is already occupied at the target time. | Blocked β the appointment reverts. |
| Therapist cannot perform service | The provider is not qualified or set up to perform the selected service. | Blocked β the appointment reverts. |
| Room unavailable for service | The room is not set up for the selected service. | Blocked. |
| Therapist not working | The provider has no schedule entry at the target time. | Blocked or PIN auth required (see below). |
| Resource not available | A required resource (other than room or equipment) is not available. | Blocked. |
| Equipment not available | A required equipment unit is not available at the target time. | Blocked. |
| Room capacity exceeded (warning) | The room is at capacity but can be overridden. | Warning β you can confirm to override. |
| Room stop / no suitable room | No room is available that matches the service requirements. | Opens an Available Rooms dialog for you to select from alternatives. |
| Equipment capacity exceeded (stop) | Equipment is at maximum capacity and the Allow booking beyond capacity checkbox is unchecked on the equipment record. | Blocked β alert shown, appointment reverts. |
| Multiple equipment capacity exceeded | Multiple equipment units are over capacity. | Blocked. |
| Equipment capacity exceeded (warning) | Equipment is at capacity and the Allow booking beyond capacity checkbox is checked on the equipment record. | Warning β you can confirm to override. |
| Therapist has no schedule (stop) | Therapist has no working schedule and overrides are not permitted by the organization setting. | Blocked, or PIN auth required depending on settings. |
| Therapist has no schedule (warning) | Therapist has no schedule but overrides are allowed by the organization setting. | Warning β you can confirm to override. |
| Therapist already booked (warning) | Provider already has an appointment but double-booking is allowed. | Warning β you can confirm to override. |
| Guest already booked (warning) | The guest already has an appointment at the target time. | Warning β you can confirm to override. |
| Therapist cannot perform add-on | Provider is not qualified to perform one of the add-on services. | Blocked. |
| Prerequisite service order violated | A service in the booking has prerequisites that are not met in the correct order. | Blocked β a message shows the required order. |
Note: The conflict types in the table above apply to calendar drag, resize, and clipboard-paste operations in the Appointment Book. Other booking surfaces that perform their own conflict checks are outside the scope of this table.
Equipment capacity conflicts: block vs. warn
Whether an equipment-capacity overrun blocks the move or produces an overridable warning depends on the configuration of the individual equipment record:
| Allow booking beyond capacity checkbox | Result |
|---|---|
| Unchecked | Hard block β the appointment reverts automatically. |
| Checked | Warning dialog β you can confirm to override. |
This setting is on the equipment record itself, not on any center-level booking-restrictions configuration.
Conflict indicators on the calendar
When a scheduling conflict is detected on an appointment card in the Appointment Book calendar, the card shows a yellow-triangle icon. The yellow triangle is a visual cue that a warning-level conflict exists for that appointment (for example, the provider is not scheduled, or the guest has a conflicting appointment at the same time). Hovering over or clicking the appointment reveals the specific conflict type.
Note: The yellow-triangle icon appears only for warning-level conflicts. Hard-blocked conflicts prevent the appointment from being placed at all.
What happens after a warning
When a warning-level conflict is detected, Zenoti displays a confirmation dialog explaining the conflict. You can:
- Confirm to proceed with the override (the move is saved).
- Cancel to revert the appointment to its original position.
If multiple warning conflicts exist, you confirm each one in sequence. Each confirmation is accumulated and included when the system retries the conflict check, so all overrides are validated together before the appointment is committed.
Therapist schedule override behavior
The behavior when a provider has no schedule at the target time depends on an organization-level setting:
| Setting | Behavior |
|---|---|
| Block | A hard alert is shown. The appointment reverts automatically. |
| Warn | A warning dialog appears. Staff can confirm to proceed. |
| Require PIN authorization | A PIN dialog appears. An authorized user must enter a valid PIN to override. |
Tips
- If a move is blocked unexpectedly, check whether the provider has a schedule entry for the target time. Front desk staff with the appropriate permission can adjust provider schedules before reattempting the move.
- For equipment-capacity warnings, review whether the Allow booking beyond capacity checkbox is intentionally set on the equipment record. If your center policy is to prevent overbooking, ensure the checkbox is unchecked.
- When a Room stop / no suitable room conflict appears, the Available Rooms dialog lists alternatives that do match the service requirements β select one from the list to complete the move without reverting to the original position.
Troubleshooting
The appointment snaps back every time I try to move it, and no dialog appears. This is a hard-block conflict (types such as therapist busy, room busy, or equipment at capacity with Allow booking beyond capacity unchecked). No override is possible. Check the target time slot for provider availability, room occupancy, and equipment availability, then try a different slot.
I see a PIN dialog when I try to move an appointment to a time slot outside the provider's schedule. Your organization is configured to require PIN authorization for bookings outside scheduled hours. An authorized user must enter their PIN to complete the override.
The Available Rooms dialog is empty β no rooms are listed. No configured rooms match both the target time slot and the service requirements. Either the service has room-type restrictions or all matching rooms are occupied at that time. Try a different time slot, or contact your administrator to review room-service associations.