Metadata-Version: 2.1
Name: odoo-addon-donation_mass
Version: 18.0.1.0.0.4
Requires-Python: >=3.10
Requires-Dist: odoo-addon-donation==18.0.*
Requires-Dist: odoo==18.0.*
Summary: Manage Mass
Home-page: https://github.com/OCA/vertical-abbey
License: AGPL-3
Author: Barroux Abbey, Akretion, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 18.0
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

=============
Donation Mass
=============

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:9b2f770a0a78d3c926220e7c36d3e5f36fa37bf2ac16e77389e9f7b679392771
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |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/license-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%2Fvertical--abbey-lightgray.png?logo=github
    :target: https://github.com/OCA/vertical-abbey/tree/18.0/donation_mass
    :alt: OCA/vertical-abbey
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/vertical-abbey-18-0/vertical-abbey-18-0-donation_mass
    :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/vertical-abbey&target_branch=18.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module manages mass requests and the planning of masses. Mass
requests can be created manually or from a donation.

This module has an impact on accounting: \* a mass request in waiting or
started state is considered as a stock from an accounting point of view.
\* when a mass is celebrated, i.e. when the mass is validated in Odoo,
an account move is automatically generated to move the amount of the
donation associed to the mass line from the stock account to the revenue
account.

When a donation is validated with a mass in one of the donation lines, a
new mass request is automatically created and the account move
associated to the donation will send the amount of that donation line to
a stock account. When the mass is celebrated, i.e. when the mass is
validated in Odoo, an accounting entry is generated from the stock
account to a revenue account.

This module also allows to transfer masses to an external celebrant.
When validating the mass transfer, a journal entry is created that moves
the corresponding donation amount from the mass stock account to the
payable account of the external celebrant.

This module has been developped by the `Barroux
Abbey <https://www.barroux.org/>`__ which is a French Catholic Abbey. It
is specific to the management of christian masses.

**Table of contents**

.. contents::
   :local:

Configuration
=============

- create a partner for each celebrant with the option *Celebrant* set to
  *Internal*.
- if you transfer masses to an external celebrant, create a
  corresponding partner with *Celebrant* set to *External*.
- check the configuration of the Mass Request Types that have been
  automatically created by the module.
- check the configuration of the Mass Products that have been
  automatically created by the module. The revenue account of the mass
  product is used when the mass journal is validated.
- on the Donation configuration page, configure the stock account for
  the celebrated mass and the account journal that will be used for the
  accounting entries generated when a mass is validated.

Usage
=====

When you create a new donation line, if you select a mass product, you
can specify the mass intention. If the donor wants the mass to be
celebrated by a particular celebrant, you can also specify a celebrant
on the donation line (otherwise, leave empty). If the donor wants the
mass to be celebrated at a particular date, you can also specify a
Celebration Requested Date on the donation line (otherwise, leave
empty).

When the donation is validated, the mass request is automatically
created. You can jump on it via an icon/button at the top right of the
donation form view.

You can also create mass requests manually from the menu *Donation >
Mass > Mass Requests*.

Then, start the wizard *Generate Masses Journal* to generate the masses
for a particular date. You can print a report that display the list of
masses with the associated celebrant, donor and intention. When it is
confirmed that the masses for that day have been celebrated, start the
wizard *Validate Masses Journal* to validate the masses ; you won't be
able to modify the masses any more.

If you want to transfer mass requests to an external celebrant with the
associated donations, create a new mass requests transfer. When you
validate the mass request transfer, it will generate the corresponding
accounting entries ; with these accounting entries, you will be able to
generate the payment of the corresponding donations to the external
celebrant.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/vertical-abbey/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/OCA/vertical-abbey/issues/new?body=module:%20donation_mass%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
-------

* Barroux Abbey
* Akretion

Contributors
------------

- Brother Bernard <informatique - at - barroux.org>
- Brother Irénée (Barroux Abbey)
- Alexis de Lattre <alexis.delattre@akretion.com>

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-alexis-via| image:: https://github.com/alexis-via.png?size=40px
    :target: https://github.com/alexis-via
    :alt: alexis-via

Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-alexis-via| 

This module is part of the `OCA/vertical-abbey <https://github.com/OCA/vertical-abbey/tree/18.0/donation_mass>`_ project on GitHub.

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