Skip to main content
Skip table of contents

Configuring and uploading pay history

For each payroll migration, configuring pay history is a one-time setup task. Pay history is a type of dynamic data, and you need to configure it before you can extract dynamic data from your customer's source product.

This page explains how to configure pay history and then upload pay history to your customer's MYOB Advanced site.

To apply the uploaded pay history to your customer's employees, you also need to do a pay run in your customer's MYOB Advanced site. Because every migration is different, we can't tell you exactly how to do this pay run, but you can find general pay run instructions on Doing a pay run.

New Zealand pay history

1. Before extracting dynamic data, configure pay history

 Before configuring pay history, there are prerequisites you need to set up in MYOB Advanced. You can find instructions on what to do on Importing pay history - NZ only.

  1. Log in to MYOB Adapt Desktop.

  2. In the progress table, click the Config progress item.

  3. In the Item Data tab, for the Pay History Start Date row, enter a date in the Value column. Make sure the date is at least 52 weeks ago.

  4. For the Re-upload Action Entitlement Adjustments row, set the Value column to:

    • R to replace entitlements on re-upload.

    • D to create more batches of entitlement adjustments.

  5. On the toolbar, go to the Actions menu and click Apply Pay History Settings.

  6. On the toolbar, click the Save icon (

    ).

  7. When the customer's site is ready to go live, use Adapt Uploader to extract their dynamic data.

2. After extracting dynamic data, upload pay history
  1. Log in to Adapt Desktop.

  2. In the progress items, Entitlement Adjustments Details, Entitlement Adjustments, Import Pay History Details and Import Pay History progress items, follow the in-product instructions to upload the entitlement adjustments and import pay history for each employee. These will populate the Pay History Details and the Import Pay History screens in MYOB Advanced.

  3. Log in to your customer's MYOB Advanced site and follow the instructions in Importing pay history - NZ only instructions for Entitlement Adjustments and Import Pay History.

Australia pay history

For Australian companies, uploading pay history is optional. If you're not going to import pay history, you must still configure it.

1. Before extracting dynamic data, configure pay history

If you won't import pay history

  1. Log in to Adapt Desktop.

  2. In the progress table, click the Config progress item.

  3. If you won't import pay history, in the Import Pay History row, enter N in the Value column.

  4. On the toolbar, go to the Actions menu and click Apply Pay History Settings.

  5. When the customer's site is ready to go live, use Adapt Uploader to extract their dynamic data.

If you will import pay history

  1. Log in to Adapt Desktop.

  2. In the progress table, click the Config progress item.

  3. In the Import Pay History row, enter Y in the Value column.

  4. In the Pay History Start Date row, enter a date in the Value column.

  5. For the Re-upload Action Entitlement Adjustments row, set the Value column to:

    • R to replace entitlements on re-upload.

    • D to create more batches of entitlement adjustments.

  6. On the toolbar, go to the Actions menu and click Apply Pay History Settings.

  7. In the Employees, Employee Banking and Pay Details-Distribution Balance progress items, upload information for both terminated and active employees.

  8. When the customer's site is ready to go live, use Adapt Uploader to extract their dynamic data.

2. After extracting dynamic data, upload pay history
  1. Log in to Adapt Desktop.

  2. In the Pay Group for Pay History progress item, the Pay Group column displays IMPORT by default. Upload this information.

  3. In the Pay History-Pay Groups progress item, the Pay Group ID column displays IMPORT for all employees by default. Upload this information.

  4. In the progress item Pay History-Standard Pay, upload the data containing gross earnings, tax, and super for each employee.

  5. In your customer's MYOB Advanced site, do a pay run for the Import pay group to apply the pay history to your customer's employees.

    Once you've finished the pay run, you can set employees terminated during the pay history period as Inactive.

Setting terminated employees as inactive

After uploading pay history and doing a pay run to apply it to employees, you can deactivate employees that were terminated during the pay history period.

In Adapt Desktop, go to the Deactivate Terminated Employees progress item and upload the status changes for terminated employees. The Deactivate Terminated Employees progress item also lets you set deactivated employees as active again.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.