Payroll: Payroll Configuration


The purpose of this documentation is to outline the use case and processes associated with setting up and maintaining the Payroll application in Odoo 13. 

Configuration includes:

  • Settings: Set up payroll localizations and Accounting functionalities. 

  • Work Entry Types: View types of Work Entries, the visual representations of working schedules. 

  • Structure Types: View Salary Structure Types, which contain the payroll structures.

  • Structures: View Salary Structures, the localized constructions that contain Salary Rules.

  • Rules: View Rules, the lines that appear on payslips and indicate an input or output.

  • Rule Parameters: View the input parameters for any Rule. 

  • Other Input Types: Create a new input type that will appear on the payslip. 

Good to Know!

The payroll information outlined in this document uses modules in the Hibou Odoo Suite. Hibou created and maintains the US Federal and State localizations for payroll in the United States. The data you will see below is drawn from that module. 

We recommend that you install Hibou’s USA - Payroll with Accounting module, which links Rules to Accounts based on the US Accounting Localization.

Structure Types, Structures, and Rules are all pre-loaded in Hibou's module. We recommend not altering them in any way, and instead reaching out to us if you require additional rules, structures, or modifications. 

To get started, navigate to the Payroll application. 


Setting Up Payroll


Under Payroll, click on Choose a Payroll Localization. 

Odoo CMS - a big picture

On the next screen, locate the Hibou United States of America - Payroll with Accounting module.If the module hasn't been installed, click the INSTALL button. 

Odoo CMS - a big picture

When the installation is complete, you'll be taken back to Odoo's main menu screen. From there, navigate back to the Payroll application.

Good to Know!

Odoo does not come pre-loaded with salary rules or conditions. Without them, you cannot run payroll in any country. 

In order to run payroll, you must install a localization, like Hibou's USA Payroll - With Accounting module. This module is pre-loaded with Basic Salary, Commissions, Badges, Gross, all federal taxes (Social Security, FUTA, and medicare) and Net Salary. 
We do not recommend modifying rules unless you are familiar with this process. If you require additional or modified salary rules, please contact us.  

From within Payroll, go to CONFIGURATION > SETTINGS and find the Accounting section. You'll see the following options:

Payroll Entries: By enabling this option, payroll slip amounts will be posted in the Accounting app.

Payroll SEPA: SEPA is a payment method for the European Union. Leave this unchecked if you only run payroll in the U.S.

Odoo CMS - a big picture

Once you've enabled Payroll Entries, click Save

Salary Structure Types

Go to CONFIGURATION > Structure types.   

Structure Types give you basic information about the wage structure. If you need assistance downloading additional structure types, please contact us

NOTE: The Hibou United States of America - Payroll with Accounting module is preconfigured with basic Structure Types for US Payroll. 

Odoo CMS - a big picture

Salary Structures

Go to CONFIGURATION > Salary > Structures.   

Salary Structures are used to determine an employee's compensation. You will typically require one or more salary structures for your employees depending on where they live and work.

Please contact us if you need more salary structures. 

NOTE: The Hibou United States of America - Payroll with Accounting module is preconfigured with basic Salary Structures for US Payroll. 

Odoo CMS - a big picture

You can click CREATE to see the available options on a Salary Structure template. By default, it contains the following rules:

  • Basic Salary (base pay)

  • Gross (taxable income)

  • Net Salary

Odoo CMS - a big picture

Click DISCARD to leave this screen. 

Next, click into the USA Employee Standard Salary Structure to see how Hibou has preconfigured the template. 

Under the Salary Rules tab is where requirements for each state you run payroll for will be configured, including state unemployment, tax withholdings, and other applicable rules. 

NOTE: The Hibou United States of America - Payroll with Accounting module is preconfigured with basic Salary Rules for US Payroll. 

Odoo CMS - a big picture

Salary Rules


On this page, click the USA Employee Standard group heading from the list to see all US Salary Rules. Salary Rules are conditions that apply to a Salary Structure, such as computation of amount, designation of general ledger accounts for the Accounting app, Python code, and more. 

Odoo CMS - a big picture

We will use Basic Salary to review the Salary Rules configuration. Click Basic Salary, then click Edit

Odoo CMS - a big picture

You will see the following fields:

Name: A unique but identifiable name for the rule.

Category: Select the appropriate category.

Code: Can be used as a reference in the computation of other rules. In that case, it is case sensitive. 

Salary Structure: Indicates which structure this salary rule falls under. 

Appears on Payslip: Use to display salary rule on payslip. 

Sequence: Use to arrange a calculation sequence. For example, a 401K contribution should have a lower sequence number than Gross Wages, while Taxes would have a higher sequence number than Gross Wages.

Active: Disabling this field will allow you to hide the salary rule without deleting it. 

Odoo CMS - a big picture

On the General tab:


  • Condition Based on: Condition on which the rule is based (Always True, Range, or Python Expression). If you choose Range or Python Expression, other fields will become available for setting the conditions. Hibou creates these for its pre-loaded rules and provides them in the module. 


  • Amount Type: Computation for the rule amount. 

  • Python Code (only available if Amount Type is set to Python Code): Input Python code for the salary rule calculation. 

  • Quantity (only available if Amount Type is set to Fixed Amount or Percentage (%))Used in computation for percentage and fixed amount.

  • Fixed Amount (only available if Amount Type is set to Fixed Amount): Input field for amount. 

  • Percentage (%) (Only available if Amount Type set to Percentage (%)): Input field for percentage. 

Company Contribution

  • Partner: Indicates to whom we send the money being withheld. Hibou pre-programs the appropriate partners at state and federal levels in the module. 

Odoo CMS - a big picture


If you create a new tax or deduction and enter a fixed amount or percentage (%), make sure it is entered as a negative amount. 

On the Description tab, use the freeform field to write a more detailed description of the rule.

Odoo CMS - a big picture

On the Accounting tab, refer to the Good to Know section below for guidance in completing these fields:

  • Debit Account: Select the appropriate account.

  • Credit Account: Select the appropriate account.

  • Analytic Account: If applicable, select Analytic Account. 

  • Not computed in net accountability: Allows you to explicitly display the value of this rule in the accounting, rather than including it in the "Net Salary" rule. 

Odoo CMS - a big picture

Good to Know!

Example of proper uses of Debit and Credit accounts:

Basic Salary: Debit salary expense

Basic Bonus: Debit salary expense

Net Salary: Credit accounts payable or a payables account specifically for employee payables (example: Employee Net Payable).

EE: US FICA or Federal Income Tax W/H: Debit accounts payable (since the amounts are negative number on the payslips , by selecting the debit account, the number will be posted as a credit in accounts payable) .

ER: US FICA, state unemployment  or Federal Income Tax W/H: Debit accounts payable and credit a salary expense, such as Salary FUTA Expense, Salary FICA Expense or Salary SUTA Expense. Both fields are filled out as it is paid by the company.

Gross, Wage: US FICA, FUTA, or state unemployment: No accounts selected

Rule Parameters

Go to CONFIGURATION > rule parameters.   

On this page, all federal (FUTA, FICA (Social Security & Medicare) and state (unemployment) deductions are set-up and maintained. We do not recommend that you alter these parameters. 

NOTE: The Hibou United States of America - Payroll with Accounting module is preconfigured with basic Rule Parameters for US Payroll. 

Odoo CMS - a big picture

Other Input Types

Go to CONFIGURATION > other input types.

On this page, you can set up additional Input Types that will appear on a payslip. 

Description: Enter a brief description of the Input Type.

Availability in Structure: Indicate to which structure you want to assign the input type.

Code: Give the input type a unique code. 

Odoo CMS - a big picture

When you're ready, click save