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

===========================
Default packaging for sales
===========================

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

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-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_packaging_default
    :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_packaging_default
    :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 simplifies and emphasizes the usage of packaging in sales
orders.

- Packaging fields in sale order lines appear before product quantity
  fields.
- When selecting a product to sell, its default packaging is added
  automatically.

.. IMPORTANT::
   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.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

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

Some companies, like food distributors, need to emphasize the usage of
product packaging in the sale process.

Product packaging in Odoo is designed to be computed automatically when
you choose the final amount of products to sell. For example, if you
sell 12 kgs of apples and those can be packaged by bags of 4kg, you'll
get automatically suggested to sell 3 bags.

Although you can still do that, with this module the natural usage is
inverted: it's easier for you to select the packaging and quantity
first, and then the final amount of products is computed automatically.
Following the same example, you'll choose bags, then 3, and then the
12kg will be computed automatically.

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

To configure this module, you need to:

1. Go to *Sales > Configuration > Settings*.
2. Under *Product Catalog*, enable *Product Packagings*.

Usage
=====

To use this module, you need to configure a product with packaging:

1. Go to *Sales > Products > Products* and select or create a product.
2. In the *Inventory* tab, add some packaging(s).
3. Enable *Sales* and in one packaging.
4. Sort the packaging options at will. The first one enabled for *Sales*
   will be considered the default one.

Then you have to sell it:

1. Go to *Sales > Orders > Quotations* and create a new quotation.
2. Select any customer.
3. Select that product.

You will notice that:

- The product is added with the default sale packaging.
- The packaging quantity is set to 1 packaging unit.
- The product UoM quantity is set to the amount of units contained in 1
  packaging.
- When changing to another product, instead of keeping the amount of UoM
  units, we now keep the packaging qty, and the UoM qty is recomputed
  accordingly.

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_packaging_default%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
-------

* Moduon

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

- Jairo Llopis (`Moduon <https://www.moduon.team/>`__)
- Emilio Pascual (`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-yajo| image:: https://github.com/yajo.png?size=40px
    :target: https://github.com/yajo
    :alt: yajo

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

|maintainer-yajo| 

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

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