Author: |
Open Source Integrators, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
14.0 |
Repository: |
acsone/sale-workflow |
Dependencies: |
base,
partner_stage,
and
sale_exception |
Languages: |
HTML (384, 59.0%),
Python (111, 17.1%),
XML (57, 8.8%),
and
reStructuredText (99, 15.2%) |
Other branches: |
14-sale_automatic_workflow-xbo,
14-sale_order_restrict_cancel_existing_invoice,
14-sale_promotion_rule_delivery,
14-sale_promotion_rule_delivery-xbo,
14.0-abi_master,
14.0-fix-sale-product_set-dro,
14.0-imp-sale-mass_action-dro,
14.0-mig-sale-procurement-amendment-dro,
and
sale_quotation_delivery_mandatory-xbo |
Other repositories: |
BenjaHe/sale-workflow,
Change2improve/sale-workflow,
Comunitea/sale-workflow,
Darknroses/sale-workflow,
Digital5-Odoo/sale-workflow,
ForgeFlow/sale-workflow,
Ingeos/sale-workflow,
JuaniFreedoo/sale-workflow,
LevelPrime/sale-workflow,
MindAndGo/sale-workflow,
OCA/sale-workflow,
SeuMarco/sale-workflow,
SodexisTeam/sale-workflow,
Studio73/sale-workflow,
Tecnativa/sale-workflow,
akretion/sale-workflow,
aurestic/sale-workflow,
brain-tec/sale-workflow,
camptocamp/sale-workflow,
coopiteasy/sale-workflow,
damdam-s/sale-workflow,
daramousk/sale-workflow,
ecosoft-odoo/sale-workflow,
elego/sale-workflow,
florian-dacosta/sale-workflow,
grindtildeath/sale-workflow,
hurrinico/sale-workflow,
igallart/sale-workflow,
initOS/sale-workflow,
jado95/sale-workflow,
kmee/sale-workflow,
sodexis/sale-workflow,
sygel-technology/sale-workflow,
ursais/sale-workflow,
versada/sale-workflow,
and
vialaurea/OCA-sale-workflow |
<h1 class="title">Sale Partner Approval</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/sale-workflow/tree/14.0/sale_partner_approval"><img alt="OCA/sale-workflow" src="https://img.shields.io/badge/github-OCA%2Fsale--workflow-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/sale-workflow-14-0/sale-workflow-14-0-sale_partner_approval"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/167/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>Require partners to be approved before thay can be used on Sales Orders.</p>
<p>This does not require, but was designed to be used with
Partner Tier Validation (partner_tier_validation module).</p>
<p>Using that module, rules can be configured on who must approve,
before the Partner Stage can be changed to an apptoved one.</p>
<div class="admonition important">
<p class="first admonition-title">Important</p>
<p class="last">This is an alpha version, the data model and design can change at any time without warning.
Only for development or testing purpose, do not use in production.
<a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p>
</div>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li>
<li><a class="reference internal" href="#usage" id="id2">Usage</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id4">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id5">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id6">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>The Sales Order validation rules are configurable.
By default Sale Order confirmation is prevented is the Customer or Invoice Address
is not approvaed to be used in sales.</p>
<p>To configure Sales Order validations navigate to
Sales / Configuration / Sales Orders / Sale Exception Rules.
You need to belong to the Exception Manager security group to see this menu option.</p>
<p>For new customer to require approval before being sold to, configure the Contact Stages
appropriately. For example:</p>
<ul class="simple">
<li>Navigate to Contacts / Configuration / Contact Stages</li>
<li>Edit the "Active" stage: uncheck "Default Stage" and check "Approved for Sales"</li>
<li>Edit the "Draft" stage: check "Default Stage" and uncheck "Approved for Sales"</li>
</ul>
<a name="usage"></a>
<h2><a class="toc-backref" href="#id2">Usage</a></h2>
<p>To approve a Partner to be used in sales:</p>
<ul class="simple">
<li>Edit the Partner form, and in the "Sales & Purchase" tab check the "Candidate to Sell" box.</li>
<li>Make sure the Parter is in a Stage that has the "Approved for Sales" checkbox enabled.
If this is the case, the Partner will automatically have enabled the "Can Sell To" checkbox.
found next to the "Candidate to Sell" checkbox.</li>
</ul>
<p>The "Candidate to Sell" checkbox is only available in a draft/to approve Stage.
The "Can Sell To" will only be set when moving to a Stage that is not draft/to approve.
Moving from an approved Stage to a draft one will not automatically reset the "Can Sell To".
This means that removing from Can Sale state also needs to go through an approval.</p>
<p>On a Sales Order:</p>
<ul class="simple">
<li>The "Customer" and "Invoice Address" selection lists
only propose partners you "Can Sell To".</li>
<li>The CONFIRM button will show a blocking exception message if the selected Customeror
Invoice Address do not have the "Can Sell To" flag checked (this may vary depending
how the exception rules are configured).</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id3">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/sale-workflow/issues">GitHub Issues</a>.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us smashing it by providing a detailed and welcomed
<a class="reference external" href="https://github.com/OCA/sale-workflow/issues/new?body=module:%20sale_partner_approval%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p>
<p>Do not contact contributors directly about support or help with technical issues.</p>
<a name="credits"></a>
<h2><a class="toc-backref" href="#id4">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id5">Authors</a></h3>
<ul class="simple">
<li>Open Source Integrators</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id6">Contributors</a></h3>
<ul class="simple">
<li><a class="reference external" href="https://opensourceintegrators.com">Open Source Integrators</a>.<ul>
<li>Daniel Reis <<a class="reference external" href="mailto:dreis@opensourceintegrators.com">dreis@opensourceintegrators.com</a>></li>
</ul>
</li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id7">Maintainers</a></h3>
<p>This module is maintained by the OCA.</p>
<a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a>
<p>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.</p>
<p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p>
<p><a class="reference external" href="https://github.com/dreispt"><img alt="dreispt" src="https://github.com/dreispt.png?size=40px" /></a></p>
<p>This module is part of the <a class="reference external" href="https://github.com/OCA/sale-workflow/tree/14.0/sale_partner_approval">OCA/sale-workflow</a> project on GitHub.</p>
<p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>