How to set up and use the Active - MYOB Practice Management integration

 

Article Objective: To assist admin users in navigating the Active Platform to set up and use the Active -  MYOB Practice Management integration.       


Context: Admin users can connect the Active Platform with MYOB Practice Management to synchronise client and user data. By the end of this article, you will understand the prerequisites, setup, data sync details (frequency and fields), usage, error logs and FAQs of this connection.           


TABLE OF CONTENTS

Prerequisites

Before setting up the MYOB Practice Management and Active Platform integration, you will need to ensure that you meet the following prerequisites:

  • You must have a current MYOB Practice Management subscription.
  • You must have a current Active by Business Fitness subscription. This integration is not available during the trial period.
  • You must have administrator access to both MYOB Practice Management and Business Fitness Active accounts.
  • The user needs to have Admin rights to apply and they need to have the following API tokens assigned to them:


    For the same user, ensure the (Available license count) option is TICKED on the Employee Maintenance, user Security tab:


  • In MYOB Practice Management, all staff must have the following fields completed:    
  • Name (Active will split this into first and last name)
  • Email address
  • In MYOB Practice Management, all clients must have the following fields completed:
  • Client Name (or first name, last name)
  • Partner 
  • The above mentioned partner(s) must also exist in the Active Platform, and their email addresses should match those in MYOB Practice Management. We suggest manually adding the partner to the Active Platform before configuring the sync
  • If you are a single partner firm or a firm that does not allocate partners to clients in MYOB Practice Management, you now have the option to establish a 'default partner' in Active Platform. This ensures that in cases where a client has not been assigned a specific partner in MYOB Practice Management, the synchronisation will proceed using the default partner.
    • To set up a 'Default Partner,' go to Admin Centre -> Office, select the default partner from the list, Save and Close



To prevent duplications, please ensure that 

  • any clients set up directly in the Active Platform before enabling this integration have the same client code in Active as in MYOB Practice Management. 
  • offices created in Active should have the same Office Code as in MYOB Practice Management.

Supported fields

The MYOB Practice Management and Active Platform integration sync the following office, user and client fields.   


For Office

MYOB Practice Management field name

Business Fitness field name

Validation 

Name

Office Name

Required

Trading NameTrading NameRequired
CodeCodeOptional
EmailEmailOptional
AddressAddressOptional
TelephoneTelephoneOptional



For users

MYOB Practice Management field name

Business Fitness field name

Validation 

First Name, Last Name

First Name, Last Name

Required

Email

Email

Required

OfficeOfficeRequired
User CodeCodeOptional



After users have been added to the Platform, your Platform Administrator must include the following for users to access the Active Platform.                        

  1. Role
  2. Office
  3. Module


For clients

 

MYOB Practice Management field nameBusiness Fitness field nameValidation
CodeCodeRequired
TypeEntity TypeRequired
NameLegal NameRequired
ACNACNOptional
ABNABNOptional
Tax Branch NumberBranch NumberOptional
GroupClient GroupOptional
EmailContact Details – EmailOptional
Phone Contact Details – TelephoneOptional
FaxContact Details – FaxOptional
PartnerPartnerRequired
ManagerManagerOptional
OfficeOfficeRequired
Physical Address line 1Residential Address line 1Optional
Physical Address line 2Residential Address line 2Optional
Physical Address line 3Residential Address line 3Optional
Physical Address Town/CityResidential Address SuburbOptional
Physical Address Region/StateResidential Address StateOptional
Physical Address Post CodeResidential Post CodeOptional
Postal Address 1Postal Address line 1Optional
Postal Address 2Postal Address line 2Optional
Postal Address 3Postal Address line 3Optional
Postal Address Town/CityPostal Address SuburbOptional
Postal Address Region/StatePostal Address StateOptional
Postal Address Post CodePostal Address Post CodeOptional
Registered Address Line 1Registered Office Address line 1Optional
Registered Address Line 2Registered Office Address line 2Optional
Registered Address Line 3Registered Office Address line 3Optional
Registered Address Town/CityRegistered Office Address SuburbOptional
Registered Address Region/StateRegistered Office Address StateOptional
Registered Address Post CodeRegistered Office Post CodeOptional
Business Address Line 1Principal Place of Business Address line 1Optional
Business Address Line 2Principal Place of Business Address line 2Optional
Business Address Line 3Principal Place of Business Address line 3Optional
Business Address Town/CityPrincipal Place of Business Address SuburbOptional
Business Address Region/StatePrincipal Place of Business Address StateOptional
Business Address Post CodePrincipal Place of Business Post CodeOptional
First nameIndividual First NameRequired
Last nameIndividual Last NameRequired
Contact SalutationIndividual SalutationOptional


Setup

To set up the MYOB Practice Management and Active Platform integration, you will need to follow these steps:


1. Log in to the Active homepage and navigate to the ‘Admin Centre’ by clicking on your username.

 

2. In the Admin Centre, under the 'Firm', select Integrations.


 

3. In the ‘Integrations’ menu, select the MYOB Practice Management Configure button.


 

4. Update the sync name if applicable and click on the next step.

5. Enter the your MYOB Practice Manager URL

5. Click the Connect to MYOB Practice Manager button and enter MYOB Practice Management credentials. The user credential used for this process must need MYOB Practice Management Administration privileges. 

6. Click ‘Allow Access'.  Once the connection is successful, you will be redirected to the ‘Set up MYOB Practice Management Connection’ page. 


** If the 'MYOB Practice Manager Tenant' value is empty, please click on the drop-down menu and select the available connection.

 

7. Select the 'Default Office Code' from the dropdown. You can also set the 'Default Office Partner' here.


8. Under the 'Notification Settings' section, select a user from the dropdown menu. If the synchronisation between MYOB Practice Management and Active is disrupted, we will send email notifications to the selected user, a maximum of one notification per 24-hour period. 



Hit Submit, and you will receive a message as shown below.


 

Ready to start the sync? Click Start Sync to initiate the process.


Prefer to sync later? Simply choose the Later option. When you are ready, use the Start Sync button located at the top of the screen to initiate the sync.       

 

 

Frequency

The MYOB Practice Management and Active Platform integration sync data automatically every hour.


Error logs

The MYOB Practice Management and Active Platform integration generates error logs in case of any issues during the data sync process. You can access the error logs by going to Sync Monitoring (Admin Centre -> Firm -> Sync Monitoring) in Active and clicking on the MYOB Practice Management tab. The error logs provide details on the errors encountered during the sync process and suggestions for resolving the errors.



FAQ's

Question

Answer

How often does the MYOB Practice Management and Active Platform integration sync data?

The integration syncs user and client data from MYOB Practice Management to the Active Platform every hour.

What happens if there are errors during the data sync process?

The MYOB Practice Management and Active Platform integration generate error logs that provide details on the errors encountered during the sync process and suggestions for resolving the errors.

Can I choose which fields to sync?

No, it is a standard integration that syncs predefined fields listed in the 'Supported Fields' section of this article.

What should I do if I encounter issues with the MYOB Practice Management and Active Platform integration?

If you encounter any issues with the integration, you can contact Business Fitness support for assistance.

     

 

 

 

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.