From 2ba8006c3507da0cfa7b9337ce1038311f41ac27 Mon Sep 17 00:00:00 2001 From: Aungkokolin1997 Date: Tue, 27 Jan 2026 11:28:36 +0000 Subject: [PATCH] [ADD] purchase_order_etd_eta --- purchase_order_etd_eta/README.rst | 109 +++++ purchase_order_etd_eta/__init__.py | 1 + purchase_order_etd_eta/__manifest__.py | 20 + purchase_order_etd_eta/models/__init__.py | 3 + .../models/purchase_order.py | 24 + purchase_order_etd_eta/models/res_company.py | 10 + .../models/res_config_settings.py | 13 + purchase_order_etd_eta/pyproject.toml | 3 + purchase_order_etd_eta/readme/CONFIGURE.md | 6 + purchase_order_etd_eta/readme/CONTEXT.md | 5 + purchase_order_etd_eta/readme/CONTRIBUTORS.md | 2 + purchase_order_etd_eta/readme/DESCRIPTION.md | 2 + .../report/purchase_order_templates.xml | 34 ++ .../report/purchase_quotation_templates.xml | 11 + .../static/description/index.html | 448 ++++++++++++++++++ purchase_order_etd_eta/tests/__init__.py | 1 + .../tests/test_purchase_order_etd_eta.py | 44 ++ .../views/purchase_order_views.xml | 100 ++++ .../views/res_config_settings_views.xml | 23 + 19 files changed, 859 insertions(+) create mode 100644 purchase_order_etd_eta/README.rst create mode 100644 purchase_order_etd_eta/__init__.py create mode 100644 purchase_order_etd_eta/__manifest__.py create mode 100644 purchase_order_etd_eta/models/__init__.py create mode 100644 purchase_order_etd_eta/models/purchase_order.py create mode 100644 purchase_order_etd_eta/models/res_company.py create mode 100644 purchase_order_etd_eta/models/res_config_settings.py create mode 100644 purchase_order_etd_eta/pyproject.toml create mode 100644 purchase_order_etd_eta/readme/CONFIGURE.md create mode 100644 purchase_order_etd_eta/readme/CONTEXT.md create mode 100644 purchase_order_etd_eta/readme/CONTRIBUTORS.md create mode 100644 purchase_order_etd_eta/readme/DESCRIPTION.md create mode 100644 purchase_order_etd_eta/report/purchase_order_templates.xml create mode 100644 purchase_order_etd_eta/report/purchase_quotation_templates.xml create mode 100644 purchase_order_etd_eta/static/description/index.html create mode 100644 purchase_order_etd_eta/tests/__init__.py create mode 100644 purchase_order_etd_eta/tests/test_purchase_order_etd_eta.py create mode 100644 purchase_order_etd_eta/views/purchase_order_views.xml create mode 100644 purchase_order_etd_eta/views/res_config_settings_views.xml diff --git a/purchase_order_etd_eta/README.rst b/purchase_order_etd_eta/README.rst new file mode 100644 index 00000000000..bd95c9f4903 --- /dev/null +++ b/purchase_order_etd_eta/README.rst @@ -0,0 +1,109 @@ +====================== +Purchase Order ETD/ETA +====================== + +.. + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! This file is generated by oca-gen-addon-readme !! + !! changes will be overwritten. !! + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + !! source digest: sha256:38890cab558012aca5ba0396b59d0116ea743611b7c0bcb74fdda76da3465194 + !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +.. |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/18.0/purchase_order_etd_eta + :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-18-0/purchase-workflow-18-0-purchase_order_etd_eta + :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=18.0 + :alt: Try me on Runboat + +|badge1| |badge2| |badge3| |badge4| |badge5| + +The module adds ETD, ETA, and Shipping Schedule Note fields to purchase +orders and displays them in the purchase order and RFQ reports. + +**Table of contents** + +.. contents:: + :local: + +Use Cases / Context +=================== + +Some companies need to store ETD and ETA information on Purchase Orders +for communication with suppliers and for printing on reports. + +These values are informational and may include simple instructions such +as "ASAP" or "TBD". + +Configuration +============= + +To hide the Expected Arrival in purchase reports when ETA is set: + +1. Go to Purchase ‣ Configuration ‣ Settings. +2. Enable *Hide Expected Arrival in Purchase Order Reports*. When + enabled, the Expected Arrival date will not be displayed in purchase + order reports if ETA is set. + +Bug Tracker +=========== + +Bugs are tracked on `GitHub 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 `_. + +Do not contact contributors directly about support or help with technical issues. + +Credits +======= + +Authors +------- + +* Quartile + +Contributors +------------ + +- `Quartile `__: + + - Aung Ko Ko Lin + +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-yostashiro| image:: https://github.com/yostashiro.png?size=40px + :target: https://github.com/yostashiro + :alt: yostashiro +.. |maintainer-aungkokolin1997| image:: https://github.com/aungkokolin1997.png?size=40px + :target: https://github.com/aungkokolin1997 + :alt: aungkokolin1997 + +Current `maintainers `__: + +|maintainer-yostashiro| |maintainer-aungkokolin1997| + +This module is part of the `OCA/purchase-workflow `_ project on GitHub. + +You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. diff --git a/purchase_order_etd_eta/__init__.py b/purchase_order_etd_eta/__init__.py new file mode 100644 index 00000000000..0650744f6bc --- /dev/null +++ b/purchase_order_etd_eta/__init__.py @@ -0,0 +1 @@ +from . import models diff --git a/purchase_order_etd_eta/__manifest__.py b/purchase_order_etd_eta/__manifest__.py new file mode 100644 index 00000000000..88374d53e25 --- /dev/null +++ b/purchase_order_etd_eta/__manifest__.py @@ -0,0 +1,20 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). +{ + "name": "Purchase Order ETD/ETA", + "summary": "Add Estimated Time of Departure/Arrival fields to Purchase Orders", + "version": "18.0.1.0.0", + "category": "Purchases", + "website": "https://github.com/OCA/purchase-workflow", + "author": "Quartile, Odoo Community Association (OCA)", + "license": "AGPL-3", + "depends": ["purchase"], + "data": [ + "report/purchase_order_templates.xml", + "report/purchase_quotation_templates.xml", + "views/purchase_order_views.xml", + "views/res_config_settings_views.xml", + ], + "maintainers": ["yostashiro", "aungkokolin1997"], + "installable": True, +} diff --git a/purchase_order_etd_eta/models/__init__.py b/purchase_order_etd_eta/models/__init__.py new file mode 100644 index 00000000000..8b19d0da10e --- /dev/null +++ b/purchase_order_etd_eta/models/__init__.py @@ -0,0 +1,3 @@ +from . import purchase_order +from . import res_company +from . import res_config_settings diff --git a/purchase_order_etd_eta/models/purchase_order.py b/purchase_order_etd_eta/models/purchase_order.py new file mode 100644 index 00000000000..659e1a5cd8e --- /dev/null +++ b/purchase_order_etd_eta/models/purchase_order.py @@ -0,0 +1,24 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class PurchaseOrder(models.Model): + _inherit = "purchase.order" + + date_etd = fields.Date(string="ETD", help="Estimated Time of Departure") + date_eta = fields.Date(string="ETA", help="Estimated Time of Arrival") + shipping_schedule_note = fields.Char( + help="Additional shipping schedule instructions or clarifications. " + "Use this field when ETD or ETA cannot be expressed as a specific date " + "(for example: ASAP, TBD, etc.).", + ) + + def display_expected_arrival(self): + self.ensure_one() + if ( + self.company_id.hide_expected_arrival_when_eta and self.date_eta + ) or not self.date_planned: + return False + return True diff --git a/purchase_order_etd_eta/models/res_company.py b/purchase_order_etd_eta/models/res_company.py new file mode 100644 index 00000000000..60c9dc50422 --- /dev/null +++ b/purchase_order_etd_eta/models/res_company.py @@ -0,0 +1,10 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class ResCompany(models.Model): + _inherit = "res.company" + + hide_expected_arrival_when_eta = fields.Boolean() diff --git a/purchase_order_etd_eta/models/res_config_settings.py b/purchase_order_etd_eta/models/res_config_settings.py new file mode 100644 index 00000000000..c692973446b --- /dev/null +++ b/purchase_order_etd_eta/models/res_config_settings.py @@ -0,0 +1,13 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields, models + + +class ResConfigSettings(models.TransientModel): + _inherit = "res.config.settings" + + hide_expected_arrival_when_eta = fields.Boolean( + related="company_id.hide_expected_arrival_when_eta", + readonly=False, + ) diff --git a/purchase_order_etd_eta/pyproject.toml b/purchase_order_etd_eta/pyproject.toml new file mode 100644 index 00000000000..4231d0cccb3 --- /dev/null +++ b/purchase_order_etd_eta/pyproject.toml @@ -0,0 +1,3 @@ +[build-system] +requires = ["whool"] +build-backend = "whool.buildapi" diff --git a/purchase_order_etd_eta/readme/CONFIGURE.md b/purchase_order_etd_eta/readme/CONFIGURE.md new file mode 100644 index 00000000000..a8f6a388a64 --- /dev/null +++ b/purchase_order_etd_eta/readme/CONFIGURE.md @@ -0,0 +1,6 @@ +To hide the Expected Arrival in purchase reports when ETA is set: + +1. Go to Purchase ‣ Configuration ‣ Settings. +2. Enable *Hide Expected Arrival in Purchase Order Reports*. + When enabled, the Expected Arrival date will not be displayed in purchase + order reports if ETA is set. diff --git a/purchase_order_etd_eta/readme/CONTEXT.md b/purchase_order_etd_eta/readme/CONTEXT.md new file mode 100644 index 00000000000..4830d98a7f9 --- /dev/null +++ b/purchase_order_etd_eta/readme/CONTEXT.md @@ -0,0 +1,5 @@ +Some companies need to store ETD and ETA information on Purchase Orders for +communication with suppliers and for printing on reports. + +These values are informational and may include simple instructions such as +"ASAP" or "TBD". diff --git a/purchase_order_etd_eta/readme/CONTRIBUTORS.md b/purchase_order_etd_eta/readme/CONTRIBUTORS.md new file mode 100644 index 00000000000..faae3280c40 --- /dev/null +++ b/purchase_order_etd_eta/readme/CONTRIBUTORS.md @@ -0,0 +1,2 @@ +- [Quartile](https://www.quartile.co): + - Aung Ko Ko Lin diff --git a/purchase_order_etd_eta/readme/DESCRIPTION.md b/purchase_order_etd_eta/readme/DESCRIPTION.md new file mode 100644 index 00000000000..2af569d7a7a --- /dev/null +++ b/purchase_order_etd_eta/readme/DESCRIPTION.md @@ -0,0 +1,2 @@ +The module adds ETD, ETA, and Shipping Schedule Note fields to purchase orders +and displays them in the purchase order and RFQ reports. diff --git a/purchase_order_etd_eta/report/purchase_order_templates.xml b/purchase_order_etd_eta/report/purchase_order_templates.xml new file mode 100644 index 00000000000..0a398932b10 --- /dev/null +++ b/purchase_order_etd_eta/report/purchase_order_templates.xml @@ -0,0 +1,34 @@ + + + + + diff --git a/purchase_order_etd_eta/report/purchase_quotation_templates.xml b/purchase_order_etd_eta/report/purchase_quotation_templates.xml new file mode 100644 index 00000000000..cd88ab78952 --- /dev/null +++ b/purchase_order_etd_eta/report/purchase_quotation_templates.xml @@ -0,0 +1,11 @@ + + + + diff --git a/purchase_order_etd_eta/static/description/index.html b/purchase_order_etd_eta/static/description/index.html new file mode 100644 index 00000000000..86109ef4b56 --- /dev/null +++ b/purchase_order_etd_eta/static/description/index.html @@ -0,0 +1,448 @@ + + + + + +Purchase Order ETD/ETA + + + +
+

Purchase Order ETD/ETA

+ + +

Beta License: AGPL-3 OCA/purchase-workflow Translate me on Weblate Try me on Runboat

+

The module adds ETD, ETA, and Shipping Schedule Note fields to purchase +orders and displays them in the purchase order and RFQ reports.

+

Table of contents

+ +
+

Use Cases / Context

+

Some companies need to store ETD and ETA information on Purchase Orders +for communication with suppliers and for printing on reports.

+

These values are informational and may include simple instructions such +as “ASAP” or “TBD”.

+
+
+

Configuration

+

To hide the Expected Arrival in purchase reports when ETA is set:

+
    +
  1. Go to Purchase ‣ Configuration ‣ Settings.
    2. +
  2. Enable Hide Expected Arrival in Purchase Order Reports. When +enabled, the Expected Arrival date will not be displayed in purchase +order reports if ETA is set.
    3. +
+
+
+

Bug Tracker

+

Bugs are tracked on GitHub 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.

+

Do not contact contributors directly about support or help with technical issues.

+
+
+

Credits

+
+

Authors

+
    +
  • Quartile
    • +
+
+
+

Contributors

+ +
+
+

Maintainers

+

This module is maintained by the OCA.

+ +Odoo Community Association + +

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.

+

Current maintainers:

+

yostashiro aungkokolin1997

+

This module is part of the OCA/purchase-workflow project on GitHub.

+

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

+
+
+
+ + diff --git a/purchase_order_etd_eta/tests/__init__.py b/purchase_order_etd_eta/tests/__init__.py new file mode 100644 index 00000000000..eda559e6129 --- /dev/null +++ b/purchase_order_etd_eta/tests/__init__.py @@ -0,0 +1 @@ +from . import test_purchase_order_etd_eta diff --git a/purchase_order_etd_eta/tests/test_purchase_order_etd_eta.py b/purchase_order_etd_eta/tests/test_purchase_order_etd_eta.py new file mode 100644 index 00000000000..d75041cf70c --- /dev/null +++ b/purchase_order_etd_eta/tests/test_purchase_order_etd_eta.py @@ -0,0 +1,44 @@ +# Copyright 2026 Quartile (https://www.quartile.co) +# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl). + +from odoo import fields +from odoo.fields import Command + +from odoo.addons.base.tests.common import BaseCommon + + +class TestPurchaseOrderEtdEta(BaseCommon): + @classmethod + def setUpClass(cls): + super().setUpClass() + cls.vendor = cls.env["res.partner"].create({"name": "Test Vendor"}) + cls.product = cls.env["product.product"].create({"name": "Test Product"}) + + def _create_po(self): + return self.env["purchase.order"].create( + { + "partner_id": self.vendor.id, + "date_planned": fields.Datetime.now(), + "order_line": [ + Command.create( + { + "name": self.product.name, + "product_id": self.product.id, + "product_qty": 1.0, + "price_unit": 100.0, + } + ) + ], + } + ) + + def test_display_expected_arrival(self): + po = self._create_po() + self.assertTrue(po.display_expected_arrival()) + po.company_id.hide_expected_arrival_when_eta = True + self.assertTrue(po.display_expected_arrival()) + po.date_eta = fields.Date.today() + self.assertFalse(po.display_expected_arrival()) + po.date_planned = False + po.company_id.hide_expected_arrival_when_eta = False + self.assertFalse(po.display_expected_arrival()) diff --git a/purchase_order_etd_eta/views/purchase_order_views.xml b/purchase_order_etd_eta/views/purchase_order_views.xml new file mode 100644 index 00000000000..6f499f9970f --- /dev/null +++ b/purchase_order_etd_eta/views/purchase_order_views.xml @@ -0,0 +1,100 @@ + + + + request.quotation.select + purchase.order + + + + + + + + + + + + + + + + + + purchase.order.select + purchase.order + + + + + + + + + + + + + + + + + + purchase.order.kpis.tree + purchase.order + + + + + + + + + + + purchase.order.list + purchase.order + + + + + + + + + + + purchase.order.form + purchase.order + + + + + + + + + + diff --git a/purchase_order_etd_eta/views/res_config_settings_views.xml b/purchase_order_etd_eta/views/res_config_settings_views.xml new file mode 100644 index 00000000000..1d762c63501 --- /dev/null +++ b/purchase_order_etd_eta/views/res_config_settings_views.xml @@ -0,0 +1,23 @@ + + + + res.config.settings.view.form.inherit + res.config.settings + + + + + + + + + +