Appointments & Scheduling · How-to guide

Change appointment status from the detail view

Follow this guide to use the state-aware controls on the appointment record instead of editing status indirectly through unrelated fields. The guide then takes you through the correct route, the checks to complete before making changes, the workflow in order, and the evidence to review afterwards.

Audience: Staff who manage appointmentsFeature: Status controlsModule v1.3.6
Jump to steps
Where to goAppointments > Open appointment
Before you startThis guide follows the supplied Britixo Appointments & Scheduling module version 1.3.6. The relevant access is Appointments: Edit or Approve as applicable. A menu, button, provider, time slot or client action can remain hidden when the signed-in user lacks the required permission, the module setting is disabled, the related record is in an ineligible state, or availability validation rejects the request.

What you’ll accomplish

Use the state-aware controls on the appointment record instead of editing status indirectly through unrelated fields. It uses Britixo's permission-aware appointment, availability, status and integration flow rather than an unconnected diary entry.

How the module flow works

The detail view calculates available status controls from the appointment's current state and the signed-in user's permissions.

Each action uses a dedicated controller flow so history and notification side effects can be applied.

Unavailable buttons normally indicate a permission or state restriction rather than missing data.

Follow these steps

  1. Go to the full appointment record.
  2. Check current status, source, timing and any pending client request.
  3. Select the valid next status action.
  4. Verify the action and any required reason.
  5. Reload the detail page and verify the resulting controls.

Fields and decisions to review

Current stateDetermines which lifecycle actions are valid.
PermissionView, Edit, Delete or Approve access assigned to the staff role.
Pending requestClient cancellation or reschedule request requiring a specific decision.
HistoryAudit trail for the status transition.

How to confirm it worked

After this workflow completes, Britixo keeps the appointment and its supported relationships connected. Reopen the appointment and verify the saved status, date, timezone, customer or lead, service, provider, attendees, reminder state, calendar or meeting reference, invoice reference and history that apply to this feature. External email, SMS, Google, Microsoft or payment outcomes must be checked separately from the Britixo database save.

  • Open the saved appointment and confirm the final status and source.
  • Check the participant, provider, timing and timezone from the full detail page.
  • Review the relevant table filter, calendar, history, report or linked invoice instead of relying only on a success message.

Controls, checks and common mistakes

  • Do not manipulate database values or unrelated edit fields to force a state.
  • Handle pending cancellation or reschedule requests with their dedicated actions.
  • Confirm communication before changing an external appointment.
  • Use the least destructive correction and retain the appointment history when the booking existed operationally.
  • Never bypass a permission, availability, approval, client-access or verification control by changing an unrelated route or setting.
Scheduling and data safetyAppointment changes can notify customers, reserve provider time, update remote calendars, create meeting links or invoices and alter reports. Confirm the exact record, timezone, status and recipients before saving.