OdooWiki OCA HUB

Donation Base

donation_base folder_open OCA/donation open_in_new
Accounting License: AGPL-3

This is the base module for donations. This module doesn't do anything in itself ; it just adds some properties on products and partners and adds the donation.tax.receipt object.

To get some real features, you should install the donation or the donation_sale module. To understand the difference between these 2 modules, read this post.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

This base module lets you mark products as donations, flag donors, and manage donation tax receipts (one-time or annual) with printing and emailing. It adds no donation workflow by itself; it prepares the data and receipt object used by the donation modules.

This is a foundation module: it does not create donations on its own, but it adds the settings and the tax receipt object that the donation modules use.

On products, you can set a Donation type (Monetary Donation or In-Kind Donation) and tick Is Eligible for a Tax Receipt. When a product is a donation, customer and supplier taxes are cleared and it can no longer be purchased, and Odoo blocks saving a donation product that still has customer taxes.

On contacts, you get a Tax Receipt Option (None, For Each Donation, Annual Tax Receipt), a Tax Receipts counter button, and a Donors filter. Donors are identified by a donor rank, and a Donors menu action lists them.

Tax receipts are stored in Donation Tax Receipts with an automatic receipt number, date, donor, amount, currency, company and type (one-time or annual). From a receipt you can Send by Email (using a prepared email template) or Print it; printing stamps the print date. A wizard creates annual receipts for a chosen period, refusing to create a second annual receipt for the same donor in the same period. Another wizard prints all receipts not yet printed. Receipts are company-specific, and access is limited to accounting and system users.

Depends on

account

Required by other modules

Models and fields (6)
  • res.partner · extends an existing modeldonor_rank, tax_receipt_ids (Tax Receipts), tax_receipt_count (# of Tax Receipts), tax_receipt_option
  • product.product · extends an existing model
  • product.template · extends an existing modeldonation_type (Donation), tax_receipt_ok (Is Eligible for a Tax Receipt)
  • donation.tax.receipt · new modeldate, type, amount, number (Receipt Number), company_id (Company), partner_id (Donor), print_date, currency_id, donation_date
  • tax.receipt.annual.create · new modelend_date, company_id (Company), start_date
  • donation.tax.receipt.print · new modelreceipt_ids (Receipts to Print)

Text generated by AI (DeepSeek) from reading the Odoo 18.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 6 confirmed, 3 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 18.0

To configure this module, you need to:

> - create donation products > - set the Tax Receipt Option on partners

No verified information in OCA: Installation, Usage.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.