Off Hours for Edit
Use Off Hours for Edit to request an appointment time outside standard availability while modifying an existing appointment.
The popup displays the off-hours fee and lets the user enter a preferred appointment time.
This screen includes:
| # | Element | Description |
|---|---|---|
| 1 | Appointment context | Displays the appointment request behind the popup |
| 2 | Popup title | Displays Off-hours visit |
| 3 | Off-hours fee | Displays the additional off-hours fee |
| 4 | Instruction text | Requests a preferred appointment time |
| 5 | Time input | Displays the selected preferred time |
| 6 | Time picker | Opens the time selection control |
| 7 | OK action | Submits the selected off-hours time |
| 8 | Cancel action | Closes the popup without changes |
Workflow
- Open the appointment edit flow.
- Select an appointment option that supports off-hours requests.
- Open the off-hours visit popup.
- Review the off-hours fee.
- Enter a preferred appointment time.
- Select OK.
- Submit the off-hours request.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Appointment editable | Display off-hours request flow | state = editable |
| Off-hours supported | Display off-hours popup | offHours = available |
| Time not entered | Block submission | validation = required |
| Time entered | Enable submission | validation = valid |
| Request accepted | Continue edit flow | status = success |
| Request rejected | Display error state | status = 405 |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Off-hours popup opened | Load off-hours request popup | PUT /api/v3/wizard/time-location-selection/{appointment-id}/off-hours |
| Time selected | Update preferred appointment time | time = updated |
| OK selected | Submit off-hours request | POST /api/v3/wizard/time-location-selection/{appointment-id}/off-hours/submit |
| Cancel selected | Close popup | state = cancelled |
Endpoint Resources
Off Hours for Edit
PUT
v3/wizard/time-location-selection/{appointment-id}/off-hours
Returns the off-hours visit popup for an appointment edit flow
Submit Off Hours for Edit
POST
v3/wizard/time-location-selection/{appointment-id}/off-hours/submit
Submits the selected off-hours time