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, but the journal entries are done 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

    • The API Key can be found 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 the localization.

      Note

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

    • The Business ID can be found in the Employment Hero URL. (i.e., 189241)

      The Employment Hero Business ID number is in the URL

    • 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. The records can be fetched 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, create the same accounts as the default accounts of the Employment Hero business (same name and same code) in Odoo. The correct account types must be chosen in Odoo to generate accurate financial reports.