This module allows you to manage versions for partner addresses.
A list of fields are defined for versioning. These are immutable once set, and force the user to create a new partner if they want to change one of these fields.
This forces historical consistency. For example, the moment you confirm a sale order, you might want to lock the address of that sale order instead of having it change everytime that partner is modified (see e.g sale_partner_version).
auto_awesome What this module does
AI-generated from the code · Odoo 14.0Locks a partner's address details (name, street, city, country, parent) once they are first used, so they can no longer be changed. To change them, users must create a new partner, keeping historical addresses intact.
This module adds address versioning to contacts in Odoo. When a user first saves a change to one of the versioned fields on a contact, the module automatically creates an archived copy of the contact holding the original values, and marks the original contact as versioned. From then on, those fields are frozen: any attempt to modify them raises a blocking error telling the user they cannot change a versioned field and must create a new partner instead.
The versioned fields are the contact's name, street, street 2, zip, city, country and parent company. Two new read-only fields appear on the contact form: a version hash and a date version, showing when the version was created.
- The module works on
res.partnerand extends the partner merge wizardbase.partner.merge.automatic.wizard. - It adds automatic behaviour on save: the first write to a versioned field triggers the creation of the archived version.
- It adds a business rule: once versioned, those fields cannot be edited, and a clear error message is shown.
- It also adjusts the partner merge wizard so that merging contacts respects the versioning logic.
No new menus or screens are added; everything happens on the existing contact form and through the standard save action.
Depends on
Required by other modules
Models and fields (2)
- res.partner · extends an existing modeldate_version (Date version), version_hash
- base.partner.merge.automatic.wizard · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 14.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-03Confirmation status: 2 confirmed, 7 with no information of 9 versions.
Sources · Odoo 14.0
Confirmed on 2026-11-03 in branch 14.0 of OCA/partner-contact.
terminal Installation and usage
No verified informationInstallation 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.
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.