Contract Line Successor

Contract Line Successor extends contract.line model to support advanced contract lifecycle management, including suspension, successor planning, cancellation, and renewal.

It provides a flexible and robust framework for managing complex contract line scenarios in a clean and structured way.

Features

Successor and Predecessor Management
- Link contract lines with successor and predecessor lines.
- Plan successors automatically or manually after a stop or suspension.
Contract Line Lifecycle States
- Manage contract lines with the following computed states:
  - Upcoming
  - In-Progress
  - To Renew
  - Upcoming Close
  - Closed
  - Canceled
Lifecycle Operations
- Stop a contract line.
- Plan a successor for a contract line.
- Stop and plan a successor in one operation (useful for suspensions).
- Cancel and un-cancel contract lines.
- Renew contract lines automatically (new line or extension).
Auto-Renewal Handling
- Auto-renewal based on company settings (extend existing line or create a new one).
- Cron job to automate renewal of eligible contract lines.
Data Integrity and Validation
- Prevent invalid successor or predecessor configurations.
- Validate state transitions and date overlaps.
- Ensure clean renewal and cancellation workflows.
Audit Trail
- Automatic posting of chatter messages for lifecycle events like stops, renewals, suspensions, cancellations, etc.

Table of contents

Configuration

Auto-Renewal Strategy

In the company settings, define whether renewing a contract line:
- Extends the current line (updates date_end),
- or creates a new successor contract line.
Field:

Company > Configuration > Contracts > Create new contract line at renewal
Scheduled Actions

Ensure the scheduled action Contract Line: Auto Renew is activated if you want automatic renewal without manual intervention.

Usage

Select a contract and enable the option “Recurrence at line level?”.
Once enabled, you will have access to several actions at the contract line level:
- Stop a contract line and optionally plan a successor.
- Handle temporary suspensions and resume the contract line after the suspension period.
- Cancel and un-cancel contract lines if necessary.
- Renew contract lines either by extending the current line or by creating a new successor line automatically.

The contract lines list is colour-coded by their lifecycle state so the status is readable at a glance (mirroring the contract list and Odoo’s own draft/expired conventions):

Upcoming — blue (like a draft order), the line has not started yet.
In-progress — normal, the line is currently running.
To renew / Upcoming close — purple, the line needs attention before its end date (distinct from orange/warning, which is kept for real problems).
Closed / Canceled — muted/grey, the line is no longer active.

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

ACSONE SA/NV

Contributors

Souheil Bejaoui souheil.bejaoui@acsone.eu (ACSONE SA/NV)

Maintainers

This module is maintained by the OCA.

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

This module is part of the OCA/contract project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

Metadata

Release files for odoo-addon-contract-line-successor 19.0.1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-contract-line-successor 19.0.1.0.1
File	Interpreter	ABI	Platform	Reset
odoo_addon_contract_line_successor-19.0.1.0.1-py3-none-any.whl 63.3 kB Sep 22, 2026	Python 3	none	any	Details

Release files / odoo_addon_contract_line_successor-19.0.1.0.1-py3-none-any.whl

Download URL	odoo_addon_contract_line_successor-19.0.1.0.1-py3-none-any.whl
Size	63.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`198d6765b8513c591ba46379a9ddbb8e3cd79b60766d84ec77c3c937af77b854`
BLAKE2b-256 checksum How to use checksums	`b02ea501556bce9e2ffc88a87762ca5d301ea7f0be5ac5083f66ec998e177594`
Upload date	Sep 22, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.14.4`