This module defines blackout days (non-operational days), stress days (high-demand periods), and delivery time ranges for field service operations. It provides the necessary models to store this information, which can be used by other modules to manage scheduling, availability, and workload adjustments.
- Blackout Days (fsm.blackout.day): Represent dates when field service operations are unavailable (e.g., holidays, company-wide closures).
- Blackout Groups (fsm.blackout.group): Represent groups of days when field service operations are unavailable (e.g., holidays, company-wide closures).
- Stress Days (fsm.stress.day): Indicate dates with increased service demand (e.g., peak business periods requiring additional workforce).
- Delivery Time Ranges (fsm.delivery.time.range): Define available time slots for scheduling field service operations.
- Restricts blackout days for Scheduled Start (ETA) orders with the same date
This module validates Scheduled Start (ETA) dates on field service orders against blackout days configured on their route. Orders with an ETA that falls on a matching blackout day cannot be saved.
auto_awesome What this module does
AI-generated from the code · Odoo 19.0Lets you record days when field service cannot be performed, high-demand days, and delivery time slots, and blocks field service orders scheduled on a blackout day for their route.
This module adds an Availability section under the Field Service configuration menu with four screens.
- Blackout Days: record a description, a date and an optional postal code for days when no service is done. The same date and postal code combination cannot be saved twice.
- Blackout Groups: group several blackout days together under one name.
- Stress Days: record a description and a date for high-demand periods. Each date can only be recorded once.
- Delivery Time Ranges: define a start and end time, optionally linked to a specific route, with a sequence to control the display order. The name is generated automatically from the times, and the start time must be earlier than the end time.
On the route form, a new field lets you attach blackout groups to a route. When a field service order has a route and a scheduled start date, Odoo checks whether that date falls on a blackout day of the route's groups. If the blackout day has no postal code, it applies to the whole route; if it has one, it only applies when it matches the order's postal code. In that case saving the order is blocked with an error message showing the date.
Access rights follow the standard field service roles: managers can create, edit and delete, dispatchers can create and edit, and other users can only read.
Depends on
Required by other modules
Menus it adds
Models and fields (6)
- fsm.order · extends an existing model
- fsm.route · extends an existing modelfsm_blackout_group_ids (Blackout Group Days)
- fsm.stress.day · new modeldate (Stress Day), name (Description)
- fsm.blackout.day · new modelzip, date (Blackout Day), name (Description)
- fsm.blackout.group · new modelname, fsm_blackout_day_ids (Days)
- fsm.delivery.time.range · new modelname, end_time, route_id (Route), sequence, start_time
Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 4 confirmed, 5 with no information of 9 versions.
Sources · Odoo 19.0
Confirmed on 2026-11-03 in branch 19.0 of OCA/field-service.
terminal Installation and usage
OCA documentation · Odoo 19.0Usage
Source · Odoo 19.0Navigate to Field Service \> Configuration \> Availability. Once there, you can select Delivery Time Ranges, Blackout Days, Blackout Groups or Stress Days to create new records.
Steps to restrict blackout days for Scheduled Start (ETA) orders with the same date
- Set up Blackout Days on Configuration > Blackout Groups and create or edit one with blackout days
- Go to Field Service > Master Data > Routes > Create or edit route and assign Blackout Group Days and a Person
- Create a Field Service order and set up Scheduled Start (ETA) with date that you put on blackout days and the Odoo will throw an error
No verified information in OCA: Installation, Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.