Allows to spread costs or revenues over a customizable periods, to even out cost or invoice spikes.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Spread a cost or revenue from an invoice over several months, quarters or years, so big one-off amounts are evened out. Odoo creates the recurring journal entries automatically and reconciles them with the invoice line.
This module lets you take a single invoice line and split its amount over a chosen number of periods, instead of booking everything in one month. You set up a spread board with a start date, a number of repetitions and a period type (month, quarter or year), and Odoo builds the list of spread lines with their dates and amounts.
Where it appears: - A 'Spread Costs/Revenues' menu under Accounting, and 'Spread Templates' under the accounting configuration menu. - On the invoice form, each invoice line gets a button to link it to a spread board or open its details. - A wizard links an invoice line to an existing spread or to a template.
Business rules and automatic behaviour: - When you validate an invoice, matching templates can create the spread automatically, based on product, account or analytic distribution. - Spread lines due today or earlier are turned into journal entries by a scheduled job ('Cost/revenue Spread: Create Entries'), which can also post them and archive finished spreads. - The invoice line account must match the balance-sheet account of the spread, and entries are reconciled with the invoice line. - Cancelling the invoice deletes the spread lines and their journal entries; you cannot delete a spread linked to an invoice or with posted entries.
Company settings define default spread accounts and journals, whether planning before validation is allowed, auto-posting and auto-archiving.
Depends on
Required by other modules
Menus it adds
Models and fields (8)
- res.company · extends an existing modelauto_archive_spread (Auto-archive spread), force_move_auto_post (Auto-post spread lines), allow_spread_planning, default_spread_expense_account_id (Expense Spread Account), default_spread_expense_journal_id (Expense Spread Journal), default_spread_revenue_account_id (Revenue Spread Account), default_spread_revenue_journal_id (Revenue Spread Journal)
- account.move · extends an existing model
- account.spread · new modelname, active, line_ids (Spread Lines), days_calc (Calculate by days), all_posted, company_id, invoice_id, journal_id, currency_id, period_type, spread_date (Start Date), spread_type, template_id (Spread Template), invoice_type, total_amount, period_number (Number of Repetitions), posted_amount, invoice_line_id (Invoice line), unposted_amount, unspread_amount, debit_account_id, estimated_amount, invoice_line_ids (Invoice Lines), credit_account_id, move_line_auto_post (Auto-post lines), suitable_journal_ids, display_create_all_moves, use_invoice_line_account, display_recompute_buttons, display_move_line_auto_post (Display Button Auto-post lines)
- account.move.line · extends an existing modelspread_id (Spread Board), spread_check
- account.spread.line · new modeldate, name (Description), amount, move_id (Journal Entry), spread_id
- account.spread.template · new modelname, days_calc (Calculate by days), company_id, start_date, auto_spread (Auto assign template on invoice validate), period_type, spread_type, period_number (Number of Repetitions), auto_spread_ids (Auto Spread On), spread_account_id (Spread Balance Sheet Account), spread_journal_id (Journal), exp_rev_account_id (Expense/Revenue Account), use_invoice_line_account (Invoice account as spread account)
- account.spread.template.auto · new modelname, account_id (Account), company_id, product_id (Product), template_id (Spread Template)
- account.spread.invoice.line.link.wizard · new modelspread_id (Spread Board), company_id, invoice_id, spread_type, template_id (Spread Template), invoice_type, invoice_line_id, spread_account_id (Balance sheet account / Spread account), spread_journal_id (Spread Journal), exp_rev_account_id (Expense/revenue account), spread_action_type, use_invoice_line_account, spread_invoice_type_domain_ids
Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub
Availability by version
Reviewed: 2026-11-03Confirmation status: 7 confirmed, 2 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/account-financial-tools.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0To be able to access the full spreading features, the user must belong to Show Full Accounting Features group.
On the form view of the company, in the Account Spread tab, you can configure the journals in which the spread journal items will be generated by default:
- the Default Spread Journal for Revenues,
- the Default Spread Journal for Expenses.
In the same Account Spread tab, you can also configure the Spread Balance Sheet Accounts used by default:
- the Default Spread Account for Revenues,
- the Default Spread Account for Expenses.
This module by default allows the spreading even before the receipt of the invoice or when the invoice is still draft, so that it is possible to work on the plan of the cost/revenue spreading. To disable this feature, on the form view of the company disable the Allow Spread Planning option.
In Spread Template, there is also option to Auto assign template on invoice validate, based on the preset invoice line criteria.
On the form view of the company, the Auto-post spread lines option forces the account moves created during the cost/revenue spreading to be automatically posted. When this option is false, the user can enable/disable the automatic posting by the flag Auto-post lines present in the spread board.
On the form view of the company, enable the Auto-archive spread option if you want the cron job to automatically archive the spreads when all lines are posted.
Usage
Source · Odoo 18.0Define Spread Costs/Revenues Board
Under Invoicing -\> Accounting -\> Journals -\> Spread Costs/Revenues, create a new spread board.
Complete the definition of the spreading criteria, by setting the the fields:
- Debit Account
- Credit Account
- Estimated Amount (The total amount to spread)
- Number of Repetitions
- Period Type (Duration of each period)
- Start date
- Journal
Click on the "Recalculate unposted lines" button on the top-left to calculate the spread lines.
A cron job will automatically create the accounting moves for all the lines having date previous that the current day (today).
By default, the status of the created accounting moves is posted. To disable the automatic posting of the accounting moves, set the flag Auto-post lines to False. This flag is only available when the Auto-post spread lines option, present on the form view of the company, is disabled.
Click on button Recalculate entire spread button in the spread board to force the recalculation of the spread lines: this will also reset all the journal entries previously created.
Link Invoice to Spread Costs/Revenues Board
Create an invoice or vendor bill in draft. On its lines, the spreading right-arrow icon are displayed in dark-grey color.
Click on the spreading right-arrow icon. A wizard prompts to enter a Spread Action Type:
- Link to existing spread board
- Create from spread template
- Create new spread board
Select Link to existing spread board and enter the previously generated Spread Board. Click on Confirm button: the selected Spread Board will be automatically displayed.
Go back to the draft invoice/bill. The spreading functionality is now enabled on the invoice line: the spreading right-arrow icon is now displayed in green color.
Validate the invoice/bill. Click on the spreading (green) right-arrow icon to open the spread board, then click on the smart button Posted entries to see the moves of the spread lines together with the move of the invoice line.
In case the Subtotal Price of the invoice line is different than the Estimated Amount of the spread board, the spread lines (not yet posted) will be recalculated when validating the invoice/bill.
Define Spread Costs/Revenues Template
Under Invoicing -\> Configuration -\> Accounting -\> Spread Templates, create a new spread template.
- Spread Type
- Spread Balance Sheet Account
- Expense/Revenue Account This option visible if invoice line account is balance sheet account, user need to specify this too.
- Journal
- Auto assign template on invoice validate
When creating a new Spread Costs/Revenues Board, select the right template. This way the above fields will be copied to the Spread Board.
If Auto assign template on invoice validate is checked, this template will be used to auto create spread, if the underlining invoice match the preset product/account/analytic criteria.
No verified information in OCA: Installation.
Installation 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.