9 Error Codes

Source: This article refers to 9 Error Codes

9.1 HTTP Status Codes

The Cloud API attempts to return appropriate HTTP status codes for every request. The following table describes the statuses:

Status Code Name Description
400 Bad request Bad request received from the client. Check the details of the error response and fix the request accordingly
401 Authentication failed Check credentials used for the API access
403 Operation forbidden Check and configure permissions granted for the user
404 Resource not found The status indicates that no resource with the given name exists
409 Concurrent modification Resource on the cloud got modified in the meanwhile - resolve the conflict and upload again
422 Unprocessable entity Violation of business rules/data integrity took place.
423 Resource blocked Resource is BLOCKED on the cloud and can’t be updated

9.1.1 Error Message Format

When the Cloud API returns error messages, it does so in JSON format. For example, an error might look like this:

{ "error": "CA-19", "message": "No resource found for [BusinessPartner] version [15]", "values": [ "BusinessPartner", 15 ] }

9.2 Client Errors

In addition to descriptive error text, error messages contain machine-parseable codes. While the text for an error message may change, the codes will stay the same. The following table describes the codes which may appear when working with the API:

Error Code Default Message HTTP Response Code
CA-01 A cql syntax error discovered around position [{0}] : [{1}]. 400
CA-02 Expand string [{0}] does not match the expand pattern. 400
CA-03 Field [{0}] of resource [{1}] cannot be expanded. 400
CA-04 Can not find DTO field name [{0}] in resource [{1}]. 400
CA-05 The complex field [{0}] of resource [{1}] does not specify any of embedded fields. 400
CA-06 DTO field name [{0}] of resource [{1}] does not match the DTO field name pattern. 400
CA-07 Can not generate sequence value for [{0}] field [{1}]. 400
CA-08 Uploaded object has value [{0}] which is either 'null' or in range of automatically generated values. 400
CA-09 Could not deserialize uploaded object to [{0}], because [{1}] 400
CA-10 Object [{0}, {1}] is not valid. 400
CA-11 OrderBy [{0}] does not match the orderBy pattern. 400
CA-12 Pagination values should be greater then zero, page [{0}] pageSize [{1}]. 400
CA-13 Permission denied for uploading resource [{0}, {1}] 403
CA-14 Resource [{0}] does not match the resource name pattern. 404
CA-15 Can't find class for resource [{0}]. 404
CA-16 Shaping [{0}] does not match the shaping pattern. 400
CA-17 Invalid DTO. Name [{0}], version [{1}]. 400
CA-18 DTO name [{0}] does not match the DTO name pattern. 400
CA-19 No resource found for [{0}] version [{1}]. 400
CA-20 No DTO version specified for resource [{0}]. 400
CA-21 Invalid ETO [{0}]. 400
CA-22 Resource [{0}] doesn't support ETO version [{1}]. 400
CA-23 The URL query string contains not supported parameters {0}. Allowed query string parameters are {1}. 400
CA-24 Can not create value [{0}] of type [{1}]. 400
CA-25 Permission denied for refreshing [{0}] resource with id [{1}]. 403
CA-26 Resource [{0}] with id [{1}] is not found. 404
CA-27 Resource concurrent modification detected. Last changed [{0}] of resource [{1}, {2}]. 409
CA-28 Resource [{0}] with id [{1}] is blocked. 423
CA-29 Report template with id [{0}] not found. 400
CA-30 Embedded report template with name [{0}] not found. 400
CA-31 Error while building the report [{0}]: [{1}]. 400
CA-32 Error while compiling one of the report files [{0}]. 400
CA-33 Error while coping one of the report files [{0}]. 400
CA-34 No attachment found for report template with id [{0}]. 400
CA-35 More than one attachment found for report template with id [{0}]. 400
CA-36 Parameter(s) {0} used in query [{1}] must be set. 400
CA-37 Report template field can't be empty. 400
CA-38 Report bundle must not contain any directories [{0}]. 400
CA-39 Report bundle is missing [{0}] file. 400
CA-40 The [{0}] with id [{1}] can't be deleted because it is referenced by {1}. 422
CA-41 Can not create resource [{0}, {1}] as it already exists. 422
CA-42 Retrieved resources can not be organized in a single root hierarchy. Resources {0}. 422
CA-43 Activity template resource [{0}] should have exactly one group defined. Actual number of groups [{1}] 422
CA-44 Sequence for [{0}#{1}] is not defined 422
CA-45 Real hierarchy definition for [{0}] is not valid as resource [{1}] has status [{2}]. Can't generate service suite. 422
CA-46 Resources of type [{0}] with ids {1} are not found. 422
CA-47 Resource [{0}] with id [{1}] is not is state [{2}]. Can't remove draft resources. 422
CA-48 Generic hierarchy definition for [{0}] is not valid as resource [{1}] has status [{2}]. Can't generate service suite. 422
CA-49 Permission denied for deleting [{0}] resource with id [{1}]. 403
CA-50 Permission denied for copying [{0}] resource with id [{1}]. 403
CA-51 Configuration level equipment [{0}] defined for configuration does not have status [{1}]. 422
CA-52 Permission denied for generating service suite for [{0}]. Expected permission [{1}]:[{2}] for [{3}] is not granted. 403
CA-53 Permission denied for deleting service suite for [{0}]. Expected permission [{1}]:[{2}] for [{3}] is not granted. 403
CA-54 Can not create value [{0}] of type [{1}]. 422
CA-55 Equipment for configuration [{0}] is not defined. 422
CA-56 Can not parse condition [{0}] for activity template [{1}]. Cause [{2}]. 422
CA-57 No equipment is defined for activity template [{0}]. 422
CA-58 Next sequence value for [{0}#{1}] can't be generated. Check sequence settings (e.g. activated, max value, etc). 422
CA-59 No resources of type [{0}] with field [{1}] equal to [{2}] found. 422
CA-60 More than one resource of type [{0}] with field [{1}] equal to [{2}] found. 422
CA-61 Service call for configuration [{0}] is not defined. 422
CA-62 Can not change service suite configuration [{0}] status to [{1}] as there are no generated resources found for the it. 422
CA-63 No service suite configurations found for service call [{0}]. 422
CA-64 There are [{0}] service suite configurations found which are not in status [{1}]. 422
CA-65 Company setting [{0}] is not defined. 422
CA-66 Permission denied for releasing service call suite for [{0}]. Expected permission [{1}]:[{2}] for [{3}] is not granted. 403
CA-68 More than one attachment exist for category [{0}] and source object [{0}]. 422
CA-69 Can not open file because of its invalid format. File [{0}]. 422
CA-70 The xls attachment should contain at least one sheet. Actual sheet number [{0}]. File [{1}]. 422
CA-71 The first xls sheet should contain at least one column. Actual number of columns [{0}]. File [{1}] 422
CA-72 No attribute or field names are defined. File [{0}]. 422
CA-73 No attributes defined in header cells {0}. File [{1}]. 422
CA-74 Exactly one attribute for each of {0} names should exist. File [{1}]. 422
CA-75 XLS file has no content. File [{0}]. 422
CA-76 Can not modify service suite configuration [{0}] and related objects as it is in status [{1}]. 422
CA-77 All cells of the excel file should be of string type. File [{0}]. 422
CA-78 Some errors have been encountered during excel validation. File [{0}]. 422
CA-79 Row [{0}] has invalid size [{1}]. Row should have as many values as attributes defined [{2}]. 422
CA-80 Row [{0}] has at least one cell with no value in it. 422
CA-81 Row [{0}] should have exactly one activity template associated. Actual number of activity templates [{1}]. 422
CA-82 Some attributes are defined multiple times. Check excel column headers. File [{0}]. 422
CA-83 Row [{0}] has values which are already present in the same file earlier. 422
CA-84 The [{0}] from [{1}] has value in wrong format. The correct format is [{2}]. 422
CA-85 Company setting [{0}] should have a value higher than [{1}]. 422
CA-86 There already exists a file revision with language [{0}] and revision [{1}] for file [{2}]. 422
CA-87 No objects have been generated because no attribute values are defined on service suite configuration [{0}]. 422
CA-88 No objects have been generated because no activity templates were found for service suite configuration [{0}]. 422
CA-89 Attribute [{0}] should have the same object type as its parent [{1}]. 422
CA-90 Function [{0}] can't be used on field [{1}] due to unsupported data type. 400
CA-91 Resource [{0}] can't be copied as there is no predefined copier for resource type [{1}]. 422
CA-92 Generic hierarchy definition for [{0}] is not valid. Looks like there are loops in the hierarchy. Number of source elements [{1}], number of elements in the built hierarchy trees [{2}]. Can't generate service suite. 422
CA-93 Some filed names are defined multiple times. Check excel columns definition. File [{0}]. 422
CA-94 No field names defined in columns {0}. File [{1}]. 422
CA-95 No fields found {0}. File [{1}]. 422
CA-96 No column categories defined {0}. Check excel columns definition. File [{1}]. 422
CA-97 Following column categories {0} are invalid. Allowed categories are {1}. File [{2}]. 422
CA-98 Column category order {0} is invalid. File [{1}]. 422
CA-99 Object [{0}:{1}] not found. 404
CA-100 UdfMeta with name [{0}] not found. 404
CA-101 Object [{0}] not found. 404
CA-102 Parameter "to" should have value grater than "from" parameter 400
CA-103 Entity to delete has at least one relation of type [{0}] 422
CA-104 Parameter(s) [{0}] are missing 400
CA-105 Can not create relation object. Object with the same relations already exists: [{0}:{1}] and [{2}:{3}]. 422
CA-106 Can not update relation object. Object with the same relations already exists: [{0}:{1}] and [{2}:{3}]. 422
CA-107 Aggregate function string [{0}] does not match the aggregate function pattern. Please use one of those functions COUNT, MIN, MAX, SUM or AVG. Example: count(ServiceCall.id)@countingResultAlias 400
CA-108 GroupBy string [{0}] does not match the GROUP BY function pattern. A valid GROUP BY can look for example: BusinessPartner.currency 400
CA-109 Multiple occurrence of the same alias [{0}] for different aggregate functions 400
CA-110 Referenced resource can't be inferred for resource [{0}] field [{1}]. 422
CA-111 Can not delete enumeration value [{0}] as it is used by at least one resource of type [{1}]. 422
CA-112 Invalid Json [{0}] 400
CA-113 Query syntax error at position [{0}] for [{1}]. Please inspect the token [{2}]. 400
CA-114 The parameter [{0}] is missing. 400
CA-115 The query parameter [{0}] is empty. 400
CA-116 You can not use the complex field [{0}] into expression evaluation. 400
CA-117 Missing declaration into FROM or JOINs clauses for resource [{0}]. 400
CA-118 There is no such field [{0}]. Please consider that fields names are case sensitive. 400
CA-119 Query syntax error at position [{0}] for [{1}]. Please consider [{2}] 400
CA-120 Undefined token [{0}]. 400
CA-121 Can not perform [{0}]: [{1}], for the arguments of types [{2}]. Please consider to change the query portion: [{3}] 400
CA-122 Unknown type for field [{0}] . 400
CA-123 Unsupported operation(or function) [{0}]. This operation can not be translated into SQL syntax. 400
CA-124 Unsupported operation or function: [{1}]. 400
CA-125 Invalid parameters number for function: [{0}]. This function allows [{1}] parameters. Please consider to change the query portion: [{2}] 400
CA-126 The [{0}] clause requires a [{1}] expression. 400
CA-127 Can not perform operation: [{0}]. Please consider to change the query portion: [{1}] 400
CA-128 Can not perform function: [{0}]. Please consider to change the query portion: [{1}] 400
CA-129 Only one configuration can be marked as default. 400
CA-130 Object [{1}, {2}] is not valid. Name [{0}] is not unique. 400
CA-131 One or more [Person] objects are already assigned to a different configuration. 400
CA-132 One or more [ScreenConfiguration] objects are already assigned to a different configuration. 400
CA-133 The query parameter [{0}] has a wrong value. Please use: [{1}] 400
CA-134 A Structural output format, can be used when you have only one resource definition into the From clause & you are using a single Join clause (of type JOIN or LEFT OUTER JOIN). 400
CA-135 Can not perform query, because of a database error. Error code: [{0}] 400
CA-136 Please use a positive natural number for representing a timestamp. Please consider to change the query portion: [{0}]. 400
CA-137 Invalid reference identifier format. Please consider to change the query portion: [{0}]. 400
CA-138 Can not perform query. Only one join is allowed when using a RIGHT OUTER JOIN or a FULL OUTER JOIN 400
CA-139 Can not perform query. When using Joins, you can have only one resource defined into From clause. 400
CA-140 Please use the date & time format pattern: [{0}]. Please consider to change the query portion: [{1}]. 400
CA-141 Resource identifier [{0}] is not equal to the sync object identifier [{1}]. 400
CA-142 The UDF having [{0}] does not exist for resource [{1}]. 400
CA-143 Invalid parameters number for operation: [{0}]. This operation allows [{1}] parameters. Please consider to change the query portion: [{2}] 400
CA-144 Can not generate a code value for [{0}]. 400
CA-145 There is no support for the UDF type [{1}]. You can use this UDF as a text value by using the optional parameter 'useUdfAs' with values: 'allAsText' or 'unknownAsText' 400
CA-146 You are trying to reference an object by externalId using a DTO version that does not support externalId. Please use a DTO version that extends SyncObjectDTO_V9 or above. 422
CA-147 You are not allowed to update the resource identifier. 422
CA-148 Please use the time format pattern: [{0}]. Please consider to change the query portion: [{1}]. 400
CA-149 You can not use the same resource name declaration [{0}] for multiple times. Please correct the WHERE (or JOINs) resources declarations. 400
CA-150 Pagination is supported only for [{0}] output format 400
CA-151 Invalid query parameter [{0}]. Reason: [{1}]. 400
CA-152 There is no Udf [{0}] into UdfMeta associated to the resource [{1}]. 400
CA-153 You can not use NULL keyword into the query. If you want to check for null, please use IS NULL or IS NOT NULL syntax. 400
CA-154 Object [{0}] with externalId [{1}] was not found. 422
CA-155 Cannot parse HTTP request. 400
CA-156 There are too many requests in the batch. Maximum is set to [{0}]. 422
CA-157 Because the server is busy at this moment, your query was cancelled. Please try again later. 400
CA-158 The query was cancelled because it takes more then 30 seconds to execute. 408
CA-159 Please do not mix explicit & implicit joins. Try to rethink the query by using only explicit joins. 400
CA-160 When using FULL OUTER JOIN or RIGHT OUTER JOINS, the joining condition must be merge-joinable or hash-joinable. Try to rethink the query. 400
CA-161 Fail to read the file. 400
CA-162 Internal error. Please contact support. 400
CA-163 One or more columns names are empty. 400
CA-164 The resource name [{0}] in the URL path is not valid. 400
CA-165 Please upload a file. 400
CA-166 The file does not exist 400
CA-167 Please use an alias for the expression [{0}]. Example: SELECT count(bp.id) AS 'countResult' FROM BusinessPartner bp 400
CA-168 You can not use the same alias [{0}] for more then one expression. 400
CA-169 Please don't use an alias for the expression or field [{0}]. 400
CA-170 When using aggregate functions, the GROUP BY clause should contain the same fields as the SELECT clause. 400
CA-171 You can not use pagination in combination with aggregate functions 400
CA-172 You can use pagination in combination with OFFSET or LIMIT sql clauses. 400
CA-173 For using pagination, you have to use both [{0}] and [{1}] parameters 400
CA-174 You can not use aggregate functions (or aggregate functions aliases) into [{0}] clause. 400
CA-175 The import file should be less then [{0}] megabytes. 400
CA-176 The import file should contain less then [{0}] rows of data. 400
CA-177 There is not such type [{0}] for udf meta fields. The allowed types are [{1}]. 400
CA-178 There is already a udf meta named [{0}] having a different type then [{1}]. 400
CA-179 For updating an object of type [{0}] you need: READ and also CREATE or UPDATE permissions. 400
CA-180 The import file does not contains the following required columns: [{0}]. 400
CA-181 The value [{0}] is not valid for the expected [{1}] udf type 400
CA-182 There is already an UdfMeta having the name [{0}], but with a different udfType then [{1}] 400
CA-183 We detect a problem for column [{0}]. [{1}] 400
CA-184 The number of columns into this row is different from the number of column headers. 400
CA-185 Identification column [{0}] can not be empty. 400
CA-186 Unrecognized column names [{0}] for object [{1}]. Please use the column names provided in the template or create new properties by using the User Defined Fields standard: UDF.columnName[dataType] (eg: UDF.price[int]) 400
CA-187 Status transition for approval is invalid. Approval can not change from status [{0}] to [{1}] 422
CA-188 Status transition for object is invalid. Object can not change from status [{0}] to [{1}] 422
CA-189 Invalid custom rule [{0}] 400
CA-190 Invalid type [{0}]. Available types are {1} 400
CA-191 Permission denied for search in documents of type [{0}]. Read all permissions are missing for the following domain objects {1}. 403
CA-192 No valid subscriptions 403
CA-193 Only query for id is allowed for ProfileObject 400
CA-194 Object with specified external id is not found. But object with specified id already exists 422
CA-195 Overlap with exclusive reservation is not allowed. Resource [{0}]. 422
CA-196 Changing enumeration type is not allowed 400
CA-197 Cannot process attachment of id [{0}] 422
CA-198 Maximum attachment [{0}] size exceeded. 422
CA-199 Person of type [{0}] and user name [{1}] already exists with different id! 422
CA-200 Object [{0}, {1}] already exists but with different id! 422
CA-201 Object [{0}, {1}] doesn't have a unique externalId [{2}] 422
CA-202 Object [{0}, {1}] doesn't have a unique code [{2}]. 422
CA-203 Object [{0}, {1}] contains invalid object refence. 422
CA-204 Assignment [{0}] cannot be created on a closed service call. 422
CA-205 Wrong file extension [{0}] allowed extensions are [{1}]. 422
CA-206 Excel file does not contain sheet named as resource [{0}]. 422
CA-207 Report template with name [{0}] is an offline report and can't be build in the Cloud. 400
CA-208 User is not assigned to any Person object. 403
CA-209 Element [{3}] in collection [{2}] in object [{0}:{1}] not found. 400
CA-210 [{0}] not specified, BAD_REQUEST) 400
CA-211 Validation fails. Reasons: [{0}] 422
CA-212 Activity [{0}] can not be cancelled. Not in stages [DISPATCHING, EXECUTION] 422
CA-214 Wrong file extension [{0}] allowed extensions are [{1}]. 422
CA-215 Wrong resource [{0}]. 422
CA-216 Wrong additional resource [{0}]. 422
CA-217 Unsupported resource [{0}]. 422
CA-218 Wrong additional resource [{0}] for resource [{1}]. 422
CA-219 Found more than one object by field [{0}]. 422
CA-220 Field [{0}] on object [{1}] must have not empty value. 422
CA-221 Field [{0}] on object [{1}] has invalid value. Valid values are [{2}]. 422
CA-222 Manager [{0}] for this person [{1}] is invalid. Manager must be of type EMPLOYEE and ACTIVE. 422
CA-223 There is another data indexing process started for the given company. Process started on [{0}]. 422
CA-224 There was an error in custom rule [{0}]. 500
CA-225 Current user is not the issuer of the approval. Cannot cancel approval [{0}]. 422
CA-226 Activity [{0}] of Approval [{1}] does not have ServiceAssignment. 422
CA-227 State [{0}] of approval [{1}] is not PENDING or REVIEW. 422
CA-228 Current user [{0}] is not the issuer of the approval [{1}]. 422
CA-229 Approvals [{0}] not found. 422
CA-230 Current user [{0}] cannot modify approval [{1}]. 422
CA-231 Activity not found for approval [{0}]. 422
CA-232 Type [{0}] of approval [{1}] is not related to activity. 422
CA-233 Entity [{0}] is not allowed to search. 400
CA-234 Join chain has not connected elements [{0}]. 400
CA-235 [{0}] allowed only for standalone companies. 400
CA-236 UDF data type required for header [{0}] 400
CA-237 Join in query options is not properly formed. 400
CA-238 Constraint violation [{0}]. 400
CA-239 [{0}] with id [{1}] not found. 400
CA-240 {0}. 400
CA-241 Equipments [{0}] and [{1}] have reference to each other in the hierarchy. 422
CA-242 No identifiers provided to resolve branches in equipment hierarchy. 400
CA-243 Resources of type [{0}] with ids {1} are not found. 400
CA-244 Client is not allowed for this user. 403

9.3 Common Errors

Common Error Code Description HTTP Response Code
CM-01 Request has no content. 400
CM-02 The service experienced an unexpected error. 500
CM-03 Authentication fails. 401
CM-04 You are not authorized to access the resource. 403
CM-05 Input field has an incorrect value. Input: [{0}]. 400
CM-06 The server cannot or will not process the request due to something that is perceived to be a client error. [{0}] 400
CM-07 Resource not found. 404
CM-08 Multiple errors occurred. 422

9.4 Directory Errors

Directory Error Code Description HTTP Response Code
DS-01 Cluster [{0}] not found. 404
DS-02 Account [{0}] does not exist. 404
DS-03 Account [{0}] is not unique. 422
DS-04 Account with internal id [{0}] already exists in cluster [{1}]. 422
DS-05 Client does not have access to cluster [{0}]. 403
DS-06 Client id or secret are not unique. 422
DS-07 Client [{0}] does not exist. 404

9.5 ERP API Errors

ERP API Error Code Description HTTP Response Code
EA-01 Confirm Failed Import request contains ‘null’ id list. 400
EA-02 Transaction ids should be of type Long. Confirm transfer request [{0}]. 400

9.6 Master Cloud Errors

Master Cloud Error Code Description HTTP Response Code
MC-01 Notification [{0}] not found. 404
MC-02 expected id [{0}] but receive [{1}]. 404
MC-03 Can not assign more than one subscription of type [{0}] to company [{1}] and user [{2}] with the same valid to date [{3}]. 400
MC-04 Password must be different than name 400
MC-05 Password was already used before 400
MC-06 Password must be at least [{0}] character(s) long 400
MC-07 Password must contain at least [{0}] digit(s) 400
MC-08 Password must contain at least [{0}] letter(s) 400
MC-09 Password must contain at least [{0}] lower case letter(s) 400
MC-10 Password must contain at least [{0}] special character(s) 400
MC-11 Password must contain at least [{0}] upper case letter(s) 400
MC-12 Password is to fresh to change 400
MC-13 Password is not valid 400
MC-14 Password is not correct 400
MC-15 Password can't be changed 400
MC-16 Password must be different from the old one 400
MC-17 NPS already exists 400
MC-18 Account name must be unique 400
MC-19 Company name must be unique 400
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.