.. 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:3869fbd7c7f1ad4b8660b3cf768511622163800c2b4c42e019e7175a4abf1048
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/18.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-18-0/sale-workflow-18-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=18.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.

If the elaboration has a defined route, selecting the elaboration, it is
set on the order line, which will result in the generation of multiple
delivery notes depending on the established route.

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

This module was created to meet the need of providing the customer with
products that are not transformed into something new, but rather require
a simple preparation process. Example: Scaling a fish

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

To configure this module you need to:

1. Go to *Sale > Configuration > Elaborations > Sale Elaboration*.
2. Create a new record.
3. Set a product linked to the elaboration.
4. If you use Multi-Step Routes, you can also select a route to procure
   this elaboration.
5. 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 define elaboration profiles to limit the elaborations that can
be selected for each product.

To set the profile globally for a product category:

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

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

1. Go to *Sale > Configuration > Elaborations > Sale Elaboration
   Profile*.
2. Create a new record.
3. Select the elaborations included to the profile.
4. Set the elaboration to the related products.

Usage
=====

1. Go to *Sale > Quotations*.
2. Create a sales order.
3. Add a new line.
4. Select an elaboration in the line. If the product has an elaboration
   profile selected, you will just be able to select the elaborations
   set on the profile.
5. Confirm the sales order.
6. Go to the picking created by this sales order and validate it.
7. Print Delivery Slip and Picking Operations.
8. 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:%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
-------

* 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/18.0/sale_elaboration>`_ project on GitHub.

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