OdooWiki OCA HUB

French Departments (Départements)

l10n_fr_department folder_open OCA/l10n-france open_in_new
French Localization License: AGPL-3

This module creates a new model res_country_department, sub division of the res_country_state and populate it with all the french departments, but only the french departments of mainland. If you need the overseas departments, please install the module l10n_fr_department_oversea.

It also adds a computed many2one country_department_id field on the res_partner object.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds French departments (départements) as a new reference list in Odoo and automatically fills in a contact's department from their postal code and city.

This module gives Odoo a proper list of French departments, which sit between the region (state) and the city. A new "Departments" entry appears under the Localisation menu in the Contacts app, where you can list, search and open departments. Each department has a name, a code (the official ISO code such as 01, 2A or 75), the region it belongs to and, indirectly, the country. The list is pre-loaded with the departments of mainland France, and the same code cannot be used twice within one country.

On contacts, a new "Department" field is added. It is calculated automatically from the contact's country, postal code and city, so users do not type it by hand. The calculation only applies to France and the French overseas territories (Guadeloupe, Martinique, French Guiana, Réunion, Mayotte). It handles special cases such as Corsica (2A/2B), overseas codes starting with 97, and a list of postal codes that are shared between several departments, where the city name is used to decide. When the module is installed, existing contacts are recalculated so the field is filled in.

Users can group and filter contacts by department in the Contacts search view, and the field can be shown as an optional column in the contact list. On the contact form it is only visible to users with technical settings enabled.

Depends on

Menus it adds

menu_res_country_department
Models and fields (3)
  • res.partner · extends an existing modelcountry_department_id (Country Department)
  • res.country.state · extends an existing modeldepartment_ids (Departments)
  • res.country.department · new modelcode (Department Code), name (Department Name), state_id, country_id

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: 8 confirmed, 1 with no information of 9 versions.

Sources · Odoo 13.0

Confirmed on 2026-11-03 in branch 13.0 of OCA/l10n-france.

terminal Installation and usage

No verified information

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.

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.