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
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 |
Comments