v 14.0 Third Party 9187
Download for v 14.0 Deploy on Odoo.sh
Odoo Online
On Premise
Odoo Apps Dependencies Invoicing (account)
Discuss (mail)
Lines of code 5221
Technical Name contract
Versions 11.0 9.0 15.0 16.0 14.0 12.0 13.0
You bought this module and need support? Click here!

Recurring - Contracts Management

Production/Stable License: AGPL-3 OCA/contract Translate me on Weblate Try me on Runboat

This module enables contracts management with recurring invoicing functions. Also you can print and send by email contract report.

It works for customer contract and supplier contracts.

Contracts are shown in portal.

Table of contents


To view discount field in contract line, you need to set Discount on lines in user access rights.

Contracts can be viewed on the portal (list and detail) if the user logged into the portal is a follower of the contract.


  1. Contracts are in Invoicing -> Customers -> Customer and Invoicing -> Vendors -> Supplier Contracts
  2. When creating a contract, fill fields for selecting the invoicing parameters:
    • a journal
    • a price list (optional)
  3. And add the lines to be invoiced with:
    • the product with a description, a quantity and a price
    • the recurrence parameters: interval (days, weeks, months, months last day or years), start date, date of next invoice (automatically computed, can be modified) and end date (optional)
    • auto-price, for having a price automatically obtained from the price list
    • #START# - #END# or #INVOICEMONTHNAME# in the description field to display the start/end date or the start month of the invoiced period in the invoice line description
    • pre-paid (invoice at period start) or post-paid (invoice at start of next period)
  4. The “Generate Recurring Invoices from Contracts” cron runs daily to generate the invoices. If you are in debug mode, you can click on the invoice creation button.
  5. The Show recurring invoices shortcut on contracts shows all invoices created from the contract.
  6. The contract report can be printed from the Print menu
  7. The contract can be sent by email with the Send by Email button
  8. Contract templates can be created from the Configuration -> Contracts -> Contract Templates menu. They allow to define default journal, price list and lines when creating a contract. To use it, just select the template on the contract and fields will be filled automatically.
  • Contracts appear in portal to following users in every contract:
https://raw.githubusercontent.com/OCA/contract/14.0/contract/static/src/screenshots/portal-my.png https://raw.githubusercontent.com/OCA/contract/14.0/contract/static/src/screenshots/portal-list.png https://raw.githubusercontent.com/OCA/contract/14.0/contract/static/src/screenshots/portal-detail.png

Known issues / Roadmap

  • Recover states and others functional fields in Contracts.
  • Add recurrence flag at template level.

Bug Tracker

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.



  • Tecnativa



This module is maintained by the OCA.

Odoo Community Association

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.

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.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.
excellent module
محمد يوسف
on 1/22/22, 8:29 AM

I was searching for a contract module with these options for a long time in free and paid, 

but finally, I find your module is free and covers all options related to contracts.

Thanks very much 

installment ??
Turki Ahmad
on 1/29/23, 4:11 AM

do I have to make all installments for the contract before starting the contract?

is there a user guide for this module
Turki Ahmad
on 1/29/23, 4:07 AM

I have a problem using this module.

for example, wine paying 2 serves that have different analytic account how can i make a payment for the 2 different analytic accounts at the same timee