Skip to content
Health
54/100
fair
  • Security19/25
    2 minor findings
  • Activity25/25
    Human commit this month
  • Required by5/25
    0 modules depend on it
  • Maturity5/25
    In 1 Odoo series since 18.0

Heuristic over the facts below, not an audit · How it's computed

Security findings
Grave / minor (static analysis)
Required by
0
Modules depending on it
External deps
0 pip · 0 bin
Python packages / system binaries
License
AGPL-3
No conflicts with its dependencies
Folder size
3.49 MB
Module directory on disk
Code analysis 0 migration notes 4 models 12 views 5 HTTP endpoints

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 .ics file 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:

Appointment status in the list view

Confirmed appointments in the calendar

Dependencies

Odoo dependencies
Python dependencies
None
System dependencies
None
Required by
None

Code analysis

Extracted from the source by best-effort static analysis (no code is executed); details may be incomplete.

Views touched 12

XML IDNameModelTypeStatus
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)HandlerAuthTypeMethodsFlags
/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

New fields (2)
  • attachment_ids Many2many → ir.attachment
    string='Attachments' args: 'ir.attachment', 'fsm_appointment_confirmation_wizard_attachment_rel', 'wizard_id', 'attachment_id'
  • partner_ids Many2many → res.partner
    string='Additional Contacts' args: 'res.partner', 'fsm_appointment_confirmation_wizard_partner_rel', 'wizard_id', 'partner_id'
Public methods (0)

No public methods.

New fields (7)
  • appointment_calendar_label Char
    compute='_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=True string='Calendar Label'
  • appointment_confirmed_by Char
    copy=False readonly=True
  • appointment_confirmed_date Datetime
    copy=False readonly=True string='Appointment Confirmed On'
  • appointment_reschedule_count Integer
    copy=False default=0 readonly=True string='Reschedule Count'
  • appointment_state Selection
    copy=False default='pending' required=True selection=[('pending', 'Pending'), ('requested', 'Requested'), ('rescheduled', 'Rescheduled'), ('confirmed', 'Confirmed')] string='Appointment Status' tracking=True
  • appointment_state_label Char
    compute='_compute_appointment_state_label' string='Appointment Status Label'
  • can_request_confirmation Boolean
    compute='_compute_can_request_confirmation'
Public methods (3)
  • action_request_appointment_confirmation(self)
  • confirm_appointment(self, confirmed_by=None)
  • reschedule_appointment(self, new_start)

New fields (1)
  • allow_confirmation_request Boolean
    default=False help='If enabled, field service orders in this stage display the button to request an appointment confirmation from the customer.' string='Allow Appointment Confirmation Request'
Public methods (0)

No public methods.

New fields (2)
  • fsm_appointment_reschedule_window_days Integer
    config_parameter='fieldservice_appointment_confirmation.reschedule_window_days' default=14 help='Number of days ahead offered to the customer when rescheduling an appointment.' string='Reschedule Window (days)'
  • fsm_appointment_slot_duration_hours Float
    config_parameter='fieldservice_appointment_confirmation.slot_duration_hours' default=1.0 help='Granularity, in hours, of the time slots offered to the customer when rescheduling an appointment.' string='Reschedule Slot Duration (hours)'
Public methods (0)

No public methods.