Alternative Appointment Offer
Use Approve Alternative Offer to review and approve an alternative appointment offer.
This screen includes:
| # | Element | Description |
|---|---|---|
| 1 | Header | Displays title, refresh, and filter actions |
| 2 | Offer notice | Prompts the user to review the offer |
| 3 | Offer details | Displays doctor, specialty, date, time, clinic, and patient |
| 4 | Change status | Marks the offer as changed |
| 5 | View alternative | Opens other options |
| 6 | More info | Opens offer details |
Workflow
- Open the appointment approval screen.
- Render available appointment offers.
- Select one offer.
- Approve the selected offer or refuse all offers.
- Refresh the appointment state.
Offer selection
Only one offer can be selected at a time. Selecting another offer clears the previous selection. When only one offer exists, the platform can return it as the selected offer.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| No offer selected | Disable Approve action | selection = required |
| One offer available | Apply implicit selection | selectedOfferId = <id> |
| Multiple offers available | Require offer selection | selection = required |
| Offer selected | Enable Approve action | selectedOfferId = <id> |
| Offer unavailable | Disable offer card | offer = unavailable |
| Approval rejected | Display error state | state = error |
| Refusal rejected | Display error state | state = error |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Approval screen opened | Load appointment offers | PUT /api/v3/appointments/{appointment-id}/approve |
| Offer selected | Update selected offer | PATCH /api/v3/appointments/{appointment-id}/approve/select |
| Different offer selected | Replace selected offer | selectedOfferId = updated |
| Approve selected | Approve selected offer | POST /api/v3/appointments/{appointment-id}/approve |
| Refuse All selected | Refuse all offers | refusal = submitted |
| Back selected | Return without changes | state = unchanged |
Refusal behavior
If you refuse all offers, the appointment remains unscheduled.
The clinic may send new alternatives or contact you for further coordination.
Endpoint Resources
Approve Alternative Offer
PUT
v3/appointments/{appointment-id}/approve
Displays alternative offers for the specified appointment.
Select Card
PATCH
v3/appointments/{appointment-id}/approve/select
Selects the offer card for approval.
Approve Offer
POST
v3/appointments/{appointment-id}/approve
Approves the appointment offer with the selected alternative.