Nmbrs API Error codes

When working with the Nmbrs® API service, it can happen that you bump in an (unexpected) error message. The following information is there to troubleshoot the errors!

  1. Nmbrs API error codes
  2. External errors

Nmbrs API error codes

Error 1001: Invalid Authentication
Cause The email adress or the API token 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. 
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.  See where do users with an API token have access to?
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. For more information see How to get 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. For more information see How to get CompanyId?
Error 2006: Invalid Period
Cause Inserted period is not according company's period type. 
Solution Use the period type according to company settings. For more information see Company Period.
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. For more information see How to get 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.


External Errors

Error 9999: Unknown
Cause Some input parameters are not in the correct format (integers, dates, strings).
Solution Check all data types and input values  of input parameters.
Make sure input values are in the expected format.
example, date types, enumerations, or integers. See References and enumerations  

Opmerkingen

Mogelijk gemaakt door Zendesk