[IMP] sales: adding global discount info

closes odoo/documentation#10468

X-original-commit: 6f74248de1
Signed-off-by: Kevin Scannell (ksc) <ksc@odoo.com>

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 <sales/discounts>` 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