.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

==============
Sale Exception
==============

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

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

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

This module allows you attach several customizable exceptions to your
sale order in a way that you can filter orders by exceptions type and
fix them.

This is especially useful in an scenario for mass sales order import
because it's likely some orders have errors when you import them (like
product not found in Odoo, wrong line format etc.)

**Table of contents**

.. contents::
   :local:

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

If you are going to use Customer sale warning and Product warning, for
setting corresponding information, you need to:

1. Go to *Settings > User & Companies > Users*.
2. Edit your user.
3. Check "A warning can be set on a product or a customer (Sale)" group.
4. Install sale_management addon.

Usage
=====

Not Enough Virtual Stock: #. Go to *Sales > Products > Products*. #.
Create new storable product without stock available. #. Go to *Sales >
Orders > Quotations* #. Create new quotation. #. Add product without
stock available. #. An exception will be displayed.

No ZIP code on destination: #. Go to *Contacts*. #. Edit or create new
contact. #. Set empty zip code. #. Go to *Sales > Orders > Quotations*
#. Create new quotation. #. Set delivery address with no zip code. #. An
exception will be displayed.

Product warning: #. Go to *Sales > Products > Products*. #. Edit or
create new product. #. Go to *Sales* tab. #. Set your desired warning
option under the *Warning when Selling this Product* group. #. Set some
warning message. #. Go to *Sales > Orders > Quotations* #. Create new
quotation. #. Add product with warning message. #. An exception will be
displayed.

Partner warning: #. Go to *Contacts*. #. Edit or create new contact. #.
Go to *Internal notes* tab. #. Set warning option according to *Warning
on the Sales Order* group. #. Set some warning message. #. Go to *Sales
> Orders > Quotations* #. Create new quotation. #. Set partner with
warning message. #. An exception will be displayed.

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

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

* Akretion
* Sodexis
* Camptocamp

Contributors
------------

- Raphaël Valyi <raphael.valyi@akretion.com>
- Renato Lima <renato.lima@akretion.com>
- Sébastien BEAU <sebastien.beau@akretion.com>
- Guewen Baconnier <guewen.baconnier@camptocamp.com>
- Yannick Vaucher <yannick.vaucher@camptocamp.com>
- Simone Orsi <simahawk@gmail.com>
- SodexisTeam <dev@sodexis.com>
- Mourad EL HADJ MIMOUNE <mourad.elhadj.mimoune@akretion.com>
- Raphaël Reverdy <raphael.reverdy@akretion.com>
- Florian da Costa <florian.dacosta@akretion.com>
- Iván Todorovich <ivan.todorovich@druidoo.io>
- Nguyen Minh Chien <chien@trobz.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/sale-workflow <https://github.com/OCA/sale-workflow/tree/18.0/sale_exception>`_ project on GitHub.

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