Subscription management
This module allows creating subscriptions that generate recurring invoices or orders. It also enables the sale of products that generate subscriptions.
Subscriptions can be paused and resumed, so they can be put on hold without being closed; the recurring cron skips paused subscriptions and can resume them automatically on a configured date.
Table of contents
Usage
To make a subscription:
Go to Subscriptions > Configuration > Subscription templates.
Create the templates you consider, choosing the billing frequency: daily, monthly… and the method of creating the invoice and/or order.
Go to Subscription > Subscriptions.
Create a subscription and indicate the start date. When the Subscriptions Management cron job is executed, the subscription will begin and the first invoice will be created if the execution date matches the start date. The invoice will also be created when the execution date matches the next invoice date. Additionally, you can manually change the subscription status and create an invoice by using the Create Invoice button. This action creates just an invoice even if the subscription template has the Sale Order & Invoice option selected, because the Invoicing mode option is triggered through the cron job.
The cron job will also end the subscription if its end date has been reached. The end date honours the template recurrence (days, weeks, months or years) and the interval, instead of always assuming months.
To create subscriptions with the sale of a product:
Go to Subscriptions > Subscriptions > Products.
Create the product and in the sales tab, complete the fields Subscribable product and Subscription template
Create a sales order with the product and confirm it.
Invoice and delivery addresses:
Each subscription has an Invoice address and a Delivery address. They default to the customer’s corresponding addresses and can be overridden per subscription.
These addresses are propagated to the recurring invoices (the invoice is addressed to the invoice address and records the delivery one) and to the sale orders generated by the subscription.
The fields are shown when the Customer Addresses setting (group Display Delivery / Invoice addresses) is enabled.
To pause and resume a subscription:
On an in-progress subscription, press Pause. A dialog lets you optionally set a Resume on date.
While paused, the cron skips the subscription: it is not invoiced, started or closed.
Press Resume to reactivate it manually. If a Resume on date was set, the cron resumes the subscription automatically once that date is reached. Leaving the date empty pauses it indefinitely.
Known issues / Roadmap
Refactor all the onchanges that have business logic to computed write-able fields when possible. Keep onchanges only for UI purposes.
Add tests.
Bug Tracker
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
Credits
Contributors
Carlos Martínez <carlos@domatix.com>
Carolina Ferrer <carolina@domatix.com>
-
Ilyas <irazor147@gmail.com>
-
Harald Panten
Valentin Vinagre
Alberto Martínez
Dennis Sluijk <d.sluijk@onestein.nl>
-
Yan Chirino <yan.chirino@iku.solutions>
Maintainers
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
This module is part of the OCA/contract project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
1 maintainer
Release files for odoo-addon-subscription-oca 19.0.1.1.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| odoo_addon_subscription_oca-19.0.1.1.4.2-py3-none-any.whl | Python 3 | none | any | Details |
Release files / odoo_addon_subscription_oca-19.0.1.1.4.2-py3-none-any.whl
| Download URL | odoo_addon_subscription_oca-19.0.1.1.4.2-py3-none-any.whl |
|---|---|
| Size | 367.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cdc5e8f1cbd345e96156329ca0d70e88da05fd3726481fe43b6d7fc0098a4943
|
|
BLAKE2b-256 checksum How to use checksums |
3ad83326112ba053d26fda2730e67875dda8e2a5831b1f9ef004f3490442a061
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
