Hibou Odoo Suite: Payroll: US Payroll: Pennsylvania State Payroll


The purpose of this documentation is to outline the use case and processes associated with Hibou's Pennsylvania State Payroll module for Odoo. The Pennsylvania State Payroll module includes contribution registers and calculations for the Pennsylvania Department of Revenue.

Getting Started

First thing's first, we need to install the module! Navigate to the Apps application, remove the Apps filter from the search bar, and then search for 'USA - Pennsylvania - Payroll'. When ready, hit Install.

Odoo CMS - a big picture

  Good to Know!

The Pennsylvania State Payroll module requires requires Hibou's USA Payroll module and Odoo's Payroll application. However, if you do not already have these installed, Odoo will install them for you during this module's installation!


To get started, navigate to the Employees application.

Odoo image and text block

Configuring an Employee Contract

Once there, select CONTRACTS.

This will bring you to a kanban view of all employee contracts. Select an existing contract or make a new one by clicking CREATE.

In the Salary Structure field select "USA Pennsylvania Employee" from the dropdown menu.

Ensure you have a Wage set for the employee.

Odoo CMS - a big picture

After selecting USA Pennsylvania Employee for the Salary Structure, click on the US State Filing tab.

The only field here is for Additional Withholding. This is because Pennsylvania has a flat tax rate for all residents.

It is also important to enter W4 information in the US Federal Filing tab section, which is provided by Hibou's USA Payroll module.

Odoo CMS - a big picture

When finished, hit SAVE.


Ensure that the status of the contract is Running. A contract that is not Running cannot be used during payroll. To change this, simply click 'Running' in the status bar on the contract. 

New Payslip Computations and Categories

When running payroll, after hitting COMPUTE SHEET you will see the various new Pennsylvania State taxes in the Salary Computation tab.

Odoo CMS - a big picture


This module includes contribution registers and partners for:

  • Pennsylvania Department of Revenue - Unemployment Insurance

  • Pennsylvania Department of Revenue - State Income Tax

Additionally, it adds contract level Pennsylvania Unemployment Rate and Pennsylvania State Income Tax Rate as well as a company level Pennsylvania Unemployment Rate.