View source for Connecting Wageloch to MYOB Advanced

Once your company file is configured correctly and ready to link, you will need to authenticate Wageloch with the MYOB Advanced company file.

Completing the connection process is fairly simple, and should only need to be completed once.

==Required Credentials==
* Open <b>https://app.wageloch.com.au</b> and go to <b>Settings >> Payroll >> Connection.</b>
* Click on the <b>Store</b> name to open the configuration window.
* You will be presented with a screen requesting MYOB Advanced information.
* To obtain these details, we need to add Wageloch as a <b>Connected Application</b> through MYOB Advanced.

[[File:Settings-payroll-connection.png|300px]]  [[File:MYOBAD-connection-settings.png]]


==Create Connected Application==

* Open <b>MYOB Advanced</b> in a web browser and sign in.
* Copy the URL in your address bar at the top of the page into a notepad document or similar, removing any text after ".com"
** You should have a URL that looks like this:
[[File:URL.png]]


Now you're signed in to MYOB Advanced, we will need to create a set of API credentials.

* Go to <b>More Items</b> from the left menu and select <b>Integration >> Connected Applications.</b>
* You will then be presented with fields for Client ID, Client Name, OAuth 2.0 Flow.

* Fill the fields out as follows:
** <b>Client Name:</b> Wageloch
** <b>OAuth 2.0 Flow:</b> Authorization Code

* Click the <b>Save</b> icon <i>(floppy disk, top left)</i>
* Once saved, the <b>Client ID</b> field will populate with a generated Client ID; copy and paste this into a notepad document.


[[File:Myob-advanced-connections.png|725px]] [[File:MYOBAD-connected-apps.png|600px]]
 

* Click on <b>Add Shared Secret</b>, and a new window will be displayed as follows.
* In the <b>Description</b> field, type <b>Wageloch</b>
* Copy the text in the <b>Value</b> field and paste it into your notepad document.
* Click OK.


[[File:MYOBAD-shared-secret.png|675px]]

* You'll be taken back to the <b>Connected Applications</b> window.
* Click on the <b>Redirect URIS</b> tab and paste the following API link into the field next to the asterisk: <b>https://apiroute.wageloch.com.au/myobadvanced</b>
* Click the <b>Save</b> icon in MYOB.


[[File:MYOBAD-connected-apps.png|675px]]


==Access to API License==

We need to make sure that MYOB User profiles have access to the API license. 

* Log into <b>MYOB Advanced</b>
* Select <b>More Items</b> from the left menu
* Select <b>User Security >> User Management >> Users</b>



* Use the <b>magnifying glass</b> in the <b>Login</b> field to choose the active User profile that is/will be linked to Wageloch
* Pick the <b>LICENSE TYPES</b> tab
* Ensure <b>Full User</b> is ticked 
* Ensure either <b>Full User (Full API)</b> or <b>Limited API</b> are also ticked. 
** Most users will have <b>Limited API</b> selected by default; this is acceptable and will provide the correct level of access to API Licenses.
** Users marked with <b>Full User (Full API)</b> likely use MYOB extensively with other product suites which require higher levels of access.
** <b>NOTE:</b> If the “Available” column shows no available licenses, they need to either use a different User profile with these licenses enabled OR they need to contact MYOB Advanced to have an API license made available:

* Make sure that you are logged in as the user in MYOB Advanced <i>before</i> trying to link to MYOB.
<br>
<br>

==Enter MYOB Credentials into Wageloch==
* Go back to Wageloch where your MYOB Advanced Settings window should still be up.
* Get your notepad document ready!
* Fill out each field with the information from the notepad as follows:

** <b>Store Name:</b> Can be anything, but it must contain something
** <b>API URL:</b> https://yourbusinessnamehere.myobadvanced.com
** <b>Client ID:</b> The Client ID you copied from the Connected Applications window in MYOB Advanced
** <b>Client Secret:</b> The value you copied from the Add Shared Secret window in MYOB Advanced.


[[File:MYOB-Advanced-Credentials.png|600px]]


==Authorize Wageloch in MYOB Advanced==
* Click on the <b>Link to MYOB</b> button.
* You will asked to finish authorizing Wageloch to have access to MYOB Advanced.
* Click on <b>Yes, Allow</b> and close the tab.


[[File:MYOBAD-auth.png|675px]]

* Click OK to confirm the MYOB authorization is complete.
* You should now see your MYOB Advanced file is connected! 
* Click Done to finish.


[[File:MYOBAD-auth-complete.png|600px]] [[File:MYOBAD-connection-fin.png|750px]] 

 










[[File:Back-button-new.png|link=MYOB Advanced Configuration]]  [[File:Home-button-new.png|link=Main Page]]  [[File:Topic-button-new.png|link=https://wiki.wageloch.com.au/index.php?title=MYOB_Advanced]] [[File:Next-button-new.png|link=MYOB Payroll Mappings]]