From e6a052c4dd75cc9c677567649243db76e07340ef Mon Sep 17 00:00:00 2001 From: Parish Bracha Date: Wed, 21 Aug 2024 16:28:19 +0000 Subject: [PATCH] [IMP] Subscriptions: Contract in exception closes odoo/documentation#11642 X-original-commit: ea2fc6dbc4baec545b17c72f1cde91df267ba223 Signed-off-by: Parish Bracha (pabr) --- .../sales/subscriptions/renewals.rst | 79 ++++++++++++++---- .../renewals/contract-in-exception.png | Bin 0 -> 45066 bytes 2 files changed, 61 insertions(+), 18 deletions(-) create mode 100644 content/applications/sales/subscriptions/renewals/contract-in-exception.png diff --git a/content/applications/sales/subscriptions/renewals.rst b/content/applications/sales/subscriptions/renewals.rst index 23fdc2c00..e71405412 100644 --- a/content/applications/sales/subscriptions/renewals.rst +++ b/content/applications/sales/subscriptions/renewals.rst @@ -2,21 +2,21 @@ Renew subscriptions =================== -The foundation of any subscription business model is recurring payments. That's when customers +The foundation of any subscription business model is recurring payments. This is when customers reliably pay a regular amount at specific intervals, in exchange for access to a subscription product or service. -The renewal of a subscription is the process followed by customers when they willingly choose to -continue their participation (and payment) for a subscription product or service. +Subscription renewal is the process customers follow when they willingly choose to continue +participating in, and paying for, a subscription product or service. Subscribers experience the renewal process at different intervals -- weekly, monthly, annually, etc. -- depending on the duration of the agreed-upon contract. -Most companies that offer subscriptions prefer to automate the renewals process for customers, but, -in some cases, manual subscription renewals are still used. +Most companies that offer subscriptions prefer to automate the renewal process for customers. +However, manual subscription renewals are still used in some cases. -With the Odoo *Subscriptions* application, a company can manage all of their subscriptions in one -place. Renewals can be processed automatically or manually, include additional products or upsells +With the Odoo **Subscriptions** application, a company can manage all of its subscriptions in one +place. Renewals can be processed automatically, or manually, include additional products or upsells per renewal order, and be filtered in batch views to quickly locate customers who need to renew their subscriptions. @@ -24,18 +24,29 @@ Subscription renewals ===================== In order to renew a subscription, a quotation with a subscription product **must** be confirmed, -with a configured :guilabel:`Recurring Plan` selected, which turns it into a sales order. +with a configured *Recurring Plan* selected. + +To open a subscription quotation, navigate to :menuselection:`Subscriptions app --> Subscriptions +--> Quotations`, and select the desired quotation from the list. Or, create a new one by clicking +:guilabel:`New` to open a new quotation form. .. note:: - Only a singular product is required. - - A subscription service is still a product (albeit a digital, recurring one) + - A subscription service counts as a product, as it is considered a recurring product. -Then, that sales order needs to be confirmed, and payment from the customer for the initial -subscription has to be invoiced and registered. +Subscription quotations **must** be confirmed, and payment from the customer for the +initial subscription **must** be invoiced and registered in order to successfully open a *Renewal +Quotation*. -When those steps are complete, an :guilabel:`In Progress` tag is applied to the sales order form, -and a series of buttons appear at the top of the sales order -- including a button titled, -:guilabel:`Renew`. +.. seealso:: + For more information on the above process of confirming quotations and invoicing payments, + see: + - :doc:`../sales/send_quotations/create_quotations` + - :doc:`../sales/send_quotations/get_paid_to_validate` + +Once the payment from the subscription quotation is confirmed, the quotation turns into a sales +order. An :guilabel:`In Progress` tag is applied to the sales order form, and a series of buttons +also appear at the top of the sales order, including a :guilabel:`Renew` button. .. image:: renewals/renew-button.png :align: center @@ -48,12 +59,12 @@ complete with a :guilabel:`Renewal Quotation` tag. :align: center :alt: Renewal quotation in the Odoo Subscriptions application. -From here, a standard sales flow can occur in order to confirm the quotation. This typically begins -by clicking :guilabel:`Send by Email`. This sends a copy of the quotation to the customer, by email, -for them to confirm, and eventually, pay for. +From here, a standard sales flow can occur to confirm the quotation. This typically begins +by clicking :guilabel:`Send by Email`, which sends a copy of the quotation to the customer, by +email, for them to confirm, and eventually, pay for. .. note:: - In the *Chatter* of the :guilabel:`Renewal Quotation`, it is mentioned that this subscription is + In the chatter of the :guilabel:`Renewal Quotation`, it is mentioned that this subscription is the renewal of the subscription from the original sales order. Once the :guilabel:`Renewal Quotation` is confirmed, it becomes a sales order, and a @@ -81,6 +92,38 @@ also appears at the top of the sales order. When clicked, Odoo reveals an :guilabel:`MRR Analysis` page, detailing the monthly recurring revenue related to this specific subscription. +.. important:: + On rare occasions, automatic payment can fail, which results in a *Payment Failure* tag on the + top-right of the sales order, if there is an error in the payment method. + + This is done to prevent the system from charging the customer again the next time a scheduled + action is run. Because the status of the payment is unknown, Odoo requests a manual operation to + check if the payment has been made, before the payment can be used again. + + To do this, navigate to :menuselection:`Subscriptions app --> Subscriptions --> Quotations`. + Click into the desired subscription, then check the *Chatter* to see if the payment was made. + + If the payment was **not** made, first enter :doc:`debug mode <../../general/developer_mode>`. + Then, click the :guilabel:`Other Info` tab, and untick the checkbox next to :guilabel:`Contract + in exception`. Reload the sales order, and the :guilabel:`Payment Failure` tag is gone. + + If the payment **was** made, a new invoice must be made and posted manually. This automatically + updates the next invoice date of the subscription. Once created, enter :doc:`debug mode + <../../general/developer_mode>`, and navigate to the new sales order. Click the :guilabel:`Other + Info` tab, and untick the checkbox next to :guilabel:`Contract in exception`. + Reload the sales order, and the :guilabel:`Payment Failure` tag is gone. + + .. figure:: renewals/contract-in-exception.png + :align: center + :alt: The "contract in exception" option selected with the "payment failure" tag shown. + + The :guilabel:`contract in exception`` option selected with the :guilabel:`payment failure` + tag shown. + + In both cases, once the :guilabel:`Contract in exception` option is no longer selected, Odoo + handles renewals automatically again. If the subscription remains in *payment failure*, it is + skipped by Odoo until the sales order is closed. + .. seealso:: - :doc:`../subscriptions` - :doc:`plans` diff --git a/content/applications/sales/subscriptions/renewals/contract-in-exception.png b/content/applications/sales/subscriptions/renewals/contract-in-exception.png new file mode 100644 index 0000000000000000000000000000000000000000..532b2a093633d7549deb80fba97e44395da8624c GIT binary patch literal 45066 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

~< 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 KB!7z=2mKHDY7Nr> literal 0 HcmV?d00001