Setting up MYOB Acumatica

Set up an API user

Go to the Users screen.
Change the automatically generated password:
1. Deselect the Generate Password checkbox.
2. Enter a new Password.

Deselect the Password Never Expires checkbox.
In the Email field, enter an email address. This is a mandatory MYOB Acumatica field, but doesn’t affect the migration. You’ll mainly use this email address for receiving password reset emails, etc.
In the Max. Number of Concurrent Logins field, enter 99.
On the Roles tab, select the following roles:
- Administrator
- People ESS
- People MSS
- People Payroll User.
Click the License Types tab.
Select the Limited API licence type checkbox.
On the main toolbar, click the Save icon.

Publish the MYOB Adapt customisation

For MYOB Adapt to be able to upload data to the site, you must publish the ADAPTERP customisation.

Log in to the MYOB Adapt online portal.

Need a login for the online portal? Request one in Phoenix. Select MYOB Advanced as your product, ADAPT as the area and New User Login as the subarea.
Click Downloads on the left. The Files to Download page opens.
Click ADAPTERP.zip to download the MYOB Adapt customisation for ERP migrations.

To prevent errors when using the files, make sure that the name of the file you downloaded matches the name on the MYOB Adapt online portal. For example, if you've previously downloaded the MYOB Adapt customisation file, it might be named ADAPTERP (1).zip. In that case, you should rename it to ADAPTERP.zip.
Log in to the MYOB Acumatica site for the customer you're migrating.
Go to the Publish Customisation screen.
Publish the ADAPTERP.zip file you downloaded in step 3.

Set the company ID

In MYOB Acumatica, you can set a company ID on the Companies screen (CS101500) by clicking Change ID on the form toolbar.

If the tenant you're setting up doesn't need multiple branches, the company should be the same as the branch ID, instead of MAIN. You need to set this up before you can upload employees using MYOB Adapt.

Set up a cash account

You need to set up at least one cash account for each company and company branch.

Before you can set up a cash account you need to:

Set up an account as a cash asset on the Chart of Accounts screen (GL202500).
The segmented key ID for cash accounts should have a length of at least ten. You can check this by going to the Segmented Keys screen and entering CASHACCOUNT in the Segmented Key ID field.

Other setup requirements

What to set up	How to set it up
Branches	These should match the branches in the customer's source product. By default, Adapt maps all branches to MAIN.
Warehouses	These should match the warehouses in the customer's source product. By default, Adapt maps all warehouses to MAIN.
Credit terms	These should match the credit terms in the customer's source product.
Extra fields	When migrating from MYOB Exo Business, you can either set up fields or attributes to map the extra fields to.
Subaccounts	If you don't set up any subaccounts, Adapt maps all subaccounts to the default 0 subaccount.
Chart of accounts	Set this up as you would for any other migration.
Financial calendar	Set this up as you would for any other migration.
Retained earnings account	Set this up as you would for any other migration.
Tax periods	Set this up as you would for any other migration.
Tax codes	Make sure you create the tax codes for purchase-exempt GST and sales-exempt GST.

Back up your customer's site

After configuring your customer's sites, it's a good idea to back up both the test site and production site. That way, if something breaks during the migration, you can quickly restore the site to its original state, without having to reconfigure all of its settings.

Alternatively, you can take a snapshot of the site before beginning the migration.

What's next?

After you've finished setting up your customer's MYOB Acumatica — Payroll site, you need to set up a migration in the MYOB Adapt online portal.