MBI Contrat Abonnement

✅ Compatibility

Module version: 22.0.0
Publisher/Licence: MB Informatique / GPL-v3
User interface language: English, French
Help/Support: MB Informatique
Prerequisites:

• Dolibarr min version: auto
• Dolibarr max version: auto

The Contrat Abonnement module allows the management of subscriptions as well as their mass invoicing.

It is possible to configure the number of alert days before and after the due date.

The module adds a widget to the "Subscriptions to be billed" home page and a new "subscription" tab on contracts.

You can indicate whether the price of the service is a price per hour / day / week / month / quarter / semester / year.

The subscription period can be repeated every month / two months / quarter / quarter / semester / year / three years.

You can choose whether to invoice the subscription at the beginning or end of the period.

By default, the module uses calendar periods to invoice all subscriptions on the same date.

A period always begins at the beginning of the month and ends at the end of the month except possibly for the first and last period.

The amount of the invoice depends on the number of days in the period. A subscription can be terminated or reactivated at any time.

Each subscription can be billed separately, but the module allows their mass billing by clicking on the link in the widget for a significant amount of bills. In this case, you can choose to validate and generate the invoices and mark them as paid as well as send them by email.

It is possible to renew subscriptions by entering the number of periods to be created for the renewal and not to specify an end date on the service.

Demo : https://demo.mbicloud.fr 

- Drop the folder ‘contratabonnement’ in htdocs/custom or use the option ‘Deploy/install external app/module’ in the list of modules.
- Activate the Contrat Abonnement module which is now in the list of modules and change the module setup according to your needs.

🛠 Updates

Update 22.0.0 (03/02/2026) :
- Added an editable discount field to change the discount and recalculate amounts for each subscription within a contract.
- Added a field to display service descriptions on invoices within a subscription contract.
- Fixed the display of discounts in the bulk billing list.

Update 21.0.0 (09/18/2025) :
- Ability to take into account the actual number of days in the month (instead of a fixed 30-day month) when pricing is based on a daily rate.
- When editing the end date of a service/contract, the module can automatically adapt subscription periods (remove periods that exceed the new end date + prorate the last amount).
- In edit mode, if you change a period date, the amount can be recalculated automatically when the “per day” mode is used.
- Fixes to totals and selected amount when discounts are applied, to avoid display/calculation discrepancies.
- Cleanup and adjustments to reduce error risks and make installation/data handling more robust.

Update 20.0.0 (05/07/2025) :
- Ability to automatically use, when available, the payment terms, payment method, and now also the bank account defined on the third-party record (otherwise the module uses its default settings).
- Improved/clarified subscription-to-invoice comparison tool (importing a bank file in XLS format) to make checks easier.
- Adjustments and cleanup to improve day-to-day reliability.

Update 19.0.1 (09/17/2024) :
- Added a screen to compare amounts to be invoiced in Dolibarr with a bank file (XLS format) to ease controls and quickly spot discrepancies.
- Ability to use the customer’s payment method and payment terms (when set on the third-party record) instead of the module’s default settings.
- Display and processing improvements so discounts are better handled and easier to read during the invoicing process.
- General fixes and improvements (especially around sensitive actions) to reduce errors and improve reliability, including adjustments related to protections (tokens) and stability fixes.
- Various UI tweaks, labels, and cleanup to make the module more stable and pleasant to use day to day.

Update 17.0.0 (08/30/2023) :
- During invoicing (single or mass), the service description is now handled more appropriately.
- Adjustments to subscription/order tracking boxes (widgets) for a cleaner and more consistent display.
- Various fixes and cleanup to stabilize the module (loading translations/labels, compatibility, internal improvements).

Update 16.0.0 (07/04/2023) :
- Improved action tracking (invoice creation/validation/payment/document generation, email sending, etc.) with a dedicated log file that can be downloaded from the interface.
- Adjustments to required permissions to avoid unnecessary access blocks (while keeping Dolibarr security).
- New description display options: choose to show/hide service descriptions on invoices or in the contract “Subscriptions” tab.
- Improvements to mass invoicing: clearer interface (harmonized labels, grouped options), better operation traceability (more explicit logs).
- Fixes for various cases that could trigger errors during processing.
- Adjustments to ensure proper operation on more recent environments (notably PHP 8.1).

Update 15.0.0 (04/08/2022) :
- Added/fixed security tokens on several forms (configuration, mass invoicing, contract page) to prevent errors and improve protection for sensitive actions.
- Fixed an issue when creating a supplier invoice from a supplier order/subscription (better handling of the supplier third party and related fields).
- Secured forms (token) to prevent unexpected behavior during selections/submissions.
- Cleaned up description display (removed unnecessary line breaks/formatting) for better readability on records.

Update 14.0.0 (03/01/2021) :
- Support for durations (added to the duration selector + related translations).
- Adjusted seed data (tables/insertions) so frequencies and period splits are consistent.
- Added a dedicated “payment terms” setting for subscriptions (in addition to payment method), configurable in admin.
- More explicit display (e.g., bank account label in addition to reference, translated labels for payment methods/terms).
- Configurable reminder windows (days before / days after) for due periods displayed in the home box.
- Fixed the assignment of settings (payment method/terms) during invoice generation.
- Fixed checkbox display and improved reliability of selected amount recalculation.
- Added private notes in the list and/or in the mass generation process.
- Changed log location: moved from a single “logs.txt” file to a dedicated `logs/` structure (e.g., `logs/logs.txt` + `logs/index.html`), and updated log writes in scripts (invoicing and email sending).
- Added the required elements to manage subscriptions on supplier orders.
- Added supplier-side invoicing/record scripts (including supplier mass invoicing and supplier email sending).
- Added a “supplier order subscriptions” tracking box (upcoming due dates, late warning, link to supplier mass invoicing if available).

Initial version 1.0 :
- Subscription management for Dolibarr products and services, as an extension to the Contract module.
- Automatic creation and calculation of subscription periods (dates + amounts) based on the schedule.
- Periodicity settings (monthly, quarterly, four-monthly, half-yearly, yearly) and billing mode (rate “per”, billed in arrears/in advance).
- Civil (calendar-based) periods generated by default, with proration on the first/last period if needed.
- Period tracking (status, amounts, “invoiced” flag) and subscription ↔ invoice linking.
- Subscription invoice creation by selecting periods to invoice (with an option to “mark as invoiced”).
- Home dashboard box to track periods to invoice + configurable alerts before/after due date.
- Printing/exporting period status (PDF/ODT depending on version) with an editable ODT template.

The MBI Contrat Abonnement module is edited by MB Informatique SARL (SIRET: 83434236200029), whose head office is located at 120 Rue de l'Île Napoléon 68170 Rixheim - Tel. : 03 67 262 242. This End-user License Agreement legally frame the use of the services of the MBI Contrat Abonnement module.

MB Informatique SARL declines all responsibility for any viruses that may infect the User's computer equipment after use or access to this module.

The total guarantee of data security, integrity and confidentiality, whatever it is, is not guaranteed by MB Informatique SARL.

The user must check his invoices and amounts, MB Informatique SARL cannot be held responsible for a billing error.

MB Informatique SARL cannot be held responsible for its use outside the legal framework.

This contract is valid for an indefinite period. The beginning of the use of the module's services marks the application of the contract with regard to the User.

Image in the logo by Chanut is Industries is licensed under Creative Commons (Attribution 3.0 Unported).