What This Screen Does

This is where you set up a new wage rate in the system. Think of it like creating a pay-rate label that you can later assign to employees. You give it a name, link it to your payroll system with an external ID, and set the hourly amount. Once saved, the wage rate is available for use across the platform.

How to Get There

Open the dashboard.
In the left-hand menu, click Wage Rate.
Click the button to add a new wage rate.
You are now on the Create a New Wage Rate screen.

Step-by-Step Guide

1. Fill In the Details

This section contains all the information the system needs to create the wage rate. Every field here is required.

Field	Required	What to Enter
Name	Yes	A descriptive name for this wage rate (e.g. “Weekend Evening Rate” or “Standard Hourly”). This is how you will recognise the rate in lists and dropdowns.
External ID	Yes	The ID that matches this wage rate in your external payroll system. It must be exactly the same as in the payroll system so the two can stay in sync.
Payroll System	Yes	Select the payroll system this rate belongs to. Currently the only available option is Danloen.
Hourly rate	Yes	The amount paid per hour. Type a number greater than zero. The currency symbol shown is based on your organisation’s default currency setting. You can use commas for formatting (e.g. `1,250`).

2. Save

Click the Create button at the bottom-right of the form.
The system will:
1. Validate all your inputs.
2. Create the wage rate record.
3. Redirect you to the wage rates list.
You will see a green “Create success!” notification at the bottom of the screen.

What Happens Behind the Scenes

You click "Create"
        |
        v
Form validates all fields (Yup schema)
        |
        v
API call: WageRatesService.create({ body: formData })
        |
        v
Wage rate record is created on the server
        |
        v
Success notification appears ("Create success!")
        |
        v
You are redirected to /wage-rates (the wage rates list)

Troubleshooting

“I filled everything in but the Create button does not work”

Double-check that all four fields are filled in. Every field on this screen is required.
Look for small red error messages below the fields — they tell you exactly what is missing or incorrect.
Make sure the Hourly rate is a number greater than zero. A value of 0 will not be accepted.

“I see an error message in a red banner at the top of the form”

This means the server rejected the request. Read the message carefully — it usually explains what went wrong.
A common cause is a duplicate External ID that already exists in the system.
If the message is unclear, try again. If it keeps happening, contact your administrator with the exact error text.

“The Hourly rate field does not accept my input”

Only numbers are allowed. Do not type letters or special characters other than commas.
The value must be greater than zero. You cannot save a wage rate with a zero or negative amount.
Commas are added automatically for formatting — you do not need to type them yourself.

Currently, Danloen is the only supported payroll system. If your organisation uses a different system, contact your administrator or support team to find out when additional integrations will be available.

“I do not know what External ID to enter”

The External ID is the code or identifier used in your payroll system (e.g. Danloen) for this particular wage rate.
Ask your payroll administrator if you are unsure which ID to use.
It must match exactly — any mismatch may cause payroll exports to fail.

“The currency symbol shown is wrong”

The currency symbol is determined by your organisation’s default currency setting, not by this screen.
To change it, ask an administrator to update the default currency in the chain or organisation settings.

“I accidentally created a wage rate with the wrong details”

Go back to the wage rates list and find the rate you just created.
Open it and use the edit screen to correct the details.
All fields can be updated after creation.

“The page just shows a spinner and nothing loads”

Check your internet connection and try refreshing the page.
If the problem continues, the server may be experiencing issues. Wait a moment and try again, or contact support.