diff --git a/content/applications/general/users/portal.rst b/content/applications/general/users/portal.rst index 029269f132..49bb4a317d 100644 --- a/content/applications/general/users/portal.rst +++ b/content/applications/general/users/portal.rst @@ -7,8 +7,8 @@ Portal access Portal access is given to users who need the ability to view certain documents or information within an Odoo database. -Some common use cases for providing portal access include allowing customers to read/view any or all -of the following in Odoo: +Some common use cases for providing portal access include allowing customers to make partial payment +on an invoice, to add funds to their eWallet, and to read/view any or all of the following in Odoo: - leads/opportunities - quotations/sales orders diff --git a/content/applications/inventory_and_mrp/inventory/product_management/configure/uom.rst b/content/applications/inventory_and_mrp/inventory/product_management/configure/uom.rst index 6c0bf4afc6..9643dd9783 100644 --- a/content/applications/inventory_and_mrp/inventory/product_management/configure/uom.rst +++ b/content/applications/inventory_and_mrp/inventory/product_management/configure/uom.rst @@ -46,9 +46,9 @@ Price` or :guilabel:`Cost` fields. :alt: Edit the inventory unit of measure in the "Sales Price" or "Cost" fields. .. important:: - The :guilabel:`Sales Price` and :guilabel:`Cost` units of measure cannot be updated - independently of each other. When one unit of measure is updated, the other unit of measure - automatically updates to use the same unit of measure. + The :guilabel:`Sales Price` and :guilabel:`Cost` units of measure cannot be updated independently + of each other. When one unit of measure is updated, the other unit of measure automatically + updates to use the same unit of measure. Sales unit of measure (packagings) ---------------------------------- @@ -69,7 +69,8 @@ Purchase unit of measure Units of measure that the product is purchased in are defined in the :guilabel:`Purchase` tab of the product. Purchase orders can be created in these units of measure after they are defined in the -vendor price list. +vendor price list. Purchase units of measure must be in the same category as the default unit of +measure. .. image:: uom/purchase-uom.png :alt: Specify a purchase unit of measure in the "Purchase" tab. @@ -101,8 +102,7 @@ Buy products in the purchase UoM When creating a new request for quotation (RFQ) in the *Purchase* app, Odoo pulls the unit that the vendor prefers to use, defined in the :guilabel:`Unit` field of the vendor line in the :guilabel:`Purchase` tab of the product. The unit the vendor prefers **can** be different from the -unit your company prefers to use. If needed, manually edit the :guilabel:`Unit` value on -the |RFQ|. +unit your company prefers to use. If needed, manually edit the :guilabel:`Unit` value on the |RFQ|. After the |RFQ| is confirmed into a |PO|, click the :guilabel:`Receipt` smart button at the top of the |PO|. @@ -111,9 +111,9 @@ Odoo automatically converts the purchase unit of measure into the product's sale measure, so the :guilabel:`Demand` column of the delivery receipt shows the converted quantity. .. example:: - When the product's purchase :guilabel:`Unit` is `m` (meters), and its inventory unit of - measure is `yard`, the |PO| shows the quantity in meters, and the receipt (and other - internal warehouse documents) shows the quantity in yards. + When the product's purchase :guilabel:`Unit` is `m` (meters), and its inventory unit of measure + is `yard`, the |PO| shows the quantity in meters, and the receipt (and other internal warehouse + documents) shows the quantity in yards. .. figure:: uom/on-po.png :alt: Image of a purchase order that is using the purchase unit of measure. @@ -163,9 +163,9 @@ measure into the product's inventory unit of measure, so the :guilabel:`Demand` delivery shows the converted quantity. .. example:: - When the product's sales :guilabel:`Unit` is `m` (meters), and its inventory unit of - measure is `yard`, the |SO| shows the quantity in meters, and the delivery (and other - internal warehouse documents) shows the quantity in yards. + When the product's sales :guilabel:`Unit` is `m` (meters), and its inventory unit of measure is + `yard`, the |SO| shows the quantity in meters, and the delivery (and other internal warehouse + documents) shows the quantity in yards. .. figure:: uom/on-so.png :alt: Sales order that is using the sales unit of measure. @@ -175,8 +175,7 @@ delivery shows the converted quantity. .. figure:: uom/on-delivery.png :alt: Delivery displaying the inventory unit of measure. - Upon warehouse delivery, the recorded quantities are in the internal "Unit": - `yards`. + Upon warehouse delivery, the recorded quantities are in the internal "Unit": `yards`. Create custom units of measure ============================== @@ -187,8 +186,8 @@ of measure. To create a new unit, click the :guilabel:`New` button. Specify a unit name. If you want to convert between units, specify a quantity and a reference unit of measure to convert between. If applicable, -enter a :guilabel:`UNSPSC Category`, which is a globally recognized `code managed by -GS1 `_, that **must** be purchased in order to use. +enter a :guilabel:`UNSPSC Category`, which is a globally recognized `code managed by GS1 +`_, that **must** be purchased in order to use. .. example:: You will be purchasing fabric in terms of yards or meters. Specify that one yard is equal to diff --git a/content/applications/sales/sales.rst b/content/applications/sales/sales.rst index c25b91935f..93449158fc 100644 --- a/content/applications/sales/sales.rst +++ b/content/applications/sales/sales.rst @@ -7,11 +7,12 @@ Sales ===== -**Odoo Sales** is the application to run your sales process (from quotation to sales order) and -deliver and invoice what has been sold. +The **Sales** application is used to run the sales process (from quotation to sales order) and +deliver and invoice what has been sold. Any product with the *Sales* checkbox ticked on its product +form can be sold with the **Sales** app. .. seealso:: - - `Odoo Tutorials: Sales Tutorials `_ + - `Odoo Tutorials: Sales `_ .. toctree:: :titlesonly: diff --git a/content/applications/sales/sales/commissions.rst b/content/applications/sales/sales/commissions.rst index b9806ab123..5faeb9e9b1 100644 --- a/content/applications/sales/sales/commissions.rst +++ b/content/applications/sales/sales/commissions.rst @@ -97,9 +97,9 @@ Achievement-based commission plans ---------------------------------- In a *Achievement* based commission plan, salespeople earn a percentage of their invoice value as -commission. Target based plans are ideal for rewarding sales activity consistently, regardless of -specific goals. For example, offering a `5%` commission on all invoiced amounts, regardless of how -much is sold. +commission. Achievement-based plans are ideal for rewarding sales activity consistently, regardless +of specific goals. For example, offering a `5%` commission on all invoiced amounts, regardless of +how much is sold. .. tip:: Achievement based plans differ from *Target* based plans because they are calculated based on @@ -126,7 +126,8 @@ Achievements ------------ Performance can be measured in several ways in performance plans. These are configured in the -:guilabel:`Achievements` tab of each plan. +:guilabel:`Achievements` tab of each plan. It is possible to track achievements by all products +sold, by specific products sold, by all products sold in a specific category, and more. - :guilabel:`Amount Sold`: the total value of sales orders (SOs). - :guilabel:`Amount Invoiced`: the total value of confirmed invoices. diff --git a/content/applications/sales/sales/invoicing/invoicing_policy.rst b/content/applications/sales/sales/invoicing/invoicing_policy.rst index 8b9fdbe249..9e509e9676 100644 --- a/content/applications/sales/sales/invoicing/invoicing_policy.rst +++ b/content/applications/sales/sales/invoicing/invoicing_policy.rst @@ -4,12 +4,13 @@ Invoice based on delivered or ordered quantities Different business policies might require different options for invoicing: -- The *Invoice what is ordered* rule is used as the default mode in Odoo *Sales*, which means +- The *Invoice what is ordered* rule is used as the default mode in Odoo **Sales**, which means customers are invoiced once the sales order is confirmed. - The *Invoice what is delivered* rule invoices customers once the delivery is done. This rule is often used for businesses that sell materials, liquids, or food in large quantities. In these cases, the ordered quantity may differ slightly from the delivered quantity, making it preferable - to invoice the quantity actually delivered. + to invoice the quantity actually delivered. When the delivery order is validated, Odoo will + automatically decrease the on-hand quantity in the inventory. Being able to have different invoicing options provides more flexibility. @@ -66,7 +67,6 @@ The following is a breakdown of how invoicing policy rules impact the aforementi :align: center :alt: If Delivered Quantities invoicing policy is chosen, ensure a quantity has been delivered. - .. note:: Once a quotation is confirmed, and the status changes from :guilabel:`Quotation sent` to :guilabel:`Sales order`, the delivered and invoiced quantities are available to view, directly diff --git a/content/applications/sales/sales/invoicing/milestone.rst b/content/applications/sales/sales/invoicing/milestone.rst index 71bb3e6295..d220213433 100644 --- a/content/applications/sales/sales/invoicing/milestone.rst +++ b/content/applications/sales/sales/invoicing/milestone.rst @@ -2,9 +2,9 @@ Invoice project milestones ========================== -Invoicing based on project milestones can be used for expensive or large-scale projects. The series -of milestones in a project represent a clear sequence of work that will inevitably result in the -completion of a project and/or contract. +Invoicing based on project milestones can be used for expensive or large-scale projects with +discrete, measurable deliverables. The series of milestones in a project represent a clear sequence +of work that will inevitably result in the completion of a project and/or contract. This method of invoicing ensures the company gets a consistent flow of money throughout the lifetime of the project. Customers can closely monitor every phase of the project's development as it diff --git a/content/applications/sales/sales/products_prices/prices/pricing.rst b/content/applications/sales/sales/products_prices/prices/pricing.rst index 7cbf2a2cb3..88add569e7 100644 --- a/content/applications/sales/sales/products_prices/prices/pricing.rst +++ b/content/applications/sales/sales/products_prices/prices/pricing.rst @@ -2,9 +2,10 @@ Pricelists ========== -A *pricelist* is a method of dynamic pricing that applies a list of prices (or price rules) to -adjust sales prices. This adjustment can apply to specific customers, customer groups, sales orders, -time periods, etc., and is useful for creating pricing strategies and optimizing sales margins. +A *pricelist* is a method of dynamic pricing that applies a list of prices (or price rules) that +overrides the sales price on a product's product form. This adjustment can set to apply to all +products sold or tailored to only apply to specific customers, customer groups, sales orders, time +periods, etc., and is useful for creating pricing strategies and optimizing sales margins. Odoo **Sales** has a useful pricelist feature that can be tailored to fit any unique pricing strategy. Pricelists suggest certain prices, but they can always be overridden on the sales order. @@ -73,9 +74,11 @@ Price Rules tab --------------- In the :guilabel:`Price Rules` tab, each line creates a new record that will implement customized -pricing to the sales order where the pricelist is applied. To create a new price rule, click on -:guilabel:`Add a line`, which opens a new pricelist rules form. +pricing to the sales order where the pricelist is applied. This can be used to create complex +pricing structures, such as progressive discounts when greater quantities of a product are +purchased. +To create a new price rule, click on :guilabel:`Add a line`, which opens a new pricelist rules form. Then, select whether to apply this set of rules to a :guilabel:`Product` or :guilabel:`Category`. From here, there are several configuration options: diff --git a/content/applications/sales/sales/products_prices/products/variants.rst b/content/applications/sales/sales/products_prices/products/variants.rst index 89ae27b4c0..ff59f70813 100644 --- a/content/applications/sales/sales/products_prices/products/variants.rst +++ b/content/applications/sales/sales/products_prices/products/variants.rst @@ -78,7 +78,8 @@ The :guilabel:`Display Type` options are: - :guilabel:`Select`: options appear in a drop-down menu on the product page of the online store. set, on the product page of the online store. - :guilabel:`Multi-checkbox (option)`: options appear as selectable checkboxes on the product page - of the online store. + of the online store. This allows customers to choose options for themselves and is good choice for + highly customizable products. .. image:: variants/display-types.png :align: center @@ -92,8 +93,8 @@ once an attribute is added to a product. order for the :guilabel:`Multi-checkbox (option)` to work properly as the :guilabel:`Display Type`. -- :guilabel:`Instantly`: creates all possible variants as soon as attributes and values are added - to a product template. +- :guilabel:`Instantly`: creates all possible variants as soon as attributes and values are added to + a product template. - :guilabel:`Dynamically`: creates variants **only** when corresponding attributes and values are added to a sales order. - :guilabel:`Never (option)`: never automatically creates variants. @@ -162,23 +163,23 @@ color selector pop-up window. .. image:: variants/picking-a-color.png :alt: Selecting a color from the HTML color pop-up window that appears on attribute form. -In this pop-up window, select a specific color by dragging the color slider to a particular hue, -and clicking on the color portion directly on the color gradient window. +In this pop-up window, select a specific color by dragging the color slider to a particular hue, and +clicking on the color portion directly on the color gradient window. Or, choose a specific color by clicking the *dropper* icon, and selecting a desired color that's currently clickable on the screen. -If you sell products with specific patterns, you can also add an image to display the -pattern of the product. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon, -then click the :icon:`fa-pencil` :guilabel:`(pencil)` icon and select an image from your local -drive. This pattern will appear as a color option on the ecommerce product page. +Businesses can attach images to product variant attribute values for customers to view on an +eCommerce webite. To do so, click the :icon:`fa-camera` :guilabel:`(camera)` icon, then click the +:icon:`fa-pencil` :guilabel:`(pencil)` icon and select an image from your local drive. This image +will appear as a color option on the ecommerce product page. .. image:: variants/ecommerce-pattern-option.png :alt: Pattern as color option on the ecommerce page. .. tip:: - Attributes can also be created directly from the product template by adding a new line and - typing the name into the :guilabel:`Variants` tab. + Attributes can also be created directly from the product template by adding a new line and typing + the name into the :guilabel:`Variants` tab. Once an attribute is added to a product, that product is listed and accessible, via the attribute's :guilabel:`Related Products` smart button. That button lists every product in the database currently @@ -283,8 +284,8 @@ impacts that can be taken advantage of throughout the Odoo database. - :guilabel:`Barcode`: barcodes are associated with each variant, instead of the product template. Each individual variant can have its own unique barcode/SKU. -- :guilabel:`Price`: every product variant has its own public price, which is the sum of the - product template price *and* any extra charges for particular attributes. +- :guilabel:`Price`: every product variant has its own public price, which is the sum of the product + template price *and* any extra charges for particular attributes. .. example:: A red shirt's sales price is $23 -- because the shirt's template price is $20, plus an additional diff --git a/content/applications/sales/sales/sales_quotations/create_quotations.rst b/content/applications/sales/sales/sales_quotations/create_quotations.rst index 0e7483717e..55caaa2ded 100644 --- a/content/applications/sales/sales/sales_quotations/create_quotations.rst +++ b/content/applications/sales/sales/sales_quotations/create_quotations.rst @@ -148,7 +148,8 @@ newly-selected catalog items can be found in the :guilabel:`Order Lines` tab. If multiple items should be presented in a more organized way on the quotation, click :guilabel:`Add a section`, enter a name for the section, and drag-and-drop that section heading in the desired -location amongst the items in the :guilabel:`Order Lines` tab. The section heading appears in bold. +location amongst the items in the :guilabel:`Order Lines` tab. The section heading appears in bold +and a sub-total for all products in a section is displayed. If needed, click :guilabel:`Add a note` beneath a certain product line to add a custom note about that specific product. The note appears in italics. Then, if needed, proceed to drag-and-drop the diff --git a/content/applications/sales/sales/sales_quotations/margin.rst b/content/applications/sales/sales/sales_quotations/margin.rst index 2ecc61ec8d..dc03fb69b6 100644 --- a/content/applications/sales/sales/sales_quotations/margin.rst +++ b/content/applications/sales/sales/sales_quotations/margin.rst @@ -79,8 +79,7 @@ product. Follow these steps: #. Go to :menuselection:`Sales app --> Products --> Pricelists` and click the :guilabel:`New` button. -#. Enter the name of the pricelist and click :guilabel:`Add a line` to create a new pricelist - rule. +#. Enter the name of the pricelist and click :guilabel:`Add a line` to create a new pricelist rule. #. Configure the pricelist and click :guilabel:`Save & Close` button. #. Go to :menuselection:`Sales app --> Orders --> Quotations` and create a quotation. #. In the :guilabel:`Pricelist` field, select the newly made pricelist. @@ -110,6 +109,6 @@ product. Follow these steps: .. tip:: Another way to visualize the impact of margins on sales orders is to go to :menuselection:`Sales app --> Orders --> Quotations`, select the :icon:`fa-area-chart` :guilabel:`(area chart)` icon or - :icon:`oi-view-pivot` :guilabel:`(pivot)` icon, click :guilabel:`Measures` button and change it - to :guilabel:`Margin` to see margin contributions across the customer base. + :icon:`oi-view-pivot` :guilabel:`(pivot)` icon, click :guilabel:`Measures` drop-down button and + change it to :guilabel:`Margin` to see margin contributions across the customer base. diff --git a/content/applications/websites/ecommerce/checkout.rst b/content/applications/websites/ecommerce/checkout.rst index ea0795ee24..d23ec6c352 100644 --- a/content/applications/websites/ecommerce/checkout.rst +++ b/content/applications/websites/ecommerce/checkout.rst @@ -29,11 +29,11 @@ Default add to cart behavior When clicking the :guilabel:`Add to cart` button, different actions can be triggered. To configure them, go to :menuselection:`Website --> Configuration --> Settings`, scroll down to the -:guilabel:`eCommerce` section, and select one of the following options for the -:guilabel:`Add to cart` feature: +:guilabel:`eCommerce` section, and select one of the following options for the :guilabel:`Add to +cart` feature: -- :guilabel:`Stay on Product Page`: The customer can choose if they want to :guilabel:`Add - to cart` and continue shopping or :guilabel:`Go to the Checkout`. +- :guilabel:`Stay on Product Page`: The customer can choose if they want to :guilabel:`Add to cart` + and continue shopping or :guilabel:`Go to the Checkout`. - :guilabel:`Go to cart`: The customer is immediately redirected to the cart. .. _ecommerce/checkout/prevent-sale: @@ -66,8 +66,8 @@ You can add additional :guilabel:`Add to Cart` buttons and link them to specific website page. To add them, open the website editor and place the :guilabel:`Add to Cart Button` inner content -building block. Once placed, click the button, scroll to the :guilabel:`Add to Cart Button` -section, and configure the following: +building block. Once placed, click the button, scroll to the :guilabel:`Add to Cart Button` section, +and configure the following: - :guilabel:`Product`: Select the product to link the button with. - :guilabel:`Action`: Choose if it should be an :guilabel:`Add to Cart` or :ref:`Buy Now @@ -154,9 +154,9 @@ Order summary The :guilabel:`Order summary` step allows customers to see the items they added to their cart, adjust quantities, :guilabel:`Remove` products, and :ref:`reorder products from a previous order -`. Information related to the product prices and -taxes applied are also displayed. Customers can then click the :guilabel:`Checkout` button to -continue to the :ref:`Address and delivery ` step. +`. Information related to the product prices and taxes applied are also +displayed. Customers can then click the :guilabel:`Checkout` button to continue to the :ref:`Address +and delivery ` step. Open the website editor to :ref:`enable ` checkout options such as: @@ -225,15 +225,14 @@ Configuration --> Payment Providers`, :guilabel:`Activate` the relevant payment :ref:`configure ` it. .. tip:: - The options displayed at checkout depend on the active payment providers, the - enabled :ref:`payment methods `, the :ref:`customer’s country - and currency `, and, optionally, the :ref:`maximum - amount ` set for the provider. + The options displayed at checkout depend on the active payment providers, the enabled + :ref:`payment methods `, the :ref:`customer’s country and + currency `, and, optionally, the :ref:`maximum amount + ` set for the provider. - To display an :ref:`availability ` report for payment - providers and payment methods and help diagnose potential availability issues on the payment - form, enable the :ref:`developer mode ` and click the :icon:`fa-bug` - (:guilabel:`bug`) icon. + To display an :ref:`availability ` report for payment providers + and payment methods and help diagnose potential availability issues on the payment form, enable + the :ref:`developer mode ` and click the :icon:`fa-bug` (:guilabel:`bug)` icon. Terms and conditions ~~~~~~~~~~~~~~~~~~~~ @@ -260,7 +259,9 @@ Order confirmation ------------------ The final step of the checkout process is the :guilabel:`Order confirmation`, which provides a -summary of the customer's purchase details. +summary of the customer's purchase details. If the :guilabel:`Automatic Invoice` setting has been +activated in the **Sales** app's configuration settings, a sales order and invoice will +automatically be created by Odoo. .. seealso:: :doc:`Order handling documentation `