odoo-addon-loyalty-multi-gift


Nameodoo-addon-loyalty-multi-gift JSON
Version 18.0.1.0.0.2 PyPI version JSON
download
home_pagehttps://github.com/OCA/sale-promotion
SummaryAllows to configure multiple gift rewards per promotion
upload_time2025-07-10 08:33:39
maintainerNone
docs_urlNone
authorTecnativa, Odoo Community Association (OCA)
requires_python>=3.10
licenseAGPL-3
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            .. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

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

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

.. |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/license-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/18.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-18-0/sale-promotion-18-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=18.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:

1. Go to *Sales > Products > Discount & Loyalty* and select or create a
   new one.
2. 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.
3. On the *Program Type* field choose *Multi Gift*.
4. 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:

   [TABLE]

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:%2018.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

- `Heliconia Solutions Pvt. Ltd. <https://www.heliconia.io>`__

  - Bhavesh Heliconia

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/18.0/loyalty_multi_gift>`_ project on GitHub.

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

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/OCA/sale-promotion",
    "name": "odoo-addon-loyalty-multi-gift",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": null,
    "author": "Tecnativa, Odoo Community Association (OCA)",
    "author_email": "support@odoo-community.org",
    "download_url": null,
    "platform": null,
    "description": ".. image:: https://odoo-community.org/readme-banner-image\n   :target: https://odoo-community.org/get-involved?utm_source=readme\n   :alt: Odoo Community Association\n\n==================\nLoyalty multi gift\n==================\n\n.. \n   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n   !! This file is generated by oca-gen-addon-readme !!\n   !! changes will be overwritten.                   !!\n   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n   !! source digest: sha256:08aa73d4d7f9ba4ac1dc4c20bc2dd64ff08498ae6c6bd32c20ffe763f4a8b95c\n   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png\n    :target: https://odoo-community.org/page/development-status\n    :alt: Beta\n.. |badge2| image:: https://img.shields.io/badge/license-AGPL--3-blue.png\n    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n    :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fsale--promotion-lightgray.png?logo=github\n    :target: https://github.com/OCA/sale-promotion/tree/18.0/loyalty_multi_gift\n    :alt: OCA/sale-promotion\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n    :target: https://translation.odoo-community.org/projects/sale-promotion-18-0/sale-promotion-18-0-loyalty_multi_gift\n    :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png\n    :target: https://runboat.odoo-community.org/builds?repo=OCA/sale-promotion&target_branch=18.0\n    :alt: Try me on Runboat\n\n|badge1| |badge2| |badge3| |badge4| |badge5|\n\nThis module allows to define multiple reward products on promotions.\n\n**Table of contents**\n\n.. contents::\n   :local:\n\nUse Cases / Context\n===================\n\nFor the 'buy_x_get_y' type promotion, the 'Reward_type' field is\nrestricted to the 'Product' option only and the possibility to select\n'Multigift' is disabled. This restriction is implemented because, in\nthis scenario, the 'reward_type' field becomes 'readonly'.\n\nIt is crucial to note that modifying the values displayed in this field\nto set different values according to the type of promotion may generate\nconflicts with other modules that contribute to the configuration of\nthis same field. Therefore, it is recommended not to alter these values\ndirectly, as this may affect the consistency and functionality of other\ncomponents of the system.\n\nTo configure similar promotions, it is suggested to modify another type\nof promotion by adapting its rules and rewards according to specific\nneeds. This provides a more secure and consistent way to manage custom\nconfigurations without compromising the integrity of the system.\n\nConfiguration\n=============\n\nTo configure multiple product rewards:\n\n1. Go to *Sales > Products > Discount & Loyalty* and select or create a\n   new one.\n2. Choose the criteria of appliance you want to use and the minimum\n   quantities, that will be used to calculate the times the rewards can\n   be applied.\n3. On the *Program Type* field choose *Multi Gift*.\n4. You'll see a now the *Gift list* on which you can add the products\n   you want to give away and the quantities for each of them.\n\nAn example:\n\n   [TABLE]\n\nWith a minimum quantity of 3, for every 3 units of products that fulfill\nthe domain we'd get 3 units of A and 2 of B. So if the valid products\nquantities are 11, we'd get 3 of product A and 2 of product B.\n\nUsage\n=====\n\nThis module is a base to be used by extra modules that use it in sale\norders, PoS orders, etc.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/sale-promotion/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us to smash it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/sale-promotion/issues/new?body=module:%20loyalty_multi_gift%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n-------\n\n* Tecnativa\n\nContributors\n------------\n\n- `Tecnativa <https://www.tecnativa.com>`__:\n\n  - David Vidal\n  - Pilar Vargas\n\n- `Domatix <https://www.domatix.com>`__:\n\n  - Carolina Ferrer\n\n- `Heliconia Solutions Pvt. Ltd. <https://www.heliconia.io>`__\n\n  - Bhavesh Heliconia\n\nMaintainers\n-----------\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n   :alt: Odoo Community Association\n   :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\n.. |maintainer-chienandalu| image:: https://github.com/chienandalu.png?size=40px\n    :target: https://github.com/chienandalu\n    :alt: chienandalu\n\nCurrent `maintainer <https://odoo-community.org/page/maintainer-role>`__:\n\n|maintainer-chienandalu| \n\nThis module is part of the `OCA/sale-promotion <https://github.com/OCA/sale-promotion/tree/18.0/loyalty_multi_gift>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n",
    "bugtrack_url": null,
    "license": "AGPL-3",
    "summary": "Allows to configure multiple gift rewards per promotion",
    "version": "18.0.1.0.0.2",
    "project_urls": {
        "Homepage": "https://github.com/OCA/sale-promotion"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2d50597030c6c5ecf3f1d633731a3baea5345ac34a4e3b96b5b61abe1869c3dd",
                "md5": "8d1c7ed37bfe8fe0ea58fb6ed60703d6",
                "sha256": "a6e0760195a0eb9a9b2a3bdc249801d649136a0ee18200cf21e9a2d78f87745d"
            },
            "downloads": -1,
            "filename": "odoo_addon_loyalty_multi_gift-18.0.1.0.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "8d1c7ed37bfe8fe0ea58fb6ed60703d6",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 29676,
            "upload_time": "2025-07-10T08:33:39",
            "upload_time_iso_8601": "2025-07-10T08:33:39.554400Z",
            "url": "https://files.pythonhosted.org/packages/2d/50/597030c6c5ecf3f1d633731a3baea5345ac34a4e3b96b5b61abe1869c3dd/odoo_addon_loyalty_multi_gift-18.0.1.0.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-10 08:33:39",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "OCA",
    "github_project": "sale-promotion",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "odoo-addon-loyalty-multi-gift"
}
        
Elapsed time: 0.57645s