# 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.

- **What it is:** 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.
- **For:** Accounting
- **Odoo versions:** 16.0, 17.0, 18.0, 19.0, 20.0 - Community and Enterprise
- **Runs on:** Odoo.sh or Odoo you host yourself - not Odoo Online, which accepts no third-party apps
- **Price:** 397 EUR, one-time, on the Odoo Apps Store
- **Technical name:** bambooforge_revrec_subscription
- **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:** https://docs.bambooforge.dev/bambooforge_revrec_subscription/
- **Live demo:** https://demo20.bambooforge.dev/odoo
- **Store page:** https://apps.odoo.com/apps/modules/20.0/bambooforge_revrec_subscription
- **Manual last updated:** 2026-11-12

---
# Revenue Recognition All in One with Subscriptions

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

1. 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.
2. 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

1. Give a subscription a line of a product that defers its revenue.
2. Bill it: the job or **Bill what is due**.
3. The invoice's lines carry the billing period as their service period.
4. 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.

## Reference

The complete reference of this bridge is generated from the code on every release and published
with this manual at https://docs.bambooforge.dev/bambooforge_revrec_subscription/ under
*Reference*.

## 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](mailto: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.
