From 6f74248de13356fdf637b00b72ff4cb102e01b3c Mon Sep 17 00:00:00 2001 From: "KC (ksc)" Date: Thu, 27 Jun 2024 06:38:53 -0700 Subject: [PATCH] [IMP] sales: adding global discount info closes odoo/documentation#9962 Signed-off-by: Kevin Scannell (ksc) --- .../sales/products_prices/prices/pricing.rst | 43 ++++++++++++++++++ .../pricing/discount-button-sales-order.png | Bin 0 -> 21251 bytes .../pricing/global-discount-option-so.png | Bin 0 -> 15228 bytes 3 files changed, 43 insertions(+) create mode 100644 content/applications/sales/sales/products_prices/prices/pricing/discount-button-sales-order.png create mode 100644 content/applications/sales/sales/products_prices/prices/pricing/global-discount-option-so.png 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 0000000000000000000000000000000000000000..ee3e01157442ec7fff2d29a8802d567b3de9b028 GIT binary patch literal 21251 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 literal 0 HcmV?d00001