[6456][ADD] account_billing_target_month

account_billing_target_month/README.rst

@@ -0,0 +1,62 @@
+============================
+Account Billing Target Month
+============================
+
+.. 
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! source digest: sha256:4727c2352f1c1afcefee757106fa4dbd50bec366643c764c8dd6ed5ec3172e99
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |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-qrtl%2Fhls--custom-lightgray.png?logo=github
+    :target: https://github.com/qrtl/hls-custom/tree/18.0/account_billing_target_month
+    :alt: qrtl/hls-custom
+
+|badge1| |badge2| |badge3|
+
+This module extends ``l10n_jp_summary_invoice`` to add a **Target
+Month** field to the billing document, computed automatically from the
+threshold date. If the threshold date falls on the last day of the
+month, the target month is set to the following month; otherwise it is
+set to the same month as the threshold date.
+
+The target month is also displayed as a prefix in the summary invoice
+PDF title (e.g. "3 Summary Invoice").
+
+**Table of contents**
+
+.. contents::
+   :local:
+
+Bug Tracker
+===========
+
+Bugs are tracked on `GitHub Issues <https://github.com/qrtl/hls-custom/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/qrtl/hls-custom/issues/new?body=module:%20account_billing_target_month%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
+-------
+
+* Quartile
+
+Maintainers
+-----------
+
+This module is part of the `qrtl/hls-custom <https://github.com/qrtl/hls-custom/tree/18.0/account_billing_target_month>`_ project on GitHub.
+
+You are welcome to contribute.

account_billing_target_month/__init__.py

@@ -0,0 +1,4 @@
+# Copyright 2026 Quartile
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from . import models

account_billing_target_month/__manifest__.py

@@ -0,0 +1,17 @@
+# Copyright 2026 Quartile
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+{
+    "name": "Account Billing Target Month",
+    "version": "18.0.1.0.0",
+    "author": "Quartile",
+    "website": "https://www.quartile.co",
+    "category": "Invoice",
+    "license": "AGPL-3",
+    "depends": ["l10n_jp_summary_invoice"],
+    "data": [
+        "views/account_billing_views.xml",
+        "reports/report_summary_invoice_templates.xml",
+    ],
+    "installable": True,
+}

account_billing_target_month/models/__init__.py

@@ -0,0 +1,4 @@
+# Copyright 2026 Quartile
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from . import account_billing

account_billing_target_month/models/account_billing.py

@@ -0,0 +1,44 @@
+# Copyright 2026 Quartile
+# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).
+
+from odoo import api, fields, models
+
+
+class AccountBilling(models.Model):
+    _inherit = "account.billing"
+
+    target_month = fields.Selection(
+        selection=[
+            ("1", "January"),
+            ("2", "February"),
+            ("3", "March"),
+            ("4", "April"),
+            ("5", "May"),
+            ("6", "June"),
+            ("7", "July"),
+            ("8", "August"),
+            ("9", "September"),
+            ("10", "October"),
+            ("11", "November"),
+            ("12", "December"),
+        ],
+        compute="_compute_target_month",
+        store=True,
+    )
+
+    @api.depends("threshold_date")
+    def _compute_target_month(self):
+        # Standard days per month (non-leap year). Index 0 is a placeholder so the
+        # list is 1-indexed. When threshold_date.day >= this value, the billing month
+        # advances to the next month (e.g. Jan>=31 -> Feb billing, Dec>=31 -> Jan).
+        month_days = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
+        for rec in self:
+            if not rec.threshold_date:
+                rec.target_month = False
+                continue
+            d = rec.threshold_date
+            if d.day >= month_days[d.month]:
+                # % 12 wraps December (12 % 12 = 0) back to January (0 + 1 = 1).
+                rec.target_month = str(d.month % 12 + 1)
+            else:
+                rec.target_month = str(d.month)

account_billing_target_month/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["whool"]
+build-backend = "whool.buildapi"

account_billing_target_month/readme/DESCRIPTION.md

@@ -0,0 +1,8 @@
+This module extends `l10n_jp_summary_invoice` to add a **Target Month**
+field to the billing document, computed automatically from the threshold
+date. If the threshold date falls on the last day of the month, the target
+month is set to the following month; otherwise it is set to the same month
+as the threshold date.
+
+The target month is also displayed as a prefix in the summary invoice PDF
+title (e.g. "3 Summary Invoice").

account_billing_target_month/reports/report_summary_invoice_templates.xml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8" ?>
+<odoo>
+    <template
+        id="report_summary_invoice_document"
+        inherit_id="l10n_jp_summary_invoice.report_summary_invoice_document"
+    >
+        <xpath expr="//h2/span[1]" position="before">
+            <t t-if="o.target_month"><t t-esc="o.target_month" />Target Month </t>
+        </xpath>
+    </template>
+</odoo>