Field Service - Appointment Confirmation
fieldservice_appointment_confirmation · OCA/field-service
-
Security19/252 minor findings
-
Activity25/25Human commit this month
-
Required by5/250 modules depend on it
-
Maturity5/25In 1 Odoo series since 18.0
Heuristic over the facts below, not an audit · How it's computed
Description
This module automates the confirmation of field service appointments with the final customer.
From a field service order the coordinator can request a confirmation from the customer through a pre-filled, editable email (standard mail composer). The customer confirms or reschedules the visit from a secure tokenized link, without any login or portal user, and the order is updated accordingly:
- the appointment status is tracked (Pending, Requested, Confirmed) with a badge, a ribbon and calendar/list decorations; a confirmed appointment that was rescheduled is shown as "Confirmed (rescheduled)";
- confirming and rescheduling are logged in the chatter and notify the order followers and the assigned worker; the customer also receives a confirmation email;
- picking an available slot when rescheduling is treated as the customer's acceptance, so the appointment is automatically confirmed on the new date;
- on confirmation (or reschedule) the customer can download an RFC 5545
.icsfile to add the visit to Google Calendar, Outlook or Apple Calendar; - rescheduling only offers slots where the assigned worker is actually available, based on their working schedule and existing orders;
- an appointment whose date has already passed can no longer be confirmed online, only rescheduled to a future slot.
The module is designed as a generic OCA contribution and only depends on
fieldservice, mail, resource and portal.
The appointment status is shown as a coloured badge in the list view and as a coloured event (prefixed with a check mark once confirmed) in the calendar:


Dependencies
Code analysis
Extracted from the source by best-effort static analysis (no code is executed); details may be incomplete.
Views touched 12
| XML ID | Name | Model | Type | Status |
|---|---|---|---|---|
appointment_confirm_page |
FSM Appointment Confirm | ir.ui.view | qweb | New |
appointment_confirmed |
FSM Appointment Confirmed | ir.ui.view | qweb | New |
appointment_invalid |
FSM Appointment Invalid Link | ir.ui.view | qweb | New |
appointment_reschedule_page |
FSM Appointment Reschedule | ir.ui.view | qweb | New |
appointment_rescheduled |
FSM Appointment Rescheduled | ir.ui.view | qweb | New |
fsm_appointment_confirmation_wizard_form |
fsm.appointment.confirmation.wizard.form | fsm.appointment.confirmation.wizard | form | New |
fsm_order_calendar_view |
fsm.order.calendar.appointment.confirmation | fsm.order | calendar | Inherits fieldservice.fsm_order_calendar_view |
fsm_order_form |
fsm.order.form.appointment.confirmation | fsm.order | form | Inherits fieldservice.fsm_order_form |
fsm_order_list_view |
fsm.order.list.appointment.confirmation | fsm.order | list | Inherits fieldservice.fsm_order_list_view |
fsm_order_search_view |
fsm.order.search.appointment.confirmation | fsm.order | search | Inherits fieldservice.fsm_order_search_view |
fsm_stage_form_view |
fsm.stage.form.appointment.confirmation | fsm.stage | form | Inherits fieldservice.fsm_stage_form_view |
res_config_settings_view_form |
res.config.settings.form.fsm.appointment.confirmation | res.config.settings | form | Inherits base.res_config_settings_view_form |
HTTP endpoints 5
| Route(s) | Handler | Auth | Type | Methods | Flags |
|---|---|---|---|---|---|
/fieldservice/appointment/<int:order_id>/confirm |
FSMAppointmentController.appointment_confirm_page |
public | http | GET | website |
/fieldservice/appointment/<int:order_id>/confirm |
FSMAppointmentController.appointment_confirm_submit |
public | http | POST | csrf off website |
/fieldservice/appointment/<int:order_id>/ics |
FSMAppointmentController.appointment_ics |
public | http | GET | website |
/fieldservice/appointment/<int:order_id>/reschedule |
FSMAppointmentController.appointment_reschedule_page |
public | http | GET | website |
/fieldservice/appointment/<int:order_id>/reschedule |
FSMAppointmentController.appointment_reschedule_submit |
public | http | POST | csrf off website |
Models touched 4
-
attachment_idsMany2many → ir.attachmentstring='Attachments' args: 'ir.attachment', 'fsm_appointment_confirmation_wizard_attachment_rel', 'wizard_id', 'attachment_id' -
partner_idsMany2many → res.partnerstring='Additional Contacts' args: 'res.partner', 'fsm_appointment_confirmation_wizard_partner_rel', 'wizard_id', 'partner_id'
No public methods.
-
appointment_calendar_labelCharcompute='_compute_appointment_calendar_label'help='Order name shown in the calendar, prefixed with a mark when the appointment is confirmed.'inverse='_inverse_appointment_calendar_label'store=Truestring='Calendar Label' -
appointment_confirmed_byCharcopy=Falsereadonly=True -
appointment_confirmed_dateDatetimecopy=Falsereadonly=Truestring='Appointment Confirmed On' -
appointment_reschedule_countIntegercopy=Falsedefault=0readonly=Truestring='Reschedule Count' -
appointment_stateSelectioncopy=Falsedefault='pending'required=Trueselection=[('pending', 'Pending'), ('requested', 'Requested'), ('rescheduled', 'Rescheduled'), ('confirmed', 'Confirmed')]string='Appointment Status'tracking=True -
appointment_state_labelCharcompute='_compute_appointment_state_label'string='Appointment Status Label' -
can_request_confirmationBooleancompute='_compute_can_request_confirmation'
-
action_request_appointment_confirmation(self) -
confirm_appointment(self, confirmed_by=None) -
reschedule_appointment(self, new_start)
-
allow_confirmation_requestBooleandefault=Falsehelp='If enabled, field service orders in this stage display the button to request an appointment confirmation from the customer.'string='Allow Appointment Confirmation Request'
No public methods.
-
fsm_appointment_reschedule_window_daysIntegerconfig_parameter='fieldservice_appointment_confirmation.reschedule_window_days'default=14help='Number of days ahead offered to the customer when rescheduling an appointment.'string='Reschedule Window (days)' -
fsm_appointment_slot_duration_hoursFloatconfig_parameter='fieldservice_appointment_confirmation.slot_duration_hours'default=1.0help='Granularity, in hours, of the time slots offered to the customer when rescheduling an appointment.'string='Reschedule Slot Duration (hours)'
No public methods.