OdooWiki OCA HUB

French Localization - Check Social Security Number

l10n_fr_hr_check_ssnid folder_open OCA/l10n-france open_in_new
Human Resources License: AGPL-3

With this module, the social security number of employees of French companies will be checked: if the length or checksum is wrong, an error message will be displayed.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Checks the Social Security Number entered on employee records for French companies and blocks saving when the number is invalid.

This module adds a validation rule to employee records in Odoo. When a company's country is France or one of its overseas territories (such as Guadeloupe, Martinique, French Guiana, Réunion, Mayotte, French Polynesia, Saint-Pierre-et-Miquelon, Saint-Martin, Saint-Barthélemy or New Caledonia), the Social Security Number stored on the employee form is verified automatically.

  • The check runs whenever the Social Security Number field is saved on an employee.
  • If the number has the wrong format, the wrong length, or an incorrect checksum, Odoo refuses to save and shows an error message containing the number and the reason.
  • If the number is empty, no check is performed.
  • The rule applies to the hr.employee model and uses the company's country to decide whether the French rule applies.

There are no new menus or screens: the validation appears directly on the existing employee form. The module relies on an external Python library to perform the actual number validation.

Depends on

hr

Required by other modules

Models and fields (1)
  • hr.employee · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 18.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: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 18.0

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

terminal Installation and usage

OCA documentation · Odoo 18.0

This module require the Python stdnum library. To install it, run:

pip3 install python-stdnum

Check that the country of the company is France. Go to the menu Employees \> Employees, select an employee. In the tab Private Information, enter the French social security number in the field SSN No.

No verified information in OCA: 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.