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

================
Sale Elaboration
================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
    :target: https://odoo-community.org/page/development-status
    :alt: Production/Stable
.. |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/16.0/sale_elaboration
    :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-16-0/sale-workflow-16-0-sale_elaboration
    :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=16.0
    :alt: Try me on Runboat

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

This module extends the functionality of sales orders to allow to set an
elaboration on lines that will add an extra order line with an elaboration
product linked to it when the delivery order is validated.

An **elaboration** is a process that needs to be done over the product, usually
on picking/handling phase. It doesn't modify too much the product for needing
an specific product, but it adds a surcharge on the final price.

**Table of contents**

.. contents::
   :local:

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

To configure this module you need to:

#. Go to *Sale > Configuration > Products > Sale Elaboration*.
#. Create a new record.
#. Set a product linked to the elaboration.
#. Also you can select a route to procure this elaboration.
#. Go to *Settings > Inventory > Traceability* and select *Display Elaboration
   notes on Delivery Slips* if you want to show elaborations on Delivery Slips
   or *Display Elaboration notes on Picking Operations* if you want to show
   elaborations on Picking Operations.

You can configure elaboration profiles as well. These profiles are a set of elaborations
that are available for chosen products or categories. When the salesman chooses the
elaboration in sales line, only those from the set for that product will be available.

To set the profile globally for a product category:

#. Go to *Inventory > Configuration > Product Categories* and choose one.
#. In the **Logistics** sections, you can set the desired **Elaboration profile**.

If you want to set an specific elaboration profile for a product:

#. Go to *Inventory > Products > Products* and choose one.
#. In the **Sales** tab, you'll find an **Elaboration** section where you can set the
   **Elaboration profile** for that specific product.

Usage
=====

#. Go to *Sale > Quotations*.
#. Create a sales order.
#. Add a new line.
#. Select an elaboration in the line.
#. Confirm the sales order.
#. Go to the picking created by this sales order and validate it.
#. Print Delivery Slip and Picking Operations.
#. Go back to the sales order. A new line is created with the product linked to
   the elaboration.

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

* Tecnativa

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

* `Tecnativa <https://www.tecnativa.com>`_:

  * Sergio Teruel
  * Pedro M. Baeza
  * Carlos Roca
  * Ernesto Tejeda

* Eduardo de Miguel (`Moduon <https://www.moduon.team/>`__)
* Jairo Llopis (`Moduon <https://www.moduon.team/>`__)

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-CarlosRoca13| image:: https://github.com/CarlosRoca13.png?size=40px
    :target: https://github.com/CarlosRoca13
    :alt: CarlosRoca13
.. |maintainer-rafaelbn| image:: https://github.com/rafaelbn.png?size=40px
    :target: https://github.com/rafaelbn
    :alt: rafaelbn
.. |maintainer-sergio-teruel| image:: https://github.com/sergio-teruel.png?size=40px
    :target: https://github.com/sergio-teruel
    :alt: sergio-teruel
.. |maintainer-yajo| image:: https://github.com/yajo.png?size=40px
    :target: https://github.com/yajo
    :alt: yajo

Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-CarlosRoca13| |maintainer-rafaelbn| |maintainer-sergio-teruel| |maintainer-yajo| 

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

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