> ## Documentation Index
> Fetch the complete documentation index at: https://help.visualcare.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

# MYOB integration

> Connect Visualcare to MYOB AccountRight or Advanced for invoice and payroll export

Visualcare integrates with MYOB AccountRight and MYOB Advanced via API to export client invoices and worker payroll data. Once connected, you map Visualcare services to MYOB accounts and export on demand from the Data Export area.

## Connecting to MYOB

<Steps>
  <Step title="Open accounting software settings">
    Go to **Settings** → **Data Export** → **Accounting Software**.
  </Step>

  <Step title="Select MYOB as the export target">
    Choose the MYOB option from the **Invoice Export** and/or **Timesheet Export** drop-downs, depending on what you want to export. Click **Save**.
  </Step>

  <Step title="Authorise the connection">
    Click the **Authorise** button and follow the prompts to connect to your MYOB company file. You'll need your MYOB login credentials and the company file details.
  </Step>

  <Step title="Verify the connection">
    Once connected, the settings page shows the connected MYOB company file. Check the details to make sure the right file is linked.
  </Step>
</Steps>

## Setting up for export

Before exporting, make sure the following are configured:

### Client accounting codes

Each client needs an **Accounting Code** set on their profile so Visualcare knows which MYOB customer to send invoices to. Open the client profile and select the code from the **Accounting Code** drop-down.

### Service accounting codes

Services in **Maintenance** → **Services** need accounting codes mapped to the correct MYOB accounts. This controls how invoice line items are categorised in MYOB.

### MYOB jobs (optional)

If your organisation uses MYOB jobs to track costs by project or funding type, map the relevant job to each service or agreement. Missing job mappings cause export errors.

### Worker accounting codes

For payroll exports, each worker needs an **Accounting Code** on their profile linking them to the corresponding MYOB employee or supplier contact.

<Tip>After setting up or changing contacts in MYOB, use the **Sync** buttons under **Settings** → **Data Export** to pull the latest MYOB data into Visualcare's drop-downs.</Tip>

## Exporting data

### Invoices

Navigate to **Timesheets** → **Data Export** and select the invoice export option. Choose the date range and any filters, then click **Export**. Visualcare sends the invoice data to MYOB via the API connection.

### Payroll

Navigate to **Timesheets** → **Data Export** and select the timesheet export option. Choose the pay period and click **Export**. Timesheet data is sent to MYOB for payroll processing.

## Common export errors

| Error                                      | Cause                                                                                            | Fix                                                                                                   |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------- |
| No Client Accounting Code                  | The client profile doesn't have an accounting code set                                           | Open the client profile and select an accounting code from the drop-down                              |
| No Service Accounting Code                 | A service used on the shift doesn't have an accounting code mapped                               | Go to **Maintenance** → **Services**, find the service, and add the accounting code                   |
| MYOB Job is missing                        | The export expects a MYOB job but none is mapped                                                 | Map the correct MYOB job to the service or agreement                                                  |
| No Client Payer Accounting Code            | The payer linked to the client or agreement is missing an accounting code                        | Open the payer profile in **Maintenance** → **Payers** and set the accounting code                    |
| FAIL Error converting value to System.Guid | A data mismatch between Visualcare and MYOB, usually caused by a deleted or renamed MYOB contact | Re-sync contacts from MYOB and re-select the accounting code on the affected profile                  |
| EXEMPTOUTPUT error                         | A GST configuration issue on the MYOB side                                                       | Check the tax code settings on the relevant MYOB account and make sure they match the expected output |

## Running into issues?

See [Integration troubleshooting](/troubleshooting/integration-issues) for common errors and fixes.

## Related articles

<CardGroup cols={2}>
  <Card title="Xero integration" icon="building-columns" href="/integrations/xero">
    Connect Visualcare to Xero for invoice and payroll export
  </Card>

  <Card title="Billing to accounting software" icon="file-invoice-dollar" href="/finance/billing-to-accounting-software">
    Overview of accounting software export options
  </Card>

  <Card title="Supported integrations" icon="puzzle-piece" href="/integrations/matrix">
    Full list of integrations supported by Visualcare
  </Card>
</CardGroup>