OdooWiki OCA HUB

Base Territory

base_territory folder_open OCA/field-service open_in_new
Hidden License: AGPL-3

This module allows you to define territories, branches, districts and regions to be used for Field Service operations or Sales.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Lets you define a sales or field-service coverage structure in Odoo: regions, districts, branches and territories, each with a responsible manager. Territories can be defined by ZIP codes, states or countries.

This module adds a simple geographic coverage structure to Odoo, made of four levels: Region, District, Branch and Territory. Each level is a separate record you can create, edit and delete from the Users menu, where four new entries appear: Regions, Districts, Branches and Territories.

  • Regions hold a name, a description and a Region Manager (a contact).
  • Districts belong to a Region and can have a District Manager.
  • Branches belong to a District and can have a Branch Manager.
  • Territories belong to a Branch; their District and Region are filled in automatically from the branch, so you do not retype them.

On a Territory you choose a type: Zip, State or Country. If you pick Zip, a ZIP Codes field appears; if you pick Country, you can list the countries covered. The form also has a Definition tab for the description.

The module also extends the standard Country screen: each country can be linked to one Territory and to several Regions, shown as a list you can edit directly on the country form.

All four new record types are readable and editable by every internal user. No automatic emails, scheduled jobs or validation rules are added by the code.

Depends on

base

Required by other modules

fieldservice

Menus it adds

TerritoriesBranchesDistrictsRegions
Models and fields (5)
  • res.branch · new modelname, partner_id (Branch Manager), description, district_id (District)
  • res.region · new modelname, partner_id (Region Manager), description
  • res.country · extends an existing modelregion_ids (Regions), territory_id (Territory)
  • res.district · new modelname, region_id (Region), partner_id (District Manager), description
  • res.territory · new modelname, type, branch_id (Branch), region_id (Region), zip_codes (ZIP Codes), country_ids (Country Names), description, district_id (District)

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 7 confirmed, 2 with no information of 9 versions.

Sources · Odoo 14.0

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

terminal Installation and usage

OCA documentation · Odoo 19.0

Usage

Source · Odoo 19.0

To use this module, you need to:

  • Go to Settings \> Users & Companies
  • Define your territories, branches, districts and regions with their respective manager.

No verified information in OCA: Installation, Configuration.

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.