[ADD] purchase_product_packaging_container_deposit

purchase_product_packaging_container_deposit/README.rst

@@ -0,0 +1,117 @@
+============================================
+Purchase Product Packaging Container Deposit
+============================================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:93d24ccd70dee39ba12ac22b7220d5aee3233d419cb9c6bc45874a4aaf42efed
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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/licence-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%2Fpurchase--workflow-lightgray.png?logo=github
+    :target: https://github.com/OCA/purchase-workflow/tree/16.0/purchase_product_packaging_container_deposit
+    :alt: OCA/purchase-workflow
+.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
+    :target: https://translation.odoo-community.org/projects/purchase-workflow-16-0/purchase-workflow-16-0-purchase_product_packaging_container_deposit
+    :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/purchase-workflow&target_branch=16.0
+    :alt: Try me on Runboat
+
+|badge1| |badge2| |badge3| |badge4| |badge5|
+
+This module allows you to add product packaging to an order automatically.
+Based on the order line quantity with associated packaging, the quantity of product packaging is calculated and added to the order. 
+
+Hypothesis:
+
+* package type "Pack of 12" has the container deposit "pack of 12"
+* package type "Pack of 24" has the container deposit "pack of 24"
+* package type "EUROPAL" has the container deposit "EU pallet"
+
+
+.. list-table:: Product A has those packaging:
+    :widths: 50 50 25
+    :header-rows: 1
+
+    * - package type
+      - package level
+      - qty
+    * - Pack of 12
+      - PACK
+      - 12
+    * - Pack of 24
+      - Pack
+      - 24
+    * - EUROPAL
+      - PALLET
+      - 240
+
+Order Line:
+
+* Case 1: Product A | qty = 280. Result:
+
+  * 280 // 240 = 1 => add order line for 1 EU pallet
+  * 280 // 24 (biggest PACK) => add SO line for 11 pack of 24
+* Case 2: Product A | qty = 280 and packaging=Pack of 12. Result:
+
+  * 280 // 240 =1 => add order line for 1 EU pallet
+  * 280 // 12 (forced packaging for PACK) => add order line for 23 pack of 12
+* Case 3: Product A &  Product B. Both have a deposit of 1 pack of 24 
+
+  * only one line for 2 pack of 24
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/purchase-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/purchase-workflow/issues/new?body=module:%20purchase_product_packaging_container_deposit%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
+~~~~~~~
+
+* Camptocamp
+* BCIM
+
+Contributors
+~~~~~~~~~~~~
+
+* Telmo Santos <[email protected]>
+* Jacques-Etienne Baudoux <[email protected]>
+
+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/purchase-workflow <https://github.com/OCA/purchase-workflow/tree/16.0/purchase_product_packaging_container_deposit>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

purchase_product_packaging_container_deposit/__init__.py

@@ -0,0 +1 @@
+from . import models

purchase_product_packaging_container_deposit/__manifest__.py

@@ -0,0 +1,17 @@
+# Copyright 2023 Camptocamp (<https://www.camptocamp.com>).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+{
+    "name": "Purchase Product Packaging Container Deposit",
+    "version": "16.0.1.0.0",
+    "development_status": "Beta",
+    "category": "Product",
+    "summary": "Purchase Product Packaging Container Deposit",
+    "author": "Camptocamp, BCIM, Odoo Community Association (OCA)",
+    "website": "https://github.com/OCA/purchase-workflow",
+    "license": "AGPL-3",
+    "depends": ["purchase", "product_packaging_container_deposit"],
+    "data": [],
+    "installable": True,
+    "auto_install": False,
+}

purchase_product_packaging_container_deposit/models/__init__.py

@@ -0,0 +1,2 @@
+from . import purchase_order
+from . import purchase_order_line

purchase_product_packaging_container_deposit/models/purchase_order.py

@@ -0,0 +1,12 @@
+# Copyright 2023 Camptocamp (<https://www.camptocamp.com>).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+from odoo import models
+
+
+class PurchaseOrder(models.Model):
+    _name = "purchase.order"
+    _inherit = ["purchase.order", "container.deposit.order.mixin"]
+
+    def _get_order_line_field(self):
+        return "order_line"

purchase_product_packaging_container_deposit/models/purchase_order_line.py

@@ -0,0 +1,20 @@
+# Copyright 2023 Camptocamp (<https://www.camptocamp.com>).
+# License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
+
+from odoo import models
+
+
+class PurchaseOrderLine(models.Model):
+    _name = "purchase.order.line"
+    _inherit = ["purchase.order.line", "container.deposit.order.line.mixin"]
+
+    def _get_product_qty_field(self):
+        return "product_qty"
+
+    def _get_product_qty_delivered_received_field(self):
+        return "qty_received"
+
+    def _compute_qty_received(self):
+        res = super()._compute_qty_received()
+        self.mapped("order_id").update_order_container_deposit_quantity()
+        return res

purchase_product_packaging_container_deposit/readme/CONTRIBUTORS.rst

@@ -0,0 +1,2 @@
+* Telmo Santos <[email protected]>
+* Jacques-Etienne Baudoux <[email protected]>

purchase_product_packaging_container_deposit/readme/DESCRIPTION.rst

@@ -0,0 +1,40 @@
+This module allows you to add product packaging to an order automatically.
+Based on the order line quantity with associated packaging, the quantity of product packaging is calculated and added to the order. 
+
+Hypothesis:
+
+* package type "Pack of 12" has the container deposit "pack of 12"
+* package type "Pack of 24" has the container deposit "pack of 24"
+* package type "EUROPAL" has the container deposit "EU pallet"
+
+
+.. list-table:: Product A has those packaging:
+    :widths: 50 50 25
+    :header-rows: 1
+
+    * - package type
+      - package level
+      - qty
+    * - Pack of 12
+      - PACK
+      - 12
+    * - Pack of 24
+      - Pack
+      - 24
+    * - EUROPAL
+      - PALLET
+      - 240
+
+Order Line:
+
+* Case 1: Product A | qty = 280. Result:
+
+  * 280 // 240 = 1 => add order line for 1 EU pallet
+  * 280 // 24 (biggest PACK) => add SO line for 11 pack of 24
+* Case 2: Product A | qty = 280 and packaging=Pack of 12. Result:
+
+  * 280 // 240 =1 => add order line for 1 EU pallet
+  * 280 // 12 (forced packaging for PACK) => add order line for 23 pack of 12
+* Case 3: Product A &  Product B. Both have a deposit of 1 pack of 24 
+
+  * only one line for 2 pack of 24