Docs › Accounting › Revenue Recognition All in One with Subscriptions

Revenue Recognition All in One with Subscriptions
The billing period of a subscription invoice becomes its service period, so the revenue defers itself - installed by itself when Revenue Recognition and Subscription Billing are both present.
bambooforge_revrec_subscriptionKey facts
- Not for
- Touch a line that has a period. A line already carrying a service period keeps it.; Touch a product that does not defer. Its lines stay as Subscription Billing made them.
- Manual last updated
- 2026-11-12
Subscription Billing knows which days each invoice pays for; Revenue Recognition needs to know it to spread the revenue. This bridge writes the billing period of a subscription invoice on its lines as their service period, so the invoice of a deferred product defers itself over the period it bills. It installs by itself when both apps are on Odoo 20, and has nothing to set up.
This page is the complete manual of the bridge; each app has its own.
Overview
For whom. A business that bills subscriptions for services delivered over time and reports revenue when it is earned. It needs Subscription Billing and Revenue Recognition, on Odoo 20.
What it does
The billing period is the service period. Each line of a subscription invoice whose product defers its revenue gets Service from and Service to: the first and last day of the period billed.
Posted or draft. With Post automatically, the period is there when the invoice is posted, so its schedule is made at once. A draft gets the period on its lines and its schedule when a person posts it.
Coupons and usage. An invoice priced after posting (usage, coupon) keeps its revenue deferred, at the priced amount.
Plan changes. The invoice or credit note that settles a plan change carries the days it settles as its service period.
What it does not do
Touch a line that has a period. A line already carrying a service period keeps it.
Touch a product that does not defer. Its lines stay as Subscription Billing made them.
What it needs
Subscription Billing and Revenue Recognition on Odoo 20, Community or Enterprise.
A product with Defer revenue on a subscription's lines.
What each app needs, in its own manual: on Community, Revenue Recognition's hidden accounting groups for the people who post the invoices of deferred products.
Concepts
Billing period. The days a subscription invoice bills.
Service period. The days an invoice line pays for, which Revenue Recognition spreads its revenue over.
Install and first run
Install both apps. The bridge installs by itself when its folder is in the addons path.
Expected: nothing to set up; there is no menu of its own.
Bill a subscription of a deferred product with Bill what is due.
Expected: each line of the invoice shows the period's first and last day as Service from and Service to; posted, the invoice's button opens its schedule.
Uninstalling
Uninstalling changes nothing already written: the service periods stay on the invoice lines and the schedules stay as they are.
Flows
One thing the bridge does for you.
Bill a subscription of a deferred product
Give a subscription a line of a product that defers its revenue.
Bill it: the job or Bill what is due.
The invoice's lines carry the billing period as their service period.
Posted (by the billing or by a person), the invoice gets one schedule per deferred line, over that period, and its deferral entry.
How it works
What the bridge writes
While the billing makes an invoice, it passes the period along, so the posting reads it.
After that, every deferred line without a service period gets the period written on it.
If the invoice was already posted and such a line was found, its schedules are made then.
Who reads and writes what
The bridge writes with the rights of whoever bills: the job's (OdooBot) or the user's who pressed Bill what is due.
What may be read and changed is each app's own rule; see their manuals.
How we make sure it works
Before every release, 3 automated checks run against this app on Odoo 16, 17, 18, 19 and 20. Among them:
A coupon still leaves the revenue parked.
Subscription invoice defers over its period.
The complete list is in the source you receive.
For managers
The bridge has no figures of its own: the subscriptions' revenue shows in Revenue Recognition's Waterfall and SaaS Metrics, and the subscriptions' value in Subscription Billing's MRR analyses.
No document prints from this bridge.
Troubleshooting and FAQ
... defers revenue but has no service period. On a plan change, before this version: give the settling document's line its period (the change day to the end of the paid period) and post it.
The other messages come from the two apps: see their manuals.
Questions people ask
Do I set anything up? No. A product with Defer revenue is enough.
What period does an invoice in arrears get? The period it bills, like any other.
Support
Write to support@bambooforge.dev with your Odoo series and what the screen said.
Changelog
20.0.1.0.1
This manual, the bridge's first.
20.0.1.0.0
The billing period of a subscription invoice becomes its service period, so its revenue defers itself.
Reference
Generated from the module's own code (version 20.0.1.0.1, series 20.0) on 2026-11-12; every menu, field, setting, scheduled action, group, rule, report and endpoint below is read from the files, not written by hand.
Models
bf.subscription (extends bambooforge_subscription's bf.subscription)
Adds no fields.