=======================
Purchase Minimum Amount
=======================

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

.. |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%2Fpurchase--workflow-lightgray.png?logo=github
    :target: https://github.com/OCA/purchase-workflow/tree/16.0/purchase_minimum_amount
    :alt: OCA/purchase-workflow
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/purchase-workflow-16-0/purchase-workflow-16-0-purchase_minimum_amount
    :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/purchase-workflow&target_branch=16.0
    :alt: Try me on Runboat

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

This module allows you to establish and automate a specific Purchase Order
Approval Block Reason in the system: the 'Minimum Purchase Order Amount per
Vendor'.

**Table of contents**

.. contents::
   :local:

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

* Go to 'Purchases / Purchase / Vendors'
* Click on a Vendor and inside the 'Sales & Purchases' page specify the
  non-required field 'Minimum Purchase Amount'.
* Assign the security group 'Release RFQ with approval block' to users that
  should be able to release the block. Users in group 'Purchase / Managers'
  are by default assigned to this group.

Usage
=====

Set the Purchase Approval Block
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Go to 'Purchases / Purchase / Requests for Quotation'
#. Create a new RFQ and upon saving if the Untaxed Amount is below the
   Purchase Minimum Amount specified in that vendor, then the Approval Block
   Reason is automatically set and the Approval Block Reason is not editable
   anymore.

Search existing RFQ
~~~~~~~~~~~~~~~~~~~

There is a filter 'Blocked' to search for orders that are blocked.
It is also possible to search RFQ’s with the Approval Block Reason 'Minimum
Purchase Order Amount per Vendor'.

Confirm the RFQ
~~~~~~~~~~~~~~~

#. Press the button ‘Confirm’. If there’s an approval block, the order will
   be set to status 'To Approve'. You will then need to request a Purchase
   Manager to approve it.

Release the purchase approval block
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. All the RFQ’s with a total amount surpassing the specified Minimum Purchase
   Order Amount for that vendor (excluding taxes) are automatically released.
#. If a blocked RFQ without surpassing the minimum amount wants to be
   released, a user member of the security group 'Release RFQ with approval
   block' can see a button 'Release Approval Block'. When pressing it, anyone
   seeing that RFQ is able to validate it.

Notifications to followers
~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Followers of the RFQ receive notifications when an approval block has been
   set or released.

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

Bugs are tracked on `GitHub Issues <https://github.com/OCA/purchase-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/OCA/purchase-workflow/issues/new?body=module:%20purchase_minimum_amount%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
~~~~~~~

* ForgeFlow

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

* Jordi Ballester Alomar <jordi.ballester@forgeflow.com>
* Roser Garcia <roser.garcia@forgeflow.com>
* Darshan Patel <darshan.patel.serpentcs@gmail.com>
* Nikul Chaudhary <nikulchaudhary2112@gmail.com>

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.

This module is part of the `OCA/purchase-workflow <https://github.com/OCA/purchase-workflow/tree/16.0/purchase_minimum_amount>`_ project on GitHub.

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