OdooWiki OCA HUB

Field Service Route

fieldservice_route folder_open OCA/field-service open_in_new
Field Service License: AGPL-3

A Field Service route is the sorted list of orders that one worker/vehicle will perform during a day.

This module allows you to manage your Field Service routes: when assigning an order to a worker and scheduling it, a route is automatically created for that worker and day.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Organize field service work into routes and daily routes, so each worker has a sorted list of orders for a given day. Routes are created automatically when an order is assigned to a worker and scheduled.

This module adds the idea of a route (a recurring round, for example a district) and a day route (that route on one specific date, for one worker).

  • You define Routes with a name, the person who runs them, the weekdays they run on, and a maximum number of orders per day. Routes are found under the Field Service master data menu.
  • Locations can be linked to a route, so orders for that location automatically belong to that route.
  • When an order is assigned to a worker and has a planned start date, Odoo automatically finds or creates the matching day route for that worker, that date, that route and that team, and links the order to it. Day routes get an automatic reference number starting with SR.
  • Day Routes are listed, shown in a calendar, and reported with graph and pivot views, from the Field Service dashboard, operations and reporting menus.
  • On a day route you see the number of orders, the available capacity and the maximum capacity, plus planning information such as planned start time, working time before overtime, maximum allowable time and start/end/last locations.
  • Business rules: a day route cannot be created on a weekday the route does not run on, and it cannot exceed the route's maximum number of orders. If you move an order to a day route belonging to a different route, Odoo blocks it with an error.
  • Changing the worker on a route, or the route on a location, re-evaluates the day routes of the affected orders. Empty day routes are removed automatically.
  • Day routes have their own stages (New, Closed) and portal users can only see their own day routes.

Depends on

Menus it adds

Day RoutesDay RoutesRoutesDay RoutesRoute Days
Models and fields (6)
  • fsm.order · extends an existing modelperson_id (Assigned To), dayroute_id (Day Route), fsm_route_id (Route)
  • fsm.route · new modelname, day_ids (Days), max_order (Maximum Orders), fsm_person_id (Person)
  • fsm.stage · extends an existing modelstage_type
  • fsm.location · extends an existing modelfsm_route_id (Route)
  • fsm.route.day · new modelname
  • fsm.route.dayroute · new modeldate, name, team_id (Team), latitude, route_id (Route), stage_id (Stage), longitude, max_order (Maximum Capacity), order_ids (Orders), person_id (Person), work_time (Time before overtime (in hours)), order_count (Number of Orders), max_allow_time (Maximal Allowable Time (in hours)), end_location_id (End Location), order_remaining (Available Capacity), last_location_id (Last Location), start_location_id (Start Location), date_start_planned (Planned 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. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 17.0

Confirmed on 2026-11-03 in branch 17.0 of OCA/field-service.

terminal Installation and usage

OCA documentation · Odoo 19.0

To use this module, you need to:

  • Go to Field Service > Configuration > Stages
  • Define the workflow of your routes by creating new stages whose type is "Route"
  • Go to Field Service > Master Data > Routes
  • Create your routes by setting their name, worker, days, and capacity

To use this module, you need to:

  • Go to Field Service
  • Create or select an order
  • Assign it to a worker and schedule it
  • Go to Field Service \> Dashboard \> Day Routes. A new record has been created.

No verified information in OCA: Installation.

info

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.