Connecting Payroll to Dynamics 365 Business Central

Andrew

Updated 05 November 2025 10:34

You can integrate your payroll with Dynamics 365 Business Central to export your payroll details to the Dynamics 365 Business Central general ledger. Once your Dynamics 365 Business Central account is connected, you simply need to map your chart of accounts and then export your payroll journal to the general ledger when you finalise your pay run.

Connecting to Dynamics 365 Business Central

You can connect Dynamics 365 Business Central by following these steps:

Go to 'Payroll Settings' > 'Business Management' > 'Integrations'.
Go to 'Dynamics 365 Business Central' and click 'Add':

- Once you have selected 'Dynamics 365 Business Central', click the 'Connect to Dynamics 365 Business Central' button:

You will be redirected to the Dynamics 365 Business Central login page where you will need to enter your Dynamics 365 Business Central username and password
You will then be redirected to the Integrations page where you'll need to confirm the Dynamics 365 Business Central file you're connecting to:
Once confirmed, click 'Save'.

Use your Dynamics 365 Business Central locations to assign employees

If you would like to use the locations you have set up in Dynamics 365 Business Central to assign locations to your employees, you will need to go to 'Payroll Settings' > 'Pay Run Settings' > 'Locations'. Click on the 'Add' button and you will see a drop-down list for you to select and add locations. Please refer to the Locations support article for more information.

Mapping your payroll accounts

Once you've connected to your Dynamics 365 Business Central account, you will need to map the chart of accounts. You can do this by following these steps:

Go to 'Payroll settings' > 'Business Settings' > 'Chart of accounts'.
Click on 'Import accounts' to select which accounts you would like to use.
Click 'Default accounts' and you'll see a list of transaction types that need to be mapped to a Dynamics 365 Business Central account. The Dynamics 365 Business Central accounts appear in the drop-down list next to the transaction type. You can select the same account for multiple transaction types.
Once you've completed all the mappings, you are now ready to export a journal.

If you add any extra accounts to your Dynamics 365 Business Central chart of accounts, you can click on Import accounts and select these accounts so that they appear in your drop-down lists in the account mappings.

Further information on location-specific account mapping can be found in the Mapping GL Accounts support article.

Exporting your journal

Once you've completed a pay run, you'll be able to export a journal to the Dynamics 365 Business Central general ledger. You can export a journal by following these steps:

Once you've created and completed your pay run, click 'Finalise pay run' from the 'Pay run actions' tab.
In the 'Finalise pay run' dialogue box, ensure 'Export journals to Dynamics 365 Business Central now' is selected:
Click 'Finalise pay run' and your journal will be exported.

You can find the journal in the General Journals section in Dynamics 365 Business Central, within the Payroll folder. It will be in a "draft" state.

At this point, if the pay run is unlocked and edited, when you finalise the pay run again, the journal will be updated with the new pay run figures. You can then select Post/Print option and select Post. The journal entries will disappear from the General Journals and the figures will be added to the account in the chart of accounts.

If a user unlocks a pay run and deletes the pay run, the journal is deleted in Business Central.

Once a journal is posted, we can not change anything from our side. You will have to contact Dynamics 365 Business Central support if you don't know how to delete a posted journal entry.

Pay run number mapping - Employment Hero to Business Central

Scenario 1: Using the Business Central Connector

If you're using the native Employment Hero connector:

Employment Hero Field
Business Central Field
Description
Pay Run Number
Document No. (in General Journal Header)
The Pay Run Number becomes the unique document identifier in BC
Pay Date
Posting Date
Used for journal line date
Account Mapping
G/L Account No. (Journal Line)
Mapped based on CoA integration
Employee Name (optional)
Description (Journal Line)
Additional detail, depending on setup

This mapping is automatic once the Chart of Accounts is configured and mapped.

The Document No. becomes static, based on the Pay Run reference, so BC does not auto-generate its own document number unless you overwrite this.

Warning

If your journal batch is set to auto-generate numbers, but EH pushes the Pay Run Number into the Document No. field, the BC number series may clash or fail to post unless the Pay Run Number fits the number series format.

Fix Options: Ensure your Number Series in BC accepts the Pay Run format (e.g. PAY-000456).