Metadata-Version: 2.1
Name: odoo-addon-loyalty_multi_gift
Version: 16.0.1.0.0.9
Summary: Allows to configure multiple gift rewards per promotion
Home-page: https://github.com/OCA/sale-promotion
Author: Tecnativa, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
License: AGPL-3
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 16.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.10
Requires-Dist: odoo<16.1dev,>=16.0a

==================
Loyalty multi gift
==================

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

.. |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-OCA%2Fsale--promotion-lightgray.png?logo=github
    :target: https://github.com/OCA/sale-promotion/tree/16.0/loyalty_multi_gift
    :alt: OCA/sale-promotion
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/sale-promotion-16-0/sale-promotion-16-0-loyalty_multi_gift
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/sale-promotion&target_branch=16.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module allows to define multiple reward products on promotions.

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

For the 'buy_x_get_y' type promotion, the 'Reward_type' field is restricted to the 'Product'
option only and the possibility to select 'Multigift' is disabled. This restriction is implemented
because, in this scenario, the 'reward_type' field becomes 'readonly'.

It is crucial to note that modifying the values displayed in this field to set different
values according to the type of promotion may generate conflicts with other modules that
contribute to the configuration of this same field. Therefore, it is recommended not to
alter these values directly, as this may affect the consistency and functionality of other
components of the system.

To configure similar promotions, it is suggested to modify another type of promotion by
adapting its rules and rewards according to specific needs. This provides a more secure
and consistent way to manage custom configurations without compromising the integrity of
the system.

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

To configure multiple product rewards:

#. Go to *Sales > Products > Discount & Loyalty* and select or create a new one.
#. Choose the criteria of appliance you want to use and the minimum quantities, that
   will be used to calculate the times the rewards can be applied.
#. On the *Program Type* field choose *Multi Gift*.
#. You'll see a now the *Gift list* on which you can add the products you want to give
   away and the quantities for each of them.

An example:

 ===== ================
  Qty      Products
 ===== ================
    3   Prod A
    2   Prod B
 ===== ================

With a minimum quantity of 3, for every 3 units of products that fulfill the domain
we'd get 3 units of A and 2 of B. So if the valid products quantities are 11, we'd
get 3 of product A and 2 of product B.

Usage
=====

This module is a base to be used by extra modules that use it in sale orders, PoS
orders, etc.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/sale-promotion/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/OCA/sale-promotion/issues/new?body=module:%20loyalty_multi_gift%0Aversion:%2016.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
~~~~~~~

* Tecnativa

Contributors
~~~~~~~~~~~~

* `Tecnativa <https://www.tecnativa.com>`_:

  * David Vidal
  * Pilar Vargas

* `Domatix <https://www.domatix.com>`_:

  * Carolina Ferrer

Maintainers
~~~~~~~~~~~

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-chienandalu| image:: https://github.com/chienandalu.png?size=40px
    :target: https://github.com/chienandalu
    :alt: chienandalu

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-chienandalu| 

This module is part of the `OCA/sale-promotion <https://github.com/OCA/sale-promotion/tree/16.0/loyalty_multi_gift>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
