Skip to main content
Odoo Community Association

Account Invoice Advance Compensation

Beta License: AGPL-3 OCA/account-invoicing Translate me on Weblate Try me on Runboat

This module provides a comprehensive solution for managing advance payments and their compensation in Odoo. It enables businesses to efficiently handle prepayments and their application against regular invoices through a user-friendly interface.

Key Features:

  • Dedicated advance payment tracking for both customers and suppliers

  • Flexible compensation wizard for applying advances against invoices

  • Automatic reconciliation of advance payments with regular invoices

  • Configurable advance payment journals

  • Multi-currency support for advance payments

The module streamlines the advance payment process by providing a structured workflow for recording, tracking, and compensating advance payments, ensuring accurate financial records and improved cash flow management.

Table of contents

Use Cases / Context

Module Context and Implementation Guide

When to Use This Module

This module is particularly valuable for businesses that:

  • Regularly process advance payments from customers or to suppliers

  • Need to track prepayments separately from regular invoices

  • Require precise reconciliation of advances against final invoices

  • Operate in project-based or milestone-payment environments

Key Implementation Scenarios

Customer Advances

  1. Service Retainers

    • Track client deposits against monthly service invoices

    • Example: Law firm applying retainer payments to monthly bills

  2. Product Deposits

    • Manage customer down payments for goods

    • Example: Manufacturer applying 30% deposit against production order

Supplier Prepayments

  1. Material Purchases

    • Track and apply prepayments to supplier invoices

    • Example: Construction company managing material prepayments

  2. Service Contracts

    • Reconcile advance payments to contractors

    • Example: IT firm managing vendor retainers

Technical Context

Prerequisites

  • Odoo Accounting module installed

  • Properly configured Chart of Accounts

  • At least one journal marked as “Advance Journal”

Integration Points

  • Works with standard Odoo invoicing workflow

  • Extends the account.move model

  • Compatible with:

    • Odoo’s native multi-currency

    • Multi-company setups

    • Standard reporting features

Configuration

Configuration Guide

Core Setup

1. Journal Configuration

Path: Accounting → Configuration → Journals
For new journal:
  1. Create → Type: Miscellaneous

  2. Name: “Advance Compensation”

  3. Code: ADV

  4. Default Account: [Select prepayment account]

  5. Advanced Settings → ☑ Is Advance Journal

2. Prepayment Accounts

Path: Accounting → Configuration → Chart of Accounts

  • Customer Advances:

    • Type: Current Assets

    • Name: “Advances Receivable”

    • ☑ Allow Reconciliation

  • Supplier Advances:

    • Type: Current Liabilities

    • Name: “Advances Payable”

    • ☑ Allow Reconciliation

3. Advance Product

Path: Inventory → Products

  • Name: “Advance Payment”

  • Type: Service

  • Accounting:

    • Income/Expense: [Linked to prepayment account]

Usage

This module allows you to manage advance payments and their compensation against regular invoices. It supports both customer and supplier invoices, with multi-currency capabilities.

Step-by-Step Process

1. Recording an Advance Payment

  1. Create a new invoice with the “Advance” product

  2. Register the complete payment for the advance invoice

  3. The advance will be available for compensation once fully paid

2. Applying Compensation

  1. Open the regular invoice (must be for the same partner)

  2. Click the Compensate Advance button

  3. In the compensation wizard:

    • Select available advance(s) from the left panel

    • Choose invoice lines to compensate on the right

    • Enter the compensation amount

  4. Click Compensate to apply the compensation

Key Features

Supported Scenarios

  • Customer and supplier invoices

  • Partial compensation of advances

  • Multi-currency transactions

  • Multiple advance compensations per invoice

Prerequisites

  • Advance invoice must be fully paid

  • Regular invoice must be for the same partner

  • Accounts must be reconcilable

  • Proper journal configuration

Troubleshooting

Common Issues

  1. Advance not appearing in compensation wizard

    • Verify the advance invoice is fully paid

    • Check if the partner matches

    • Confirm journal settings are correct

  2. Compensation not working

    • Ensure accounts are properly configured

    • Check currency compatibility

    • Verify user has necessary permissions

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

  • Escodoo

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.

This module is part of the OCA/account-invoicing project on GitHub.

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

Release files for odoo-addon-account-invoice-advance-compensation 18.0.1.0.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-account-invoice-advance-compensation 18.0.1.0.0.4
File Interpreter ABI Platform
odoo_addon_account_invoice_advance_compensation-18.0.1.0.0.4-py3-none-any.whl Python 3 none any Details

Release files / odoo_addon_account_invoice_advance_compensation-18.0.1.0.0.4-py3-none-any.whl

Download URL odoo_addon_account_invoice_advance_compensation-18.0.1.0.0.4-py3-none-any.whl
Size 46.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
90a7094c385f99e0df6f84c635a4bad84de4a2f1d1165676666dd29ada3c32df
BLAKE2b-256 checksum
How to use checksums
3a0a72c512e3ddb4fd969e3135ceefaeb3c132e2ccb06c1cbf7c0c9c1832f303
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

18.0.1.0.0.4 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page