Hibou Odoo Suite: Payroll Modules: US Payroll: New Jersey State Payroll

Repository Versions:



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

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 - New Jersey - Payroll'. When ready, hit Install.

Odoo CMS - a big picture

Good to Know!

The New Jersey 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 create one by clicking Create.

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

Ensure you have a Wage set for the employee.

Odoo CMS - a big picture

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

Fill in the following fields, which are found on the employee's completed New Jersey NJ-W4 form:

  • NJ Filing Status: Filing status from section 2 of the completed NJ-W4 form.

  • Wage Chart Letter: Found on Line 3 of the NJ-W4. If this line on the NJ-W4  is empty, leave blank.

  • NJ-W4 Allowances: Allowances claimed on line 4 of the completed NJ-W4.

  • Additional Withholding: Any additional withholding found on Line 5 of the completed NJ-W4 form. 

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 New Jersey State taxes in the Salary Computation tab.

Odoo CMS - a big picture


This module includes a new contribution register and partner for the New Jersey Department of Taxation.

Additionally, it adds a company level New Jersey Unemployment Rate and New Jersey State Disability Insurance Rate as well contract level New Jersey State Disability Insurance Rate, New Jersey Family Leave Insurance Rate and New Jersey Workforce/Supplemental Workforce funds.