From 91b913553ac5edc4c77883a1dc417a167a267c41 Mon Sep 17 00:00:00 2001
From: "Valeriya(vchu)" <vchu@odoo.com>
Date: Tue, 12 Nov 2024 10:06:43 +0100
Subject: [PATCH] [IMP] eCommerce: adapt to new Click&Collect flow

task-4199792
---
 .../checkout_payment_shipping/shipping.rst    |  76 ++++++++++++------
 .../shipping/shipping-checkout.png            | Bin 10249 -> 0 bytes
 2 files changed, 50 insertions(+), 26 deletions(-)
 delete mode 100644 content/applications/websites/ecommerce/checkout_payment_shipping/shipping/shipping-checkout.png

diff --git a/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst b/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
index 4ad329bcaf..21210d9bbb 100644
--- a/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
+++ b/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
@@ -1,9 +1,9 @@
 ================
-Shipping methods
+Delivery methods
 ================
 
-Depending on your shipping strategy, you have the choice to either use your :ref:`own shipping
-methods <ecommerce-own-shipping>`, or use an integration with an :ref:`existing shipping provider
+Depending on your shipping strategy, you have the choice to either use your :ref:`own delivery
+methods <ecommerce-own-shipping>`, or use an integration with an :ref:`existing delivery provider
 <ecommerce-shipping-providers>`.
 
 .. _ecommerce-own-shipping:
@@ -11,22 +11,56 @@ methods <ecommerce-own-shipping>`, or use an integration with an :ref:`existing
 .. seealso::
    :doc:`../checkout_payment_shipping/checkout`
 
-Own shipping methods
+Own delivery methods
 ====================
 
-You can create your own custom shipping methods and define rules to compute shipping costs. To do
-so, go to :menuselection:`Website --> Configuration --> Shipping Methods`, and either select an
-**existing** shipping method, or :guilabel:`Create` one. When creating a shipping method, you can
+You can create your own custom delivery methods and define rules to compute delivery costs. To do
+so, go to :menuselection:`Website --> Configuration --> Delivery Methods`, and either select an
+**existing** delivery method, or :guilabel:`Create` one. When creating a delivery method, you can
 choose between :ref:`Fixed Price <inventory/shipping/fixed>`, :ref:`Based on Rules
 <inventory/shipping/rules>`, and :guilabel:`Pickup in store`.
 
-Pickup in store
----------------
+Pick up in store
+----------------
 
-:guilabel:`Pickup in store` must first be **enabled** in the settings (:menuselection:`Website -->
-Configuration --> Settings --> Shipping section)` by checking :guilabel:`On Site Payments &
-Picking`. Once enabled, you can select and :guilabel:`Customize Pickup Sites`. :guilabel:`Picking
-sites` can be made **website-specific**, but are by default available for *all* websites.
+To enable :guilabel:`Pick up in store`, follow these steps:
+
+#. **Enable Click & Collect**
+
+   Go to the website settings :menuselection:`Website -->
+   Configuration --> Settings --> Delivery section`, then check the box for :guilabel:`Click &
+   Collect`.
+
+#. **Select stores for a pick-up**
+
+   Choose stores represented by your warehouses where customers can pick up their orders from.
+
+#. **Set address information**
+
+   Ensure that each selected warehouse has a partner assigned, along with complete address data.
+   This is essential for localizing the warehouse and displaying its accurate location to customers.
+
+#. **(Optional) Configure warehouse opening hours**
+
+   You can set the opening hours for each warehouse which enhances the user experience by informing
+   customers of the operational hours for pick-up locations.
+
+#. **Publish the provider**
+
+   Once all settings are configured, publish the provider to make it available to customers.
+
+After publishing, customers will be able to choose a pick-up location using a **location selector**
+if a product is in stock. This selector will be available on the **product page** and during the
+**checkout process** when selecting delivery methods.
+
+.. note::
+   - Services are not available for **Pick up in store**.
+   - Customers can not select a pick-up location if a product is out of stock at that location. The
+     `Continue selling` option when out of stock is not supported.
+   - If the `Show Available Qty` setting is activated on the product, customers will be able to view
+     the available stock quantity for each warehouse in the location selector on the product page.
+   - Customers will not be able to complete the checkout if any of the selected products are out of
+     stock at the chosen pick-up location.
 
 .. seealso::
    - :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration`
@@ -36,10 +70,10 @@ sites` can be made **website-specific**, but are by default available for *all*
 
 .. _ecommerce-shipping-providers:
 
-Shipping providers
+Delivery providers
 ==================
 
-Another solution is to use one of the integrations with an existing shipping provider. The advantage
+Another solution is to use one of the integrations with an existing delivery provider. The advantage
 of using an integration is that delivery costs are automatically computed based on each order as
 well as generating shipping labels.
 
@@ -56,15 +90,5 @@ Website availability
 
 Shipping methods can be made available on **specific** websites *only*, if desired. To do so, go to
 :menuselection:`Website --> Configuration --> Settings --> Shipping Methods`, and select the desired
-**shipping method**. In the :guilabel:`Website` field, set the website you want the shipping method
+**shipping method**. In the :guilabel:`Website` field, set the website you want the delivery method
 to be restrained to. Leave the field **empty** for the method to be available on *all* websites.
-
-Delivery method at checkout
-===========================
-
-Customers can choose the shipping method at the end of the checkout process, at the
-:guilabel:`Confirm Order` step.
-
-.. image:: shipping/shipping-checkout.png
-   :align: center
-   :alt: Delivery method choice at checkout
diff --git a/content/applications/websites/ecommerce/checkout_payment_shipping/shipping/shipping-checkout.png b/content/applications/websites/ecommerce/checkout_payment_shipping/shipping/shipping-checkout.png
deleted file mode 100644
index 6b9fb95b413e43c9220b292231af98c662ef68c9..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 10249
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
QnSaPq;&NhTBHw-g2W<`@rT_o{