# Configuring the Integration

Source: https://docs.astalty.com.au/guide/integrations/myob-integration/configuring-the-integration

> Set the default income account, map Charge Items to MYOB income accounts and cost codes to MYOB Jobs, and choose how invoices sync.

Choose the default income account, map Charge Items and cost codes, and set how invoices sync to MYOB.

## Configuration

You need a valid MYOB configuration for the integration to work. Open **Settings → Integrations → [MYOB](https://app.astalty.com.au/settings/integrations/myob)**: the **Overview** shows the **Company File**, **Connection**, **Default Income Account** and **Automatic Invoice Sync**.

![MYOB Integration Settings showing the company file Sunrise Community Care, Connection Connected, Default Income Account 4-5100 and Automatic Invoice Sync Enabled](https://docs.astalty.com.au/assets/myob-integration-settings.png)

Click **Edit** to open **Update MYOB Integration Settings**.

#### Default Income Account

Astalty doesn't sync any invoice to MYOB until a default income account is chosen. Until then the page shows **Default Income Account Needed**, finalised batches aren't sent, and the person who finalises one is emailed *We couldn't sync your invoices with your accounting platform*. Those batches aren't sent later on their own: after choosing the account, use **Sync with accounting** on each one.

![The MYOB Overview, marked Setup incomplete, with the Default Income Account Needed notice and its Choose Account button above Default Income Account Not chosen](https://docs.astalty.com.au/assets/myob-default-income-account-needed.png)

1. Click **Edit**, or **Choose Account** on the notice.
2. Choose the **Default Income Account**.
3. Click **Update**.

![Update MYOB Integration Settings with Default Income Account 4-5100 - Support Services Income chosen and Sync invoices automatically ticked](https://docs.astalty.com.au/assets/myob-edit-settings.png)

The list holds the company file's active income and other income accounts. Each invoice line uses its Charge Item's own income account, or this one when the Charge Item has none.

#### Sync Invoices Automatically

On by default. Each Invoice Batch is sent to MYOB as soon as you finalise it, and each invoice arrives in MYOB open and payable.

Untick **Sync invoices automatically** in the **Edit** drawer to send batches yourself instead, with **Sync with accounting** on the finalised batch. See [Sync With MYOB](https://docs.astalty.com.au/guide/integrations/myob-integration/sync-with-myob).

## Advanced Settings

In the **Edit** drawer, click **More**.

![The More section with the Plan Managed invoice contact set to Plan Manager and Send NDIA invoices unticked](https://docs.astalty.com.au/assets/myob-edit-settings-more.png)

### Changing the Invoice Contact

**Who should we use to create invoices for Plan Managed invoices?** decides which MYOB customer card a plan managed invoice is raised against: **Plan Manager** (the default, and Astalty's recommendation) or **Participant**.

### Send NDIA Invoices

**Send NDIA invoices** sends NDIA managed invoices to MYOB alongside your plan and self managed ones. It is off by default, and Astalty recommends leaving it off.

With it off, NDIA managed invoices never reach MYOB. You reconcile the NDIA batch in Astalty against the receipt file, which tells you how much the NDIA paid, and record that total in MYOB as a single **Receive Money** transaction. See [Reconciling NDIA Payments](https://docs.astalty.com.au/guide/finance/payments/reconciling-ndia).

#### Why NDIA Invoices Are Kept Out of MYOB

Astalty reconciles NDIA claims line by line from the receipt file, which is the only thing that matches how the NDIA actually pays:

- **The NDIA rejects claims individually.** An invoice commonly comes back part paid, with the rejected charges fixed and re-claimed in a later bulk upload file. The invoice in MYOB keeps showing its full amount until every line has been paid, across however many attempts that takes.
- **A claim can come back OPEN**, then be paid in a later deposit, splitting one invoice across two receipt files.
- **Nothing reconciles itself.** Astalty never brings a MYOB payment back onto an NDIA managed invoice, whatever this setting says, and payments never travel from Astalty to MYOB. Turning it on means reconciling twice: once in Astalty from the receipt file, and again by hand in MYOB.
- **Every NDIA invoice uses one customer card.** Astalty creates them in MYOB against a single card named **NDIA**, so one deposit covering a whole batch has to be split across those invoices by hand.

> **Turning it on doesn't backfill**
>
> Only invoices that haven't reached MYOB yet are sent, and a batch that has finished syncing is never offered for syncing again. NDIA managed invoices in batches you have already synced therefore stay out of MYOB for good. Contact Astalty support if you need one of those batches reset so they can be sent.

## Charge Item Settings

#### Income Account

Click **Charge Items** in the MYOB menu. **Charge Item Mapping** lists every Charge Item, archived ones included, with its **Income account**. A Charge Item showing **Not mapped** uses the default income account, and a notice above the list counts how many do. Without the Scheduling add-on, Charge Items that belong to a Charge Item Set aren't listed.

![Charge Item Mapping listing Charge Items as Not mapped, below a notice that 69 charge items use the default income account, 4-5100](https://docs.astalty.com.au/assets/myob-charge-items.png)

1. Click the menu on a Charge Item's row, then **Edit**.
2. Choose the **Income account**.
3. Click **Update**.

![Update Charge Item Mapping for Provider Travel (ASC\_KM\_NOT\_DURING) with income account 4-5400 - Provider Travel Income chosen](https://docs.astalty.com.au/assets/myob-charge-item-edit.png)

Filter **Mapping** by **Not mapped** to find the Charge Items still using the default.

#### Tax Codes

Each line's MYOB tax code comes from the Charge Item's **GST Code**. There is nothing to map.

| GST Code | MYOB tax code |
| -------- | ------------- |
| P1       | GST           |
| P2       | FRE           |
| P5       | N-T           |

The company file must have each tax code your Charge Items use, and always **GST**, which Astalty sets on every customer card it creates.

## Cost Codes and MYOB Jobs

If you use [Cost Codes](https://docs.astalty.com.au/guide/finance/cost-codes), you can map each one to a MYOB Job. An invoice line for a support with a mapped cost code carries that Job into MYOB.

Mapping a Job needs permission to update both Settings and cost codes.

1. Click **Cost Codes** in the MYOB menu.
2. Click the menu on a cost code's row, then **Edit MYOB Job Mapping**.
3. Choose the **Job**.
4. Click **Update**.

![MYOB Job Mapping for the Administration cost code with Job ADMIN - Administration chosen](https://docs.astalty.com.au/assets/myob-cost-codes.png)

The list holds the company file's active Jobs. Only a support's cost code sets a Job, never its Charge Item, so a line whose support has no cost code (or an unmapped one) carries no Job. **Cost Codes** appears in the MYOB menu only when cost codes are turned on in [Scheduling Settings](https://docs.astalty.com.au/guide/scheduling/setup/scheduling-settings). The same **Edit MYOB Job Mapping** option is on **Settings → Scheduling → Cost Codes**.

## Invoice Number Prefix

MYOB keeps an invoice number of at most 13 characters. Astalty numbers invoices as prefix, batch number (3 digits) and invoice number (4 digits), so `ABC-001-0001` is 12.

While you invoice through MYOB, a new invoice number prefix can have at most 3 letters or numbers. Change it in [Invoice Settings](https://docs.astalty.com.au/guide/settings/invoices-settings).

The numbers grow past their padding: batch 1000 or invoice 10000 adds a character. A 1- or 2-character prefix leaves more room. An invoice number over 13 characters doesn't sync.

> **Check a prefix you set before connecting MYOB**
>
> A longer prefix saved before you connected MYOB is kept as it is. An invoice whose number is longer than 13 characters doesn't sync: *MYOB stores an invoice number of at most 13 characters and "…" is longer. Shorten the invoice number prefix.* Shorten the prefix before you finalise your first batch.
