Skip to content

[FW][REF] ecommerce: restructure doc #12483

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -1048,7 +1048,7 @@ Client account registration
***************************

To configure your website for client accounts, follow the instructions in the :doc:`checkout
<../../websites/ecommerce/checkout_payment_shipping/checkout>` documentation.
<../../websites/ecommerce/checkout>` documentation.

Automatic invoice
*****************
Expand Down Expand Up @@ -1093,7 +1093,7 @@ the corresponding layout and fiscal stamps stated in the :ref:`Invoice printed r
<argentina/invoice-printed-report>`.

.. seealso::
:doc:`Client account creation <../../websites/ecommerce/checkout_payment_shipping/checkout>`
:doc:`Client account creation <../../websites/ecommerce/checkout>`

Liquidity product direct sales
------------------------------
Expand Down
2 changes: 1 addition & 1 deletion content/applications/finance/fiscal_localizations/peru.rst
Original file line number Diff line number Diff line change
Expand Up @@ -928,7 +928,7 @@ the following configurations for the **eCommerce** flow:
- :doc:`../../websites/ecommerce/products`: Set the :guilabel:`Invoicing Policy` to
:guilabel:`Ordered quantities` and define the desired :guilabel:`Customer taxes`.
- :doc:`../payment_providers`;
- :doc:`../../websites/ecommerce/checkout_payment_shipping/shipping`: For each shipping method, set
- :doc:`../../websites/ecommerce/shipping`: For each shipping method, set
the :guilabel:`Provider` field to :guilabel:`Fixed Price`. Then, set a :guilabel:`Fixed Price`
amount greater than `0.00` (not zero), as the shipping method price is added to the invoice line.

Expand Down
3 changes: 1 addition & 2 deletions content/applications/finance/payment_providers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -420,7 +420,7 @@ the field to `0.00` to make the payment provider available regardless of the pay
.. important::
This feature is not intended to work on pages that allow the customer to update the payment
amount, e.g., the **Donation** snippet and the **Checkout** page when paid :doc:`shipping methods
<../websites/ecommerce/checkout_payment_shipping/shipping>` are enabled.
<../websites/ecommerce/shipping>` are enabled.

.. _payment_providers/journal:

Expand Down Expand Up @@ -471,5 +471,4 @@ payments from other payments.
- :doc:`payment_providers/stripe`
- :doc:`payment_providers/worldline`
- :doc:`payment_providers/xendit`
- :doc:`../websites/ecommerce/checkout_payment_shipping/payments`
- :doc:`accounting/bank`
2 changes: 1 addition & 1 deletion content/applications/sales/subscriptions/plans.rst
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ the following additional options:

- :guilabel:`Self Closable`: Check this box to enable the customer to terminate their subscription
from the :doc:`customer portal
</applications/websites/ecommerce/ecommerce_management/customer_accounts>`.
</applications/websites/ecommerce/customer_accounts>`.
- :guilabel:`Automatic Closing`: Enter the number of days after which *unpaid* subscriptions *past*
the due date are automatically closed.
- :guilabel:`Invoicing Journal`: Select the accounting journal in which invoices for this
Expand Down
9 changes: 7 additions & 2 deletions content/applications/websites/ecommerce.rst
Original file line number Diff line number Diff line change
Expand Up @@ -24,5 +24,10 @@ products and increase your average cart sizes.
:titlesonly:

ecommerce/products
ecommerce/checkout_payment_shipping
ecommerce/ecommerce_management
ecommerce/cart
ecommerce/checkout
ecommerce/payments
ecommerce/shipping
ecommerce/order_handling
ecommerce/customer_accounts
ecommerce/performance
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,11 @@ the :guilabel:`Shop - Checkout Process` section, look for :guilabel:`Add to Cart
the options.

.. note::
If a product has :doc:`optional products <../products/cross_upselling>`, the **dialog
If a product has :doc:`optional products <products/cross_upselling>`, the **dialog
box** will always appear.

.. seealso::
:doc:`../products/catalog`
:doc:`products/catalog`

.. _cart/prevent-sale:

Expand All @@ -50,7 +50,7 @@ To do so, go to :menuselection:`Website --> Configuration --> Settings --> Shop
:guilabel:`Prevent Sale of Zero Priced Product`. This creates a new :guilabel:`Button url` field
where you can enter the **redirect URL** to be used. Then, set the price of the product to `0.00`
either from the **product's template**, or from a
:doc:`pricelist <../../../sales/sales/products_prices/prices/pricing>`.
:doc:`pricelist </applications/sales/sales/products_prices/prices/pricing>`.

.. image:: cart/cart-contactus.png
:align: center
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ To restrict checkout to selected B2B customers, follow these steps:
:guilabel:`On invitation`.
#. Go to :menuselection:`Website --> eCommerce --> Customers`, switch to the :guilabel:`List` view,
and select the customers you wish to grant access to your
:doc:`portal <../../../general/users/portal>`.
:doc:`portal </applications/general/users/portal>`.
#. Click the :icon:`fa-cog` :guilabel:`Actions` button, then :guilabel:`Grant portal access`.
#. Review the selected customers in the :guilabel:`Portal Access Management` pop-up and click
:guilabel:`Grant Access`.
Expand All @@ -47,13 +47,13 @@ instructions on setting a password and activating their account.
.. note::
- You can revoke access or re-invite a customer using the related buttons in the
:guilabel:`Portal Access Management` pop-up.
- Users can only have one :doc:`portal access <../../../general/users/portal>` per email.
- Users can only have one :doc:`portal access </applications/general/users/portal>` per email.
- Settings are website-specific, so you could set up a B2C website that allows guest checkout and
B2B website with mandatory sign-in.

.. seealso::
- :doc:`Customer accounts <../ecommerce_management/customer_accounts>`
- :doc:`Portal access <../../../general/users/portal>`
- :doc:`Customer accounts <customer_accounts>`
- :doc:`Portal access </applications/general/users/portal>`

.. _ecommerce/checkout/steps:

Expand All @@ -71,7 +71,7 @@ During the checkout process, customers are taken through the following steps:
.. _ecommerce/checkout/customize_steps:

Each step can be customized using the website editor: Click :guilabel:`Edit` to add
:doc:`building blocks <../../website/web_design/building_blocks>` from the :guilabel:`Blocks` tab or
:doc:`building blocks <../website/web_design/building_blocks>` from the :guilabel:`Blocks` tab or
open to the :guilabel:`Customize` tab to enable various checkout options.

.. note::
Expand All @@ -93,7 +93,7 @@ as:
- :guilabel:`Suggested Accessories`: to showcase :ref:`accessory products
<ecommerce/cross_upselling/accessory>`;
- :guilabel:`Promo Code`: to allow customers to redeem :ref:`gift cards <ewallet_gift/gift-cards>`
or apply :doc:`discount codes <../../../sales/sales/products_prices/loyalty_discount>`;
or apply :doc:`discount codes </applications/sales/sales/products_prices/loyalty_discount>`;
- :guilabel:`Add to Wishlist`: To allow signed-in users to remove a product from their cart and add
it to their wishlist, go to :menuselection:`Website --> Configuration --> Settings`, scroll to
the :guilabel:`Shop - Products` section, and enable :guilabel:`Wishlists`. The :guilabel:`Add to
Expand Down Expand Up @@ -172,4 +172,4 @@ The final step of the checkout process is the :guilabel:`Order confirmation`, wh
summary of the customer's purchase details.

.. seealso::
:doc:`Order handling <../../ecommerce/ecommerce_management/order_handling>`
:doc:`Order handling <order_handling>`
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

This file was deleted.

13 changes: 0 additions & 13 deletions content/applications/websites/ecommerce/ecommerce_management.rst

This file was deleted.

This file was deleted.

Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,9 @@ enable the feature in the settings of the
manually to reserve products in stock.

.. seealso::
- :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/invoicing`
- :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels`
- :doc:`../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/multipack`
- :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/invoicing`
- :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels`
- :doc:`../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/multipack`

Returns and refunds
-------------------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ customers to pay with their preferred payment methods.

.. seealso::
- :doc:`/applications/sales/sales/products_prices/ewallets_giftcards`
- :doc:`../checkout_payment_shipping/checkout`
- :doc:`checkout`

Configuration
=============
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -169,7 +169,7 @@ or a **wishlist**. To do so, go to your **main shop page**, and at the end of th
appear when hovering the mouse over a product's image.

- :guilabel:`Add to Cart`: adds a button to
:doc:`add the product to the cart <../checkout_payment_shipping/cart>`;
:doc:`add the product to the cart <../cart>`;
- :guilabel:`Comparison List`: adds a button to **compare** products based on their price, variant,
etc.;
- :guilabel:`Wishlist Button`: adds a button to **wishlist** the product.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,22 +6,25 @@ Odoo eCommerce allows you to configure various delivery methods, enabling custom
their preferred option at :doc:`checkout <checkout>`. These methods include :ref:`external providers
<ecommerce/shipping/external-provider>`, :ref:`custom options <ecommerce/shipping/custom-method>`
such as flat-rate or free shipping, local carriers via
:doc:`Sendcloud <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
or ::ref:`Based on Rules <inventory/shipping/rules>`, and
:doc:`Sendcloud </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
or :ref:`Based on Rules <inventory/shipping/rules>`, and
:ref:`in-store pickup <ecommerce/shipping/instore-pickup>`.
:doc:`Sendcloud </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`
or :ref:`Based on Rules <inventory/shipping/rules>`, and :ref:`in-store pickup
<ecommerce/shipping/instore-pickup>`.

.. _ecommerce/shipping/external-provider:

External provider integration
=============================

To handle product delivery, you can connect your database to :doc:`third-party shipping carriers
<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
like :doc:`FedEx <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex>`,
:doc:`UPS <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/ups_credentials>`,
or :doc:`DHL <../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials>`.
</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
like :doc:`FedEx </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/fedex>`,
:doc:`UPS </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/ups_credentials>`,
or :doc:`DHL </applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/dhl_credentials>`.
A shipping connector links to these providers, automating :doc:`tracking labels
<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels>` and shipping
</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/labels>` and shipping
processes.

To enable a third-party delivery provider, go to :menuselection:`Website --> Configuration -->
Expand All @@ -33,7 +36,7 @@ in the list to :ref:`configure it <inventory/shipping_receiving/configure-delive

.. seealso::
:doc:`Third-party shipping carriers
<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`
</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/third_party_shipper>`

.. important::
The field used to define additional fees **must** be filled **in your third-party delivery
Expand Down Expand Up @@ -67,7 +70,7 @@ Custom delivery method
Custom delivery methods must be created, for example:

- to integrate delivery carriers through :doc:`Sendcloud
<../../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`;
</applications/inventory_and_mrp/inventory/shipping_receiving/setup_configuration/sendcloud_shipping>`;
- to configure specific rules (e.g., to offer free shipping for orders above a specific amount) for
a specific provider;
- to configure :ref:`Fixed Price <inventory/shipping/fixed>` shipping, or shipping :ref:`Based on
Expand All @@ -84,11 +87,11 @@ In the :guilabel:`Provider` field, select :ref:`Based on Rules <inventory/shippi
Upon :ref:`configuring <inventory/shipping_receiving/configure-delivery-method>` a delivery
method, you can:

- Restrict it :doc:`to a specific website <../../website/configuration/multi_website>` by
selecting it in the :guilabel:`Website` field;
- Restrict it :doc:`to a specific website <../website/configuration/multi_website>` by
selecting it in the :guilabel:`Website` field.
- Click the :guilabel:`Test Environment` smart button to switch to the
:guilabel:`Production Environment`. Then, click :guilabel:`Unpublished` to :guilabel:`Publish`
the delivery method and make it available to website visitors;
the delivery method and make it available to website visitors.
- Use the :guilabel:`Availability` tab to define :ref:`conditions
<inventory/shipping_receiving/availability>` for the delivery method based on the order's
content or destination.
Expand All @@ -113,7 +116,7 @@ To allow customers to reserve products online and pay for/collect them in-store,

.. note::
- When the product is in stock, a location selector is displayed on the :doc:`product
<../products>` and :doc:`checkout <checkout>` pages. Customers cannot select a pickup location
<products>` and :doc:`checkout <checkout>` pages. Customers cannot select a pickup location
if the product is out of stock at that location. The :ref:`Continue selling
<ecommerce/products/stock-management>` option for out-of-stock products is not supported.
- If the :ref:`Show Available Qty <ecommerce/products/stock-management>` option is enabled for a
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -124,8 +124,8 @@ Customer accounts
-----------------

You can :doc:`allow your customers to use the same account
<../../ecommerce/ecommerce_management/customer_accounts>` on all of your websites by enabling the
:guilabel:`Shared Customer Accounts` check box in the website settings.
<../../ecommerce/customer_accounts>` on all of your websites by enabling the :guilabel:`Shared
Customer Accounts` check box in the website settings.

Pricing
-------
Expand Down
Loading