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

# QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum

export const InlineImage = ({src, alt = "", height = "1.6em"}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: "inline",
    verticalAlign: "start",
    height: height,
    margin: "0"
  }} />;
};

# Purpose

The purpose of this quick reference guide is to step through the process of defining the Payee Opening
Balances. The intended audience for this document is Standard Users.

# Steps

### Create Payee Opening Balances - Payment

To create a Payee Opening Balance record:

1. Go to the **Payee** record.

   1. To identify a Payee record from an Employee record, enter the Employee name into the
      Global Search (see Figure 1).

   <Frame>
     <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-0-figure-1.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=8ce766ebb81558ca736d248fe60e2edc" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="208" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-0-figure-1.png" />
   </Frame>

   2. Select the Employee record from the suggestions provided.
   3. Open the Related tab (see Figure 2).
   4. Identify the Payee related list.
   5. Select the Payee record.

   <Frame>
     <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-0-figure-2.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=4f183f1ea2a7964d95a6bf5272eaaa12" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="492" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-0-figure-2.png" />
   </Frame>

2. Within the Payee record, click on the **More** button (see Figure 3).

3. Click on **Opening Balances** .

<Frame>
  <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-1-figure-3.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=67aac33f550f8bc78c6e20e35ec47670" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="548" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-1-figure-3.png" />
</Frame>

4. In the Payee Opening Balances tab, click on the **New** button (see Figure 4).

<Frame>
  <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-1-figure-4.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=a31c99be6bc9adff3d60da027b51a0ec" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="392" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-1-figure-4.png" />
</Frame>

5. To create a Payee Opening Balance record, select either the **Allowance**, **Lump Sum**, or **Payment**
   Record Type as required (see Figure 5).
6. Click **Next.**

<Frame>
  <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-2-figure-5.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=6719bf5c26b9d5f6f2d12f045af7a087" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="902" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-2-figure-5.png" />
</Frame>

7. Populate the following required fields to provide the base details of the Payee Opening Balance
   record: (see Figure 6)
   1. **Payee**
   2. **Employee**
   3. **Effective Date**
   4. **Status**
   5. **ATO Income Classification**
   6. **Pay Code**
   7. **MTD Units, QTD Units, YTD Units**
   8. **MTD Value, QTD Value, YTD Value**

<Note>
  **Important Notes**\
  *(Page 4)*

  The Status must be entered as Confirmed which creates a Pay Batch Event, and automatically
  populates the fields of Pay Batch Event and Pay Batch Event Processing Status upon saving this
  Record. Ensure that the Payee Opening Balance records are processed in a Pay Batch so that they are
  included in the Payee Aggregate Records.
  The correct Effective Date must be populated, otherwise, it can't be picked up in a Pay Batch to be
  included in the Payee Aggregates for a Pay Code for an Employee.
</Note>

8. Populate the following optional fields as needed:
   1. If the ATO Income Classification is an Approved Working Holiday Maker, Inbound
      Assignee to Australia, or Foreign Employment Income, populate the field **Country of**
      **Work/Visa** with the relevant country from the list available. This should match the details
      provided in their PAYG Payee Withholding Record.
   2. To indicate that this Payee Opening Balance record will be used only during the Pay
      Batch calculations, but not included in the Finalisation process, tick the optional **Exclude**
      **from Finalise** checkbox. This would normally be populated when the Payee has a Payee
      Withholding Rule for the PAYG record type. This record will be used in the calculation of
      YTD earnings for Working Holiday Maker PAYG and also for observing superannuation
      caps during Pay Batch calculations.
   3. If you selected the Lump Sum Record Type and wish to populate the Financial Year End
      Date applicable to this Lump Sum E payment, populate the **Lump Sum E Year End Date**
      field.
9. Click on the **Save** button.

<Frame>
  <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-4-figure-6.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=e2b22432862f140b7402053461eb07e9" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="1064" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-4-figure-6.png" />
</Frame>

10. A new Payee Opening Balance Record has been created (see Figure 7).

<Frame>
  <img src="https://mintcdn.com/2cloudnine-2edf05eb/smuhLCeRVopY-I_w/images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-5-figure-7.png?fit=max&auto=format&n=smuhLCeRVopY-I_w&q=85&s=74ee2437b7804d9aa6e5b345611ed380" alt="Screenshot from QRG Define Payee Opening Balances - Allowance, Payment, and Lump Sum" width="976" height="508" data-path="images/generated/reference-guides/data-set-up-and-creation/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-pdf-5-figure-7.png" />
</Frame>

<Note>
  **Important Notes**\
  *(Figure 7)*

  If you try to delete a Payee Opening Balance that has been included in a Pay Batch, you will receive
  an error message ‘ERROR: You cannot delete a Payee Opening Balance when it has been included in
  a Pay Batch.’
</Note>

11. To modify an existing **Payee Opening Balance** record, open the required record and
    select the **Edit** button available on the top right side of the page. You can also
    double-click in any of the fields that need editing, or just click on the pencil icon <InlineImage src="/images/icons/qrg-define-payee-opening-balances-allowance-payment-and-lump-sum-inline-5-1.png" alt="Inline icon" />
    that appears within fields when you move your cursor over the field.

12. When complete, click on the **Save** button.

# Field Descriptions

| Field Name                         | Description                                                                                                                                                                                                                                                                                                              |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **ATO Income** **Classification**  | This is the associated ATO Income Classification for this Opening Balance.                                                                                                                                                                                                                                               |
| **Country of** **Visa/Work**       | The home country for WHM (Working Holiday Maker) and IAA (Inbound Assignees to Australia), or the country of work for FEI (Foreign Employment Income).                                                                                                                                                                   |
| **Effective Date**                 | Determines which Calendar Period the Payee Opening Balance record should be included in the Pay Batch processing based on the Payee’s Pay Schedule.                                                                                                                                                                      |
| **Employee**                       | This is the related Employee record.                                                                                                                                                                                                                                                                                     |
| **Exclude From** **Finalise**      | Indicates that a confirmed Payee Opening Balance record will be used during Pay Batch calculations, but not included in the Finalise process, which gets included in the Payee Aggregates and then sent via STP to the ATO. If this field is checked, any MTD, QTD, or YTD values will not be added to Payee Aggregates. |
| **Lump Sum E** **Year End Date**   | The Financial Year End Date is applicable if this is a Lump Sum E payment.                                                                                                                                                                                                                                               |
| **MTD Value**                      | The Month to Date monetary value being brought in from the prior software system of this particular Pay Code.                                                                                                                                                                                                            |
| **MTD Units**                      | These are the units to be included in the Month to Date of this Payee Opening Balance.                                                                                                                                                                                                                                   |
| **Pay Batch Event**                | The associated Pay Batch Event created automatically by the system for inclusion in the Pay Batch creation process.                                                                                                                                                                                                      |
| **Pay Code**                       | This is the related Pay Code record.                                                                                                                                                                                                                                                                                     |
| **Payee**                          | This is the related Payee record.                                                                                                                                                                                                                                                                                        |
| **Payee Opening** **Balance Name** | This is the automatically generated name given to the new Payee Opening Balance record upon saving the record.                                                                                                                                                                                                           |
| **Payee Pay Batch** **Processed**  | This is the Payee Pay Batch this Payee Opening Balance was processed in.                                                                                                                                                                                                                                                 |
| **QTD Units**                      | These are the units to be included in the Quarter to Date of this Payee Opening Record.                                                                                                                                                                                                                                  |
| **QTD Value**                      | The Quarter to Date monetary value being brought in from the prior software system of this particular Pay Code.                                                                                                                                                                                                          |
| **Status**                         | Indicates at which point in the payrun process this Payee Opening Balance is currently at.                                                                                                                                                                                                                               |
| **YTD Units**                      | These are the units to be included in the Year to Date of this Payee Opening Record.                                                                                                                                                                                                                                     |
| **YTD Value**                      | The Year to Date monetary value being brought in from the prior software system of this particular Pay Code.                                                                                                                                                                                                             |

# Further Information

| Document                  | Document Type     | Description                  |
| ------------------------- | ----------------- | ---------------------------- |
| QRG Create a Payee record | Task Instructions | How to create a Payee Record |
| QRG Create a Pay Batch    | Task Instructions | How to create a Pay Batch    |
