From fa53d573f89a756df53f77e5864acd97285ed8e6 Mon Sep 17 00:00:00 2001
From: "Tom Aarab (toaa)" <toaa@odoo.com>
Date: Mon, 26 Dec 2022 13:02:50 +0000
Subject: [PATCH] [ADD] eCommerce: shipping page

Added a shipping page to the eCommerce section. Forward to master.

closes odoo/documentation#3641

Taskid: 3111638
X-original-commit: 470e74492f69afc061e727d90c38fa04d327b7b5
Signed-off-by: Aarab Tom (toaa) <toaa@odoo.com>
---
 .../ecommerce/checkout_payment_shipping.rst   |   1 +
 .../checkout_payment_shipping/shipping.rst    |  70 ++++++++++++++++++
 .../shipping/shipping-checkout.png            | Bin 0 -> 10249 bytes
 3 files changed, 71 insertions(+)
 create mode 100644 content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
 create mode 100644 content/applications/websites/ecommerce/checkout_payment_shipping/shipping/shipping-checkout.png

diff --git a/content/applications/websites/ecommerce/checkout_payment_shipping.rst b/content/applications/websites/ecommerce/checkout_payment_shipping.rst
index 6218d28a7..dfb6233ed 100644
--- a/content/applications/websites/ecommerce/checkout_payment_shipping.rst
+++ b/content/applications/websites/ecommerce/checkout_payment_shipping.rst
@@ -9,4 +9,5 @@ Checkout, payment, and shipping
 
    checkout_payment_shipping/cart
    checkout_payment_shipping/checkout
+   checkout_payment_shipping/shipping
    checkout_payment_shipping/payments
diff --git a/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst b/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
new file mode 100644
index 000000000..e1c12f9b2
--- /dev/null
+++ b/content/applications/websites/ecommerce/checkout_payment_shipping/shipping.rst
@@ -0,0 +1,70 @@
+================
+Shipping 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
+<ecommerce-shipping-providers>`.
+
+.. _ecommerce-own-shipping:
+
+Own shipping 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
+choose between
+:doc:`Fixed Price </applications/inventory_and_mrp/inventory/shipping/setup/delivery_method>`,
+:doc:`Based on Rules </applications/inventory_and_mrp/inventory/shipping/setup/delivery_method>`,
+and :guilabel:`Pickup in store`.
+
+Pickup 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.
+
+.. seealso::
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/setup/delivery_method`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/operation/invoicing`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/operation/multipack`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/operation/cancel`
+
+.. _ecommerce-shipping-providers:
+
+Shipping providers
+==================
+
+Another solution is to use one of the integrations with an existing shipping provider. The advantage
+of using an integration is that delivery costs are automatically computed based on each order as
+well as generating shipping labels.
+
+.. seealso::
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/setup/third_party_shipper`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/setup/ups_credentials`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/setup/dhl_credentials`
+   - :doc:`/applications/inventory_and_mrp/inventory/shipping/operation/labels`
+
+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
+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
+
+.. seealso::
+   :doc:`../checkout_payment_shipping/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
new file mode 100644
index 0000000000000000000000000000000000000000..6b9fb95b413e43c9220b292231af98c662ef68c9
GIT binary patch
literal 10249
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
QnSaPq;&NhTBHw-g2W<`@rT_o{

literal 0
HcmV?d00001