Features

• Per-partner grouping toggle — the new Group Invoice Subscriptions checkbox on the partner form decides, customer by customer, whether their recurring invoices are consolidated into a single document or generated one per subscription.
• Defaults to grouped — subscription_group = True for new partners, matching the most common business case (one invoice per customer per cycle).
• Auto-enables the consolidation parameter — ticking the checkbox automatically sets sale_subscription.invoice_consolidation = True, so the two features stay in sync without an extra config step.
• Custom invoice day — the Subscription Invoice Day integer (1–28) pins the recurring invoice date to a chosen day of the month; the first invoice date is shifted forward when the start date is later in the month.
• Cron-aware splitting — the recurring-invoice cron splits eligible subscriptions into grouped vs non-grouped and calls the super implementation for each set, with no_grouping=True for the non-grouped one.
• Postpaid safety — for fully-postpaid subscriptions with a partner-specific invoice day and no invoice yet, the next invoice date is left untouched so the first cycle is not skipped.

Configuration

Grouping is decided on the partner record; the related global parameter is enabled automatically when needed.

1. As a Sales Administrator, open Contacts → → Accounting. In the Subscription Invoice group you will find two new fields:

   • Group Invoice Subscriptions — tick to consolidate every recurring invoice run for this customer into a single invoice; untick to keep one invoice per subscription.
   • Subscription Invoice Day — integer between 1 and 28. When set, every subscription created for this partner is normalised so its first invoice date falls on that day of the month.

   

   

2. Save. The first time you tick Group Invoice Subscriptions, the global parameter sale_subscription.invoice_consolidation is set to True automatically — there is no separate switch to flip in the Settings page.

3. New subscriptions inherit the day-of-month rule via _compute_next_invoice_date: if the subscription starts after the configured day, the first invoice rolls to the next month; otherwise it stays in the current month.

Mixing modes is supported: you can have grouped and non-grouped partners in the same database — the recurring-invoice cron processes each set independently.

How it works

The module is fully driven by the recurring-invoice cron — once partners are configured, no extra action is needed at billing time.

1. Each time the Sale Subscription: generate recurring invoices cron runs, eligible subscriptions are fetched and split in two sets based on the partner-level Group Invoice Subscriptions flag.

2. For partners with the flag ticked, all their due subscriptions are consolidated: every subscription contributes its invoice lines to a single account.move for that partner / template / company.

   

   

   Opening either subscription's Invoices shows the same shared invoice with all subscription lines merged.

   

3. For partners with the flag unticked, the cron falls back to the standard Odoo behaviour — one invoice per subscription — using the no_grouping=True context.

4. When the partner has a Subscription Invoice Day configured, the first invoice of every new subscription for that partner is aligned to that day, so all the customer's subscriptions end up sharing the same monthly cycle and can be grouped cleanly on the next run.

The module is compatible with sale_subscription_suspended_periods (a dependency), so suspension days continue to be deducted line by line before the lines are consolidated.

Versions

19.0.1.0.1 (2026-05-25)

• Changelog tracking starts at this release.