Appointments & Scheduling · How-to guide

Change appointment status from the detail view

Use the state-aware controls on the appointment record instead of editing status indirectly through unrelated fields.

Audience: Staff who manage appointmentsFeature: Status controlsModule v1.3.6
Feature pathAppointments > Open appointment
Before you beginThis 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 this feature does

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.

Step-by-step workflow

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

Important fields and decisions

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.

What happens after completion

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.