Garnishments: Support State Specific Garnishment Setups
Background:
Our original Garnishment setup did not allow for clients to define all parameters for some state-based garnishments. Though they were supported there was no way to make any adjustments through our user interface.
What’s new?
Clients that administer garnishment deductions through Payroll have additional fields to more accurately calculate employee subject earnings. The additional fields will populate when the state is selected from the dropdown in the deduction code setup.
Pay Run Wizard: Add Payment method as a column to Review & Submit Step
Background:
During a pay run, clients were unable to see the method of payment each employee would receive. If an employee was unexpectedly receiving a check, there was not an easy way to easily verify who that employee was during the payroll process.
What’s new?
A new column has been added to the Review and Submit step called “Payment Method” which specifies the payment type each employee will be paid.
Navigation:
Payroll > Start a Pay Run > Review and Submit
Greenshades API: Public API: Additional 400 Error Responses for Pay Run Endpoints
Background:
Error responses from our endpoints were not descriptive.
What’s new?
We have updated our 400 error responses to provide better descriptions for the data issues.
Pay run Employees and Pay run Employee Earnings end point Pay run Earnings POST/PUT
Missing/Invalid Employee ID: "Invalid Employee ID. Employee does not exist"
Good EE Id but not in pay run: "Invalid Employee ID. Employee is not in this pay run"
Missing Work Period Id: "Defaulting to employee's first work period but unable to find a valid work period for Employee. Is this employee missing a pay schedule?"
Invalid Work Period Id: "Invalid work period id for given employee"
Location Missing: "Earning location is required"
Location Invalid: "Invalid earning location"
Department Invalid: "Invalid department"
Position Invalid: "Invalid position"
Earning Code Invalid: "Invalid earning code"
The Calculation method for earning code does not match with the calculation method in the input: "Calculation method does not match with code's setup"
Non hourly and salary but has time: "Earning Code '{dto.CodeId}' is not hourly or salary and cannot contain hours."
Non piece rate but has unit: "Earning Code '{dto.CodeId}' is not piece rate and cannot contain units."
Same Custom Field mentioned more than once: "One or more duplicate custom fields were submitted. {list of the dupe custom fields, comma separated}"
Custom field marked required missing values: One or more required custom field are missing values. {list of required custom fields missing values, comma separated"
Custom field invalid: "Invalid custom field {custom field name}"
Dimension Custom Field mentions an invalid dimension: Dimension '{dimension.Name}' not found."
Bad value for enum custom field: "'{customFieldValue.Value}' is not an accepted value for custom field '{customField.Name}'. Please provide a value from the list ({comma separated valid values here})."
Pay run Employees Add/Update
Missing Employee ID: "EmployeeId is required in the request body."
Malform JSON for the single EE add/update: "Employee details are required."
Mismatch between body EEid and URL EEid on single EE add/update: "EmployeeId in the request body ({payrunEmployee.EmployeeId}) must match the one in the path ({employeeId})."
Dupe EE entries for the bulk endpoint: "Multiple entries for the same Employee ID is not allowed"
Missing Payschedule: "Employee is missing pay schedule assignment and was not added to pay run"
Missing location: "Employee is not assigned primary work location and was not added to pay run"
Trying to set DD for EE with no DD info: "Cannot pay Employee ID {setting.EmployeeId} via direct deposit. The employee has elected to receive a paper check."
