Payroll Deduction Codes (Asia Pacific)

Activate User's Guide

Version
2025.2
Payroll Deduction Codes (Asia Pacific)

Important: This wizard is for use only by customers with pay groups in Asia, Australia, and New Zealand. See the Prerequisites section (below).

Customers with pay groups in Australia, New Zealand, or Asia can use the Payroll Deduction Codes (Asia Pacific) wizard to create and install Payroll Deduction codes.

This wizard uses a template that includes the most common configuration options for deduction codes, plus the settings required for single-touch payroll reporting in Australia. You can also use this wizard to add one or more pay groups to some of the new deduction codes. Because employee payroll election and year-to-date information aren’t required, this wizard reduces the time required to gather the data and work through the wizard. This wizard also removes the need to update deduction codes later. The Payroll Deduction Codes (Asia Pacific) wizard simplifies implementations, reduces manual interventions by human resources and payroll teams, and improves data integrity.

Important notes

  • Customers with pay groups in Australia, New Zealand, or Asia can use this wizard to install deduction code information in Dayforce. The other option is to use the Payroll Deduction Codes Wizard. The other option is to use the Payroll Deduction Codes wizard, which requires employee payroll elections and year-to-date data.
  • Pay groups aren’t created as part of this wizard.

Before you begin

To use this wizard, you must have pay groups in at least one of the following countries:

  • Australia
  • New Zealand
  • Asia (Afghanistan, Bahrain, Bangladesh, Bhutan, The British Indian Ocean Territory, Brunei Darussalam, Cambodia, China, Christmas Island, The Cocos (Keeling) Islands, Hong Kong, India, Indonesia, Iran, Iraq, Israel, Japan, Jordan, Korea, The Democratic People's Republic of Korea, Kuwait, Kyrgyzstan, Laos, Lebanon, Macao, Malaysia, Maldives, Mongolia, Myanmar, Nepal, Oman, Pakistan, State of Palestine, Philippines, Qatar, Saudi Arabia, Singapore, Sri Lanka, The Syrian Arab Republic, Taiwan, Tajikistan, Thailand, Timor-Leste, Turkmenistan, United Arab Emirates, Uzbekistan, Vietnam, and Yemen)

The pay groups, custom earning groups, and payout balances must already be set up and installed in Dayforce. See Pay Group Editor.

Errors, warnings, and messages

The rules set up in Dayforce generate any Error or Warning indicators shown above the grid's column headings.

  • Errors prevent you from continuing with the Wizard.
  • Warnings are informational and indicate potential problems that you need to be aware of.
  • Messages are informational and identify a deviation from the rules.

To refer to the errors, warnings, and messages while you correct the data, click Download Errors File.

To correct the errors, messages, or warnings, do one of the following:

  • Update the information directly in the grid.
  • Click Download Errors File to download the list and then upload an Excel file containing the corresponding corrections.

Whether you edit the data directly in the grid or upload the file, Activate shows validation warnings or errors to indicate problems with the data. To review and correct any warnings or errors that display, either edit the records in the grid or upload the corrected information in a template again.

Always enter required changes in the Excel document to make sure that future uploads are accurate. If you make edits directly in the grid, click Download File and save the updated file for record keeping purposes.

Tasks

Confirm the prerequisites:

  1. In Activate Central, click Build Dayforce. The Build Dayforce wizards show.
  2. Click Payroll Deduction Codes (Asia Pacific).
  3. On the Intro page, review the information.
  4. Select the checkbox to confirm that the following are configured in Dayforce:
    • Pay groups
    • Custom earning groups
    • Payout balances
  5. Click Next.

Complete and upload the Payroll Deduction Data template:

  1. On the Payroll Deductions Data page, click Download.
  2. Select the location where you want to save the template document.
  3. Open the PayrollDeductionDataTemplate.xlsx template on your hard drive.

    Note: You can also download an empty Payroll Deduction Data template from the Download Template Files page.

    Note: The Activate release version shows in cell B3 on the Instructions tab of the template. This information helps you later determine the version of Activate you were using when you downloaded the template.

  4. On the Payroll Deduction Data tab, complete all columns with the data for the required new deduction codes.

    Note: Instructions for populating the fields are in the Payroll Deduction Data template fields section (below) and on the Instructions tab of the template.

  5. Click Save and close the template.

    You can use any file name for the template you upload. The only requirement is that the file is an Excel or CSV (Comma-Separated Value) document and the data is in the required format.

    Important: Don’t change the name of the tab because (Undefined variable: MyVariables.OngoingProductName) uses it to validate that the correct template is being uploaded.

  6. On the Payroll Deductions Data page, click Upload.
  7. Go to your completed Payroll Deduction Data template in the location where you saved it.
  8. Click Open.

    The Payroll Deduction Codes (Asia Pacific) wizard validates the uploaded file.

    Note: If the file you uploaded has any errors, a Validation Failed message shows in red at the bottom of the page. You must correct the errors in the file on your computer and upload the file again.

    Note: When you upload an Excel file, Activate includes the name of the uploaded file in the name of the XML file it generates and loads to the Dayforce File Server. The format of the generated XML file name is <NamespaceName>_<Import Type>_<file name provided>_YYY-MM-DD_HHMM. This naming convention makes it easier to audit files later.

  9. Click Next.
  10. Click Done. The Payroll Deductions Review page opens.

To review and confirm the data:

  1. Review the information shown in the grid.

    You can use the pick list in the IR8A Reporting section field and the Tax Compliance Rule field to view all of the valid options.

  2. To make updates to data on the page:
    • To insert a new row in the grid, click the row where you want to insert it and click New.

    • To delete a row, click the row and click Delete.

    • To correct errors in the grid, click in the field containing the error. Click Tab to move to the right and Shift+Tab to move to the left in the row. Use the scrollbars on the right side and bottom of the grid to go to other areas of the grid.
    • To save information in the grid to your computer, click Download File and save it to the location you want. The download file includes only the following information: Employee Number, First Name, Last Name, Effective Start Date, and the respective global properties and values selected.

    • To upload the file from your computer, locate the file and click Upload File. The data in the file shows in the grid.

    • To download a complete list of all errors from the data load process so you can review and correct them, click Download Errors File. The document lists the Severity, Employee Identifier, Column Name, Message, and Value for each item.
    • To remove changes that you don’t want to save, click Refresh.

  3. When the data is complete, click Done & Install. The selected values stay in the grid after you leave the page.

Install the deduction information:

When the deduction information is complete in Activate, you must install the data in Dayforce.

  1. After making any necessary corrections on the Payroll Deductions Review page, click Load.

    The Load page opens with a list of the steps to complete and an estimate of how long the installation usually takes. During the installation, the current step in the process is bolded so you can monitor the progress.

  2. Click one of the following:
    • Add Email and enter your email address to receive an email when the installation process ends, instead of waiting for it to finish.
    • Next w hen the installation is complete.

    Activate Central opens with the name of the Wizard now shown in green text and a green checkmark to the left of the wizard’s name. The current day, date, and time of completion are included, along with your name as the user who completed the Wizard. The environment in which the installation was applied (Stage, Config, or Train) is also shown.

    Note: If you want to add more information, click I want to add more. See Executing a Rollback When Using the “Add More“ Feature in the Payroll Wizards.

To refresh the data in the grid:

If you make a change on the page that you don't want to save, click Refresh. The page refreshes and any unsaved changes are removed.

Results

The deduction data is installed in Dayforce on the Payroll Setup > Earnings and Deductions > Deductions page.

Fields populated in Dayforce

The data uploaded from the Payroll Deduction Data template populates the fields on the following pages in Dayforce.

Dayforce fields populated by the Payroll Deduction Data template
Field in Template Field in Dayforce Page in Dayforce
Name Name Payroll Setup > Earnings and Deductions > Deductions, General tab
Description Description
Display Name Display Name
Reference Code Reference Code
Tax Compliance Rule   Payroll Setup > Earnings and Deductions > Deductions, Options tab, under the Reports group box.
Pay Groups Pay Group Payroll Setup > Earnings and Deductions > Deductions, Pay Groups tab
Allow Payee Allow Payee Payroll Setup > Earnings and Deductions > Deductions, General tab
Payee Category Payee Category Payroll Setup > Earnings and Deductions > Deductions, Payees tab
Suppress on Earning Statements Suppress on Earning Statements Payroll Setup > Earnings and Deductions > Deductions, General tab
Allow Partial Allow Partial Declining Balance Payroll Setup > Earnings and Deductions > Deductions, Options tab
Declining Balance Declining Balance
Display Remaining Balance on Earning Statement Display on Compensation Payroll Setup > Earnings and Deductions > Deductions, General tab
PAYEVNT Category PAYEVNT category
PAYEVNT Code PAYEVNT code
FBT Status FBT Status Payroll Setup > Earnings and Deductions > Deductions, Options tab
IR8A Reporting Section   Payroll Setup > Earnings and Deductions > Deductions, Options tab, under the Reports group box.

Deduction Codes templates

All templates have the same basic structure:

  • Instructions tab: Helps you understand the purpose of the data and complete the fields in the template.
  • Data tab: Contains headers for the data to be included in the template. The headers remain the same, but you can change the column order. If you add more columns, Activate ignores them.

All number ranges in the templates include the numbers at both ends of the range.

Note: Make sure that you include all deductions that are currently used, and the deductions to be used during the elected Parallel Periods.

Payroll Deduction Data template fields

Name (Required)

Field information for the Name field
Order Data Type Description Examples Why This Is Needed
1 String1 between
1-64 characters.
The name to use to identify the deduction. AU Expense Recovery
NZ Payroll Giving
SG Donation
Used to identify the deduction.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Description

Field information for the Description field
Order Data Type Description Example Why This Is Needed
2 String1 between
1-256 characters.
A brief description of the deduction. AU Expense Recovery
NZ Payroll Giving
SG Donation
Used to identify the deduction in reports.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Display Name

Field information for the Display Name field
Order Data Type Description Example Why This Is Needed

3

String1 between
1-15 characters.
Shown on earning statements. Expense Recover
Payroll Giving
Donation
Used to identify the deduction in employee earning statements.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Reference Code (Required)

Field information for the Reference Code field
Order Data Type Description Example Why This Is Needed

4

String1 between
1‑128 characters.
Cross-reference codes are used to export data from Dayforce to other applications. AU_EXPENSE_RECOVERY
NZ_PAYROLL_GIVING
SG_DONATION
Used for imports and exports.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Tax Compliance Rule (Required)

Field information for the Tax Compliance Rule field
Order Data Type Description Examples Why This Is Needed
5 String1 between
1-128 characters.
Cross-reference code of the Tax and Compliance Rule associated with the deduction. PRE-TAX_PRE-SUPER_DEDUCTION-AUS WORKPLACE_GIVING-NZL SGP-Memo Used to identify the Tax and Compliance Rule associated with the deduction. For nonnative payroll countries, a custom Tax and Compliance rule must be created for the required country before using this template.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Pay Groups

Field information for the Pay Groups field
Order Data Type Description Examples Why This Is Needed
6 Semicolon separated list String1 between 1-256 characters. When you enter a value for this option, pay groups are added to the deduction with default options (every regular run, effective 1/1/1975). WKLY;FTNT Defines the eligible pay groups for the deduction.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Allow Payee (Required)

Field information for the Allow Payee field
Order Data Type Description Example Why This Is Needed

7

Boolean. Enable the configuration of one or more third-party payees to receive payment for the amounts that were withheld from employees for this deduction. YES
NO
This field enables deductions to be paid to a third-party payee. When you select this option, the Payees subtab becomes available so you can configure a third-party payee after the data load.

Payee Category (Conditional)

Field information for the Payee Category field
Order Data Type Description Example Why This Is Needed

8

String1 between 1-256 characters.

Cross-reference code of the payee category.

Note: This option is required when Allow Payee is set to YES.

Garnishment Child Support Payment Superannuation Scheme Defines the Payee Category for filtering the list of payees who are available on the Payees subtab.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &

Suppress on Earnings Statement

Field information for the Suppress on Earnings Statement field
Order Data Type Description Example Why This Is Needed

9

Boolean. This information prevents the deduction from showing on employee earning statements. YES
NO
Is used for reporting purposes.

Allow Partial (Required)

Field information for the Allow Partial field
Order Data Type Description Example Why This Is Needed

10

Boolean. Configures Dayforce to carry forward any unpaid amounts if it calculates that employees don’t have enough earnings to cover the entire deduction. YES
NO
This information enables the carry-forward of unpaid amounts to the next pay.

PAYEVNT Category

Field information for the PYEVNT Category field
Order Data Type Description Example Why This Is Needed

11

Accepted Values:

  • Deductions
  • Income Fringe Benefits Reportable
  • Salary Sacrifice Amounts
  • Superannuation Contribution

Note: For Australian deductions only.

Define the PAYEVNT category for STP reporting.

Deductions
Salary Sacrifice Amounts

Superannuation Contribution

Required in Australia for STP2 reporting.

PAYEVNT Code (Conditional)

Field information for the PAYEVNT Code field
Order Data Type Description Example Why This Is Needed

12

Accepted Values2:

  • W
  • F
  • X
  • T
  • S
  • O
  • R
  • L

Note: For Australian deductions only.

Define the PAYEVNT code to come with the PAYEVNT category for STP reporting.

Note: This option is required when the PAYEVNT Category is provided.

W
S
R

Required in Australia for STP2 reporting.

The entered value is only valid if the PayEvent in brackets is also present:2

  • W (Deductions)
  • F (Deductions)
  • X (Income Fringe Benefits Reportable)
  • T (Income Fringe Benefits Reportable)
  • S (Salary Sacrifice Amounts)
  • O (Salary Sacrifice Amounts)
  • R (Superannuation Contribution)
  • L (Superannuation Contribution)
2 Australian STP PAYEVNT Code Descriptions and the PAYEVNT Category values they can be used with
PAYEVNT Category PAYEVNT Codes & Descriptions
Deductions W - Workplace Giving
F - Fees
Income Fringe Benefits Reportable X - Exempt
T - Taxable
Salary Sacrifice Amounts S - Superannuation
O - Other Employee Benefits
Superannuation Contribution R - Reportable Employer Superannuation Contributions
L - Superannuation Liability (SG)

FBT Status

Field information for the FBT Status field
Order Data Type Description Example Why This Is Needed

13

Accepted Values3:

  • X
  • T
  • N

Note: For Australian deductions only.

Used to define the FBT Status for Salary Sacrifice Amounts in STP reporting.

X
T

Required in Australia for STP2 reporting.

The entered value is only valid if the PAYEVNT Category is “Salary Sacrifice Amounts” and the PAYEVNT Code is “O.”

3 Australian FBT Status Descriptions
FBT Status & Descriptions
X - FBT Tax Exempt
T - FBT Taxable
N - Not reportable for FBT

IR8A Reporting Section (Conditional)

Field information for the IR8A Reporting Section field
Order Data Type Description Example Why This Is Needed

14

See Accepted Values.4

Note: For Singapore deductions only.

Used to define how the deduction is to be reported on the IR8A form.

Donation
Insurance
Required in Singapore for yearly reporting of employee income to the Inland Revenue Authority of Singapore (IRAS).

4 Singapore IR8A Reporting Section options

IR8A Reporting Section
Compensation For Loss Of Office
Contractual Bonus
Designated Pension
Director Fees
Donation
Employee Fixed Income Tax
Employer PF Cont. Overseas
Entertainment
Exempt Income
Ex-Gratia
Gratuity
Gross Commission
Gross Salary
Insurance
Lump Sum
Mosque Building Fund
Non Contractual Bonus
Notice Pay
Other Allowance
Pension
PILON
Provident Fund
RetrenchmentBenefits93
RetrenchmentBenefitsUpto92
ShareOptionGainsS101b
ShareOptionGainsS101g
Transport

Declining Balance (Required)

Field information for the Declining Balance field
Order Data Type Description Example Why This Is Needed

15

Boolean. Indicates if the deduction allows a declining balance. YES
NO
Indicates if the deduction allows a declining balance

Display Remaining Balance on Earning Statement

Field information for the Display Remaining Balance on Earning Statement field
Order Data Type Description Example Why This Is Needed

16

Boolean. Shows declining balances on the employee's earnings statement. YES
NO
shows declining balances on the employee's earnings statement.

1 Special characters accepted within the string include: alphanumeric, space, period, apostrophe, dash, number symbol #, comma, underscore, forward slash /, parentheses (), &