Use this guide to identify and resolve common MYOB Business connection and export errors in HirePOS.

Find the exact error message or symptom in the tables below. Simple errors are resolved directly in the table, while errors needing additional checks are explained under the corresponding heading. Values such as an account code, Job name, or Invoice Number will vary.

If this message appears on secure.myob.com after clicking Connect, the error occurred during MYOB's authentication process before control returned to HirePOS.

1. Confirm that the MYOB user has Administrator access to the selected MYOB business.

2. Wait approximately 30 minutes.

3. Open the MYOB Exporter from HirePOS again.

4. Sign in, select the correct business, and click Connect.

There is generally no need to change the HirePOS accounting settings or company-file credentials for this error.

See MYOB - "Something went wrong and we couldn't connect the app" for more information.

The MYOB account authorisation and optional company-file credentials are separate.

1. Close the MYOB Exporter.

2. Open it again from HirePOS and sign in if prompted.

3. Confirm that the correct MYOB business is connected.

4. If the exporter opens but MYOB requests still fail, click the padlock beside Refresh.

5. Check the Company File User Name and Password. Leave the password blank if the company file does not have one.

Go to Setup > Preferences > Accounting and confirm that MYOB Business is selected.

If user restrictions are enabled, the HirePOS user must also have permission to use accounting synchronisation. Ask an administrator to review the user's restrictions if the launch option remains unavailable.

These include:

• SerializationError - Error converting value {null} to type 'System.Guid'. Path 'Lines[0].Account.UID'

• No matching MYOB Account Code for [code]

• SerializationError referring to Lines[*].Account.UID

Every invoice line needs an income account code that exactly matches an MYOB account number.

Click the Invoice Number in the exporter to preview the invoice and review the account selected for each line. HirePOS chooses the account code in this order:

1. Invoice Category

2. Selling Unit

3. Item

4. Item Category

5. Item Type

6. The applicable group item's category or type for a group-code line without an item

The first available code is used. A higher-priority code can override the Item Category or Item Type.

Correct the code in the applicable setup record, then transfer the invoice again.

For a free-typed line without an Item Code, replace the line with a configured HirePOS item where practical. For an applicable group-code line, check the related group item category and type.

These include:

• No matching MYOB Tax Code for [code]

• SerializationError referring to Lines[0].TaxCode.UID

Open the HirePOS invoice and confirm that every line has a valid Tax Code. Go to Setup > Tax Codes and confirm that the corresponding code also exists in MYOB.

Correct any missing or mismatched value, then transfer the invoice again.

An MYOB Tracking Category linked to the invoice's item or branch contains a Job number that cannot be found in MYOB.

1. Check the MYOB Tracking Category assigned to the affected item.

2. Check the MYOB Tracking Category assigned to the invoice branch.

3. Confirm that its Job number exactly matches an existing MYOB Job number.

4. Correct the Job number or clear the tracking category if it is not required.

Item tracking takes priority over branch tracking.

Tracking records are configured under Setup > Preferences > Accounting > MYOB Tracking Categories (Jobs).

Errors such as the following have previously been associated with customer names, codes, contact details, or invoice descriptions that MYOB could not accept:

• 16 - QueryParseException - Syntax error

• ValidationError - Identifier:(Card)

• Object variable or With block variable not set

• ValidationError - Lines:(ReceivePaymentEvent)

Inspect the customer and invoice for unusual punctuation or symbols, particularly in names, codes, contact details, and descriptions. Correct the affected value and try again.

Quotation marks, apostrophes, ampersands, and hash symbols have caused these errors in some cases, but do not remove valid customer information unnecessarily. If the problematic value is not apparent, capture the complete error and contact HirePOS Support.

This is a general error and can have more than one cause.

Check that:

• the correct MYOB business is connected;

• the Company File Password is correct, or blank if the company file has no password;

• the customer has usable identifying details; and

• every invoice line has a valid account code and tax code.

If the error continues, send HirePOS Support the complete error, the Invoice Number, and a screenshot with the browser address visible.

When Export Approved Invoices Only is enabled, unapproved invoices display as Not Approved and cannot be selected.

Approve the invoice in HirePOS, then refresh the exporter.

If the HirePOS Draft/Approved invoicing restriction is enabled, the exporter setting is forced on and cannot be switched off. An administrator can review the restriction under Setup > Preferences > Restrictions, but it should not be disabled merely to bypass the approval workflow.

Payment export uses Account Code from Setup > Bank Accounts.

The code must exactly match the MYOB account number or Display ID for the asset or bank account receiving the payment.

If the field is blank, the exporter may show No Account Code!. If the code is missing or invalid in MYOB, errors can include:

• Account Code does not match any MYOB Account Numbers

• AccountNotValid

Correct the HirePOS Bank Account code, then transfer the payment again.

MYOB must contain the related invoice before HirePOS can apply a payment to it.

1. Export the invoice first.

2. Confirm that it exists in MYOB.

3. Check whether the exporter Prefix has changed since the invoice was exported.

4. Transfer the payment again.

Payment export is unavailable when Use MYOB Invoice Number Sequence is enabled because MYOB assigns a different Invoice Number.

Purchase Orders cannot be exported without a Supplier Code. If the code is missing, open the supplier in HirePOS, enter a unique Supplier Code, and save the supplier.

For expense account errors, Purchase Order lines select the MYOB expense account in this order:

Purchase Order lines select the MYOB expense account in this order:

1. Setup > Item Related > Item Categories > MYOB Expense Code

2. Setup > Item Related > Item Types > MYOB Expense Code

The selected code must exactly match an MYOB account number or Display ID.

MYOB must contain tax codes FRE and GST for Purchase Order export.

The exporter uses FRE when the HirePOS order-line tax amount is zero and GST when it is non-zero.

If an order is not listed, confirm that it is not cancelled and has been received, fully or partially. Also confirm that the export Date From and Date To include its received date.

Mark As Completed and Mark As Pending only change the HirePOS export marker.

They do not create, delete, void, or update records in MYOB.

Before exporting a record that was changed back to pending, confirm whether it already exists in MYOB and whether the current Prefix still matches it. If the exporter cannot identify the original MYOB record, another transfer may create a duplicate.

Contact HirePOS Support if the suggested resolution does not work or the error does not appear in this guide.

Include:

• the complete error message;

• the affected Invoice Number, payment, or Purchase Order number;

• what you were transferring; and

• a screenshot showing the error and browser address bar.