Hibou Odoo Suite: Payroll: US Payroll: Virginia State Payroll


The purpose of this documentation is to outline the use case and processes associated with Hibou's Virginia State Payroll module for Odoo. The Virginia State Payroll module includes contribution registers and calculations for the Virginia 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 - Virginia - Payroll'. When ready, hit Install.

Odoo CMS - a big picture

Good to Know!

The Virginia 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 Contact

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 Viriginia Employee" from the dropdown menu.

Ensure you have a Wage set for the employee.

Odoo CMS - a big picture

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

Here is where you will enter data for the fields found on the employee's completed Virginia VA-4 form. You may also have a completed VA-4P form, which is specifically for recipients of pension and annuity payments.

  • VA-4 Exemptions: Total of exemptions from line 8 of the completed VA-4 document.

  • VA-4P Exemptions: Total of exemptions from line 8 of the completed VA-4P document (only for recipients of pension and annuity payments).

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

Odoo CMS - a big picture


This module includes contribution registers and partners for:

  • Virginia Department of Taxation - Unemployement

  • Virginia Department of Taxation - Income Tax Withholding

Additionally, it adds contract level Virginia Exemptions along with a company level Virginia Unemployment Rate.