Errors

Error responses in the Import API.

Representations

Error responses always contain the following fields:

  • code - String
    An error identifier.
  • message - String
    A plain language description of the cause of an error.

An error response may contain additional fields depending on the type of an error, for example, attribute in DuplicateAttributeValueError.

Below is the list of all error responses.

List of error responses

AccessDeniedError

This is the generic error code for access denied. In case of a wrong scope, an InvalidScopeError will be returned.

code​
String​
"access_denied"
message​
String​

ConcurrentModificationError

The request conflicts with the current state of the involved resources. This error typically occurs when the request attempts to modify a resource that is out of date, that is, it has been modified by another client since the last time it was retrieved by the system attempting to update it. The client application should resolve the conflict (with or without involving the end-user) before retrying the request.

code​
String​
"ConcurrentModification"
message​
String​
specifiedVersion​
Int​

The version specified in the failed request.

currentVersion​
Int​

The current version of the resource.

conflictedResource​
Any​

The resource in conflict.

ContentionError

code​
String​
"Contention"
message​
String​

DuplicateAttributeValueError

The Unique Attribute Constraint was violated.

code​
String​
"DuplicateAttributeValue"
message​
String​
attribute​
Attribute​

The attribute in conflict.

DuplicateAttributeValuesError

The CombinationUnique Attribute Constraint was violated.

code​
String​
"DuplicateAttributeValues"
message​
String​
attributes​
Array of Attribute​

DuplicateFieldError

The given value already exists for a field that is checked for unique values.

code​
String​
"DuplicateField"
message​
String​
field​
String​

The name of the field.

duplicateValue​
Any​

The offending duplicate value.

DuplicateVariantValuesError

The given combination of values of a Product Variant conflicts with an existing one. Every Product Variant must have a distinct combination of SKU, prices, and custom attribute values.

code​
String​
"DuplicateVariantValues"
message​
String​
variantValues​
VariantValues​

The offending variant values.

GenericError

code​
String​
"Generic"
message​
String​

InsufficientScopeError

code​
String​
"insufficient_scope"
message​
String​

InvalidCredentialsError

code​
String​
"InvalidCredentials"
message​
String​

InvalidFieldError

A given field is not supported. This error occurs, for example, if the field variants, which is not supported by Product Import, is sent to the Product Import endpoint.

code​
String​
"InvalidField"
message​
String​
field​
String​

The name of the field.

invalidValue​
Any​

The invalid value.

allowedValues​
Array of Any​

The set of allowed values for the field, if any.

resourceIndex​
Int​

InvalidInput

An invalid input has been sent to the service. The client application should validate the input according to the constraints described in the error message before sending the request again.

code​
String​
"InvalidInput"
message​
String​

InvalidJsonInput

An invalid JSON input has been sent to the service. Either the JSON is syntactically incorrect or the JSON has an unexpected shape, for example, a required field is missing. The client application should validate the input according to the constraints described in the error message before sending the request again.

code​
String​
"InvalidJsonInput"
message​
String​

InvalidOperation

The resources in the request are not in the valid state for the operation. The client application should validate the constraints described in the error message before sending the request again.

code​
String​
"InvalidOperation"
message​
String​

InvalidScopeError

The requested scope is invalid, unknown, malformed, or exceeds the scope granted by the resource owner.

code​
String​
"invalid_scope"
message​
String​

InvalidStateTransitionError

code​
String​
"InvalidTransition"
message​
String​
currentState​

Every Import Operation is assigned with one of the following states.

newState​

Every Import Operation is assigned with one of the following states.

InvalidTokenError

code​
String​
"invalid_token"
message​
String​

RequiredFieldError

A required field is missing a value.

code​
String​
"RequiredField"
message​
String​
field​
String​

The name of the field.

ResourceCreationError

code​
String​
"ResourceCreation"
message​
String​
resource​
Any​

ResourceDeletionError

code​
String​
"ResourceDeletion"
message​
String​
resource​
Any​

ResourceNotFoundError

code​
String​
"ResourceNotFound"
message​
String​
resource​
Any​

ResourceUpdateError

code​
String​
"ResourceUpdate"
message​
String​
resource​
Any​