Nmbrs API error codes

⚠️ Disclaimer: As of March 1, 2027, the SOAP API will no longer be supported. The REST API will be the only API we offer from that point forward.

The following list is a colletion of API error codes you can run in to when using the Nmbrs® API.

Nmbrs API error codes
External errors

Error	1001: Invalid Authentication
Cause	The email address, API token or domain is not valid.
Solution	Make sure that the email and the token that you use are right. For more information see API error 1001: Invalid Authentication?

Error	1002: Unauthorized Access
Cause	You do not have the rights for the debtor, company or the employee services.
Solution	Contact the administrator of the environment and review the API template. See API user template

Error	1003: Unauthorized Access Data
Cause	You do not have the rights for the debtor or company.
Solution	Contact the administrator of the environment and review access rights by tags/filters.

Error	1004: Disabled, no valid subscription
Cause	Disabled, no valid subscription
Solution

Error	2001: Invalid Hour component
Cause	Hour component number is not right. Hour component is not inserted.
Solution	Use valid hour component number. To see the hour components that are in use see method HourModel_GetHourCodes.

Error	2002: Invalid Wage component
Cause	Wage component number is not right therefor the wage component is not inserted.
Solution	Insert valid wage component number. To see the hour components that are in use see method WageModel_GetWageCodes .

Error	2003: Unauthorized Access
Cause	You do not have the rights to the employee that you are using the API method for.
Solution 1	Make sure you have the right EmployeeID.

Error	2004: Unauthorized Access
Cause	You do not have the rights to the company that you are using the API method for.
Solution 1	Make sure you have the right CompanyID.

Error	2006: Invalid Period
Cause	Inserted period is not according company's period type.
Solution	Use the period type according to company settings.

Error	2009: Unauthorized Access
Cause	You do not have the rights to the debtor that you are using the API method for.
Solution	Make sure you have the right DebtorId.

Error	2011: Protected mode: Cannot change in the past
Cause	You are changing something in the past or future without unprotected mode on.
Solution	You need to put the unprotected mode on by filling <UnprotectedMode>boolean</UnprotectedMode> with true.

Error	2012: Wage tax declaration already sent
Cause	Wage tax declaration already sent
Solution 1

Error	2013: Operation Not Possible On Free Trial
Cause	Operation Not Possible On Free Trial
Solution 1	Update your account from the free trial. See this list of enumerations.

Error	2014: Invalid BankAccount IBAN
Cause	Invalid BankAccount IBAN
Solution 1	Insert a valid bank account IBAN

Error	2015: Invalid BankAccount Number
Cause	Invalid BankAccount Number
Solution 1	Insert a valid bank account number

Error	2016: Invalid BankAccount Type
Cause	Invalid BankAccount Type
Solution 1	Insert a valid bank account type. See the BankAccountType enumeration for valid values. See this list of enumerations.

Error	2017: Invalid Labour Agreement ID
Cause	Invalid Labour Agreement ID
Solution 1	Insert a valid Labour Agreement ID. You may get them using the methods LabourAgreements_Get and LabourAgreements_GetCurrent.

Error	2018: Invalid Leave Id
Cause	Invalid Leave Id
Solution	Insert a valid Leave Id. You can get the available Leave Ids with the method Leave_GetList_V2.

Error	2019: Task status not available
Cause	Possibly caused by an error or the task Id belongs to a different task.
Solution	Insert a valid task Id or retry launching the task.

Error	2020: Task status not available
Cause	Possibly caused by an error or the task Id belongs to a different task.
Solution	Insert a valid task Id or retry launching the task.

Error	2021: Invalid task result
Cause	Task doesn’t have the correct format or the task Id used belongs to a different task.
Solution	Insert a valid task Id or retry launching a task.

Error	2022: Invalid Leave Type
Cause	Invalid Leave Type or the leave type requested isn’t available.
Solution	Insert a valid leave type from the enumeration. See this list of enumerations.

Error	2028: Start time cannot be after end time
Cause	The start time must always be before the end time
Solution	Make sure the end time is not before the start time

Error	2029: Time slots cannot overlap
Cause	Time Schedule in SE cannot have overlapping slots
Solution	Check what are the current time slots and make sure what you are trying to add is not overlapping

Error	2030: Invalid set of values
Cause	The values inputted are invalid
Solution	Review if you are not inserting any type of value incorrect. For example, characters where it's expected int.

Error	2032: Bank account IBAN required
Cause	The IBAN was not given in the input
Solution	Add the IBAN to the input.

Error	2033: Tax type required
Cause	SE-only. The tax type was not inputted.
Solution	Add a tax type to the input.

Error	2034: Invalid tax type
Cause	SE-only. The tax type is invalid.
Solution	Add a valid tax type to the input.

Error	2035: Tax form required
Cause	SE-only. The tax form for was not inputted.
Solution	Add a tax form to the input.

Error	2036: Invalid tax form
Cause	SE-only. The tax form is invalid.
Solution	Add a valid tax form to the input.

Error	2037: Invalid CostCenterId
Cause	The CostCenterId inputted is invalid
Solution	Get the list of valid cost centers and try again.

Error	2038: Invalid CostCenterCode
Cause	The CostCenterCode inputted is invalid
Solution	Get the list of valid cost centers and try again

Error	2039: Duplicated cost center code
Cause	The cost center code is duplicated and that's not allowed
Solution	Only one cost center can be added at a time

Error	2040: Provide file name with an extension
Cause	The file added was not inputted with an extension
Solution	It's mandatory to add the extension of the file when uploading. Please try again with the extension.

Error	2041: File too large
Cause	File is too big to be uploaded
Solution	Try uploading the file again in a smaller size

Error	2042: User belongs to multiple environments, cannot SSO
Cause	This username belongs to multiple environments, it could not be authenticated.
Solution	Use the call GetTokenWithDomain instead of GetToken to authenticate and SSO

Error	2043: Invalid domain
Cause	An invalid domain was inputted
Solution	Add a valid domain

Error	2044: Invalid endpoint
Cause	Endpoint does not have a valid format
Solution	Add a endpoint with valid format, with https:// on the url

Error	2045: Invalid name
Cause	Name cannot be empty, it's a mandatory field
Solution	Add a name for this webhook setting

Error	2046: Not found
Cause	Could not find the requested resource
Solution	Input a valid resource, use a get call to retrieve the data

Error	2047: Invalid document type
Cause	Invalid document type
Solution	Document type "Employee Login File" is not available anymore, use a different type

Error	3001: Call not available in your country
Cause	The call you are requesting is not available in your country
Solution	Check the documentation to see which calls are available for your country

Nmbrs API error codes

Nmbrs API error codes

Comments

Knowledge base