MYOB ARL - API integration re-write (MYOB ARL deprecation 31/10/2023)

 

What version am I running?

To determine which version you are currently running:

  1. Open Easy Employer and log in
  2. Click organisation
  3. Click organisation structure
  4. Click the payroll entity that is integrated with MYOB AccountRight
  5. Click settings

If the payroll application shows "MYOB ARL" you are on version 1 (the original version) and you will need to get in contact with us - see "what you need to do" below.

If the payroll application shows "MYOB AccountRight" you are on the new version (the re-written version) and you do not need to do anything.

If another payroll application is showing, then you do not need to do anything.

 

Deprecation notice

The MYOB AccountRight API integration has been re-written to better handle MYOB AccountRight's timeout issues (see the following MYOB post on their issue: 504 Gateway Time out errors) - along with better handling the many other errors that MYOB will also produce.

We have also taken the opportunity to dramatically improve the user experience to show you exactly where MYOB went wrong at what step in the process. Adding auto retry functionality and the ability to retry at specific steps, along with the new "run export checks" functionality, the new integration is superior and will make your pay run experience much smoother. 

The old version of the MYOB AccountRight API integration (MYOB ARL) will be turned off on the 31/10/2023 and will be replaced with the re-written version (version 2)

 

What you need to do

Send an email to support@easyemployer.com with the date of your next pay run and the estimated time as to when you normally click the "export for payroll processing" button on the payroll report. We are offering free remote support sessions to support your organisation to move to the new integration - hand holding you through the process.

 

Example email

 

Hello

 

I would like to move to the new MYOB AccountRight integration. My next pay run occurs on the DATE and I normally click the export for payroll processing button at TIME.

 

Regards,

 

The new integration

A demonstration of the new MYOB AccountRight integration 'Run export checks' process that can be run before the pay run day is located here and the new 'Export for payroll processing' process is located here. The following is a screenshot of the new Export for payroll processing dialog:

 

To accomplish this, we have had to make a few changes to the integration, these include:

  • Easy Employer will no longer be creating wage categories if they do not exist in MYOB AccountRight
    • the MYOB AccountRight API endpoint for this step regularly timed out, removing this reduces the chance of a timeout at this step
    • New wage categories will need to be added into MYOB AccountRight manually
    • Easy Employer will still be pushing multiplier and/or hourly rate updates to wage categories
  • Easy Employer will no longer be creating new employee CARDS in MYOB AccountRight
    • the MYOB AccountRight API endpoint for this step regularly timed out, removing this reduces the chance of a timeout at this step
    • New employees will need to be added to MYOB AccountRight
  • Easy Employer will now export timesheet data to MYOB timesheets to the first day of week 1 instead of trying to split it across each day of each week
    • the MYOB API endpoint for this step regularly timed out, reducing the data size reduces the chance of a timeout at this step
    • Timesheet data will continue to be split by wage category and job code
    • Timesheet data and/or interpretation data for each timesheet shift can be obtained through Easy Employer
  • MYOB CARD IDs will no longer be imported and set as the user 'Export code'
    • This change was made to allow clients that do not use the MYOB CARD ID as the Export code for non-MYOB payroll imports and exports into Easy Employer the flexibility in setting whatever code they want to use
    • If you are using the export code for other imports and exports into and from Easy Employer, you will need to set this manually as part of your process (you can use the user details report to determine which user does not have an export code set).
  • MYOB job code list is no longer added to Easy Employer
    • Previously, when the pay run was exported, or a sync is performed, the job codes from MYOB would be automatically added to the Easy Employer list
    • Job codes will no longer automatically add to the Easy Employer list and will need to be managed manually
  • The sync process has been removed
    • The synchronise applications process has been removed
    • This was only used to push new employees to MYOB or pull in job codes from MYOB outside of the pay run, which is no longer required in the new integration 

Integration documentation on the new integration is located here

Have more questions? Submit a request
Powered by Zendesk