Features

• Dated suspension intervals — a new sale.subscription.suspended.period model stores Start, End and Suspension Reason per subscription, exposed as a Suspended Periods notebook tab on the subscription form.
• Overlap validation — periods are validated on save: end must be after start, and overlapping periods on the same subscription raise a clear error so suspensions stay clean.
• Pro-rata credit line — at invoice generation, every period that overlaps the invoiced window adds a negative line with quantity = -original_quantity and a unit price scaled by days_suspended / days_invoiced, leaving the recurring line at full price for traceability.
• Carry-over across invoices — when a suspension extends past the current invoice period, the remaining days are deducted from the next invoice automatically, until the suspended interval is fully applied.
• Human-readable description — the credit line label includes the subscription name, the original line name and the Suspended period: start to end range formatted in the partner language.
• Self-healing cron — is_invoice_cron flags left over from an interrupted run are reset before the next recurring-invoice cron, so a previously skipped subscription is picked up again.

Configuration

There is no global switch — suspended periods are declared directly on the subscriptions that need them.

1. As a Sales Manager, open Subscriptions → Subscriptions and select the subscription you want to pause for a given interval.
2. Open the Suspended Periods tab (visible only when is_subscription is true).
3. Click Add a line and fill in:
   • Start — first suspended day (required).
   • End — last suspended day (optional; leave empty for an open-ended suspension that will keep deducting days until you close it).
   • Suspension Reason — free text used for traceability (holiday, service pause, dispute, ...).
4. Save. Validation prevents overlapping periods on the same subscription and end dates earlier than start dates, so the data stays consistent.

Suspended periods take effect immediately: the next recurring invoice generated for this subscription — either manually from the Generate Invoice action or by the scheduled cron — applies the pro-rata credit based on the overlap between the suspended interval and the invoiced period.

To remove a suspension, simply delete the line. Already-issued credit lines on previous invoices are not affected; only future invoices will stop deducting from that interval.

To install this module, you need to:

• update the module list
• search for "Sale Subscription Suspended Periods" in your addons
• install the module

How it works

Once a suspended period is declared on a subscription, the recurring invoice flow handles the rest. Here is a worked example for a Monthly plan with a suspension that straddles two invoices.

1. Declare the suspended interval on the subscription's Suspended Periods tab. The example below adds a single period that covers part of May and part of June.

   

2. The next recurring invoice is generated as usual — for the period 24 May – 23 June. The invoice contains the standard recurring line at full price, followed by a negative line carrying the pro-rata credit for the suspended days that fall inside this invoice window. The credit line label spells out the exact suspension dates.

   

3. The portion of the suspension that did not fit inside the first invoice (here, 24 June – 30 June) is automatically carried into the next invoice. When the following recurring run produces the 24 June – 23 July invoice, it deducts the remaining suspended days the same way.

   

The recurring line itself is never altered, so reporting on subscription revenue stays clean — the suspension is always visible as a separate, signed line. The same logic applies to grouped invoices (when sale_subscription_group_invoice is installed), to multiple parallel suspended periods on the same subscription, and to open-ended suspensions (no end date) which keep deducting until they are closed manually.

Versions

19.0.1.0.0 (2026-05-25)

• Changelog tracking starts at this release.