OdooWiki OCA HUB

HR Contract Reference

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

This module was written to extend the functionality of employees contracts to support sequence of contract reference which will be generated automatically from the sequence predefined.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Automatically gives every employee contract a unique reference number, such as EC/2025/00001, when the contract is created.

This module changes how the Contract Reference field on employee contracts works. Instead of typing a reference by hand, Odoo fills it in automatically when a new contract is saved.

  • The reference is generated from a predefined numbering sequence, so each contract gets a unique number.
  • The format uses a prefix with the year followed by a five-digit number, for example EC/2025/00001.
  • The field is read-only, so users cannot accidentally change the reference after it is created.
  • When a contract is copied, the reference is not copied with it; a new one is generated for the copy.
  • If a reference is already provided when the contract is created, Odoo keeps it instead of generating a new one.

The feature appears on the employee contract form in the Human Resources app, on the hr.contract model. No new menus or reports are added. The numbering sequence is installed with the module and is used only for contract references.

Depends on

hr_contract
Models and fields (1)
  • hr.contract · extends an existing modelname (Contract Reference)

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

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 "Contract Reference" sequence, where you modify its prefix and numbering formats.

Usage

Source · Odoo 18.0

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

No verified information in OCA: Installation.

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.