給与¶
In Odoo, salaries are calculated and determined by five factors: salary structure types, salary structures, rules, rule parameters, and other input types. Together, these determine how each employee's pay is calculated.
Each structure type contains one or more structures within it. Each structure contains a set of rules, and every rule uses parameters to define how specific amounts are calculated. Additional inputs, (such as bonuses or deductions) can also be included to adjust the final salary.
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.
給与体系¶
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.
給与規則¶
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.
General tab¶
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¶
Using the drop-down menu, select the eventual third party involved in the salary payment to the employees.
Display tab¶
This section determines the appearance of the rule on the payslip PDF available to the employee, and defines the rule aesthetics.
First, select a Color for the rule using the color picker. Next, check the Title checkbox to only display the salary rule's title and description, and hide any numerical values.
Check the Indented, Space Above, Bold, Underline, and Italic checkboxes to activate the options.
Finally, enter a Description for the rule, which is displayed below the rule name.
会計タブ¶
This section determines how the rule affects the various accounting journals and how the Net salary is calculated for employees. Configure the following fields in this section:
Debit Account: Using the drop-down menu, select the debit account for the rule.
Credit Account: Using the drop-down menu, select the credit account for the rule.
Split on names: Enable this option to split the accounting entries for this rule according to the payslip line name. Splitting the entries provides more visibility for deductions and reimbursements, or for salary adjustments.
Excluded from Net: Check this checkbox to exclude the rule's calculations from the net salary rule in journal entries. A specific debit and credit account should be set to independently classify it.
Set employee on account line: Check this checkbox to have the employee's name visible on the journal items.
重要
This tab is only available if the Accounting app is installed.
Rule parameters¶
Rule parameters inform Odoo how to calculate each line of a payslip. To view the configured rule parameters, navigate to .
All rule parameters are displayed. Click on an individual rule parameter to view the details.
Each rule parameter displays the name of the rule, the code, when the rule is active, and the parameter value.
Example
The rule parameters for overtime pay inform Odoo that employees receive time and a half when working over 40 hours.
Other input types¶
When creating payslips, it is sometimes necessary to add other entries for specific circumstances, like tips, commissions, expenses, or deductions. These other inputs can be found by navigating to .
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.
Check the Available in attachments checkbox if the input should be a salary attachment.
重要
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.
