OdooWiki OCA HUB

Employee ID

hr_employee_id folder_open OCA/hr open_in_new
Generic Modules/Human Resources License: AGPL-3

Company wide unique employee ID. Supports:

  • Random ID Generation
  • Sequence

This module supports sequence of employee ID which will be generated automatically from the sequence predefined.

Nevertheless, if you need a difference ID in particular cases you can pass a custom value for identificationid: if you do it no automatic generation happens.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Automatically gives every employee a unique company-wide identification number, either random or from a sequence, and blocks duplicates.

This module adds a company-wide unique employee number to Odoo. When a new employee is created without an identification number, the system fills it in automatically.

  • Two generation methods are available per company: Random (a set number of digits) or Sequence (using a predefined numbering pattern).
  • The default is Random with 5 digits, and a ready-made sequence called Employee Identifier is provided.
  • If you type your own identification number when creating an employee, no automatic number is generated.
  • The number must be unique across all companies; Odoo refuses to save a duplicate.
  • If it cannot find a free number after 50 attempts, it shows an error message.

Where it appears: - On the employee form, the identification number is shown under the employee name. - It is also visible in the employee list, in the search filters, and on the employee kanban cards. - In Settings, under the Human Resources section, a new Employee Identifier block lets you choose the generation method, the number of digits, or the sequence.

Only users with HR officer rights can see and edit the identification number. The settings are company-specific, so each company can use its own numbering scheme.

Depends on

hr
Models and fields (3)
  • hr.employee · extends an existing modelidentification_id (Identification No)
  • res.company · extends an existing modelemployee_id_sequence (Identifier Sequence), employee_id_gen_method (Generation Method), employee_id_random_digits (# of Digits)
  • res.config.settings · extends an existing modelemployee_id_sequence, employee_id_gen_method, employee_id_random_digits

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

terminal Installation and usage

OCA documentation · Odoo 18.0

Installation

Source · Odoo 18.0

To install this module, you need to:

  • clone the branch 11.0 of the repository
  • add the path to this repository in your configuration (addons-path)
  • update the module list
  • search for "Employee Identification Numbers" in your addons
  • install the module

Configuration

Source · Odoo 18.0

If you want to modify the format of the sequence, go to Settings -\> Technical -\> Sequences & Identifiers -\> Sequences and search for the "Employee ID" sequence, where you modify its prefix and numbering formats.

To configure the 'ID Generation Method', the '# of Digits' and the 'Sequence', activate the developer mode and go to Employees -\> Configuration -\> Settings -> Employee Identifier

Usage

Source · Odoo 18.0

When you will create a new employee, the field reference will be assigned automatically with the next number of the predefined sequence.

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.