odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/sales/sales/shopee_connector/setup.md

@@ -0,0 +1,226 @@
+---
+title: "Shopee Connector configuration"
+source_url: "https://docs.odoo.sbggai.top/applications/sales/sales/shopee_connector/setup.html"
+---
+
+==============================
+# Shopee Connector configuration
+
+Odoo allows users to synchronize with Shopee Seller account in the database, but users **must**
+have a registered **Shopee Seller account** and a **Shopee Open account** prior to completing the
+configuration.
+
+Set up an Open Shopee account by first going to the [Shopee Open Platform
+](https://open.shopee.com/), and click the :guilabel:`Get Access (Now)` button located in the
+middle of the page.
+
+Use the [Open Shopee Developer Guide ](https://open.shopee.com/developer-guide/12), and follow the
+registration process. Once all done, proceed to follow the instructions below to register and link
+the Open Shopee account in Odoo.
+
+> **important**:
+>    Shopee Open Platform access and seller account requirements are **regionally specific**. This
+   means the rules, qualifications, and processes differ from country to country. Before proceeding
+   with Odoo's Shopee Connector setup, verify the requirements for *your* specific Shopee region.
+
+   **Key Considerations:**
+
+   - **Shopee Seller Status & Business Type:** You must have an active Shopee seller account
+     (Individual or Registered Business). Your eligibility depends on your region and business
+     registration.
+   - **Order Volume/Seller Tier (If Applicable):** Many regions require a minimum number of orders
+     within a specific time frame or a certain seller tier (e.g., Mall, Preferred, Managed) to
+     access the Open Platform.
+
+   **Action Required:**
+
+   #. Identify your Shopee region.
+   #. Locate the official Shopee documentation for your region.
+      [Open Shopee Developer Guide ](https://open.shopee.com/developer-guide/12)
+   #. Carefully review the requirements for seller accounts and Open Platform access in your
+      region.
+   #. Ensure your Shopee account meets all the necessary criteria *before* proceeding with the
+      Odoo Shopee Connector configuration.
+
+.. _shopee/setup:
+
+# Connect Shopee seller account to Odoo
+
+:ref:`Install <general/install>` the :guilabel:`Shopee Connector` (`sale_shoppe`) by going to
+:menuselection:`Apps`.
+
+Then connect your Shopee Open account by navigating to :menuselection:`Sales app --> Configuration
+--> Shopee --> Accounts`.
+
+From here, click :guilabel:`New` to create to link a new Shopee account.
+
+Then, in the :guilabel:`Credentials` tab, select the appropriate :guilabel:`API Endpoint` from the
+drop-down menu.
+
+> **note**:
+>    Shopee offers several API endpoints for production and testing. Selecting the correct endpoint
+   is crucial for successful integration. Choose the endpoint that corresponds to your marketplace
+   location.
+
+   - :guilabel:`Shopee Production Endpoint (Singapore)`: This is the primary endpoint for sellers in
+     most APAC countries. Select this option unless you are specifically operating within mainland
+     China or Brazil.
+   - :guilabel:`Shopee Production Endpoint (China)`: This endpoint is exclusively for sellers
+     operating within mainland China. It is designed to comply with local regulations and business
+     practices.
+   - :guilabel:`Shopee Production Endpoint (Brazil)`: This endpoint is dedicated to sellers
+     operating within Brazil. Select this option if your Shopee store is based in Brazil.
+   - :guilabel:`Shopee Testing Endpoint`: This endpoint is for development and testing purposes
+     only. Use it to simulate interactions with the Shopee API without affecting your live data.
+     **Do not use this endpoint for production.**
+   - :guilabel:`Shopee Testing Endpoint (China)`:  Similar to the general testing endpoint, this one
+     is specifically for testing integrations related to the China-specific production endpoint.
+     **Do not use this endpoint for production.**
+
+After selecting the correct API Endpoint in the :guilabel:`Credentials` form, input your Open
+Shopee :guilabel:`Partner ID` and :guilabel:`Partner Key` in the corresponding fields. Then click
+:guilabel:`Save And Authorize`.
+
+> **important**:
+>    You'll need your Open Shopee :guilabel:`Partner ID` and :guilabel:`Partner Key` to complete this
+   step. Here's how to find them in the Shopee Open Platform:
+
+   #. **Log in to the Shopee Open Platform:** [Log in ](https://open.shopee.com/) with the
+      credentials you used to register your Open Shopee account.
+   #. **Navigate to App Management:** Go to the :guilabel:`App Management` section, then select
+      :guilabel:`App List`.
+   #. **Select your app:** Choose the specific app you want to synchronize with Odoo (either your
+      test app or your production app).
+   #. **Find your credentials:** Within the app details, you'll find your Partner ID and Partner
+      Key. These are the values you'll need to copy and paste into the corresponding fields in
+      Odoo.
+
+> **note**:
+>    - **Copy carefully:** Copy the Partner ID and Partner Key accurately, without any extra spaces
+     or characters. These are case-sensitive.
+   - **Keep your key secure:** Your Partner Key is sensitive information. Do not share it with
+     anyone. Treat it like a password.
+
+# Authorization and account registration
+
+After entering connecting the :ref:`Shoppe Seller account to Odoo <shopee/setup>`, the authorization
+process begins.
+
+## Shopee seller account selection/login
+
+Upon clicking :guilabel:`Save and Authorize`, Odoo redirects to the Shopee seller account selection
+page.
+
+- **Already logged in:** If you are already logged in to a Shopee account, your email address or
+  username will be displayed. Click on your account to proceed.
+- **Not logged in:** If you are not logged in, you will be prompted to enter the credentials
+  (email/username and password) of the Shopee seller account you wish to connect to Odoo.
+
+## Granting access to Odoo
+
+After selecting or logging into your Shopee seller account, you will be directed to the
+authorization (or consent) page. Here, confirm that you allow Shopee to grant Odoo access to your
+account and related data. This step is essential for the integration to function correctly.
+
+# Account registration and Shopee shop creation
+
+Upon confirming access, Shopee redirects you back to Odoo. An indicator appears, confirming that
+your Shopee account has been successfully registered.
+
+## Post-synchronization configuration
+
+After the redirection, you should perform the following steps within Odoo:
+
+#. **Rename the Shopee Account (Optional):** The newly created Shopee account in Odoo will likely
+   have a default name. You can rename it to something more descriptive (e.g., the name of your
+   Shopee shop) for easier management.
+#. **Set the Last Order Synchronization Date:** This setting determines the starting point for
+   fetching orders from Shopee. Choose a date from which you want Odoo to retrieve past orders.
+#. **Configure Inventory Synchronization:**  Decide whether you want to synchronize your product
+   inventory between Odoo and Shopee. Enable the :guilabel:`Synchronize Inventory` option to
+   automatically push stock updates from Odoo to Shopee. Disabling this option prevents automatic
+   inventory updates.
+#. **Assign a Default Sales Team:** Assign a default sales team to your Shopee account in Odoo.
+   This helps with reporting and order management.
+
+With the Shopee account successfully registered, the marketplaces available with this specific
+account can later be synchronized the exact same way, and listed under the :guilabel:`Shops`
+button.
+
+# Shopee orders in Odoo
+
+When a Shopee order is synchronized, only lines for items are created on the sales order in Odoo.
+Each one represents one for the product that was sold on Shopee.
+
+.. image:: setup/shopee-sales-odoo.png
+   :alt: Shopee synchronized sale order in Odoo.
+
+Any necessary price reconciliation related to shipping or income versus fees can be managed later
+using Shopee's weekly / monthly financial reports, which can then be imported into the Odoo
+**Accounting** app.
+
+The selection of a database product for a sales order item is done by matching its
+:guilabel:`Internal Reference` (a customizable product reference identifier in Odoo, like `FURN001`)
+with the Shopee *SKU*.
+
+If no database product with a matching internal reference is found for a given
+:guilabel:`Shopee SKU`, then a default database product, *Shopee Item*.
+
+> **note**:
+>    To modify default products, activate the :ref:`developer mode <developer-mode>`, and navigate to
+   :menuselection:`Sales app --> Configuration --> Settings`. In the :guilabel:`Connectors` section,
+   under :guilabel:`Shopee Sync`, find the :guilabel:`Default Products`.
+
+# Product tax configuration
+
+To allow for tax reporting of Shopee sales with Odoo, the taxes applied to the sales order items are
+those set on the product, or determined by the :doc:`fiscal position
+<../../../finance/fiscal_localizations>`.
+
+Make sure to have the correct taxes set on your products in Odoo, or have it done by a fiscal
+position, to avoid discrepancies in the subtotals between *Shopee Seller Central* and Odoo.
+
+> **note**:
+>    As shopee does not necessarily apply the same taxes as those configured in Odoo, it may happen
+   that order totals differ by a few cents between Odoo and *Shopee Seller Central*. Those
+   differences can be resolved with a write-off when reconciling the payments in Odoo.
+
+.. _shopee/add-new-marketplace:
+
+# Add a new marketplace
+
+To add a new marketplace, follow these steps:
+
+#. **Navigate to Shopee Accounts:** Go to :menuselection:`Sales --> Configuration --> Accounts`.
+#. **Create a New Shopee Account:** Click :guilabel:`New` to create a new Shopee marketplace
+   account.
+#. **Select the API Endpoint:** Choose the appropriate API endpoint for your local market.
+   (Typically, this will be :guilabel:`Shopee Production Endpoint (Singapore)` unless you are
+   operating in mainland China or Brazil. Refer to the documentation for details on endpoint
+   selection).
+#. **Enter Credentials:** Your :guilabel:`Partner ID` and :guilabel:`Partner Key` are the same as
+   those linked to your unique Open Shopee account. Enter these values in the corresponding fields.
+#. **Name Your Shop:** Give the new shop a descriptive name (e.g., `Shopee Philippines`) to identify
+   it later.
+#. **Assign a Sales Team:** Assign a relevant sales team (e.g., `Shopee Sales Philippines`) to
+   enable advanced reporting capabilities.
+#. **Synchronize Your Account:** If none of your existing marketplaces are listed, click
+   :guilabel:`Log in with another account` to synchronize a new one. This will initiate the Shopee
+   authorization process.
+
+## Automatic synchronization
+
+Newly added marketplaces are automatically added to the list of synchronized marketplaces. If a new
+marketplace does *not* appear in the list after synchronization, it indicates that the marketplace
+is either incompatible with the Shopee Open Platform or unavailable for your specific seller
+account. Consult the Shopee Open Platform documentation or contact their support for further
+assistance.
+
+> **important**:
+>    While Odoo allows creating the same Shopee shop multiple times, only one instance will function
+   due to token limitations. To avoid order management issues, synchronize each shop only once. For
+   connection updates, manually fetch orders first before re-establishing the connection.
+
+.. seealso::
+   - :doc:`Shopee supported features and marketplaces <../shopee_connector>`
+   - :doc:`manage`

package/payload/skills/odoo18-docs/references/docs/applications/sales/sales/shopee_connector.md

@@ -0,0 +1,74 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/sales/sales/shopee_connector.html"
+---
+
+:show-content:
+# 
+# Shopee Connector
+
+The **Shopee Connector** synchronizes orders between Shopee and Odoo, which considerably reduces the
+amount of time spent manually entering Shopee orders (from the Shopee Seller account) into Odoo. It
+also allows users to accurately keep track of Shopee sales in Odoo.
+
+# Supported features
+
+The **Shopee Connector** is able to:
+
+- Synchronize (Shopee to Odoo) all confirmed orders, and their order items, which include:
+
+  - Product name
+  - SKU reference
+  - Quantity
+
+- Synchronize (Odoo to Shopee) all available quantities of your products (:abbr:`FBM (Fulfilled by
+  Merchant)`).
+- Support multiple seller accounts.
+- Support multiple Shopee marketplaces (shops) per seller account.
+
+> **note**:
+>    The **Shopee Connector** is designed to synchronize sales orders data. Other actions, such as
+   downloading weekly/monthly income/fees reports, handling disputes, or issuing refunds, **must**
+   be managed from the *Shopee Seller Central*, as usual.
+
+# Shopee supported marketplaces
+
++-------------------------------+
+| **APAC region**               |
++===============+===============+
+| Indonesia     | Shopee.co.id  |
++---------------+---------------+
+| Taiwan        | Shopee.tw     |
++---------------+---------------+
+| Vietnam       | Shopee.vn     |
++---------------+---------------+
+| Thailand      | Shopee.co.th  |
++---------------+---------------+
+| Philippines   | Shopee.ph     |
++---------------+---------------+
+| Malaysia      | Shopee.com.my |
++---------------+---------------+
+| Singapore     | Shopee.sg     |
++---------------+---------------+
+
++-------------------------------+
+| **South America region**      |
++===============+===============+
+| Brazil        | Shopee.com.br |
++---------------+---------------+
+| Chile         | Shopee.cl     |
++---------------+---------------+
+| Colombia      | Shopee.com.co |
++---------------+---------------+
+| Mexico        | Shopee.com.mx |
++---------------+---------------+
+
+.. seealso::
+   - :doc:`shopee_connector/setup`
+   - :doc:`shopee_connector/manage`
+
+.. toctree::
+   :titlesonly:
+
+   shopee_connector/setup
+   shopee_connector/manage

package/payload/skills/odoo18-docs/references/docs/applications/sales/sales.md

@@ -0,0 +1,27 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/sales/sales.html"
+---
+
+:nosearch:
+:show-content:
+:hide-page-toc:
+:show-toc:
+# 
+# Sales
+
+**Odoo Sales** is the application to run your sales process (from quotation to sales order) and
+deliver and invoice what has been sold.
+
+.. seealso::
+   - [Odoo Tutorials: Sales Tutorials ](https://www.odoo.com/slides/sales-17)
+
+.. toctree::
+   :titlesonly:
+
+   sales/sales_quotations
+   sales/invoicing
+   sales/products_prices
+   sales/amazon_connector
+   sales/shopee_connector
+   sales/gelato

package/payload/skills/odoo18-docs/references/docs/applications/sales/subscriptions/automatic_alerts.md

@@ -0,0 +1,169 @@
+---
+title: "Automation rules"
+source_url: "https://docs.odoo.sbggai.top/applications/sales/subscriptions/automatic_alerts.html"
+---
+
+================
+# Automation rules
+
+With subscriptions up-and-running, it is important to stay up-to-date with customers. It is
+efficient to use automation to avoid having to manually go through the list of subscribers to see
+how things are going. That is where Odoo's *automation rules* feature comes into play.
+
+The Odoo *Subscriptions* application allows users to set up automatic emails, create tasks for
+salespeople, and even send satisfaction surveys for subscribers to evaluate their experience.
+
+# Create automation rules
+
+To create an automated rule, start by navigating to :menuselection:`Subscriptions app -->
+Configuration --> Automation Rules`. This is where all the automation rules for subscriptions can be
+found.
+
+The :guilabel:`Automation Rules` page shows each rule's :guilabel:`Name`, :guilabel:`Action To Do`,
+what the automated rule will :guilabel:`Trigger On`, and the :guilabel:`Company` to which the rule
+applies.
+
+To view or modify any existing automation rule, simply click the desired rule from this page.
+
+> **note**:
+>    When modifying an existing automation rule, Odoo "grays-out" the :guilabel:`Action` section of
+   the form, and provides the following warning: *Action data can not be updated to avoid unexpected
+   behaviors. Create a new action instead.*
+
+To create a new automation rule, click :guilabel:`New`.
+
+.. image:: automatic_alerts/automation-rules-page.png
+   :align: center
+   :alt: The Automation Rules page in the Odoo Subscriptions application.
+
+Clicking :guilabel:`New` reveals a blank :guilabel:`Automation Rules` form with numerous fields to
+configure.
+
+.. image:: automatic_alerts/automation-rules-form.png
+   :align: center
+   :alt: A sample Automation Rules form in the Odoo Subscriptions application.
+
+## Automation rule form fields
+
+- :guilabel:`Action Name`: title of the automated action rule.
+
+### Apply On section
+
+The :guilabel:`Apply On` section dictates which subscription orders/customers this automated action
+applies to.
+
+- :guilabel:`MRR Between`: designate a range of monthly recurring revenue to target.
+- :guilabel:`MRR Change More`: designate a change of monthly recurring revenue to target, in either
+  percentage or unit of currency.
+- :guilabel:`Over`: choose a period of time over which the designated KPIs (Key Performance
+  Indicators) are calculated.
+- :guilabel:`Rating Satisfaction`: designate satisfaction as :guilabel:`greater than` or
+  :guilabel:`less than` a percentage.
+- :guilabel:`Status`: select the status of the subscriptions to be included in this automation rule.
+  The options are: :guilabel:`Quotation`, :guilabel:`Quotation Sent`, :guilabel:`Sales Order`, and
+  :guilabel:`Cancelled`.
+- :guilabel:`Stage goes from`: designate when the automation rule should be activated using two
+  fields that represent two different stages of the subscription.
+- :guilabel:`Subscription Plans`: choose specific subscription plans to target with the automation
+  rule.
+- :guilabel:`Products`: select specific product(s) to target with the automation rule.
+- :guilabel:`Customers`: select specific customer(s) to target with the automation rule.
+- :guilabel:`Company`: in a multi-company environment, select a specific company's subscription data
+  to target with the automation rule.
+- :guilabel:`Sales Team`: select the data of specific sales team(s) to target with the automation
+  rule.
+
+> **note**:
+>    If any field is left blank, the rule applies to every subscription without that specific
+   designation.
+
+> **tip**:
+>    The number of subscriptions that match the configured criteria of the customized automation rule
+   are displayed at the bottom of the :guilabel:`Apply On` field.
+
+   If that green subscriptions link is clicked, Odoo reveals a separate page showcasing all the
+   subscriptions that meet that automation rule's criteria.
+
+### Action section
+
+The :guilabel:`Action` section dictates what action occurs when an automated rule is triggered.
+
+In the :guilabel:`Action To Do` field, choose the action that will occur once the automated rule is
+triggered. When clicked, the following options become available on a drop-down menu:
+
+- :guilabel:`Create next activity`: creates the next activity to occur, which is configured in the
+  :guilabel:`Activity` section that appears at the bottom of the automation rule form.
+- :guilabel:`Send an email to the customer`: sends an email to the customer(s) who fit the specified
+  criteria of the automation rule.
+- :guilabel:`Send an SMS Text Message to the customer`: sends an SMS message to the customer(s) who
+  fit the specified criteria of the automation rule.
+- :guilabel:`Set Contract Health value`: set the health value of the subscription contract.
+
+If :guilabel:`Send an email to the customer` is selected in the :guilabel:`Action To Do` field, the
+following field appears:
+
+- :guilabel:`Email Template`: create (and edit) a new email template *or* select from a list of
+  pre-configured email templates to send to the customer(s).
+
+If :guilabel:`Send an SMS Text Message to the customer` is selected in the :guilabel:`Action To Do`
+field, the following field appears:
+
+- :guilabel:`SMS Template`: create (and edit) a new SMS template *or* select from a list of
+  pre-configured SMS templates to send to the customer(s).
+
+If :guilabel:`Set Contract Health value` is selected in the :guilabel:`Action To Do` field, the
+following field appears:
+
+- :guilabel:`Health`: designate the health of the subscription by choosing one of the following
+  options: :guilabel:`Neutral`, :guilabel:`Good`, or :guilabel:`Bad`.
+
+In the :guilabel:`Trigger On` field, decide whether the automated rule should be triggered on a
+:guilabel:`Modification` or :guilabel:`Timed Condition`.
+
+> **note**:
+>    A :guilabel:`Trigger Now` button appears at the top of the automation rule form *only* when a
+   trigger has been configured for the rule.
+
+> **warning**:
+>    When the :guilabel:`Trigger Now` button is clicked, Odoo will trigger the action on *all* linked
+   subscriptions, regardless of possible timed conditions.
+
+> **note**:
+>    Sending a SMS text message in Odoo requires In-App Purchase (IAP) credit or tokens. For more
+   information on :abbr:`IAP (In-App Purchase)`, visit :doc:`../../essentials/in_app_purchase`.
+   For more information on sending SMS messages, visit
+   :doc:`../../marketing/sms_marketing`.
+
+If :guilabel:`Timed Condition` is selected in the :guilabel:`Trigger On` field, the following fields
+appear:
+
+- :guilabel:`Trigger Date`: represents when the condition should be triggered. If left blank, the
+  action is created upon subscription creation *and* updates.
+- :guilabel:`Delay After Trigger`: select a delayed amount of time (:guilabel:`Minutes`,
+  :guilabel:`Hours`, :guilabel:`Days`, or :guilabel:`Months`) for Odoo to wait before triggering the
+  configured action. If a negative number is entered, the "delay" will occur *before* the
+  :guilabel:`Trigger Date`.
+
+Activity section
+****************
+
+If :guilabel:`Create next activity` is selected in the :guilabel:`Action To Do` field, an
+:guilabel:`Activity` section appears at the bottom of the :guilabel:`Automation Rules` form.
+
+- :guilabel:`Activity Type`: select an pre-configured activity type from the drop-down menu.
+- :guilabel:`Title`: enter a custom title for the chosen activity.
+- :guilabel:`Note`: leave a note for the employee to whom the activity is assigned.
+- :guilabel:`Due Date In`: enter an amount of days within which the activity should be completed.
+- :guilabel:`Assign To`: choose to assign the specified activity to either: :guilabel:`Subscription
+  Salesperson`, :guilabel:`Sales Team Leader`, or :guilabel:`Specific Users`.
+
+> **note**:
+>    If :guilabel:`Specific Users` is selected as the :guilabel:`Assign To` option, a new
+   :guilabel:`Specific Users` field appears beneath it, where a specific employee(s) can be chosen
+   as the assignee(s) for the configured activity.
+
+.. seealso::
+   - :doc:`../subscriptions`
+   - :doc:`plans`
+   - :doc:`products`
+   - :doc:`../../essentials/in_app_purchase`

package/payload/skills/odoo18-docs/references/docs/applications/sales/subscriptions/closing.md

@@ -0,0 +1,107 @@
+---
+title: "Close subscriptions"
+source_url: "https://docs.odoo.sbggai.top/applications/sales/subscriptions/closing.html"
+---
+
+===================
+# Close subscriptions
+
+Odoo *Subscriptions* provides flexibility for businesses to decide whether customers can self-manage
+their subscriptions, or restrict that ability entirely.
+
+# Configuration
+
+Start by navigating to :menuselection:`Subscriptions app --> Configuration --> Recurring Plans`.
+From there, either create a new plan by clicking :guilabel:`New` or select an existing one to modify
+it.
+
+Once on the :guilabel:`Recurring Plans` form, enable the :guilabel:`Closable` option, in the
+:guilabel:`Self-Service` section, to allow customers to close their own subscriptions using the
+customer portal.
+
+.. image:: closing/recurring-plans-closable-option.png
+   :align: center
+   :alt: The Closable option on a recurring plan form in Odoo Subscriptions.
+
+.. seealso::
+   :doc:`Configure recurring plans <plans>`
+
+# Close a subscription
+
+## Administrator view
+
+After a quotation for a subscription product has been confirmed, it becomes a sales order, and the
+subscription status changes to :guilabel:`In Progress`.
+
+At that point, the ability to close the subscription becomes available, via the :guilabel:`Close`
+button at the top of the subscription order, near the row that contains :guilabel:`In Progress` and
+other stages. This option is also available after the order has been invoiced and the payment has
+been registered.
+
+.. image:: closing/close-subscriptions-administrator.png
+   :align: center
+   :alt: Close subscription from an administration point of view with Odoo Subscriptions.
+
+Clicking the :guilabel:`Close` button prompts a :guilabel:`Close Reason` pop-up window to appear,
+allowing administrators to input the reason for closing the subscription, or choose from the
+drop-down menu of options in the :guilabel:`Reason` field.
+
+.. image:: closing/close-reason-popup.png
+   :align: center
+   :alt: The Close Reason pop-up when the Close button is clicked in Odoo Subscriptions.
+
+When the desired :guilabel:`Reason` is entered, click the :guilabel:`Submit` button.
+
+Clicking :guilabel:`Submit` on the :guilabel:`Close Reason` pop-up window updates the subscription
+sales order to show :guilabel:`Churned` status tag, along with the specified :guilabel:`Close
+Reason`.
+
+.. image:: closing/churned-sales-order.png
+   :align: center
+   :alt: A churned sales order for a closed subscription in Odoo Subscriptions.
+
+That same close reason can be found in the *Chatter* of the sales order, as well.
+
+.. image:: closing/churned-sales-order-chatter.png
+   :align: center
+   :alt: The chatter of a churned sales order for a closed subscription in Odoo Subscriptions.
+
+## Customer view
+
+> **note**:
+>    As an administrator, the ability to visualize what customers see when managing their
+   subscriptions is accessible via the :guilabel:`Preview` button, located at the top of the
+   subscription sales order.
+
+From the customer's point of view, in the customer portal, the :guilabel:`Close Subscription` button
+is located on the left side of the sales order.
+
+.. image:: closing/close-subscription-button-customer-view.png
+   :align: center
+   :alt: Close subscription button on a customer's view of a sales order in Odoo Subscriptions.
+
+When the customer clicks the :guilabel:`Close Subscription` button, a :guilabel:`Close Subscription`
+pop-up window appears, in which the customer has to choose from a select list of reasons why they
+are choosing to close the subscription.
+
+.. image:: closing/close-subscription-customer-pov.png
+   :align: center
+   :alt: The close subscription pop-up window customers see when closing a subscription.
+
+> **note**:
+>    Customers can *only* chose a pre-configured reason why the subscription is being closed. They can
+   *not* enter a custom reason from the customer portal. These selections can be adjusted by
+   navigating to :menuselection:`Subscriptions --> Configuration --> Close Reasons`.
+
+Once the customer has chosen a close reason, they would click the :guilabel:`Submit` button on the
+pop-up window.
+
+Upon closure, the subscription order in the customer portal is tagged as :guilabel:`Closed`.
+
+In addition, the specified :guilabel:`Close Reason` appears on the subscription order in the
+*Subscriptions* app in the backend (Administrator's view).
+
+.. seealso::
+   - :doc:`../subscriptions`
+   - :doc:`plans`
+   - :doc:`products`

package/payload/skills/odoo18-docs/references/docs/applications/sales/subscriptions/ecommerce.md

@@ -0,0 +1,28 @@
+---
+title: "Subscriptions in the eCommerce shop"
+source_url: "https://docs.odoo.sbggai.top/applications/sales/subscriptions/ecommerce.html"
+---
+
+===================================
+# Subscriptions in the eCommerce shop
+
+Subscription products can be sold in the Odoo *eCommerce* shop just like regular sales products.
+
+.. seealso::
+   - :doc:`Configure subscription products </applications/sales/subscriptions/products>`
+
+# Selling eCommerce subscriptions
+
+:doc:`Configure the subscription product <products>`  as a regular recurring sales product. To
+start selling the subscription in the eCommerce shop, click the :guilabel:`Go to Website` smart
+button to navigate to the product page.
+
+From here, review the subscription product and its recurring periods. Then, toggle the switch in the
+upper-right corner from :guilabel:`Unpublished` to :guilabel:`Published`.
+
+The new subscription product is now available to purchase on the eCommerce website, with options
+for the different recurring periods.
+
+.. image:: ecommerce/subscription-product.png
+   :align: center
+   :alt: Subscription product on eCommerce website.