Import Application for MYOB User's Guide

MYOB® is an accounting package that including payroll, job costing and stock control features.

You can use the Import Application for MYOB to import data from ServiceCEO into MYOB. This will be a one way import of data from ServiceCEO to XML to MYOB. No data will be sent from MYOB to ServiceCEO.

Insight Direct has developed this tool for ServiceCEO customers all around the world, including those in Australia and New Zealand. Currently, the Import Application only works with versions of MYOB for Australia and New Zealand. In the future, we hope to offer versions for other countries.

Table of Contents

Overview of the Import Process
Installing Overview
     Prerequisites
     Installing MYOB ODBC Direct
     Installing the Import Application for MYOB
          Troubleshooting the Activation
     Deploying the Import Application for MYOB on a Network
     Upgrading the Import Application for MYOB
Importing Data in MYOB
     How will Imported Data Appear in MYOB?
          Sales
          Deposits
          Purchase Orders
          Payroll
Known Issues
Troubleshooting
Feedback

Overview of the Import Process

ServiceCEO/MYOB integration involves three major components:

  1. ServiceCEO 6.1+
  2. MYOB
  3. Import Application for MYOB

The basic workflow is:

  1. Data is exported from ServiceCEO using XML Integration. For an overview of ServiceCEO's Accounting/XML integration, see the XML Integration section of the ServiceCEO Help System.
    All of the exported XML files will be sent to the folder configured during the accounting integration setup.
  2. The Import Application for MYOB polls the XML export folder for new information every two minutes.
  3. If any new files are located in the directory with a .xml extension, the Import Application for MYOB attempts to import them into MYOB. This process involves the Import Application for MYOB performing several steps:
    1. Opening the .xml file(s)
    2. Parsing the .xml file(s)
    3. Inserting or updating the MYOB database with the data from the XML file
  4. After a file is processed, the Import Application for MYOB renames the extension of the file from .xml to .xml.processed.
  5. The ServiceCEO data from all successfully imported .xml files appears in MYOB.

Installing Overview

Prerequisites

In order for the Import Application for MYOB to work correctly:

Back to Top

Installing MYOB ODBC Direct

To fully utilize MYOB ODBC Direct, you must first register your MYOB accounting software. If you are using any of the following products, you will also need to activate your company files before accessing them using MYOB ODBC Direct:

You will need to have your MYOB accounting product serial number close by to complete the ODBC activation process.

When you call MYOB to activate your software, you will also need to activate the MYOB ODBC component using the ServiceCEO “Add On Solution Number.” This number is 5,005,634.

In Australia, you can contact MYOB by calling 1-300-555-111. In other regions, please contact your local MYOB support team for pricing details.

You can test MYOB ODBC on the Clearwater sample company file at no charge, so you can verify that the driver suites your needs. The Clearwater file is included in all MYOB business management software test drives.

You can download MYOB ODBC Direct here: http://d2d.myob.com.au/downloads/ODBC%20v6/AU_ODBCv6.0.13.zip

Detailed MYOB ODBC Direct installation instructions are located on page three of the Australian MYOB ODBC Direct Installation Guide (PDF): .

Back to Top

Installing the Import Application for MYOB

  1. Double-click setup.exe. The InstallShield Wizard appears.

  1. Click Next. The License Agreement page appears.

  1. Select the I accept the terms in the license agreement option button.
  2. Click Next. The Destination Folder page appears.

  1. By default, the Import Application for MYOB will be installed in the C:\Program Files\Insight Direct\Import Application for MYOB\ folder. If you want to change the installation location:
  2. Click Next. The Confirm Installation page appears.

  1. Click Next. The Import Application for MYOB will be installed. The installation may take a few minutes; please be patient. The InstallShield Wizard Completed page will appear when everything has been installed.

  1. Click Finish. The wizard will close. The first time you open the Import Application for MYOB, the Activate License page appears.

To activate your license, enter your information into the appropriate fields:

  1. Type the name of your company's contact into the Contact Name field.
  2. Type the contact's email address into the Email field.
  3. Type the name of your company into the Company Name field.
  4. Type your address into the Address field.
  5. Type your city into the City field.
  6. Type the abbreviation of your State into the State field.
  7. Type your Postal Code into the Postal Code field.
  8. Click Activate. The Import Application for MYOB will contact Insight Direct over the internet to verify your license data is correct. If successful, a License Activated dialog box appears.
  9. Click OK. The Options tab of the Import Application for MYOB appears.

In this dialog box, you need to define your MYOB data so that the import application knows where MYOB is located and how to log in.

  1. Indicate the location of your XML export folder in the XML Folder field. This field should contain the same value as the Save Exported Files in Folder field in ServiceCEO's Company Information dialog box.To do so:
    1. Click Browse.... The Browse for Folder dialog box will appear.
    2. Navigate to and select the XML folder on your computer.
    3. Click OK. The location will appear in the XML Folder field.
  2. Point to the MYOB data file location in the MYOB Data File field. To do so:
    1. Click Browse.... The Browse for Folder dialog box will appear.
    2. Navigate to and select the MYOB data file.
    3. Click OK. The location will appear in the MYOB Data File field.
  3. Point to the MYOB exe file in the MYOB Executable field. To do so:
    1. Click Browse.... The Browse for Folder dialog box will appear.
    2. Navigate to and select the MYOB.exe file .
    3. Click OK. The location will appear in the MYOB Executable field.
  4. By default, the Import Application for MYOB is configured to log in to MYOB as the Administrator. To change this logon, type the user name in the MYOB Username field.
  5. Type the MYOB password in the MYOB Password field.
  6. Click Save Settings.
  7. Click Hide Window. The Import Application for MYOB will minimize, and run in your computer's task bar. You can open it again at any point by double-clicking on the MYOB pig icon:

Note that you can stop and close the Import Application for MYOB at any time by clicking Stop Application.

Back to Top

Troubleshooting the Activation

If your license is not successfully activated, some possible reasons might be:

Deploying the Import Application for MYOB on a Network

In a multi-user and/or multi-computer environment, we recommend that you, if possible, designate a single user and single computer that will export all XML files from ServiceCEO (Export Sales, Deposits and Purchase Orders). ServiceCEO should be configured to send its XML to a folder on the local computer. Install both MYOB and the Import Application for MYOB on this computer, and all of the imports to MYOB will take place on this computer as well.

If it is NOT possible to designate a single user/computer to export the XML files, configure ServiceCEO so that all XML files are being sent to a shared folder on your network. All users must have write access to this folder. Install MYOB and the Import Application for MYOB on a single computer, and point the Import Application for MYOB to the shared network folder. In this configuration, multiple users/computers can export data to XML, but only one computer will import those files into MYOB.

Back to Top

Upgrading the Import Application for MYOB

To upgrade the Import Application for MYOB:

  1. Download the Import Application for MYOB installer.
  2. Double-click the .exe file. A notification message appears, asking you if you want to upgrade the Import Application for MYOB.
  3. Click Yes. The InstallShield Wizard appears.
  4. Click Next. The Import Application for MYOB will start to upgrade. This may take a minute.
  5. Click Finish. The Import Application for MYOB is upgraded!

Back to Top

Importing Data in MYOB

Once the Import Application for MYOB is installed, it will continually run in your system tray. Every two minutes, it will scan the XML Export folder and, if it finds any XML files, will attempt to import them into MYOB. See the Overview of the Import Process for details.

All import information data is stored in the Log tab of the Import Application for MYOB.

How will Imported Data Appear in MYOB?

Since the MYOB/ServiceCEO integration is one sided (data is only sent from ServiceCEO to MYOB), ServiceCEO is your system of record for all receivables and customers. If you need detailed receivables or customer data, you will find it in ServiceCEO, not in MYOB.

In general, ServiceCEO data is imported into MYOB as a General Journal Entry, rather than a more complex MYOB record (like a Customer Card or Invoice), in order to avoid the complications that arise when trying to synchronize complex customer, invoice, and inventory records between two separate systems.

After importing accounting data from ServiceCEO via the Import Application for MYOB, MYOB will contain high-level figures for the following accounts on your balance sheet:

The following Profit & Loss (P&L) accounts will be updated by the General Journal Entries so that they reflect overall sales figures from ServiceCEO.

Additional details of how data from ServiceCEO appears in MYOB are outlined in the following sections:

Sales
Deposits
Purchase Orders
Payroll

Back to Top

Sales

A ServiceCEO invoice and, if applicable, its associated inventory are imported as a General Journal Entry.

Account adjustments and inventory adjustments entered in ServiceCEO will appear in a similar format.

Sales figures from ServiceCEO appear on all MYOB reports except for those in the Sales section, since MYOB Sales reports only account for actual Invoices in MYOB. Reports on other tabs such as Accounts and GST/Sales Tax will include all Journal Entries representing ServiceCEO invoices.

Two important things to note about sales figures are:

Back to Top

Deposits

Payments exported via ServiceCEO's Deposits tab are imported as General Journal Entries.

This Journal Entry was made directly against General Cheque Account 1, but ServiceCEO can also be configured to import its data into a Undeposited Funds account where it can be grouped with other items already in MYOB. At a later date, you can batch the items together using MYOB’s Prepare Bank Deposit screen.

Deposits will populate the General Journal # field using the format “CD1234”, short for “ServiceCEO Deposit #1234”.

Back to Top

Purchase Orders

ServiceCEO’s Purchase Orders (PO) are imported into MYOB as Miscellaneous Purchases. This means that inventory counts are not directly affected in MYOB, which is to be expected, given that ServiceCEO is the system of record for inventory. However, entering POs as miscellaneous purchases updates the Inventory Asset account on your MYOB balance sheet.

The purchase is entered against an MYOB Supplier record. If the import tool cannot locate an MYOB Supplier with a name matching the Vendor record in ServiceCEO, it will create a new Supplier Card in MYOB with the appropriate name.

Once the Miscellaneous Purchase is entered into MYOB, you can pay your supplier using MYOB’s Pay Bills functionality.

Two notes here:

Back to Top

Payroll

ServiceCEO computes and exports gross payroll figures. Unfortunately, MYOB can only import very basic Timesheet data (the number of hours worked on each day). Although this might allow us to export very basic information such as hourly pay worked at a single rate, it would not allow us to export:

For these reasons, the Import Application for MYOB does not import any payroll data into MYOB at this point in time.

Back to Top

Known Issues

MYOB field lengths only allow ServiceCEO to export records with identifiers less than 1,000,000. So, for example, you will not be able to export invoice number 1000000. If your business requires the import utility to support larger invoice numbers, please contact Technical Support to log a feature request.

Troubleshooting

If an error is generated when importing an XML file into MYOB, it will not be imported, nor will its extension be changed from .xml to .xml.processed. To attempt the import again, you need to stop and restart the Import Application for MYOB, or rename the file for it to be processed.

Feedback

Please send any feedback about this document to documentation@insightdirect.com. Please note that this email will not go to Technical Support. To receive technical support, please enter a support ticket by logging into the member center at http://www.insightdirect.com/support.html and clicking the Log a New Support Ticket link.

ServiceCEO is a registered trademark of Insight Direct, Inc. in the U.S. and/or other countries. Other parties' marks are the property of their respective owners and should be treated as such.