README.rst

Field Service

This module is the base of the Field Service application in Odoo.

Table of contents

• Configuration
  • Order Stages
  • Field Service Areas
    • Setup a Territory
    • Setup Branches, Districts, and Regions
  • Advanced Configurations
    • Manage Teams
    • Manage Categories
    • Manage Tags
    • Manage Order Templates
• Usage
  • Add Field Service Locations
  • Add Field Service Workers
  • Process Orders
• Known issues / Roadmap
• Bug Tracker
• Credits
  • Authors
  • Contributors
  • Other credits
  • Maintainers

Configuration

The base Field Service module can be used with minimal initial configuration. It also allows for many advanced features, which require a more in-depth configuration.

Order Stages

The stage of an order is used to monitor its progress. Stages can be configured based on your company's specific business needs. A basic set of order stages comes pre-configured for use.

1. Go to Field Service > Configuration > Stages
2. Create or edit a stage
3. Set the name for the stage.
4. Set the sequence order for the stage.
5. Select Order type to apply this stage to your orders.
6. Additonally, you can set a color for the stage.

Field Service Areas

You can manage designated areas or locales for your field service workers, salesmen, and other resources. For example, salesmen may serve a particular Territory. There may be multiple Territories served by a single Branch office location. Multiple Branches are managed within a District and these Districts are managed under an encompassing Region.

Setup a Territory

1. Go to Settings > Users & Companies > Territories*
2. Create or select a territory
3. Set the territory Name and description
4. Select or create a branch which this territory serves
5. Choose a type of zip, country whichs defines the boundary used
6. Input a list of zip codes, countries based on your desired configuration

Setup Branches, Districts, and Regions

If your business requires, define your Branches, Districts, and Regions. These are found under Field Service > Configuration > Locations

Advanced Configurations

Additional features, automations, and GeoEngine features can be enabled in the General Settings panel for Field Service.

1. Go to Field Service > Configuration > Settings
2. Enable additional options
3. Configure new options

Manage Teams

Teams can be used to organize the processing of field service orders into groups. Different teams may have different workflows that a field service order needs to follow.

1. Go to Field Service > Configuration > Workers > Teams
2. Create or select a team
3. Set the team name, description, and sequence

You can now define custom stages for each team processing orders.

1. Go to Field Service > Configuration > Stages
2. Create or edit a stage
3. Select the teams for which this stage should be used

Manage Categories

Categories are used to group workers and the type of orders a worker can do.

1. Go to Field Service > Configuration > Workers > Categories
2. Create or select a category
3. Set the name and description of category
4. Additionally, you can select a parent category if required

Manage Tags

Tags can be used to filter and report on field service orders

1. Go to Field Service > Configuration > Orders > Tags
2. Create or select a tag
3. Set the tag name
4. Set a color index for the tag

Manage Order Templates

Order templates allow you to create standard templates for your orders.

1. Go to Field Service > Master Data > Templates
2. Create or select a template
3. Set the name
4. Set the standard order instructions

Usage

To use this module, you need to:

Add Field Service Locations

Locations are the specific places where a field service order is performed.

1. Go to Field Service > Master Data > Locations
2. Create a location

Add Field Service Workers

Workers are the people responsible for performing a field service order. These workers may be subcontractors or a company's own employees.

1. Go to Field Service > Master Data > Workers
2. Create a worker

Process Orders

Once you have established your data, you can begin processing field service orders.

1. Go to Field Service > Dashboard > Orders
2. Create or select an order
3. Enter relevant details for the order
4. Process order through each stage as defined by your business requirements

Known issues / Roadmap

The roadmap of the Field Service application is documented on Github.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

• Open Source Integrators

Contributors

• Wolfgang Hall <[email protected]>
• Maxime Chambreuil <[email protected]>
• Steve Campbell <[email protected]>
• Bhavesh Odedra <[email protected]>
• Michael Allen <[email protected]>
• Sandip Mangukiya <[email protected]>
• Serpent Consulting Services Pvt. Ltd. <[email protected]>
• Brian McMaster <[email protected]>
• Raphaël Reverdy <[email protected]>
• Ammar Officewala <[email protected]>
• Yves Goldberg <[email protected]>
• Freni Patel <[email protected]>
• Tecnativa:
  • Víctor Martínez
• Nils Coenen <[email protected]>
• Alex Comba <[email protected]>

Other credits

The development of this module has been financially supported by:

• Open Source Integrators <https://opensourceintegrators.com>

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainers:

This module is part of the OCA/field-service project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.