Subtotals & Recurring

Clearly present quotes that mix one-shot services and recurring subscriptions.

Are you an IT services provider, telecom reseller, hosting company, installer, or agency? Your quotes often combine a one-shot part (hardware, setup, training...) and a recurring part (monthly subscription, maintenance, hosting, license...). With a standard Dolibarr PDF template, these two types blend into a single totals column — the customer can't tell what they pay once from what they pay every month.

SousTotalAbo adds two new PDF templates that visually structure your proposals:

• 📋 Automatic subtotals per category (One-shot / Subscription) in the line table
• 💰 Dedicated subscription block at the bottom-left of the PDF, with HT / VAT / TTC totals
• 🔄 Global total (Services + materials) kept at the bottom-right, like a standard PDF
• 📅 Two variants to choose from: monthly or yearly subscription

How it works

The template relies on the format of the lines you add to your proposal. No extra field to configure.

1. Title lines (subtotal)

To create a section title that triggers a subtotal, add a line with:

• Description formatted as an HTML heading (<h1>, <h2>, <h3>, or <h4>)
• Quantity = 0

In the PDF, only the description and the section subtotal will be displayed. The other columns (unit price, VAT, etc.) are hidden.

2. Comment lines

To add a note or a free explanatory paragraph, add a line with:

• Description formatted as an HTML division (<div>)
• Quantity = 0

Only the description is shown in the PDF, without a price table.

3. Subscription lines

Any line whose reference or label contains abo (case-insensitive) is automatically classified as a subscription and feeds the "Subscription Total" block at the bottom-left of the PDF.

Examples that trigger detection: SE-ABO-Hosting, Abonnement maintenance, MO-ABO-J1, Yearly abo subscription...

4. Normal lines

Any other line (plain text description, quantity > 0) is treated as one-shot and appears in the One-shot subtotal as well as in the global Services + materials total.

⚠️ Important prerequisite

The payment mode must be set on the proposal, otherwise the total blocks at the bottom of the PDF don't align correctly (layout issue). It's a standard Dolibarr field you usually fill in anyway — just don't leave it empty.

Limitations

• Single subtotal level (no nested H1 > H2 > H3 hierarchy). If you put an H1 followed by an H2, they create two separate sections, not a hierarchy.
• Subscription detection is text-based: the string abo must appear in the reference or label. No boolean "is a subscription" field is used.

Typical use cases

• 🌐 Hosting / SaaS: quote combining setup fees + monthly subscription
• 📞 Telecom reseller: hardware (phone, switch) + SIM/monthly subscription
• 🛠️ IT services / MSP: hardware + one-shot labor + monthly maintenance contract
• 🏢 Installer (alarms, copiers, HVAC): installation + yearly maintenance contract
• 🎨 Agency / freelance: one-shot project + monthly retainer

Technical details

• Compatible with Dolibarr 23.x
• Installs via Setup → Modules → Deploy an external module
• No external dependency, no core modification
• Coexists with the other PDF templates (Azur, Crabe, Cyan, etc.) — you can switch back to a standard template at any time
• Factored architecture: the generation logic is shared between the two variants (monthly/yearly) to ease maintenance and future evolutions
• GPL-3.0+ license

What's next?

Upcoming versions will add: quarterly variant, configurable detection keyword (instead of the hardcoded abo), choice of the number of subtotal levels. Your suggestions are welcome.

Other modules by Media-Interactive

• 📋 MultiSelect — Bulk actions on proposal lines: mass deletion and discount, in one click.
• 📧 AutoSendMail — Automatic email sending of recurring invoices. A massive time-saver for subscriptions and monthly billing.
• 🌙 Dark Mode — Dark theme for Dolibarr. Free, contributed to the community.

All our modules are developed and maintained by Media-Interactive.