Author: |
Camptocamp, Odoo Community Association (OCA) |
License: |
AGPL-3 |
Branch: |
15.0 |
Repository: |
Change2improve/timesheet |
Dependencies: |
analytic,
hr_timesheet,
project,
and
sale_timesheet |
Languages: |
HTML (374, 32.2%),
PO File (236, 20.3%),
Python (371, 32.0%),
XML (89, 7.7%),
and
reStructuredText (91, 7.8%) |
Other branches: |
12.0,
13.0,
and
14.0 |
Other repositories: |
Chandresh-SerpentCS/timesheet,
DITIntl/timesheet,
Digital5-Odoo/timesheet,
ERPLibre/timesheet,
ForgeFlow/hr-timesheet,
Gabinete-Digital/timesheet,
Ingeos/timesheet,
Martronic-SA/timesheet,
MathBenTech/timesheet,
NeatNerdPrime/timesheet,
OCA-MUK/timesheet,
OCA/timesheet,
OpenAT/online,
SanteLibre/timesheet,
SeuMarco/timesheet,
Syci-Consulting/timesheet,
Tecnativa/timesheet,
VCLS-org/timesheet,
Vauxoo/timesheet,
acsone/timesheet,
akretion/timesheet,
anhvu-sg/timesheet,
ankitprajapati6515/timesheet,
area-scm/timesheet,
bodi000/timesheet,
brainbeanapps/timesheet,
camptocamp/timesheet,
cloudtrim/timesheet,
coopiteasy/timesheet,
crnd-inc/timesheet,
davejames/timesheet-1,
ecosoft-odoo/timesheet,
flachica/timesheet,
grindtildeath/timesheet,
grivalta/timesheet,
hbrunn/hr-timesheet,
hinfo506/timesheet,
i-vyshnevska/timesheet,
ip-candres/timesheet,
jacky82669513/timesheet,
jkraehling/timesheet,
krismas/timesheet,
leangjia/timesheet,
leemannd/timesheet,
lideritjnma/timesheet,
michaelkarrer81/timesheet,
raouf-haddada/timesheet,
sadeqamin/timesheet,
sanube/timesheet,
shiram/timesheet,
simahawk/timesheet,
solvosci/timesheet,
sss-software/timesheet-2,
steingabelgaard/timesheet,
sunflowerit/hr-timesheet,
sunshineLhj/timesheet,
takinobori/oca-timesheet,
tegin/timesheet,
urmyway/timesheet,
vvrossem/timesheet,
wahello/timesheet,
wajao/timesheet,
and
yousef-soliman/timesheet |
<h1 class="title">Sale Timesheet Rounded</h1>
<p><a class="reference external" href="https://odoo-community.org/page/development-status"><img alt="Beta" src="https://img.shields.io/badge/maturity-Beta-yellow.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/timesheet/tree/15.0/sale_timesheet_rounded"><img alt="OCA/timesheet" src="https://img.shields.io/badge/github-OCA%2Ftimesheet-lightgray.png?logo=github" /></a> <a class="reference external" href="https://translation.odoo-community.org/projects/timesheet-15-0/timesheet-15-0-sale_timesheet_rounded"><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/117/15.0"><img alt="Try me on Runbot" src="https://img.shields.io/badge/runbot-Try%20me-875A7B.png" /></a></p>
<p>Round timesheet lines amounts in sales based on project' settings.</p>
<p>A typical use case is: you work 5 minutes but you want to invoice 15 minutes.</p>
<p>With this module you can configure a rounding unit or factor on the project
and all the lines tracked on this project's tasks will show a rounded amount.</p>
<p>If you want you can override the value manually on each entry.</p>
<p>The delivered quantity on the sale order line - and by consequence on the
invoice - will be computed using the rounded amount.
Therefore, expense lines and other non-timesheet lines will be updated with
a rounded amount that is equal to the amount.</p>
<p>WARNING: This module cannot be used with <cite>timesheet_grid</cite> without further
adapation as an update of an existing timesheet line will NOT update the
rounded amount. To achieve this, you need to override <cite>adjust_grid</cite> function
to pass the <cite>force_compute</cite> context key.</p>
<p><strong>Table of contents</strong></p>
<div class="contents local topic" id="contents">
<ul class="simple">
<li><a class="reference internal" href="#configuration" id="id1">Configuration</a></li>
<li><a class="reference internal" href="#known-issues-roadmap" id="id2">Known issues / Roadmap</a></li>
<li><a class="reference internal" href="#bug-tracker" id="id3">Bug Tracker</a></li>
<li><a class="reference internal" href="#credits" id="id4">Credits</a><ul>
<li><a class="reference internal" href="#authors" id="id5">Authors</a></li>
<li><a class="reference internal" href="#contributors" id="id6">Contributors</a></li>
<li><a class="reference internal" href="#maintainers" id="id7">Maintainers</a></li>
</ul>
</li>
</ul>
</div>
<a name="configuration"></a>
<h2><a class="toc-backref" href="#id1">Configuration</a></h2>
<p>Go to a project and set the following fields according to your needs:</p>
<ul class="simple">
<li>Timesheet rounding unit</li>
</ul>
<p>Defines the rounding unit.
For instance, if you want to round to 1 hour, you can set <cite>1.0</cite>.
If you want to round to 15 min set <cite>0.25</cite>.</p>
<ul class="simple">
<li>Timesheet rounding method</li>
</ul>
<p>Options: "No" (default), "Closest", "Up", "Down".</p>
<p>Please refer to <cite>odoo.tools.float_utils.float_round</cite> to understand the difference.</p>
<ul class="simple">
<li>Timesheet rounding factor (percentage)</li>
</ul>
<p>When round unit is not defined you can round by a fixed %.</p>
<p>When using both a unit and a factor, the factor will be applied first:</p>
<blockquote>
result = round(amount * percentage, unit)</blockquote>
<a name="known-issues-roadmap"></a>
<h2><a class="toc-backref" href="#id2">Known issues / Roadmap</a></h2>
<ul class="simple">
<li>improve test coverage</li>
</ul>
<a name="bug-tracker"></a>
<h2><a class="toc-backref" href="#id3">Bug Tracker</a></h2>
<p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/timesheet/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/timesheet/issues/new?body=module:%20sale_timesheet_rounded%0Aversion:%2015.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="#id4">Credits</a></h2>
<a name="authors"></a>
<h3><a class="toc-backref" href="#id5">Authors</a></h3>
<ul class="simple">
<li>Camptocamp</li>
</ul>
<a name="contributors"></a>
<h3><a class="toc-backref" href="#id6">Contributors</a></h3>
<ul class="simple">
<li>Simone Orsi <<a class="reference external" href="mailto:simone.orsi@camptocamp.com">simone.orsi@camptocamp.com</a>></li>
<li>Thomas Nowicki <<a class="reference external" href="mailto:thomas.nowicki@camptocamp.com">thomas.nowicki@camptocamp.com</a>></li>
<li>Akim Juillerat <<a class="reference external" href="mailto:akim.juillerat@camptocamp.com">akim.juillerat@camptocamp.com</a>></li>
<li>Foram Shah <<a class="reference external" href="mailto:foram.shah@initos.com">foram.shah@initos.com</a>></li>
</ul>
<a name="maintainers"></a>
<h3><a class="toc-backref" href="#id7">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>This module is part of the <a class="reference external" href="https://github.com/OCA/timesheet/tree/15.0/sale_timesheet_rounded">OCA/timesheet</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>