<a class="reference external image-reference" 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.svg"> </a> <a name="employee-benefit"></a> <h2>Employee Benefit</h2> <p>This module implements employee benefits in order to produce payslips.</p> <p>Employee benefits can be computed automatically at a specific point in a payroll structure. They can also be computed using the button on the payslip form, in the 'Employee Benefits' tab.</p> <p>Also, they can be added manually on a payslip.</p> <p>If a benefit has 2 different rates in the same payslip period, the 2 rates will be weighted by the fraction of the payslip over which they apply.</p> <a name="configuration"></a> <h3>Configuration</h3> <a name="setting-employee-benefits"></a> <h4>Setting employee benefits</h4> <p>Go to Human Resources -&gt; Configuration -&gt; Payroll -&gt; Employee Benefit Categories Create your own employee benefit. Select the salary rules over which the benefit will be summed. Add as many different rates as needed.</p> <p>On the contract of an employee, add employee benefits. Select the category of benefit, the rate and dates between which the benefit will be activated.</p> <a name="setting-the-payroll-structure"></a> <h4>Setting the payroll structure</h4> <p>In a salary rule of your payroll structure, you may call</p> <p>payslip.compute_benefits()</p> <p>This allows compute the employee benefits at a specific point in the payroll structure.</p> <p>Whithin a salary rule, you may sum of benefits for a list of category codes:</p> <blockquote> <ul class="simple"> <li><dl class="first docutils"> <dt>Employee contribution:</dt> <dd>result = rule.sum_benefits(payslip, codes=['A1', 'B2'])</dd> </dl> </li> <li><dl class="first docutils"> <dt>Employer contribution:</dt> <dd>result = rule.sum_benefits(payslip, codes=['C3'], employer=True)</dd> </dl> </li> </ul> </blockquote> <p>The parameter codes is the list of benefit categories to include. To sum over the benefits related to the current salary rule:</p> <blockquote> <ul class="simple"> <li><dl class="first docutils"> <dt>Employee contribution:</dt> <dd>result = rule.sum_benefits(payslip)</dd> </dl> </li> <li><dl class="first docutils"> <dt>Employer contribution:</dt> <dd>result = rule.sum_benefits(payslip, employer=True)</dd> </dl> </li> </ul> </blockquote> <p>If the salary rule is related to no benefit categories, the method will sum all benefit categories.</p> <a name="bug-tracker"></a> <h3>Bug Tracker</h3> <p>Bugs are tracked on <a class="reference external" href="https://github.com/OCA/hr/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 feedback <a class="reference external" href="https://github.com/OCA/hr/issues/new?body=module:%20payroll_employee_benefit%0Aversion:%20{version}%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**">here</a>.</p> <a name="credits"></a> <h3 class="with-subtitle">Credits</h3> <h3 class="section-subtitle" id="contributors"><span class="section-subtitle">Contributors</span></h3> <ul class="simple"> <li>David Dufresne &lt;<a class="reference external" href="mailto:david.dufresne&#64;savoirfairelinux.com">david.dufresne&#64;savoirfairelinux.com</a>&gt;</li> <li>Maxime Chambreuil &lt;<a class="reference external" href="mailto:maxime.chambreuil&#64;savoirfairelinux.com">maxime.chambreuil&#64;savoirfairelinux.com</a>&gt;</li> <li>Pierre Lamarche &lt;<a class="reference external" href="mailto:pierre.lamarche&#64;savoirfairelinux.com">pierre.lamarche&#64;savoirfairelinux.com</a>&gt;</li> </ul>