=============================
Purchase Order Approval Block
=============================

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

.. |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_order_approval_block
    :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_order_approval_block
    :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 block the approval of an RFQ when an Approval
Block Reason has been provided. Upon confirmation of an RFQ the orders will be
waiting for approval by a Manager.

**Table of contents**

.. contents::
   :local:

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

* Go to ‘Purchases / Configuration / Purchase Approval Block Reasons’ and create
  the blocking reasons as needed, providing a name and a description. A field
  ‘Active’ allows you to deactivate the reason if you do not plan to use it
  any more.
* 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 indicate the approval block reason (found in the
   right hand side of the screen, below the order date).

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

There is a filter ‘Blocked’ to search for orders that are blocked for approval.
It is also possible to search RFQ’s with a specific block reason.

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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

While the RFQ is in draft, members of security group ‘Release RFQ with approval block’,
can see a button ‘Release Approval Block’. From this point and on, anyone
seeing that RFQ will be 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_order_approval_block%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>

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_order_approval_block>`_ project on GitHub.

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