Payroll errors

You may see errors during development or when your app is live and in production. Use the error codes to identify the error. Follow the error’s message to narrow down the specific issue. For details on handling GraphQL errors, see Fix GraphQL errors.

EmployeeCompensation errors
Error Type Error Code Message Description
SYSTEM_ERROR SYSTEM_ERROR Cannot return null for non-nullable field Payroll_EmployerCompensation.xx Paytypes data is not available in the database.
SERVICE_UNAVAILABLE SERVICE_UNAVAILABLE Service Unavailable Occurs when querying paytypes if downstream service is not available.
AUTHENTICATION_ERROR AUTHENTICATION_ERROR Unauthorized Occurs when querying paytypes without valid active credentials.
VALIDATION_ON_FILTER_ERROR EMPTY_VALUES_PASSED_ERROR Invalid filter input. Multiple filter operations specified, only a single operation is allowed.  
AUTHORIZATION_ERROR AUTHORIZATION_ERROR Forbidden Occurs when querying paytypes without sufficient permissions.
PERMISSION_DENIED AUTHORIZATION_ERROR Forbidden Occurs if querying compensation without an existing EmployeeId.
INVALID_REQUEST INVALID_REQUEST Could not find any employee with RealmId ExternalEmployeeId Occurs if querying compensation without an existing EmployeeId.
INVALID_REQUEST INVALID_REQUEST Unable to find companyId for realmId= Occurs if querying PayTypes for a terminated company.
VALIDATION_ERROR NOT_A_VALID_NUMBER_ERROR Invalid filter input. Please provide a valid number for employeeId Occurs if querying paytypes without sufficient permissions.
VALIDATION_ERROR VALIDATION_ON_FILTER_ERROR Invalid filter input. No values passed for the list Occurs if querying PayTypes by compensation Ids with an empty list.
VALIDATION_ERROR NOT_A_VALID_NUMBER_ERROR Invalid filter input. Please provide a valid number for id Occurs if querying PayTypes by compensation Ids with invalid format.