Employment Hero Payroll

The Employment Hero module synchronises payslip accounting entries (e.g., expenses, social charges, liabilities, taxes) automatically from Employment Hero to Odoo. Payroll administration is still done in Employment Hero. We only record the journal entries in Odoo.

Important

KeyPay was rebranded as Employment Hero in March 2023.

Configuration

  1. Activate the Employment Hero Payroll module (l10n_employment_hero).

  2. Configure the Employment Hero API by going to Accounting ‣ Configuration ‣ Settings. More fields become visible after clicking on Enable Employment Hero Integration.

    Enabling Employment Hero Integration in Odoo Accounting displays new fields in the settings

    • You can find the API Key in the My Account section of the Employment Hero platform.

      "Account Details" section on the Employment Hero dashboard

    • The Payroll URL is left empty by default to avoid any confusion. Please fill it according to the documentation specific to your localization.

      Note

      Employment hero is available for Australia, Malaysia, New Zealand, Singapore, and the United Kingdom.

    • You can find the Business ID in the Employment Hero URL. (i.e., 189241)

      The Employment Hero "Business ID" number is in the URL

    • You can choose any Odoo journal to post the payslip entries.

  3. Configure the tax by going to Accounting ‣ Configuration ‣ Taxes. Create the necessary taxes for the Employment Hero payslip entries. Fill in the tax code from Employment Hero in the Matching Employment Hero Tax field.

How does the API work?

The API syncs the journal entries from Employment Hero to Odoo and leaves them in draft mode. The reference includes the Employment Hero payslip entry ID in brackets for the user to easily retrieve the same record in Employment Hero and Odoo.

Example of a Employment Hero Journal Entry in Odoo Accounting (Australia)

By default, the synchronisation happens once per week. You can fetch the records manually by going to Accounting ‣ Configuration ‣ Settings and, in the Enable Employment Hero Integration option, click on Fetch Payruns Manually.

Employment Hero payslip entries also work based on double-entry bookkeeping.

The accounts used by Employment Hero are defined in the section Payroll settings.

Chart of Accounts menu in Employment Hero

For the API to work, you need to create the same accounts as the default accounts of your Employment Hero business (same name and same code) in Odoo. You also need to choose the correct account types in Odoo to generate accurate financial reports.