<h1 class="title">Analytic Accounting support for WIP and Variances</h1> <p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Alpha" src="https://img.shields.io/badge/maturity-Alpha-red.png" /></a> <a class="reference external" href="http://www.gnu.org/licenses/agpl-3.0-standalone.html"><img alt="License: AGPL-3" src="https://img.shields.io/badge/licence-AGPL--3-blue.png" /></a> <a class="reference external" href="https://github.com/OCA/account-analytic/tree/14.0/account_analytic_wip"><img alt="OCA/account-analytic" src="https://img.shields.io/badge/github-OCA%2Faccount--analytic-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/account-analytic-14-0/account-analytic-14-0-account_analytic_wip"><img alt="Translate me on Weblate" src="https://img.shields.io/badge/weblate-Translate%20me-F47D42.png" /></a> <a class="reference external" href="https://runbot.odoo-community.org/runbot/87/14.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p> <p>This feature proposes a strategy to track and report work in progress and variances. The work in progress can be split in subitems, such as Labour and Overhead.</p> <p>The base components are implemented here, a minimum viable process is working, but the process is best leveraged by other apps, such as Projects or Manufacturing.</p> <p>Resource consumption is to be recorded as Analytic Items when operations are logged in the system of resources.</p> <p>These Analytic Items are then used to calculate WIP and variances versus the original expected amounts. An &quot;Analytic Tracking Items&quot; object is used to hold the expected amount, and calculate the WIP and variances to record.</p> <p>A regular scheduled job uses that information to generate the corresponding accounting moves.</p> <p>Products can be seen as cost drivers, driving consumption of other items. For example a machine work time can drive consumptions of Labor and Overhead.</p> <p>When an Analytic Item is created for a cost driver, additional Analytic Items are generated for the corresponding indirect costs. For example, each timesheet hour logged could generate a overhead amount related to that activity.</p> <div class="admonition important"> <p class="first admonition-title">Important</p> <p class="last">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. <a class="reference external" href="https://odoo-community.org/page/development-status">More details on development status</a></p> </div> <p><strong>Table of contents</strong></p> <div class="contents local topic" id="contents"> <ul class="simple"> <li><a class="reference internal" href="#usage" id="id1">Usage</a></li> <li><a class="reference internal" href="#bug-tracker" id="id2">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id3">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id4">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id5">Contributors</a></li> <li><a class="reference internal" href="#maintainers" id="id6">Maintainers</a></li> </ul> </li> </ul> </div> <a name="usage"></a> <h2><a class="toc-backref" href="#id1">Usage</a></h2> <p>The &quot;Analytic Tracking Items&quot; holds planned amounts, and tracks their WIP and variances. These must be automatically created by specific logic in the Apps supporting them.</p> <p>With this module alone the Tracking Item creation can be done manually:</p> <ul class="simple"> <li>Navigate to ''Invoicing/Accounting &gt; Reporting &gt; Management &gt; Analytic Tracking''</li> <li>Create an Analytic Tracking Item:<ul> <li>Set the Analytic Account.</li> <li>Set the Product, use one that has a non-zero cost and belongs to a category with the &quot;Costing&quot; section configured.</li> <li>Set the Planned Amount.</li> </ul> </li> </ul> <p>Analytic Items are used to record the actual costs:</p> <ul class="simple"> <li>Navigate to <em>Invoicing/Accounting &gt; Configuration &gt; Analytic Accounting &gt; Analytic Items</em>.</li> <li>Create an Analytic Item:<ul> <li>Set the Analytic Account, Description and Date.</li> <li>Set the Product, use one that has a non-zero cost and belongs to a category with the &quot;Costing&quot; section configured.</li> <li>Set the quantity consumed.</li> <li>The Amount field should be automatically computed, with a negative amount.</li> </ul> </li> </ul> <p>Analytic Tracking Items are used to follow the costs incurred and the comparison with the planned amounts. This can be used for analysis:</p> <ul class="simple"> <li>Navigate to ''Invoicing/Accounting &gt; Reporting &gt; Management &gt; Analytic Tracking''</li> <li>The list presents lines being tracked, and displays columns with Actual Amount, Expected Amount, WIP Amount, Variance Amount, etc.</li> </ul> <p>WIP and variances journal entries are generated by a scheduled job:</p> <ul class="simple"> <li>Navigate to <em>Setting &gt; Technical &gt; Automation &gt; Scheduled Actions</em>.</li> <li>Locate and open the <em>Account: Process WIP and Variances</em> record, and click on the RUN MANUALLY button.</li> <li>Check the generated journal entries, at <em>Accounting &gt; Miscellaneous &gt; Journal Entries</em>.</li> </ul> <p>When creating Analytic Items, if a configuration is in place, the corresponding Analytic Items for indirect cost are generated.</p> <ul class="simple"> <li>When an Analytic Item is created, an automatic process checks the Activity Based Cost Rules to identify the ones that apply.</li> <li>Each triggered rule created a new Analytic Item, with a copy of the original one, and:<ul> <li>Product: is the rule Cost Type Product. A validation error prevents this from being the same as the source Analytic Item Product, to avoid infinite loops.</li> <li>Quantity: is the original quantity multiplied by the rule's Factor</li> <li>Amount: is -1 * Quantity * Product Standard Price</li> <li>Parent Analytic Item (new field): set with the original Analytic Item</li> </ul> </li> <li>An update on the Quantity triggers a recalculation of the quantity and amount of the child Analytic Items.</li> <li>A delete cascades to the child Analytic Items, causing them to also be deleted.</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id2">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/account-analytic/issues">GitHub Issues</a>. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed <a class="reference external" href="https://github.com/OCA/account-analytic/issues/new?body=module:%20account_analytic_wip%0Aversion:%2014.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">feedback</a>.</p> <p>Do not contact contributors directly about support or help with technical issues.</p> <a name="credits"></a> <h2><a class="toc-backref" href="#id3">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id4">Authors</a></h3> <ul class="simple"> <li>Open Source Integrators</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id5">Contributors</a></h3> <ul class="simple"> <li><cite>Open Source Integrators &lt;https://opensourceintegrators.com&gt;</cite>:<ul> <li>Daniel Reis &lt;<a class="reference external" href="mailto:dreis&#64;opensourceintegrators.com">dreis&#64;opensourceintegrators.com</a>&gt;</li> <li>Chandresh Thakkar &lt;<a class="reference external" href="mailto:cthakkar&#64;opensourceintegrators.com">cthakkar&#64;opensourceintegrators.com</a>&gt;</li> </ul> </li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id6">Maintainers</a></h3> <p>This module is maintained by the OCA.</p> <a class="reference external image-reference" href="https://odoo-community.org"><img alt="Odoo Community Association" src="https://odoo-community.org/logo.png" /></a> <p>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.</p> <p>Current <a class="reference external" href="https://odoo-community.org/page/maintainer-role">maintainer</a>:</p> <p><a class="reference external" href="https://github.com/dreispt"><img alt="dreispt" src="https://github.com/dreispt.png?size=40px" /></a></p> <p>This module is part of the <a class="reference external" href="https://github.com/OCA/account-analytic/tree/14.0/account_analytic_wip">OCA/account-analytic</a> project on GitHub.</p> <p>You are welcome to contribute. To learn how please visit <a class="reference external" href="https://odoo-community.org/page/Contribute">https://odoo-community.org/page/Contribute</a>.</p>