Tanda Field (What you see in Tanda)

Micropay Field

Notes

Employee Number

Employee Code (empCode)

Maximum 8 characters, required

Legal First Name (or First Name if legal name not set)

First Name (firstName)

Maximum 50 characters

Legal Last Name (or Last Name if legal name not set)

Surname (surname)

Maximum 50 characters

Email Address

Default Email (defaultEmail)

Maximum 100 characters

Email Address

Personal Email (personalEmail)

Same as Default Email

-

Email Used For Payslips

Always set to "Yes"

Gender

Gender

Must be set (Male/Female/Other)

Date of Birth

Date of Birth (dateOfBirth)

Required field

Employment Start Date (or account creation date)

Hired Date (hiredDate)

Falls back to when profile was created

Phone Number

Telephone 2 (telephone2)

Maximum 20 characters

Tanda Field

Micropay Field

Notes

Street Address (Line 1)

Physical Street Address (street)

-

Street Address (Line 1)

Postal Street Address (postalStreet)

Same as physical (Tanda doesn't separate postal/physical)

Suburb/City

Physical Suburb/City (suburbCity)

-

Suburb/City

Postal Suburb/City (postalSuburbCity)

Same as physical

State/Territory

Physical State (state)

-

State/Territory

Postal State (postalState)

Same as physical

Country

Physical Country (country)

Maximum 100 characters

Country

Postal Country (postalCountry)

Same as physical

Postcode

Physical Postcode (postcode)

Maximum 10 characters

Postcode

Postal Postcode (postalPostcode)

Same as physical

Tanda Field

Micropay Field

Notes

Team → Location → "MicrOpay WebAPI Location" (platform field)

Location

Must match a Location in Micropay

Micropay Integration Settings → "Payroll Company Name"

Payroll Company (payrollCompany)

Must match a Payroll Company in Micropay (max 10 chars)

Pay Group Name (e.g., "Weekly", "Fortnightly")

Pay Frequency (payFrequency)

Must match a Pay Frequency in Micropay (max 10 chars)

Team → Location → "MicrOpay WebAPI PayPoint" (platform field)

Pay Point (payPoint)

Must match a Pay Point in Micropay (max 30 chars)

Team → Export Name/Code

Default Cost Account (defaultCostAccount)

Must match a Cost Account code in Micropay

-

On Boarding

Always set to "Yes" - enables Micropay's New Employee Wizard

Tanda Field

Micropay Field

Possible Values

Tax Declaration → Employment Basis

Basis of Payment (basisOfPayment)

Full Time / Part Time / Casual

Tax Declaration → Employment Basis

Basis of Employment (basisOfEmployment)

Full Time / Part Time / Casual (same as above)

Tanda Field

Micropay Field

Values/Notes

Tax Declaration → Tax File Number

TFN (tfn)

9-digit number or special codes below

When employee selects...

Micropay receives...

"I have applied for a TFN"

111111111

"I am under 18 and don't need to lodge a TFN"

333333333

"I am claiming a TFN exemption for allowances"

444444444

"I don't want to provide my TFN" or left blank

000000000

Tanda Field

Micropay Field

Notes

Tax Declaration → Tax Residency Status

Australian Resident (isAustralianResident)

Yes/No

Tax Declaration → Income Type: "Working Holiday Maker"

Working Holiday Maker (isWorkingHolidayMaker)

Yes/No

Tax Declaration → "I want to claim the tax-free threshold"

Tax Free Threshold (tfnTaxFree)

Yes/No checkbox

Tax Declaration → Tax Scale Type: "Senior or Pensioner"

Senior/Pensioner (tfnPensioner)

Yes/No - indicates if employee is on senior/pensioner tax scale

Tax Declaration → "Senior Tax Offset" (only shown for Senior/Pensioner scale)

Senior Tax Offset (tfnTaxOffset)

Yes/No - requires both senior scale type and offset checkbox

Tax Declaration → Tax Scale Code

Tax Scale Code (taxScaleCode)

Maximum 10 characters

Tax Declaration → Previous Family Name

Previous Surname (tfnPreviousSurname)

Optional

TFN Declaration Date

TFN Date Signed (tfnDateSigned)

Onboarding completion date, or current date if not completed

-

TFN For Super

Always set to "Yes"

-

TFN Employee Declaration

Always set to "Yes"

-

ATO Consent

Always set to "Yes"

Tanda Field

Micropay Field

Tax Declaration → "HELP/HECS debt"

HECS (hecs)

Tax Declaration → "Financial Supplement (SFSS) debt"

SFSS (sfss)

Tanda Field

Micropay Field

Notes

Bank Account → BSB

BSB Code (bsbCode)

Formatted as XXX-XXX

Bank Account → Account Number

Account Number (accountNumber)

Maximum 50 characters

Bank Account → Account Name

Account Name (accountName)

Maximum 50 characters

-

Balance of Pay

Always "Yes" - 100% of pay goes to this account

Tanda Field

Micropay Field

Notes

Super Fund → Fund Name

Fund Code (fundCode)

Must match a Super Fund in Micropay

Super Fund Membership → Member Number

Membership Number (membershipNumber)

Maximum 20 characters

Employee Name

Account Name (accountName)

Maximum 32 characters

Super Fund → USI (Unique Superannuation Identifier)

USI

-

Super Fund → ABN (Australian Business Number)

ABN (fundABN)

Maximum 11 characters

Super Fund → Electronic Service Address

ESA (esa)

-

Super Fund → Fund Name

Fund Name (fundName)

-

Super Fund → "SMSF (Self-Managed Super Fund)"

SMSF (smsf)

Yes/No

Employment Start Date + 1 day

Date Joined (dateJoined)

Must be after hire date

-

Contribution Code (contributionCode)

Always "12.0% SGL" (Superannuation Guarantee Levy)

-

Contribution Type (contributionType)

Always "Employer"

-

Default Fund

Always "No"

Tanda Setting

Micropay Field

Values

Notes

Integration Settings → "Suppress AutoPay" checkbox

Generate AutoPay (generateAutopay)

"Yes" / "No"

Controls whether Micropay creates AutoPay for this employee

Missing Tanda Data

Placeholder Sent to Micropay

Email

NO_EMAIL_FOR_USER_IN_TANDA

Street Address

NO_STREET_IN_TANDA

Suburb

NO_SUBURB_IN_TANDA

State

NO_STATE_IN_TANDA

Country

NO_COUNTRY_IN_TANDA

Postcode

NO_POSTCODE_IN_TANDA

Phone

NO_PHONE_IN_TANDA

Tax Scale Code

NO_TAX_SCALE_CODE_FOR_USER_IN_TANDA

Super Member Number

NO_MEMBERSHIP_NUMBER_IN_TANDA

Super USI

NO_SUPER_FUND_USI_IN_TANDA

Super ESA

NO_SUPER_ESA_IN_TANDA

Super ABN

NO_SUPER_FUND_ABN_IN_TANDA

Super Fund Name

NO_SUPER_FUND_NAME_IN_TANDA

TFN

000000000