حقوقها¶
در Odoo، حقوقها بر اساس پنج عامل محاسبه و تعیین میشوند: انواع ساختار حقوق، ساختارهای حقوق، قواعد، پارامترهای قواعد و سایر انواع ورودی. این عوامل در کنار یکدیگر، نحوهٔ محاسبهٔ حقوق هر کارمند را تعیین میکنند.
هر نوع ساختار شامل یک یا چند ساختار در درون خود است. هر ساختار شامل مجموعهای از قواعد است و هر قاعده از پارامترها برای تعریف نحوهٔ محاسبهٔ مبالغ مشخص استفاده میکند. ورودیهای اضافی (مانند پاداش یا کسورات) نیز میتوانند برای تنظیم حقوق نهایی گنجانده شوند.
When payslips are calculated, Odoo calculates the employee's worked time from their work entries, then applies the relevant structure, rules, and parameters from the employee's assigned structure type to determine their total pay.
Structure types¶
In Odoo, a structure type groups related salary structures. When a contract specifies a structure type, only the structures within that type are used to calculate the employee's pay. Each structure type houses individual structures within them, each containing a set of rules for processing a timesheet entry.
Structure types define key aspects of payroll configuration, including how often employees are paid, their working hours, the default salary structure, and whether wages are fixed (salary-based) or variable (hourly-based).
Example
A structure type called Employee contains two different structures within it: a Regular Pay
structure which includes all the separate rules for processing regular pay, and an End of Year
Bonus structure, which includes the rules only for the end of year bonus. Both belong to the
same Employee structure type.
View existing structure types by navigating to .
Two default structure types are preconfigured in Odoo: Employee and Worker.
Typically, Employee is used for salaried employees, which is why the Default Wage Type is a Fixed Wage, and Worker is typically used for employees paid by the hour, so the wage type is Hourly Wage.
توجه
If using a country-specific payroll localizations, it is recommended to use the structure in the corresponding country localization document.
New structure type¶
If the default structure types do not meet the company's needs, go to and click New to create a custom structure type.
هشدار
When creating a new salary structure type, ensure all local and national laws are accounted for. Confirm with the accounting department when configuring payroll structures, to ensure all requirements are met.
Proceed to enter the following information in the fields:
Structure Type: Enter the name for the new structure type, such as
EmployeeorWorker.Country: Select the country that the new structure type applies to from the drop-down menu.
Wage Type: Select the wage type for the structure:
Fixed Wage: For salaried employees who receive the same wage every pay period.
Hourly Wage: For employees paid based on hours worked during a pay period.
Default Scheduled Pay: Select the typical pay schedule for the new structure type from the drop-down menu. This indicates how often this specific type of structure is paid out.
Default Working Hours: Select the default working hours for the new structure type from the drop-down menu. All available working hours for the currently selected company appear in the drop-down menu. The default working hours are the Standard 40 hours/week option. If the needed working hours do not appear in the list, a new set of default working hours can be created.
Regular Pay Structure: Type in the name for the regular pay structure. It is used as the default option when generating payslips.
Default Work Entry Type: Select the default work entry type which is used to create all work entries for the employee.
New default working hours¶
To make new default working hours, type the name for the new working hours in the Default Working Hours field on the new structure type form. Click Create and edit. A default working hours form pops up. The default working hours form has two sections: a general information section, and a tab listing all the individual working hours by day and time. When the form is completed, click Save & Close.
Name: Type in the name for the new default working hours. This should be descriptive and clear to understand, such as
Standard 20 Hours/Week.Flexible Hours: Check the checkbox to let employees adjust their start and end times while maintaining the same total daily hours.
Company Full Time: Enter the number of hours per week an employee needs to work to be considered a full-time employee. Typically, this is approximately 40 hours, and this number affects what types of benefits an employee can receive, based on their employment status (full-time vs part-time).
Average Hour Per Day: Auto-populated based on the working hours in the Working Hours tab. This entry affects resource planning by determining how many resources can be used per workday.
Work Time Rate: This percentage is auto-generated based on the entry for the Company Full Time and the working hours configured in the Working Hours tab. This number should be between
0.00%and100%, so if the percentage is above100%, it is an indication that the working times and/or Company Full Time hours need adjustment.Company: Select the company that can use these new default working hours from the drop-down menu. Leave this field blank if the hours are available for all companies.
Timezone: Select the time zone to be used for the new default working hours from the drop-down menu.
Working Hours Tab: This tab is where each day's specific working hours are listed. When a new default working hour form is created, the Working Hours tab is pre-populated with a default 40-hour week, with each day divided into three timed sections.
Each day includes morning (8:00–12:00), lunch (12:00–13:00), and afternoon (13:00–17:00) periods, configured using the 24-hour time format.
To adjust any of these hours, click the field and modify the time using the drop-down menus, or type the desired time directly.
توجه
Working hours are company-specific, and cannot be shared between companies.
نکته
If the working hours are not consistent each week, and the hours are on a bi-weekly schedule instead, click the Switch to 2 week calendar button at the top of the new default working hours form. This changes the Working Hours tab to display two weeks of working times that can be adjusted.
Structures¶
Salary structures are the different situations in which an employee could be paid within a specific structure, and are specifically defined by various rules.
The number of structures a company needs for each structure type depends on how many different ways
employees are paid, and how their pay is calculated. A common example of an additional structure is
a Bonus.
To view all the various structures for each structure type, go to .
Each structure type lists the various structures associated with it. Each structure contains a set of rules that define it.
Click on a structure to view its Salary Rules. These rules define how the payslip will be computed for the employee.
توجه
After installing a payroll localization, relevant structures are installed and appear in this list.
Salary rules¶
Each structure has a set of salary rules used to compute the various amounts considered in the pay. These rules are configured by the localization and affect the computation of the salaries.
هشدار
Modification or creation of rules should only be done when necessary.
To view all the rules, go to . Click on a structure (such as Regular Pay) to view all the rules.
Add a new rule¶
To make a new rule, click New and a blank Salary Rules form loads. Enter the following information in the top half of the form:
Rule Name: Enter a name for the rule. This is the name displayed in the payslip.
Code: Enter a code to be used for the new rule. This is case sensitive and is used as the rule ID. This field is required.
Category: Using the drop-down menu, select the category the rule applies to, or enter a new category. The category is used to group rules and access their total sum.
Salary Structure: Using the drop-down menu, select the salary structure the rule applies to, or enter a new one. This field is required.
Sequence: Enter a number indicating when the rule is calculated, in the sequence of all other rules. Rules are processed one after another based on their sequence number. Rules with a lower sequence number are calculated first, and their results can be used by rules with a higher sequence number. This field is required.
Appears on Payslip: Check the checkbox to have the rule visible on the employee payslip PDF.
Contributes to Employer Cost: Check the checkbox to include the rule when computing the employer cost of a payslip.
تب عمومی¶
Fill out the following sections of the General tab. These configurations determine when and how the rule is calculated.
شرایط¶
Condition Based on: Using the drop-down menu, select if the rule is calculated and displayed as a line in the payslip form view. Choose from one of the following options:
Always True: The rule is always calculated. No other configurations are needed for this section.
Salary Input: This introduces a dynamic benefit to the structure. This appears as a field in the Payroll tab of the Employee form, the Inputs tab of the payslip, or both. The value of this field is added to the amount of the rule. If selected, the following additional fields appear and must be configured:
Input on: Specify where this field should appear and which object it should belong to, the Employee, the Payslip, or both. If both are selected, the value on the payslip automatically defaults to the value from the employee record, but it can be overwritten directly on the payslip for a specific payroll run.
Section: This groups several inputs into one expandable section on the form view. Only one option is available by default, Inputs.
Unit: Click the corresponding radio button to determine how the benefit is displayed. The available options are:
Monetary: A number with currency.
Quantity: A number.
Percentage: A number with a % sign.
Checkbox: Indicates boolean values.
Input Description: Enter a short explanation of when the input is applicable.
Default Value: Enter the default value, either a monetary amount, quantity, or percentage. This is determined by what is selected for the Unit. If necessary, add a Suffix in the field to the right of this value, such as
per km.توجه
If Checkbox is selected for the Unit, this field changes to Selected by Default. Click the checkbox to have the rule active by default.
Depends On: Select another rule that has a salary input, and use its value to determine whether this rule should be hidden.
Other Input: Select this to check if a payslip line exists with the same type. When selected, a Condition Other Input field appears. Using the drop-down menu, select the type of input the rule is based on, such as Deduction, Reimbursement, etc.
Python Expression: Select this to have the rule calculated using a Python script. The script is evaluated using the local dictionary. The right side lists the Available variables and the Output:
Available variables:
payslip: The
hr.payslipobject.employee: The
hr.employeeobject.version: The
hr.versionobject.result_rules: A dictionary containing the rules amounts, quantities, rates and totals (previously computed).
categories: A dictionary containing the computed salary rule categories (the sum of the amount of all the rules belonging to that category):
total: rule total
amount: rule amount
quantity: rule quantity
rate: rule rate
ytd: rule year to date value
worked_days: A dictionary containing the computed worked days, where each key is a work entry type code, and each value is a
worked_daysobject. This object contains many variables, with the most important ones being:number_of_days: The number of days registered in the payslip duration with this work entry type.
number_of_hours: The number of hours registered in the payslip duration with this work entry type.
is_paid: Whether or not this work entry type is added as an unpaid work entry on this payslip structure.
inputs: A dictionary containing the computed inputs where key is the other input type code and value is the sum of the payslip input lines with the same code.
Output:
result: The boolean is True if the rule should be calculated, or False if otherwise.
Domain: Select this option to apply the rule only if it matches the configured Applicability Domain. Configure the Applicability Domain that appears beneath this option when selected.
محاسبه¶
This section determines the final value of the rule, which consists of the base amount, the
quantity, and the rate. The total of the rule is total = amount * quantity * (rate/100).
مهم
This field does not appear if the Condition Based on field is set to Salary Input.
Using the drop-down menu, select one of the following options for the Amount Type field:
Percentage (%): Defines the values for the total calculation. When selected, configure the following fields:
Percentage based on: A Python expression is evaluated using the
localdict, and its value is assigned to the rule amount.Quantity: A Python expression is evaluated using the
localdict, and its value is assigned to the rule quantity.Percentage (%): A decimal number assigned to the rule rate.
Fixed Amount: The amount and quantity is defined, with a rate of 100%.
Quantity: A Python expression is evaluated using the
localdict, and its value is assigned to the rule quantity.Fixed Amount: Enter a decimal number which is assigned to the rule amount.
Other Input: Select this to fetch the rule amount from the payslip input lines that have the same other input type with rate of
100%and quantity of1.0. When selected, an Amount Other Input field appears beneath it. Using the drop-down menu, select the type of input it is, such as Deduction, Tips, or Expenses.Python Code: This is the more complex version of the Percentage (%) option, where a whole Python script is written then evaluated using the
localdict. This includes a list of Available variables and an Output list.Available variables:
payslip: hr.payslip object
employee: hr.employee object
version: hr.version object
result_rules: A dict containing the rules amounts, quantities, rates and totals (previously computed), where the key is the rule code, and the value is dict with the following keys:
total: rule total
amount: rule amount
quantity: rule quantity
rate: rule rate
ytd: rule year to date value
categories: A dict containing the computed salary rule categories (sum of amount of all rules belonging to that category) where key is the category code and value is the sum of the rules total values.
worked_days: A dict containing the computed worked days where key is the work entry type code and value is the
worked_daysobject contain many variables, but most important ones are:number_of_days: The number of days registered in the payslip duration with this work entry type.
number_of_hours: The number of hours registered in the payslip duration with this work entry type.
is_paid: Dictates whether or not this work entry type is added as unpaid work entry on this payslip structure.
inputs: A dict containing the computed inputs Where key* is the other input type code and value is the sum of the payslip input lines with the same code.
Output:
result: float, base amount of the rule
result_rate: float, which defaults to 100.0 (%)
result_qty: float, quantity, which defaults to 1
result_name: string, name of the line. This defaults to the name field of the salary rule (useful if the name depends or should depend on something computed in the rule).
Company contribution¶
با استفاده از منوی کشویی، شخص ثالث احتمالی دخیل در پرداخت حقوق به کارمندان را انتخاب کنید.
تب نمایش¶
این بخش ظاهر قاعده را روی PDF فیش حقوقی در دسترس کارمند تعیین میکند و زیباییشناسی قاعده را تعریف میکند.
ابتدا با استفاده از انتخابگر رنگ، یک Color برای قاعده انتخاب کنید. سپس تیک Title را بزنید تا فقط عنوان و توضیحات قاعدهٔ حقوق نمایش داده شود و هر مقدار عددی پنهان شود.
برای فعالسازی گزینهها، تیک Indented، Space Above، Bold، Underline و Italic را بزنید.
در نهایت، یک Description برای قاعده وارد کنید که زیر نام قاعده نمایش داده میشود.
تب حسابداری¶
این بخش تعیین میکند که قاعده چگونه بر ژورنالهای حسابداری مختلف تأثیر میگذارد و حقوق خالص برای کارمندان چگونه محاسبه میشود. فیلدهای زیر را در این بخش پیکربندی کنید:
Debit Account: با استفاده از منوی کشویی، حساب بدهکار را برای قاعده انتخاب کنید.
Credit Account: با استفاده از منوی کشویی، حساب بستانکار را برای قاعده انتخاب کنید.
Split on names: این گزینه را فعال کنید تا اسناد حسابداری این قاعده بر اساس نام خط فیش حقوقی تقسیم شوند.
Excluded from Net: این تیک را بزنید تا محاسبات قاعده از قاعدهٔ حقوق خالص در اسناد ژورنال مستثنی شود. یک حساب بدهکار و بستانکار مشخص باید تنظیم شود تا بهطور مستقل طبقهبندی شود.
Set employee on account line: این تیک را بزنید تا نام کارمند روی اقلام ژورنال قابل مشاهده باشد.
مهم
این تب فقط در صورت نصب اپلیکیشن حسابداری در دسترس است.
Rule parameters¶
پارامترهای قاعده به Odoo میگویند که چگونه هر خط از یک فیش حقوقی را محاسبه کند. برای مشاهدهٔ پارامترهای قاعدهٔ پیکربندیشده، به بروید.
همهٔ پارامترهای قاعده نمایش داده میشوند. روی یک پارامتر قاعدهٔ منفرد کلیک کنید تا جزئیات را مشاهده کنید.
هر پارامتر قاعده نام قاعده، کد، زمانی که قاعده فعال است و مقدار پارامتر را نمایش میدهد.
Example
پارامترهای قاعده برای پرداخت اضافهکاری به Odoo میگویند که کارمندان هنگام کار بیش از ۴۰ ساعت، یک و نیم برابر دریافت میکنند.
Other input types¶
هنگام ایجاد فیشهای حقوقی، گاهی لازم است ورودیهای دیگری برای شرایط خاص مانند انعام، کمیسیون، مخارج یا کسورات اضافه شود. این ورودیهای دیگر را میتوان با رفتن به یافت.
If a new input type is needed that does not appear on the list, click the New button to create a new input type. Enter the Description, the Code, and select which structure it applies to in the Availability in Structure field.
اگر ورودی باید یک ضمیمهٔ حقوقی باشد، تیک Available in attachments را بزنید.
مهم
The Code is used in the salary rules to compute payslips. If the Availability in Structure field is left blank, it indicates that the new input type is available for all payslips and is not exclusive to a specific structure.
