<h1 class="title">HR (Extra) Hours Management</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/compassionCH/compassion-modules/tree/11.0/hr_attendance_management"><img alt="compassionCH/compassion-modules" src="https://img.shields.io/badge/github-compassionCH%2Fcompassion--modules-lightgray.png?logo=github" /></a></p> <p>This module extends the functionality of hr_attendance and allows to keep track of the work hours of the employees, gives better overview of the work hours and follow the extra hours balance.</p> <p>You can set in the schedule of the employee how much time they are supposed to work on a daily basis, allow a maximum extra hours limit, and add minimum break time required. You will better keep track of the extra hours balance of the employees given all the rules that you setup.</p> <p>Furthermore, you can easily calculate the balance of an employee using the period system, which calculates the balance between two dates. Actual balance is based on the balance of the last period to avoid having to do many computations.</p> <p>With this module, logging your hours is made easy in Odoo!</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="#usage" id="id2">Usage</a></li> <li><a class="reference internal" href="#known-issues-roadmap" id="id3">Known issues / Roadmap</a></li> <li><a class="reference internal" href="#bug-tracker" id="id4">Bug Tracker</a></li> <li><a class="reference internal" href="#credits" id="id5">Credits</a><ul> <li><a class="reference internal" href="#authors" id="id6">Authors</a></li> <li><a class="reference internal" href="#contributors" id="id7">Contributors</a></li> <li><a class="reference internal" href="#other-credits" id="id8">Other credits</a></li> <li><a class="reference internal" href="#maintainers" id="id9">Maintainers</a></li> </ul> </li> </ul> </div> <a name="configuration"></a> <h2><a class="toc-backref" href="#id1">Configuration</a></h2> <p>To configure this module, go in <strong>Attendances/Configuration/Attendance Settings</strong>:</p> <ol class="arabic simple"> <li>You can configure a <em>free break</em> time that is offered to employees. It means this time will count as a break time but won't be deduced from the attendance of the employees.</li> <li>You can configure a <em>maximum extra hours limit</em>. When the employee makes more extra hours than the limit, it doesn't increase anymore his extra hours balance. This module offers to disable this continuous limit for some employee via the <em>continuous extra hours computation</em> flag in Employee. When unset, the limit will only be enforced once per year.</li> <li>In <strong>Attendances/Configuration/Break rules</strong> you can define a minimum break time required per day based on how many hours the employee worked on the day. Total break is the total break time the employee must do per day Minimum break is the minimum time required for at least one break (for instance if the employee should take at least 30 minutes of break for lunch)</li> <li>In <strong>Attendances/Configuration/Coefficient</strong> you can define special days that will give more extra hours to the employee. For instance you could set the Sunday to count 1.5x time. You can limit those rules to specific categories of employees.</li> <li>In <strong>Attendances/Manage Attendances/Employee</strong> you can setup the <em>initial balance</em> of each employee, when you start using the module to count the hours. Just go in one employee, under the Hours tab, and set the value. The value will be updated each year to avoid computing over more than one year of attendances.</li> <li>In <strong>Attendances/Manage Attendances/Employee</strong> you can setup a <em>continuous extra hours computation</em> for each employee. When unset, this allows the employee to get over the max_extra_hours limit. The max_extra_hours will however be enforced at the annual hours computation. The date of this computation can be set in <em>Attendance/Configuration/Next Balance Cron Execution</em>.</li> <li>In <strong>Employee/Contracts/Working Schedule</strong> configure the working schedule of each employee by going to the <em>resource.calendar</em> object</li> <li>In <strong>Leaves/Configuration/Leave Types</strong> configure if leave types should not deduce from the due hours of the employees by setting <em>Keep due hours</em></li> </ol> <p>To configure the cron which updates the balance of employees annually, go in <strong>Settings/Technical/Automation/Automated Actions</strong>:</p> <ol class="arabic simple"> <li>In the cron <em>Compute annual extra hours balance</em> choose the scheduled date on which you want to apply the process to move the extra hours of employees in their annual balance and cap off the extra hours of employee with an annual extra hours computation. This is typically done at the beginning of the year. This process avoids the system to compute a huge amount of data after a few years of attendance.</li> </ol> <a name="usage"></a> <h2><a class="toc-backref" href="#id2">Usage</a></h2> <p>As an employee, you continue to log your attendance as before with the base module hr_attendance. But you have now new views to keep track of your extra hours evolution.</p> <ol class="arabic simple"> <li>In <strong>Attendances/Manage Attendances/Attendance days</strong> you can view all your working days with the hours that were registered.</li> <li>In <strong>Attendances/Manage Attendances/Balance history</strong> you can view your extra hours evolution</li> </ol> <a class="reference external image-reference" href="https://runbot.odoo-community.org/runbot/116/10.0"><img alt="Try me on Runbot" src="https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas" /></a> <a name="known-issues-roadmap"></a> <h2><a class="toc-backref" href="#id3">Known issues / Roadmap</a></h2> <ul class="simple"> <li>Improve leaves request to be able to specify how many hours it should deduct from the due hours</li> </ul> <a name="bug-tracker"></a> <h2><a class="toc-backref" href="#id4">Bug Tracker</a></h2> <p>Bugs are tracked on <a class="reference external" href="https://github.com/compassionCH/compassion-modules/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/compassionCH/compassion-modules/issues/new?body=module:%20hr_attendance_management%0Aversion:%2011.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="#id5">Credits</a></h2> <a name="authors"></a> <h3><a class="toc-backref" href="#id6">Authors</a></h3> <ul class="simple"> <li>Compassion Switzerland</li> </ul> <a name="contributors"></a> <h3><a class="toc-backref" href="#id7">Contributors</a></h3> <ul class="simple"> <li>Stéphane Eicher &lt;<a class="reference external" href="mailto:eicher31&#64;hotmail.com">eicher31&#64;hotmail.com</a>&gt;</li> <li>Emanuel Cino &lt;<a class="reference external" href="mailto:ecino&#64;compassion.ch">ecino&#64;compassion.ch</a></li> <li>Nicolas Badoux &lt;<a class="reference external" href="mailto:n.badoux&#64;hotmail.com">n.badoux&#64;hotmail.com</a>&gt;</li> <li>Samuel Fringeli &lt;<a class="reference external" href="mailto:samuel.fringeli&#64;me.com">samuel.fringeli&#64;me.com</a>&gt;</li> <li>Quentin Gigon &lt;<a class="reference external" href="mailto:gigon.quentin&#64;gmail.com">gigon.quentin&#64;gmail.com</a>&gt;</li> </ul> <a name="other-credits"></a> <h3 class="with-subtitle"><a class="toc-backref" href="#id8">Other credits</a></h3> <h3 class="section-subtitle" id="images"><span class="section-subtitle">Images</span></h3> <ul class="simple"> <li>Odoo Community Association: <a class="reference external" href="https://odoo-community.org/logo.png">Icon</a>.</li> </ul> <a name="maintainers"></a> <h3><a class="toc-backref" href="#id9">Maintainers</a></h3> <p>This module is maintained by Compassion Switzerland.</p> <a class="reference external image-reference" href="https://www.compassion.ch"><img alt="Compassion Switzerland" src="https://upload.wikimedia.org/wikipedia/en/8/83/CompassionInternationalLogo.png" /></a> <p>Compassion Switzerland is a nonprofit organization whose mission is to release children from extreme poverty in Jesus name.</p> <p>This module is part of the <a class="reference external" href="https://github.com/compassionCH/compassion-modules/tree/11.0/hr_attendance_management">compassionCH/compassion-modules</a> project on GitHub.</p> <p>You are welcome to contribute.</p>