==================
MIS Builder Budget
==================
..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:27ee6c25b898bebeb2f6202e943c5d464f95a813fa5be1f1ee636887ee54370c
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
:target: https://odoo-community.org/page/development-status
:alt: Production/Stable
.. |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-OCA%2Fmis--builder-lightgray.png?logo=github
:target: https://github.com/OCA/mis-builder/tree/17.0/mis_builder_budget
:alt: OCA/mis-builder
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/mis-builder-17-0/mis-builder-17-0-mis_builder_budget
: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/mis-builder&target_branch=17.0
:alt: Try me on Runboat
|badge1| |badge2| |badge3| |badge4| |badge5|
Create budgets for MIS reports.
This module lets you create budgets for any MIS report. Several budgets
can be created for a given report template (ie one budget per year).
Budget figures are provided by KPI or by GL account, with different time
periods. A budget can then be selected as a data source for a MIS report
column, and the report will show the budgeted values for each KPI,
adjusted for the period of the column.
**Table of contents**
.. contents::
:local:
Usage
=====
There are two ways to use this module: create budgets by KPI or budgets
by GL accounts. Currently, the two methods cannot be combined in the
same budget.
**Budget by KPIs**
To use this this mode, you first need to flag at least some KPI in a MIS
report to be budgetable. You also need to configure the accumulation
method on the KPI according to their type.
The accumulation method determines how budgeted values spanning over a
time period are transformed to match the reporting period.
- Sum: values of shorter period are added, values of longest or
partially overlapping periods are adjusted pro-rata temporis (eg
monetary amount such as revenue).
- Average: values of included period are averaged with a pro-rata
temporis weight. Typically used for values that do not accumulate over
time (eg a number of employees).
When KPI are configured, you need to create a budget, using the MIS
Budget (by KPIs) menu, then click on the budget items button to create
or import the budgeted amounts for all your KPI and time periods.
**Budget by GL accounts**
You can also create budgets by GL accounts. In this case, the budget is
populated with one line per GL account (and optionally analytic account
and/or tags) and time period.
**Add budget columns to report instances**
Finally, a column (aka period) must be added to a MIS report instance,
selecting your newly created budget as a data source. The data will be
adjusted to the reporting period when displayed. Columns can be compared
by adding a column of type "comparison" or "sum".
Known issues / Roadmap
======================
The mis_builder
`roadmap <https://github.com/OCA/mis-builder/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement>`__
and `known
issues <https://github.com/OCA/mis-builder/issues?q=is%3Aopen+is%3Aissue+label%3Abug>`__
can be found on GitHub.
Changelog
=========
16.0.5.0.0 (2023-04-01)
-----------------------
**Features**
- Migration to 16.0.
- removal of analytic fetures because the upstream
``analytic_distribution`` mechanism is not compatible; support may
be introduced in separate module, depending on use cases
(`#472 <https://github.com/OCA/mis-builder/issues/472>`__)
**Bugfixes**
- Fix display of budgets in presence of sub KPIs.
(`#428 <https://github.com/OCA/mis-builder/issues/428>`__)
14.0.4.0.0 (2022-01-08)
-----------------------
**Features**
- A label field has been added to MIS Budget by Account items. When
overlap between budget items is allowed this allows creating a budget
with several contributions for a given account.
(`#382 <https://github.com/OCA/mis-builder/issues/382>`__)
- The balance field on MIS Budget by Account items is now writeable.
This allows for easier data entry and import.
(`#383 <https://github.com/OCA/mis-builder/issues/383>`__)
- MIS Budget by Account can now be configured to allow budget items with
overlapping dates. Each overlapping item contributes to the budget of
the corresponding period.
(`#384 <https://github.com/OCA/mis-builder/issues/384>`__)
14.0.3.5.1 (2021-04-06)
-----------------------
**Bugfixes**
- Fix incorrect budget by account multi company security rules.
(`#347 <https://github.com/OCA/mis-builder/issues/347>`__)
13.0.3.5.0 (2020-03-28)
-----------------------
**Features**
- Budget by GL account: allow budgeting by GL account in addition to the
existing mechanism to budget by KPI. Budget items have a begin and end
date, and when reporting a pro-rata temporis adjustment is made to
match the reporting period.
(`#259 <https://github.com/OCA/mis-builder/issues/259>`__)
13.0.3.4.0 (2020-01-??)
-----------------------
Migration to odoo 13.0.
12.0.3.4.0 (2019-10-26)
-----------------------
**Bugfixes**
- Consider analytic tags too when detecting overlapping budget items.
Previously only analytic account was considered, and this overlap
detection mechanism was overlooked when analytic tags were added to
budget items.
(`#241 <https://github.com/oca/mis-builder/issues/241>`__)
11.0.3.3.0 (2019-01-13)
-----------------------
**Features**
- Support analytic filters.
(`#15 <https://github.com/oca/mis-builder/issues/15>`__)
11.0.3.2.1 (2018-06-30)
-----------------------
- [IMP] Support analytic tags in budget items
(`#100 <https://github.com/OCA/mis-builder/pull/100>`__)
11.0.3.2.0 (2018-05-02)
-----------------------
- [FIX] #NAME error in out-of-order computation of non budgetable items
in budget columns
(`#68 <https://github.com/OCA/mis-builder/pull/69>`__)
11.0.3.1.1 (2018-02-04)
-----------------------
Migration to Odoo 11. No new feature.
(`#67 <https://github.com/OCA/mis-builder/pull/67>`__)
10.0.3.1.0 (2017-11-14)
-----------------------
New features:
- [ADD] multi-company record rule for MIS Budgets
(`#27 <https://github.com/OCA/mis-builder/issues/27>`__)
10.0.1.1.1 (2017-10-01)
-----------------------
First version.
Bug Tracker
===========
Bugs are tracked on `GitHub Issues <https://github.com/OCA/mis-builder/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/mis-builder/issues/new?body=module:%20mis_builder_budget%0Aversion:%2017.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
-------
* ACSONE SA/NV
Contributors
------------
- Stéphane Bidoul <stephane.bidoul@acsone.eu>
- Adrien Peiffer <adrien.peiffer@acsone.eu>
- Benjamin Willig <benjamin.willig@acsone.eu>
- Artem Kostyuk <a.kostyuk@mobilunity.com>
- Dzung Tran <dungtd@trobz.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-sbidoul| image:: https://github.com/sbidoul.png?size=40px
:target: https://github.com/sbidoul
:alt: sbidoul
Current `maintainer <https://odoo-community.org/page/maintainer-role>`__:
|maintainer-sbidoul|
This module is part of the `OCA/mis-builder <https://github.com/OCA/mis-builder/tree/17.0/mis_builder_budget>`_ project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
Raw data
{
"_id": null,
"home_page": "https://github.com/OCA/mis-builder",
"name": "odoo-addon-mis-builder-budget",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "ACSONE SA/NV, Odoo Community Association (OCA)",
"author_email": "support@odoo-community.org",
"download_url": null,
"platform": null,
"description": "==================\nMIS Builder Budget\n==================\n\n.. \n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! This file is generated by oca-gen-addon-readme !!\n !! changes will be overwritten. !!\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n !! source digest: sha256:27ee6c25b898bebeb2f6202e943c5d464f95a813fa5be1f1ee636887ee54370c\n !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!\n\n.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png\n :target: https://odoo-community.org/page/development-status\n :alt: Production/Stable\n.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png\n :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html\n :alt: License: AGPL-3\n.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fmis--builder-lightgray.png?logo=github\n :target: https://github.com/OCA/mis-builder/tree/17.0/mis_builder_budget\n :alt: OCA/mis-builder\n.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png\n :target: https://translation.odoo-community.org/projects/mis-builder-17-0/mis-builder-17-0-mis_builder_budget\n :alt: Translate me on Weblate\n.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png\n :target: https://runboat.odoo-community.org/builds?repo=OCA/mis-builder&target_branch=17.0\n :alt: Try me on Runboat\n\n|badge1| |badge2| |badge3| |badge4| |badge5|\n\nCreate budgets for MIS reports.\n\nThis module lets you create budgets for any MIS report. Several budgets\ncan be created for a given report template (ie one budget per year).\nBudget figures are provided by KPI or by GL account, with different time\nperiods. A budget can then be selected as a data source for a MIS report\ncolumn, and the report will show the budgeted values for each KPI,\nadjusted for the period of the column.\n\n**Table of contents**\n\n.. contents::\n :local:\n\nUsage\n=====\n\nThere are two ways to use this module: create budgets by KPI or budgets\nby GL accounts. Currently, the two methods cannot be combined in the\nsame budget.\n\n**Budget by KPIs**\n\nTo use this this mode, you first need to flag at least some KPI in a MIS\nreport to be budgetable. You also need to configure the accumulation\nmethod on the KPI according to their type.\n\nThe accumulation method determines how budgeted values spanning over a\ntime period are transformed to match the reporting period.\n\n- Sum: values of shorter period are added, values of longest or\n partially overlapping periods are adjusted pro-rata temporis (eg\n monetary amount such as revenue).\n- Average: values of included period are averaged with a pro-rata\n temporis weight. Typically used for values that do not accumulate over\n time (eg a number of employees).\n\nWhen KPI are configured, you need to create a budget, using the MIS\nBudget (by KPIs) menu, then click on the budget items button to create\nor import the budgeted amounts for all your KPI and time periods.\n\n**Budget by GL accounts**\n\nYou can also create budgets by GL accounts. In this case, the budget is\npopulated with one line per GL account (and optionally analytic account\nand/or tags) and time period.\n\n**Add budget columns to report instances**\n\nFinally, a column (aka period) must be added to a MIS report instance,\nselecting your newly created budget as a data source. The data will be\nadjusted to the reporting period when displayed. Columns can be compared\nby adding a column of type \"comparison\" or \"sum\".\n\nKnown issues / Roadmap\n======================\n\nThe mis_builder\n`roadmap <https://github.com/OCA/mis-builder/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement>`__\nand `known\nissues <https://github.com/OCA/mis-builder/issues?q=is%3Aopen+is%3Aissue+label%3Abug>`__\ncan be found on GitHub.\n\nChangelog\n=========\n\n16.0.5.0.0 (2023-04-01)\n-----------------------\n\n**Features**\n\n- Migration to 16.0.\n\n - removal of analytic fetures because the upstream\n ``analytic_distribution`` mechanism is not compatible; support may\n be introduced in separate module, depending on use cases\n (`#472 <https://github.com/OCA/mis-builder/issues/472>`__)\n\n**Bugfixes**\n\n- Fix display of budgets in presence of sub KPIs.\n (`#428 <https://github.com/OCA/mis-builder/issues/428>`__)\n\n14.0.4.0.0 (2022-01-08)\n-----------------------\n\n**Features**\n\n- A label field has been added to MIS Budget by Account items. When\n overlap between budget items is allowed this allows creating a budget\n with several contributions for a given account.\n (`#382 <https://github.com/OCA/mis-builder/issues/382>`__)\n- The balance field on MIS Budget by Account items is now writeable.\n This allows for easier data entry and import.\n (`#383 <https://github.com/OCA/mis-builder/issues/383>`__)\n- MIS Budget by Account can now be configured to allow budget items with\n overlapping dates. Each overlapping item contributes to the budget of\n the corresponding period.\n (`#384 <https://github.com/OCA/mis-builder/issues/384>`__)\n\n14.0.3.5.1 (2021-04-06)\n-----------------------\n\n**Bugfixes**\n\n- Fix incorrect budget by account multi company security rules.\n (`#347 <https://github.com/OCA/mis-builder/issues/347>`__)\n\n13.0.3.5.0 (2020-03-28)\n-----------------------\n\n**Features**\n\n- Budget by GL account: allow budgeting by GL account in addition to the\n existing mechanism to budget by KPI. Budget items have a begin and end\n date, and when reporting a pro-rata temporis adjustment is made to\n match the reporting period.\n (`#259 <https://github.com/OCA/mis-builder/issues/259>`__)\n\n13.0.3.4.0 (2020-01-??)\n-----------------------\n\nMigration to odoo 13.0.\n\n12.0.3.4.0 (2019-10-26)\n-----------------------\n\n**Bugfixes**\n\n- Consider analytic tags too when detecting overlapping budget items.\n Previously only analytic account was considered, and this overlap\n detection mechanism was overlooked when analytic tags were added to\n budget items.\n (`#241 <https://github.com/oca/mis-builder/issues/241>`__)\n\n11.0.3.3.0 (2019-01-13)\n-----------------------\n\n**Features**\n\n- Support analytic filters.\n (`#15 <https://github.com/oca/mis-builder/issues/15>`__)\n\n11.0.3.2.1 (2018-06-30)\n-----------------------\n\n- [IMP] Support analytic tags in budget items\n (`#100 <https://github.com/OCA/mis-builder/pull/100>`__)\n\n11.0.3.2.0 (2018-05-02)\n-----------------------\n\n- [FIX] #NAME error in out-of-order computation of non budgetable items\n in budget columns\n (`#68 <https://github.com/OCA/mis-builder/pull/69>`__)\n\n11.0.3.1.1 (2018-02-04)\n-----------------------\n\nMigration to Odoo 11. No new feature.\n(`#67 <https://github.com/OCA/mis-builder/pull/67>`__)\n\n10.0.3.1.0 (2017-11-14)\n-----------------------\n\nNew features:\n\n- [ADD] multi-company record rule for MIS Budgets\n (`#27 <https://github.com/OCA/mis-builder/issues/27>`__)\n\n10.0.1.1.1 (2017-10-01)\n-----------------------\n\nFirst version.\n\nBug Tracker\n===========\n\nBugs are tracked on `GitHub Issues <https://github.com/OCA/mis-builder/issues>`_.\nIn case of trouble, please check there if your issue has already been reported.\nIf you spotted it first, help us to smash it by providing a detailed and welcomed\n`feedback <https://github.com/OCA/mis-builder/issues/new?body=module:%20mis_builder_budget%0Aversion:%2017.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.\n\nDo not contact contributors directly about support or help with technical issues.\n\nCredits\n=======\n\nAuthors\n-------\n\n* ACSONE SA/NV\n\nContributors\n------------\n\n- St\u00e9phane Bidoul <stephane.bidoul@acsone.eu>\n- Adrien Peiffer <adrien.peiffer@acsone.eu>\n- Benjamin Willig <benjamin.willig@acsone.eu>\n- Artem Kostyuk <a.kostyuk@mobilunity.com>\n- Dzung Tran <dungtd@trobz.com>\n\nMaintainers\n-----------\n\nThis module is maintained by the OCA.\n\n.. image:: https://odoo-community.org/logo.png\n :alt: Odoo Community Association\n :target: https://odoo-community.org\n\nOCA, or the Odoo Community Association, is a nonprofit organization whose\nmission is to support the collaborative development of Odoo features and\npromote its widespread use.\n\n.. |maintainer-sbidoul| image:: https://github.com/sbidoul.png?size=40px\n :target: https://github.com/sbidoul\n :alt: sbidoul\n\nCurrent `maintainer <https://odoo-community.org/page/maintainer-role>`__:\n\n|maintainer-sbidoul| \n\nThis module is part of the `OCA/mis-builder <https://github.com/OCA/mis-builder/tree/17.0/mis_builder_budget>`_ project on GitHub.\n\nYou are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.\n",
"bugtrack_url": null,
"license": "AGPL-3",
"summary": "Create budgets for MIS reports",
"version": "17.0.1.4.0.2",
"project_urls": {
"Homepage": "https://github.com/OCA/mis-builder"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "229545e53b8d7d6f0087bc03ba2eefbe6810d5e1765f104a70a194b5d8f44a78",
"md5": "08b3b86f547134b65d8aa948470b414b",
"sha256": "999bb5c4734625c525db21518299dfc26249185700e7e6b86090bdaecbd6df7f"
},
"downloads": -1,
"filename": "odoo_addon_mis_builder_budget-17.0.1.4.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08b3b86f547134b65d8aa948470b414b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 85340,
"upload_time": "2024-12-18T03:22:54",
"upload_time_iso_8601": "2024-12-18T03:22:54.994236Z",
"url": "https://files.pythonhosted.org/packages/22/95/45e53b8d7d6f0087bc03ba2eefbe6810d5e1765f104a70a194b5d8f44a78/odoo_addon_mis_builder_budget-17.0.1.4.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-18 03:22:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "OCA",
"github_project": "mis-builder",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"lcname": "odoo-addon-mis-builder-budget"
}
JSON
