Nmbrs API error codes

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

  1. Nmbrs API error codes
  2. External errors

Nmbrs API error codes

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

 

 

External Errors

Comments

Knowledge base