diff --git a/content/applications/sales/sales/products_prices/prices/pricing.rst b/content/applications/sales/sales/products_prices/prices/pricing.rst index e5a758418..cc7cc2a78 100644 --- a/content/applications/sales/sales/products_prices/prices/pricing.rst +++ b/content/applications/sales/sales/products_prices/prices/pricing.rst @@ -353,6 +353,49 @@ discount for each product line and the new price will automatically be calculate Positive values for :guilabel:`Disc.%` will apply a *discount*, while negative values can be used to *increase* the price. +Discount button +--------------- + +In Odoo 17, with the :ref:`Discounts setting ` enabled, a :guilabel:`Discount` +button appears at the bottom of sales orders. + +.. image:: pricing/discount-button-sales-order.png + :align: center + :alt: The discount button located at the bottom of a sales order form in the Odoo Sales app. + +When the :guilabel:`Discount` button on a sales order is clicked, a :guilabel:`Discount` pop-up +window appears. + +On this pop-up window, configure the :guilabel:`Discount` percentage, and select one of the +following discount options: :guilabel:`On All Order Lines`, :guilabel:`Global Discount`, or +:guilabel:`Fixed Amount`. + +- :guilabel:`On All Order Lines`: When selected, Odoo provides the ability to add the specified + discount percentage (configured in the :guilabel:`Discount` field of the pop-up window) on all + existing order lines of the sales order. +- :guilabel:`Global Discount`: When selected, Odoo adds a discount product to the order, which has + the cumulative value equivalent to the specified discount percentage (configured in the + :guilabel:`Discount` field of the pop-up window). Any product added (or removed) *after* the + discount is added does **not** affect the discount value on the order line. + + .. example:: + In this example, since the total of the order is $600, and there is a 30% global discount, that + specific line is added to the sales order with a -180 value (which is 30% of $600). + + .. image:: pricing/global-discount-option-so.png + :align: center + :alt: The sales order with the applied global discount option in the Odoo Sales application. + +- :guilabel:`Fixed Amount`: When selected, the percentage designation in the :guilabel:`Discount` + field turns to a monetary value (e.g. dollars), wherein a specific amount must be entered. This + configured value is added as a discount line on the sales order. + +.. note:: + It is more beneficial to add a :guilabel:`Fixed Amount` discount after **all** desired products + have been added to a sales order. If there are changes made to the sales order *after* the + discount is added, make sure to change the value on the :guilabel:`Discount` line, or remove the + line and add the discount again. + .. _sales/advanced-price-rules: Advanced price rules diff --git a/content/applications/sales/sales/products_prices/prices/pricing/discount-button-sales-order.png b/content/applications/sales/sales/products_prices/prices/pricing/discount-button-sales-order.png new file mode 100644 index 000000000..ee3e01157 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/pricing/discount-button-sales-order.png differ diff --git a/content/applications/sales/sales/products_prices/prices/pricing/global-discount-option-so.png b/content/applications/sales/sales/products_prices/prices/pricing/global-discount-option-so.png new file mode 100644 index 000000000..d35172ab0 Binary files /dev/null and b/content/applications/sales/sales/products_prices/prices/pricing/global-discount-option-so.png differ