2025.1 Adapt release notes – 12 March 2025
The 2025.1 release gives you more options on how to set up migrations, from choosing templates to customising how data is formatted. This means less manual data editing and less chance of mistakes. We’ve also resolved issues identified in previous versions.
What’s new
Customisable segmented keys
You can now customise segmented keys for each migration. For example, maybe your customer has two sites for their source product which you’re migrating into one MYOB Acumatica site. They might want employee IDs to reflect which site employees were migrated from.
For payroll migrations, you can customise employees and positions.
For ERP migrations, you can customise suppliers and customers.
At the top right of Adapt Uploader, click the new Current Migration Settings button. This opens the Migration Settings screen, where you can set the prefix, length and offset for a segmented key.

For details on how to use the screen, see Customising segmented keys .
To avoid duplicate data, the segmented key length in migration settings shouldn’t be longer than the segmented key length setting in MYOB Acumatica. You need to decide the length and prefix before running the uploader, as changing it later requires you to rebuild the entire migration.
For payroll migrations, we’ve also added the Employee Code Map progress item to Adapt Desktop. This helps you keep track of how employee IDs have changed by showing the employee’s name alongside their IDs in the source product and MYOB Acumatica.
Templates for numbering pay item IDs
When creating a payroll migration, you can now choose a template for how pay item IDs are numbered and named. This keeps your customer’s data consistent easy to understand.
For descriptions of the different templates, see 1. Setting up a migration in the online portal.
Simpler to import pay history and pay history details (NZ)
For New Zealand payroll migrations, pay history and pay history details are now automatically imported to Adapt Desktop when you use Adapt Uploader. This data gets added to the Entitlement Adjustments and Import Pay History progress items.
We’ve removed the three progress items you previously had to use to manually import this data as Microsoft Excel files:
Leave (Exo Excel Export)
DVL Leave (Exo ES Excel Export)
Pay History (Exo ES Excel Export)
If you already have New Zealand payroll migrations in progress, upgrading to version 2025.1 automatically moves your customer’s data from the removed progress items to Entitlement Adjustments and Import Pay History.
Other improvements
In Adapt Desktop, you can now map departments and positions to employees by selecting from a dropdown in the Maps To column, instead of having to manually enter data.
When creating a migration in the online portal, we’ve added a warning to make it clearer that you need to enter MYOB Acumatica site details. If you don’t enter the site details, you won’t be able to upload data to MYOB Acumatica.
No matter how you filter the Item Data tab in Adapt Desktop, the To Upload, Uploaded and Ignore columns are now always shown. That way you can always see exactly what you’re uploading.
If the general ledger (GL) is disabled in MYOB Exo Employer Services, then the Exo ES General Ledger progress item doesn’t appear in Adapt Desktop.
If a customer has open pays in their source product, you now see a warning in Adapt Uploader when you extract their source product data. The warning tells you close the open pays, reset the staging database in the online portal, and re-extract their data with Adapt Uploader.
In Adapt Desktop, you can now use find and replace on all columns that have checkboxes, including the To Upload, Uploaded and Ignore columns.
In Adapt Desktop, we’ve added a ESWageTypeDescription column to the Allowance Pay Item Creation progress item, so you can more easily understand what the wage type code means.
Resolved issues
Reference | Region | Migration type | Area of Adapt | Description |
---|---|---|---|---|
N/A | NZ & AU | Payroll | Desktop | New employees without bank details were not included in the Pay Details-Tax and Distribution progress item, so they weren’t being uploaded to MYOB Acumatica. |
N/A | NZ & AU | Payroll | Desktop | In the Pay Items progress item, the FormRateValueType for allowances was always mapped to Use Employee Rate, instead of being mapped to a custom rate or or the employee rate based on the allowance type. This could cause standard pay miscalculations in MYOB Acumatica. |
N/A | NZ | Payroll ERP | Desktop | Importing a derived values list (DVL) CSV file to Adapt resulted in an empty Employee ID column. Also, the data for sick leave and alternative leave could be different between the CSV file and Adapt Desktop. |
N/A | NZ & AU | Payroll ERP | Online portal | If your local database path had spaces in it (for example, |
CE00051108 CE00051105 | NZ | Payroll | Desktop | Pay history and pay history details are now present in Adapt Desktop and are uploading successfully into MYOB Acumatica. This includes income liable for average daily pay, ordinary weekly pay, and average weekly earnings. As part of this fix, we’ve combined some progress items into one. For details, see the new features describe above. |
CE00052184 CE00052173 | NZ & AU | Payroll | Desktop | Fields that were available on the Employment tab of the Pay Details form in MYOB Acumatica weren’t available in Adapt Desktop. To fix this, we’ve added the following fields to Adapt Desktop. For Australia:
For New Zealand:
|
N/A | NZ & AU | ERP | Desktop | On the Suppliers and Customers progress items, some addresses were cut off at the end, as the full address wasn’t imported correctly from the customer’s source data. |
N/A | NZ & AU | Payroll | Uploader | When uploading dynamic data, an error could occur on MYOBES_LeaveBalanceRow table, which had missing column names. |
N/A | NZ & AU | Payroll | Desktop | Deduction codes for direct debits were always set to 2. Now, the deduction codes are always set correctly so that allocation is accurate. |
N/A | NZ & AU | Payroll | Desktop | Errors were occurring on pay items due to differences between the SQL for creating deductions compared to the SQL for creating allowances. The SQL is now the same for both, ensuring that deductions are created correctly and pay items load without any errors. |
CE00055533 | NZ & AU | Payroll | Uploader | When uploading static data, an error could occur for pay groups. Now, to prevent the error, if a database doesn’t have allowances or deductions, Adapt Uploader doesn’t try uploading them. |