Odoo Community Association

Japan Summary Invoice - Carryover

Alpha License: AGPL-3 OCA/l10n-japan Translate me on Weblate Try me on Runboat

This module extends Japan Summary Invoice to support carryover amount tracking for recurring billing cycles.

It adds the following fields to billings:

Manual override fields are available to adjust values when needed.

The visibility of carryover amounts in the report can be controlled at company, partner, and billing levels.

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

Table of contents

Configuration

The visibility of carryover amounts in the report can be controlled at three levels:

  1. Company (default for all partners): Go to Settings > Invoicing > Japan Summary Invoice and enable/disable Show Carryover Amounts.
  2. Partner (override for specific customers): Go to the partner form, under Sales & Purchases > Summary Invoice, set Show Carryover Amounts to:
    • Use Company Default: Follow the company setting
    • Yes: Always show carryover amounts
    • No: Never show carryover amounts
  3. Billing (override for a single billing): In the billing form under the Carryover tab, the Show Carryover Amounts checkbox is set from the settings above when the billing is created, and can be adjusted afterwards. Later changes to those settings apply to new billings only, so a per-billing adjustment is never discarded.

Usage

  1. When creating a new billing, the system automatically finds the most recent validated billing for the same partner and calculates:
    • Previous Billed Amount: Total amount from the previous billing.
    • Payment Amount: Payments received on the previous billing invoices.
    • Carryover Amount: Previous billed amount minus payments.
  2. Use the Manual Adj. toggle to manually override the computed values if needed. This is useful when the previous billing was created before this module was installed or when adjustments are required.
  3. When the billing is validated, the current computed values are automatically frozen by enabling the manual override toggles. This ensures that subsequent payments on previous invoices do not affect the validated billing’s carryover amounts.

Known issues / Roadmap

  • Billings sharing customer, date and remit-to bank cannot be chained. Neither is the other’s previous billing, yet both count toward the outstanding balance, so Payment Amount can report a payment that was never received, and can go negative. Reached by one invoice per site or department (rolled up by commercial partner), or a same-day catch-up run. Workaround: set the amounts with the Manual Adj. toggles before validating.
  • Previous Billing is not re-pointed when other billings change. Creating, back-dating or cancelling another billing leaves existing billings on a stale chain, understating their carryover. Validated billings are exempt by design.

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:
    • Yoshi Tashiro
    • Aung Ko Ko Lin

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/l10n-japan project on GitHub.

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