Metadata-Version: 2.1
Name: odoo-addon-sale_promotion
Version: 17.0.1.1.0
Requires-Python: >=3.10
Requires-Dist: odoo>=17.0a,<17.1dev
Summary: Sale Promotion
Home-page: https://github.com/sygel-technology/sy-sale-workflow
License: AGPL-3
Author: Sygel, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 17.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3

==============
Sale Promotion
==============

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:b63a49f8b7b7c10e8d50d2226d8376f71fde5beffa85f45c5d17f6126ec4d1dc
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
    :target: https://odoo-community.org/page/development-status
    :alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
    :alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-sygel--technology%2Fsy--sale--workflow-lightgray.png?logo=github
    :target: https://github.com/sygel-technology/sy-sale-workflow/tree/17.0/sale_promotion
    :alt: sygel-technology/sy-sale-workflow

|badge1| |badge2| |badge3|

This module allows to apply promotions to sale order lines.

**Table of contents**

.. contents::
   :local:

Configuration
=============

To configure this module, you need to go to Sales > Products >
Promotions and create a new promotion. Create as many price rules as
needed, considering the following fields:

1. **Computation:** Select "Fixed Price" as the computation method and
   set a value in the "Fixed Price" field so that value will be set as
   the unit price in sale orders if that rule is applied. Select
   "Discount" as the computacion method and set a value in the
   "Discount" field so that value will be set as the discount in sale
   orders if that rule is applied.
2. **Apply On:** Select "All Products" if the price or the discount can
   be applied to all products. Select "Product Category" and choose a
   category if the price or the discount can applied to products of a
   given category. Select "Product" and choose a product template if the
   price or the discount can be applied to a given product template.
   Select "Product Variant" and choose a product variant if the price or
   the discount can applied to a given product variant.
3. **Min. Quantity:** The rule can only be applied if the quantity is
   equal or greater than the set value.
4. **Validity:** The rule can only be applied if the date order is
   inbetween the selected dates.

Once a promotion is created, it is necessary to create a Campaign (Sales
> Products > Campaigns).

1. **Start Date:** Select a date if the promotion can only be applied
   from that date.
2. **End Date:** Select a date if the promotion can only be applied
   before that date.
3. **Pricelists:** Select the list of pricelists for which the campaign
   is available. The campaign will only be applied to a sale order if
   the order's pricelist is selected in this field.
4. **Promotions:** Select the list of promotions that are part of the
   campaign.

Usage
=====

There are two ways to apply promotions in sale orders:

1. Click on the "Apply Promotion" button under the sale order lines to
   apply promotions to all the lines if possible.
2. Click on the "Apply Promotion" in an order line to apply promotions
   to that specific order line if possible.

Promotions are only applied when the resulting price is lower than the
price already set in the sale order line. Only one rule can be applied
in each sale order line.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/sygel-technology/sy-sale-workflow/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/sygel-technology/sy-sale-workflow/issues/new?body=module:%20sale_promotion%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Sygel

Contributors
------------

- Manuel Regidor <manuel.regidor@sygel.es>
- Valentín Vinagre <valentin.vinagre@sygel.es>

Maintainers
-----------

This module is part of the `sygel-technology/sy-sale-workflow <https://github.com/sygel-technology/sy-sale-workflow/tree/17.0/sale_promotion>`_ project on GitHub.

You are welcome to contribute.
