Errors

Common HTTP error codes returned by the commercetools Composable Commerce APIs and their meaning.

Error responses have the same overall structure across the different Composable Commerce APIs. General errors, such as InvalidJsonInput or ConcurrentModification are returned across all APIs. API-specific errors, such as ExtensionPredicateEvaluationFailed are only returned for a specific set of endpoints and update actions.

Representations

ErrorResponse

AuthErrorResponse

ErrorObject

ErrorResponse

Base representation of an error response containing common fields to all errors.

`statusCode` Int	HTTP status code corresponding to the error.
`message` String	First error message in the `errors` array.
`errors` Array of ErrorObject	Errors returned for a request. A single error response can contain multiple errors if the errors are related to the same HTTP status code such as `400`.

Example: json

{
  "statusCode": 400,
  "message": "First error message.",
  "errors": [
    {
      "code": "SyntaxError",
      "message": "First error message."
    },
    {
      "code": "SemanticError",
      "message": "Second error message."
    }
  ]
}

AuthErrorResponse

Represents errors related to authentication and authorization in a format conforming to the OAuth 2.0 specification.

`statusCode` Int	HTTP status code corresponding to the error.
`message` String	First error message in the `errors` array.
`errors` Array of ErrorObject	Authentication and authorization-related errors returned for a request.
`error` String	Error code as per the OAuth 2.0 specification. For example: `"access_denied"`.
`error_description` String	Plain text description of the first error.

Example: json

{
  "statusCode": 401,
  "message": "invalid_token",
  "errors": [
    {
      "code": "invalid_token",
      "message": "invalid_token"
    }
  ],
  "error": "invalid_token"
}

ErrorObject

Represents a single error. Multiple errors may be included in an ErrorResponse.

`code` String	Error identifier.
`message` String	Plain text description of the cause of the error.
`//` Any string parameter matching this regular expression	Error-specific additional fields.

400 Bad Request

The following general error codes can appear in responses with the HTTP status code 400:

AnonymousIdAlreadyInUse

Returned when the anonymous ID is being used by another resource.

The client application should choose another anonymous ID or retrieve an automatically generated one.

`code` String	`"AnonymousIdAlreadyInUse"`
`message` String	`"The given anonymous ID is already in use."`

DuplicateField

Returned when a field value conflicts with an existing value causing a duplicate.

`code` String	`"DuplicateField"`
`message` String	`"A duplicate value $duplicateValue exists for field $field."`
`field` String	Name of the conflicting field.
`duplicateValue` Any	Conflicting duplicate value.

DuplicateFieldWithConflictingResource

Returned when a field value conflicts with an existing value stored in a particular resource causing a duplicate.

`code` String	`"DuplicateFieldWithConflictingResource"`
`message` String	`"A duplicate value $duplicateValue exists for field $field on $conflictingResource."`
`field` String	Name of the conflicting field.
`duplicateValue` Any	Conflicting duplicate value.
`conflictingResource` Reference	Reference to the resource that has the conflicting value.

FeatureRemoved

Returned when the requested feature was removed.

`code` String	`"FeatureRemoved"`
`message` String	Description of the feature that is removed.

InvalidInput

Returned when an invalid input has been sent.

`code` String	`"InvalidInput"`
`message` String	Description of the constraints that are not met by the request. For example, `"Invalid $propertyName. It may be a non-empty string up to $maxLength"`.

InvalidJsonInput

Returned when an invalid JSON input has been sent. Either the JSON is syntactically incorrect or does not conform to the expected shape (for example is missing a required field).

The client application should validate the input according to the constraints described in the error message before sending the request.

`code` String	`"InvalidJsonInput"`
`message` String	`"Request body does not contain valid JSON."`
`detailedErrorMessage` String	Further explanation about why the JSON is invalid.

InvalidOperation

Returned when the resources involved in the request are not in a valid state for the operation.

The client application should validate the constraints described in the error message before sending the request.

`code` String	`"InvalidOperation"`
`message` String	Plain text description of the error.

InvalidField

Returned when a field has an invalid value.

`code` String	`"InvalidField"`
`message` String	`"The value $invalidValue is not valid for field $field."`
`field` String	Name of the field with the invalid value.
`invalidValue` Any	Value invalid for the field.
`allowedValues` Array of Any	Fixed set of allowed values for the field, if any.

InternalConstraintViolated

Returned when certain API-specific constraints were not met. For example, the specified Discount Code was never applied and cannot be updated.

`code` String	`"InternalConstraintViolated"`
`message` String	Plain text description of the constraints that were violated.

MaxResourceLimitExceeded

Returned when a resource type cannot be created as it has reached its limits.

The limits must be adjusted for this resource before sending the request again.

`code` String	`"MaxResourceLimitExceeded"`
`message` String	`"You have exceeded the limit of $limit resources of type $resourceTypeId."`
`exceededResource` ReferenceTypeId	Resource type that reached its maximum limit of configured elements (for example, 100 Zones per Project).

MoneyOverflow

Returned when a Money operation overflows the 64-bit integer range. See Money usage for more information.

`code` String	`"MoneyOverflow"`
`message` String	`"A Money operation resulted in an overflow."`

ObjectNotFound

Returned if the requested resource was not found or the Product Search index is inactive.

`code` String	`"ObjectNotFound"`
`message` String	`"A $resourceType with identifier $id was unexpectedly not found."` or `"No index found for project"`

ReferenceExists

Returned when a resource cannot be deleted because it is being referenced by another resource.

`code` String	`"ReferenceExists"`
`message` String	`"Can not delete a $resource while it is referenced by at least one $referencedBy."`
`referencedBy` ReferenceTypeId	Type of referenced resource.

ReferencedResourceNotFound

Returned when a resource referenced by a Reference or a ResourceIdentifier could not be found.

`id` String	Unique identifier of the referenced resource, if known.
`key` String	User-defined unique identifier of the referenced resource, if known.
`code` String	`"ReferencedResourceNotFound"`
`message` String	`"The referenced object of type $typeId $predicate was not found. It either doesn't exist, or it can't be accessed from this endpoint (e.g., if the endpoint filters by store or customer account)."`
`typeId` ReferenceTypeId	Type of referenced resource.

RequiredField

Returned when a value is not defined for a required field.

`code` String	`"RequiredField"`
`message` String	`"A value is required for field $field."`
`field` String	Name of the field missing the value.

ResourceSizeLimitExceeded

Returned when the resource exceeds the maximum allowed size of 16 MB.

`code` String	`"ResourceSizeLimitExceeded"`
`message` String	`"The resource size exceeds the maximal allowed size of 16 MB."`

SemanticError

Returned when a Discount predicate or API Extension predicate is not semantically correct.

`code` String	`"SemanticError"`
`message` String	Plain text description of the error concerning the predicate. For example, `"Invalid country code $countryCode provided for the field $fieldDefinition."`.

SyntaxError

Returned when a Discount predicate, API Extension predicate, or search query does not have the correct syntax.

`code` String	`"SyntaxError"`
`message` String	`"Syntax error while parsing $fieldDefinition."`

QueryTimedOut

Returned when the query times out.

If a query constantly times out, please check if it follows the performance best practices.

`code` String	`"QueryTimedOut"`
`message` String	`"The query timed out. If your query constantly times out, please check that it follows the performance best practices (see https://docs.commercetools.com/api/predicates/query#performance-considerations)."`

403 Forbidden

This error occurs when your API Client does not have the OAuth scope required for the endpoint. Use an API Client with the required permissions for this endpoint instead.

`code` String	`"insufficient_scope"`
`message` String	`"Insufficient scope. One of the following scopes is missing:"`

404 Not Found

The following general error codes can appear in responses with the HTTP status code 404:

ResourceNotFound

Returned when the resource addressed by the request URL does not exist.

`code` String	`"ResourceNotFound"`
`message` String	`"The Resource with ID $resourceId was not found."`

409 Conflict

The following general error codes can appear in responses with the HTTP status code 409:

ConcurrentModification

Returned when the request conflicts with the current state of the involved resources. Typically, the request attempts to modify a resource that is out of date (that is modified by another client since it was last retrieved). The client application should resolve the conflict (with or without involving the end user) before retrying the request.

`code` String	`"ConcurrentModification"`
`message` String	`"Object $resourceId has a different version than expected. Expected: $expectedVersion - Actual: $currentVersion."`
`currentVersion` Int	Current version of the resource.

SearchNotReady

Returned if the requested search service is not ready. The search might be deactivated or indexing is in progress.

`code` String	`"SearchNotReady"`
`message` String	`$Search is not ready. Check the indexing-status endpoint and that the feature has been activated in the project settings.`

413 Content Too Large

The following general error codes can appear in responses with the HTTP status code 413:

ContentTooLarge

Returned when the request results in too much data being returned from the API. Adjust the request query to reduce the size of the data returned.

`code` String	`"ContentTooLarge"`
`message` String	`"Content too large."`

500 Internal Server Error

The following general error codes can appear in responses with the HTTP status code 500:

General

Returned when a server-side problem occurs before or after data persistence. In some cases, the requested action may successfully complete after the error is returned. Therefore, it is recommended to verify the status of the requested resource after receiving a 500 error.

If you encounter this error, report it to the Composable Commerce support team.

`code` String	`"General"`
`message` String	Description about any known details of the problem, for example, `"Write operations are temporarily unavailable"`.

502 Bad Gateway

The following general error codes can appear in responses with the HTTP status code 502:

BadGateway

Returned when a server-side problem is caused by scaling infrastructure resources.

The client application should retry the request with exponential backoff up to a point where further delay is unacceptable.

`code` String	`"BadGateway"`
`message` String	Plain text description of the error.

503 Service Unavailable

The following general error codes can appear in responses with the HTTP status code 503:

OverCapacity

Returned when the service is having trouble handling the load.

The client application should retry the request with exponential backoff up to a point where further delay is unacceptable.

`code` String	`"OverCapacity"`
`message` String	Plain text description of the error.

PendingOperation

Returned when a previous conflicting operation is still pending and needs to finish before the request can succeed.

The client application should retry the request with exponential backoff up to a point where further delay is unacceptable. If the error persists, report it to the Composable Commerce support team.

`code` String	`"PendingOperation"`
`message` String	Plain text description of the error.

HTTP API-specific errors

Extensions

ErrorByExtension

ExtensionError

400 Bad Request -ExtensionPredicateEvaluationFailed

502 Bad Gateway -ExtensionBadResponse -ExtensionUpdateActionsFailed

504 Gateway Timeout -ExtensionNoResponse

ErrorByExtension

`id` String	Unique identifier of the Extension.
`key` String	User-defined unique identifier of the Extension.

ExtensionError

`code` String	Error code caused by the Extension. For example, `InvalidField`.
`message` String	Plain text description of the error.
`extensionId` String	Unique identifier of the Extension.
`extensionKey` String	User-defined unique identifier of the Extension.
`//` Any string parameter matching this regular expression	Error-specific additional fields.

400 Bad Request

The following error codes specific to API Extensions can appear in responses with the HTTP status code 400:

ExtensionPredicateEvaluationFailed

Returned when the predicate defined in the ExtensionTrigger could not be evaluated due to a missing field.

`code` String	`"ExtensionPredicateEvaluationFailed"`
`message` String	`"The compared field $fieldName is not present."`
`errorByExtension` ErrorByExtension	Details about the API Extension that was involved in the error.

Example: json

{
  "code": "ExtensionPredicateEvaluationFailed",
  "message": "The compared field 'cart' is not present",
  "errorByExtension": {
    "id": "{{extension-id}}",
    "key": "{{extension-key}}"
  }
}

502 Bad Gateway

The following error codes specific to API Extensions can appear in responses with the HTTP status code 502:

ExtensionBadResponse

Returned when the response from the API Extension could not be parsed successfully (such as a 500 HTTP status code, or an invalid JSON response).

`code` String	`"ExtensionBadResponse"`
`message` String	Description of the invalid Extension response. For example, `"The extension did not return the expected JSON."`.
`localizedMessage` LocalizedString	User-defined localized description of the error.
`extensionExtraInfo` Object	Any information that should be returned to the API caller.
`extensionErrors` Array of ExtensionError	Additional errors related to the API Extension.
`extensionBody` String	The response body returned by the Extension.
`extensionStatusCode` Int	Http status code returned by the Extension.
`extensionId` String	Unique identifier of the Extension.
`extensionKey` String	User-defined unique identifier of the Extension.

Example: json

{
  "code": "ExtensionBadResponse",
  "message": "'404' is not an expected status code.",
  "extensionErrors": [],
  "extensionBody": "{\r\n  \"message\": \"No HTTP resource was found that matches the request URI 'https://example.azurewebsites.net/api/extension'.\",\r\n  \"messageDetail\": \"No type was found that matches the controller named 'extension'.\"\r\n}",
  "extensionStatusCode": 404,
  "extensionId": "{{extension-id}}",
  "extensionKey": "{{extension-key}}"
}

ExtensionUpdateActionsFailed

Returned when update actions could not be applied to the resource (for example, because a referenced resource does not exist). This would result in a 400 Bad Request response if the same update action was sent from a regular client.

`code` String	`"ExtensionUpdateActionsFailed"`
`message` String	`"The extension returned update actions that could not be executed."`
`localizedMessage` LocalizedString	User-defined localized description of the error.
`extensionExtraInfo` Object	Any information that should be returned to the API caller.
`extensionErrors` Array of ExtensionError	Additional errors related to the API Extension.

Example: json

{
  "code": "ExtensionUpdateActionsFailed",
  "message": "The extension returned update actions that could not be executed.",
  "extensionErrors": [
    {
      "code": "InvalidField",
      "message": "The value '{\"message\":\"timeout of 2000ms exceeded\",\"name\":\"Error\",\"stack\"} is not valid for field 'response'.",
      "extensionId": "{{extension-id}}",
      "extensionKey": "{{extension-key}}",
      "field": "response"
    }
  ]
}

504 Gateway Timeout

The following error codes specific to API Extensions can appear in responses with the HTTP status code 504:

ExtensionNoResponse

Returned when the API Extension does not respond within the time limit, or could not be reached.

`code` String	`"ExtensionNoResponse"`
`message` String	`"Extension did not respond in time."`
`extensionId` String	Unique identifier of the API Extension.
`extensionKey` String	User-defined unique identifier of the API Extension, if available.

Example: json

{
  "code": "ExtensionNoResponse",
  "message": "Extension did not respond in time.",
  "extensionId": "{{extension-id}}",
  "extensionKey": "{{extension-key}}"
}

External OAuth

502 Bad Gateway or 504 Gateway Timeout -ExternalOAuthFailed

502 Bad Gateway or 504 Gateway Timeout

The following error codes specific to external OAuth can appear in responses with the HTTP status code 502 or 504:

ExternalOAuthFailed

Returned when an external OAuth Introspection endpoint does not return a response within the time limit, or the response isn't compliant with RFC 7662 (for example, an HTTP status code like 500).

`code` String	`"ExternalOAuthFailed"`
`message` String	Plain text description detailing the external OAuth error. For example, `"External OAuth did not respond in time."`.

Products

400 Bad Request -DuplicatePriceKey -DuplicatePriceScope -DuplicateVariantValues -VariantValues -DuplicateAttributeValue -DuplicateAttributeValues

400 Bad Request

The following error codes specific to Products can appear in responses with the HTTP status code 400:

DuplicatePriceKey

Returned when a Price key conflicts with an existing key.

Keys of Embedded Prices must be unique per ProductVariant.

`code` String	`"DuplicatePriceKey"`
`message` String	`"Duplicate price key: $priceKey. The price key must be unique per variant."`
`conflictingPrice` Price	Conflicting Embedded Price.

DuplicatePriceScope

Returned when a Price scope conflicts with an existing one during an Update Product request.

Every Price of a Product Variant must have a distinct combination of currency, Customer Group, country, and Channel that constitute the scope of a Price.

`code` String	`"DuplicatePriceScope"`
`message` String	`"Duplicate price scope: $priceScope. The combination of currency, country, customerGroup and channel must be unique for each price of a product variant."`
`conflictingPrice` Price	Conflicting Embedded Price.

DuplicateVariantValues

Returned when a Product Variant value conflicts with an existing one during an Update Product request.

`code` String	`"DuplicateVariantValues"`
`message` String	`"A duplicate combination of the variant values (sku, key, images, prices, attributes) exists."`
`variantValues` VariantValues	Every Product Variant must have a distinct combination of SKU, prices, and custom Attribute values.

VariantValues

`sku` String	SKU of the ProductVariant.
`prices` Array of PriceDraft	Embedded Prices of the ProductVariant.
`attributes` Array of Attribute	Attributes of the ProductVariant.

DuplicateAttributeValue

Returned when the Unique AttributeConstraint criteria are not met during an Update Product request.

`code` String	`"DuplicateAttributeValue"`
`message` String	`"Attribute can't have the same value in a different variant."`
`attribute` Attribute	Conflicting Attributes.

DuplicateAttributeValues

Returned when the CombinationUnique AttributeConstraint criteria are not met during an Update Product request.

`code` String	`"DuplicateAttributeValues"`
`message` String	`"The set of attributes must be unique across all variants."`
`attributes` Array of Attribute	Conflicting Attributes.

Product Types

400 Bad Request -AttributeDefinitionAlreadyExists -AttributeDefinitionTypeConflict -AttributeNameDoesNotExist -DuplicateEnumValues -EnumKeyAlreadyExists -EnumKeyDoesNotExist -EnumValuesMustMatch -EnumValueIsUsed

400 Bad Request

The following error codes specific to Product Types can appear in responses with the HTTP status code 400:

AttributeDefinitionAlreadyExists

Returned when the name of the AttributeDefinition conflicts with an existing Attribute.

The error is returned as a failed response to the Create ProductType request or Change AttributeDefinition Name update action.

`code` String	`"AttributeDefinitionAlreadyExists"`
`message` String	`"An attribute definition with name $attributeName already exists on product type $productTypeName."`
`conflictingProductTypeId` String	Unique identifier of the Product Type containing the conflicting name.
`conflictingProductTypeName` String	Name of the Product Type containing the conflicting name.
`conflictingAttributeName` String	Name of the conflicting Attribute.

AttributeDefinitionTypeConflict

Returned when the type is different for an AttributeDefinition using the same name in multiple Product Types.

The error is returned as a failed response to the Create ProductType request.

`code` String	`"AttributeDefinitionTypeConflict"`
`message` String	`"The attribute with name $attributeName has a different type on product type $productTypeName."`
`conflictingProductTypeId` String	Unique identifier of the Product Type containing the conflicting name.
`conflictingProductTypeName` String	Name of the Product Type containing the conflicting name.
`conflictingAttributeName` String	Name of the conflicting Attribute.

AttributeNameDoesNotExist

Returned when an AttributeDefinition does not exist for an Attribute name.

The error is returned as a failed response to the Change AttributeDefinition Name update action.

`code` String	`"AttributeNameDoesNotExist"`
`message` String	`"Attribute definition for $attributeName does not exist on type $typeName."`
`invalidAttributeName` String	Non-existent Attribute name.

DuplicateEnumValues

Returned when an AttributeEnumType or AttributeLocalizedEnumType contains duplicate keys.

`code` String	`"DuplicateEnumValues"`
`message` String	`"The enum values contain duplicate keys: $listOfDuplicateKeys."`
`duplicates` Array of String	Duplicate keys.

EnumKeyAlreadyExists

Returned when an AttributeEnumType or AttributeLocalizedEnumType contains a key that already exists.

`code` String	`"EnumKeyAlreadyExists"`
`message` String	`"The $attributeName attribute definition already contains an enum value with the key $enumKey."`
`conflictingEnumKey` String	Conflicting enum key.
`conflictingAttributeName` String	Name of the conflicting Attribute.

EnumKeyDoesNotExist

Returned when an AttributeEnumType or AttributeLocalizedEnumType already contains a value with the given key.

The error is returned as a failed response to the Change the key of an EnumValue update action.

`code` String	`"EnumKeyDoesNotExist"`
`message` String	`"The $fieldName field definition does not contain an enum value with the key $enumKey."`
`conflictingEnumKey` String	Conflicting enum key.
`conflictingAttributeName` String	Name of the conflicting Attribute.

EnumValuesMustMatch

Returned when during an order update of AttributeEnumType or AttributeLocalizedEnumType the new enum values do not match the existing ones.

The error is returned as a failed response to the Change the order of EnumValues and Change the order of LocalizedEnumValues update actions.

`code` String	`"EnumValuesMustMatch"`
`message` String	`"The given values must be equal to the existing enum values."`

EnumValueIsUsed

Returned when an enum value cannot be removed from an Attribute as it is being used by a Product.

The error is returned as a failed response to the Remove EnumValues from AttributeDefinition update action.

`code` String	`"EnumValueIsUsed"`
`message` String	`"$enumKeysTranscript is used by some products and cannot be deleted because the $attributeName attribute is required."`

Carts and Orders

RecurringOrderFailureError

400 Bad Request -OutOfStock -PriceChanged -DiscountCodeNonApplicable -ShippingMethodDoesNotMatchCart -InvalidItemShippingDetails -MatchingPriceNotFound -MissingTaxRateForCountry -CountryNotConfiguredInStore

RecurringOrderFailureError

Returned when a subsequent Order for a Recurring Order could not be processed.

`code` String	`"RecurringOrderFailure"`
`message` String	Plain text description of the error.
`details` Any	Details about the error's cause and the entities involved.

400 Bad Request

The following error codes specific to Orders can appear in responses to Create Order from Cart requests with the HTTP status code 400:

OutOfStock

Returned when some of the Line Items are out of stock at the time of placing an Order.

The error is returned as a failed response to:

Create Order from Cart, Create Order in Store from Cart, Create Order from Quote, and Create Order by Import requests on Orders.
Create Order from Cart, Create Order in Store from Cart, and Create Order from Quote requests on My Orders.
Create Order from Cart in BusinessUnit and Create Order from Quote in BusinessUnit requests on Associate Orders.

`code` String	`"OutOfStock"`
`message` String	`"Some line items are out of stock at the time of placing the order: $itemSku."`
`lineItems` Array of String	Unique identifiers of the Line Items that are out of stock.
`skus` Array of String	SKUs of the Line Items that are out of stock.

PriceChanged

Returned when the Price or Tax Rate of some Line Items or Shipping Rate of some Shipping Methods changed since they were last added to the Cart.

When a Cart is frozen, the error can be returned as a failed response to all update actions on Carts and My Carts.

The error is also returned as a failed response to:

Create Order from Cart and Create Order in Store from Cart requests on Orders.
Create Order from Cart and Create Order in Store from Cart requests on My Orders.
Create Order from Cart in BusinessUnit request on Associate Orders.

`code` String	`"PriceChanged"`
`message` String	Plain text description of the reason for the Price change. For example, `"The price or tax of some line items changed at the time of placing the order: $lineItems."`.
`lineItems` Array of String	Unique identifiers of the Line Items for which the Price or TaxRate has changed.
`shipping` Boolean	`true` if the ShippingRate has changed.

DiscountCodeNonApplicable

Returned when the Cart contains a Discount Code with a DiscountCodeState other than MatchesCart or ApplicationStoppedByGroupBestDeal.

The error is returned as a failed response to:

Create Cart and Create Cart in Store requests.
Create Cart and Create Cart in Store requests.
Create Cart in BusinessUnit request on Associate Carts.
Create Order from Cart and Create Order in Store from Cart requests on Orders.
Create Order from Cart and Create Order in Store from Cart requests on My Orders.
Add DiscountCode update action on Carts, if the associated Cart Discounts are inactive or invalid, or belongs to a different Store than the Cart.
Add DiscountCode update action on My Carts, if the associated Cart Discounts are inactive or invalid, or belongs to a different Store than the Cart.
Add DiscountCode update action on Order Edits, if the associated Cart Discounts are inactive or invalid, or belongs to a different Store than the Order.
Create Order from Cart in BusinessUnit request on Associate Orders.

`code` String	`"DiscountCodeNonApplicable"`
`message` String	`"The discountCode $discountCodeId cannot be applied to the cart."`
`discountCode` String	Discount Code passed to the Cart.
`reason` String	`"DoesNotExist"` or `"TimeRangeNonApplicable"`
`discountCodeId` String	Unique identifier of the Discount Code.
`validFrom` DateTime	Date and time (UTC) from which the Discount Code is valid.
`validUntil` DateTime	Date and time (UTC) until which the Discount Code is valid.
`validityCheckTime` DateTime	Date and time (UTC) the Discount Code validity check was last performed.

ShippingMethodDoesNotMatchCart

Returned when the Cart contains a ShippingMethod that is not allowed for the Cart. In this case, the ShippingMethodState value is DoesNotMatchCart.

When a Cart is frozen, the error can be returned as a failed response to all update actions on Carts and My Carts.

The error is also returned as a failed response to:

Create Order from Cart and Create Order in Store from Cart requests on Orders.
Create Order from Cart and Create Order in Store from Cart requests on My Orders.
Create Order from Cart in BusinessUnit request on Associate Orders.

`code` String	`"ShippingMethodDoesNotMatchCart"`
`message` String	`"The predicate does not match the cart."`

InvalidItemShippingDetails

Returned when Line Item or Custom Line Item quantities set under ItemShippingDetails do not match the sum of the quantities in their respective shipping details.

When a Cart is frozen, the error can be returned as a failed response to all update actions on Carts and My Carts.

The error is also returned as a failed response to:

Create Cart and Create Cart in Store requests and Add LineItem, Add CustomLineItem, Set LineItem ShippingDetails, Set CustomLineItem ShippingDetails, Add Shopping List, and Remove LineItem update actions on Carts.
Create Cart and Create Cart in Store requests, and Add LineItem, Set LineItem ShippingDetails, and Remove LineItem update actions on My Carts.
Create Cart in BusinessUnit request on Associate Carts.
Create Order from Cart, Create Order in Store from Cart, Create Order from Quote, and Create Order by Import requests on Orders.
Create Order from Cart, Create Order in Store from Cart, and Create Order from Quote requests on My Orders.
Add LineItem, Add CustomLineItem, Set LineItem ShippingDetails, Set CustomLineItem ShippingDetails, Add Shopping List, and Remove LineItem update actions on Order Edits.
Create Order from Cart in BusinessUnit and Create Order from Quote in BusinessUnit requests on Associate Orders.

`code` String	`"InvalidItemShippingDetails"`
`message` String	`"Inconsistent shipping details for $subject with ID $itemId. $subject quantity is $itemQuantity and shippingTargets quantity sum is $quantitySum."`
`subject` String	`"LineItem"` or `"CustomLineItem"`
`itemId` String	Unique identifier of the Line Item or Custom Line Item.

MatchingPriceNotFound

Returned when the Product Variant does not have a Price according to the Product priceMode value for a selected currency, country, Customer Group, or Channel.

The error can be returned as a failed response to all update actions on Carts and Staged Orders.

The error is also returned as a failed response to:

Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store requests and Set CustomerGroup update action on Customers.
Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store requests on My Customer Profile.
Create Cart, Create Cart in Store, Replicate Cart, and Replicate Cart in Store requests on Carts.
Create Cart and Create Cart in Store and Replicate My Cart requests on My Carts.
Create Cart in BusinessUnit and Replicate Cart in Business Unit requests on Associate Carts.
Create Order from Cart and Create Order in Store from Cart requests on Orders.
Create Order from Cart and Create Order in Store from Cart requests on My Orders.
Create Order from Cart in BusinessUnit request on Associate Orders.

`code` String	`"MatchingPriceNotFound"`
`message` String	`"The variant $variantId of product $productId does not contain a price for currency $currencyCode, $country, $customerGroup, $channel."`
`productId` String	Unique identifier of a Product.
`variantId` Int	Unique identifier of a ProductVariant in the Product.
`currency` CurrencyCode	Currency code of the country. Pattern: `^[A-Z]{3}$`
`country` CountryCode	Country code of the geographic location. Pattern: `^[A-Z]{2}$`
`customerGroup` CustomerGroupReference	Customer Group associated with the Price.
`channel` ChannelReference	Channel associated with the Price.

MissingTaxRateForCountry

Returned when the Tax Category of at least one of the lineItems, customLineItems, or shippingInfo in the Cart is missing the TaxRate matching country and state given in the shippingAddress of that Cart.

The error can be returned as a failed response to all update actions on Carts and Staged Orders.

The error is also returned as a failed response to:

Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store requests and Set CustomerGroup update action on Customers.
Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store on My Customer Profile.
Create Cart, Create Cart in Store, Replicate Cart, and Replicate Cart in Store requests on Carts.
Create Cart and Create Cart in Store and Replicate My Cart requests on My Carts.
Create Cart in BusinessUnit and Replicate Cart in Business Unit requests on Associate Carts.
Create Order from Cart and Create Order in Store from Cart requests on Orders.
Create Order from Cart and Create Order in Store from Cart requests on My Orders.
Create Order from Cart in BusinessUnit requests on Associate Orders.

`code` String	`"MissingTaxRateForCountry"`
`message` String	`"Tax category $taxCategoryId is missing a tax rate for country $countriesAndStates."`
`taxCategoryId` String	Unique identifier of the TaxCategory.
`country` CountryCode	Country code of the geographic location. Pattern: `^[A-Z]{2}$`
`state` String	State within the country, such as Texas in the United States.

CountryNotConfiguredInStore

Returned when a Cart or an Order in a Store references a country that is not included in the countries configured for the Store.

The error is returned as a failed response to:

Create Cart in Store request and Set Country update action on Carts.
Create Cart in Store request and Set Country update action on My Carts.
Create Order in Store from Cart and Create Order from Quote requests on Orders.
Create Order in Store from Cart and Create Order from Quote requests on My Orders.
Create Order by Import request on Order Import.
Set Country update action on Order Edits.

`code` String	`"CountryNotConfiguredInStore"`
`message` String	`"The country $country is not configured for the store $store."`
`storeCountries` Array of CountryCode	Countries configured for the Store.
`country` CountryCode	The country that is not configured for the Store but referenced on the Cart or Order. Pattern: `^[A-Z]{2}$`

Customers

400 Bad Request -InvalidCredentials -InvalidCurrentPassword -ExpiredCustomerPasswordToken -ExpiredCustomerEmailToken

409 Conflict -LockedField

400 Bad Request

The following error codes specific to Customers can appear in responses with the HTTP status code 400:

InvalidCredentials

Returned when a Customer with the given credentials (matching the given email/password pair) is not found and authentication fails.

The error is returned as a failed response to:

Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store requests on Customers.
Authenticate (sign in) Customer and Authenticate (sign in) Customer in Store requests on My Customer Profile.

`code` String	`"InvalidCredentials"`
`message` String	`"Account with the given credentials not found."`

InvalidCurrentPassword

Returned when the current password of the Customer does not match.

The error is returned as a failed response to:

Change Customer Password and Change Customer Password in a Store requests on Customers.
Change Customer Password and Change Customer Password in a Store requests on My Customer Profile.

`code` String	`"InvalidCurrentPassword"`
`message` String	`"The given current password does not match."`

ExpiredCustomerPasswordToken

Returned when the provided password token of the Customer has expired.

The error is returned as a failed response to:

Get Customer by password token and Get Customer in Store by password token requests
Reset password of Customer and Reset password of Customer in Store requests

`code` String	`"ExpiredCustomerPasswordToken"`
`message` String	`"The given password token has expired."`

ExpiredCustomerEmailToken

Returned when the provided email token of the Customer has expired.

The error is returned as a failed response to:

Get Customer by email token and Get Customer in Store by email token requests
Verify email of Customer and Verify email of Customer in Store requests

`code` String	`"ExpiredCustomerEmailToken"`
`message` String	`"The given email token has expired."`

409 Conflict

The following general error codes can appear in responses with the HTTP status code 409:

LockedField

Returned when two Customers are simultaneously created or updated with the same email address.

To confirm if the operation was successful, repeat the request.

`code` String	`"LockedField"`
`message` String	`"'$field' is locked by another request. Please try again later."`
`field` String	Field that is currently locked.

Cart Discounts

400 Bad Request -MaxCartDiscountsReached -StoreCartDiscountsLimitReached -MaxStoreReferencesReached

400 Bad Request

The following error codes specific to Cart Discounts can appear in responses with the HTTP status code 400:

MaxCartDiscountsReached

Returned when a Cart Discount cannot be created or activated as the limit for active Cart Discounts has been reached.

The error is returned as a failed response to:

Create CartDiscount and Create CartDiscount in Store requests
Change IsActive update action

`code` String	`"MaxCartDiscountsReached"`
`message` String	`"Maximum number of active cart discounts reached ($max)."`

StoreCartDiscountsLimitReached

Returned when a Cart Discount cannot be created or assigned to a Store as the limit for active Cart Discounts in a Store has been reached for one or more Stores in the request.

The error is returned as a failed response to:

Create CartDiscount and Create CartDiscount in Store requests
Add Store and Set Store update actions

`code` String	`"StoreCartDiscountsLimitReached"`
`message` String	`"Maximum number of active cart discounts reached for $stores."`
`stores` Array of StoreKeyReference	Stores for which the limit for active Cart Discounts that can exist has been reached.

MaxStoreReferencesReached

Returned when a Store cannot be added to a Cart Discount as the limit for Stores configured for a Cart Discount has been reached.

The error is returned as a failed response to:

Create CartDiscount and Create CartDiscount in Store requests
Add Store and Set Store update actions

`code` String	`"MaxStoreReferencesReached"`
`message` String	`"Maximum number of store discounts on a single cart discount reached $max".`

Discount Groups

400 Bad Request -MaxDiscountGroupsReached

400 Bad Request

The following error codes specific to Discount Groups can appear in responses with the HTTP status code 400:

MaxDiscountGroupsReached

Returned when a Discount Group cannot be created or activated as the limit for active Discount Groups has been reached.

The error is returned as a failed response to:

Create DiscountGroup request
Set IsActive update action

`code` String	`"MaxDiscountGroupsReached"`
`message` String	`"Maximum number of active discount groups reached ($max)."`

Product Discounts

404 Not Found -NoMatchingProductDiscountFound

404 Not Found

The following error codes specific to Product Discounts can appear in responses with the HTTP status code 404:

NoMatchingProductDiscountFound

Returned when a Product Discount could not be found that could be applied to the Price of a Product Variant.

The error is returned as a failed response to the Get Matching ProductDiscount request.

`code` String	`"NoMatchingProductDiscountFound"`
`message` String	`"Couldn't find a matching product discount for: productId=$productId, variantId=$variantId, price=$price."`

Shipping Methods

400 Bad Request -EditPreviewFailed

400 Bad Request

The following error code specific to Shipping Methods can appear in responses with the HTTP status code 400:

EditPreviewFailed

Returned when a preview to find an appropriate Shipping Method for an OrderEdit could not be generated.

The error is returned as a failed response to the Get Shipping Methods for an OrderEdit request.

`code` String	`"EditPreviewFailed"`
`message` String	`"Error while applying staged actions. ShippingMethods could not be determined."`
`result` OrderEditPreviewFailure	State of the OrderEdit where the `stagedActions` cannot be applied to the Order.

Product Projection Search

400 Bad Request -SearchFacetPathNotFound -SearchExecutionFailure -SearchDeactivated -SearchIndexingInProgress

400 Bad Request

The following error code specific to Product Projection Search can appear in responses with the HTTP status code 400:

SearchFacetPathNotFound

Returned when a search facet path could not be found.

`code` String	`"SearchFacetPathNotFound"`
`message` String	`"Facet path $path not found."`

SearchExecutionFailure

Returned when a search query could not be completed due to an unexpected failure.

`code` String	`"SearchExecutionFailure"`
`message` String	`"Something went wrong during the search query execution. In most case this happens due to usage of non-existing fields and custom product attributes. Please verify all filters and facets in your search query and make sure that all paths are correct."`

SearchDeactivated

Returned when the indexing of Product information is deactivated in a Project.

To activate indexing, call Change Product Search Indexing Enabled and set enabled to true.

`code` String	`"SearchDeactivated"`
`message` String	`"The endpoint is deactivated for this project. Please enable it via the Project endpoint, via the Merchant Center in the Project settings, or reach out to Support to enable it."`

SearchIndexingInProgress

Returned when the indexing of Product information is still in progress for Projects that have indexing activated.

`code` String	`"SearchIndexingInProgress"`
`message` String	`"The indexing is currently in progress. Please wait until the status is "Activated" to execute search requests."`

Projects

400 Bad Request -LanguageUsedInStores

400 Bad Request

The following error code specific to Projects can appear in responses with the HTTP status code 400:

LanguageUsedInStores

Returned when a language cannot be removed from a Project as it is being used by a Store.

The error is returned as a failed response to the Change Languages update action.

`code` String	`"LanguageUsedInStores"`
`message` String	`"Language(s) in use by a store cannot be deleted. Remove them in all the stores of this project first."`

Stores

400 Bad Request -ProjectNotConfiguredForLanguages -MissingRoleOnChannel

400 Bad Request

The following error codes specific to Stores can appear in responses with the HTTP status code 400:

ProjectNotConfiguredForLanguages

Returned when the languages set for a Store are not supported by the Project.

The error is returned as a failed response to the Set Languages update action.

`code` String	`"ProjectNotConfiguredForLanguages"`
`message` String	`"The project is not configured for given languages."`
`languages` Array of Locale	Languages configured for the Store.

MissingRoleOnChannel

Returned when one of the following states occur:

Channel is added or set on a Store with missing Channel roles.
Standalone Price references a Channel that does not contain the ProductDistribution role.

The error is returned as a failed response to:

Add Distribution Channel, Set Distribution Channel, Add Supply Channel, and Set Supply Channel update actions.
Create StandalonePrice request.

`code` String	`"MissingRoleOnChannel"`
`message` String	`"Given channel with $idOrKeyOfChannel does not have the required role $role."`
`channel` ChannelResourceIdentifier	ResourceIdentifier to a given Channel.
`missingRole` ChannelRoleEnum	`ProductDistribution` for Product Distribution Channels allowed for the Store. Also required for Standalone Prices. `InventorySupply` for Inventory Supply Channels allowed for the Store.

Product Selections

400 Bad Request -ProductAssignmentMissing -ProductPresentWithDifferentVariantSelection

400 Bad Request

ProductAssignmentMissing

Returned when a Product is not assigned to the Product Selection. The error is returned as a failed response either to the Set Variant Selection or to the Set Variant Exclusion update action.

`code` String	`"ProductAssignmentMissing"`
`message` String	For Product Selection of mode Individual, the message is: `"A Product Variant Selection can only be set for a Product that has previously been added to the Product Selection."` For Product Selection of mode IndividualExclusion, the message is: `"A Variant Exclusion can only be set for a Product that has previously been added to the Product Selection of type Individual Exclusion."`
`product` ProductReference	Reference to the Product for which the error was returned.

ProductPresentWithDifferentVariantSelection

Returned when a Product is already assigned to a Product Selection, but the Product Selection has either a different Product Variant Selection or a different Product Variant Exclusion.

The error is returned as a failed response either to the Add Product or to the Exclude Product update action.

`code` String	`"ProductPresentWithDifferentVariantSelection"`
`message` String	`"Product is already present with the following different $variantSelections."`
`product` ProductReference	Reference to the Product for which the error was returned.
`existingVariantSelection` ProductVariantSelection	Existing Product Variant Selection or Exclusion for the Product in the Product Selection.

Standalone Prices

400 Bad Request -DuplicateStandalonePriceScope -OverlappingStandalonePriceValidity -MissingRoleOnChannel

400 Bad Request

The following error codes specific to Standalone Prices can appear in responses with the HTTP status code 400:

DuplicateStandalonePriceScope

Returned when the given Price scope conflicts with the Price scope of an existing Standalone Price. Every Standalone Price associated with the same SKU must have a distinct combination of currency, country, Customer Group, Channel, and validity periods (validFrom and validUntil).

The error is returned as a failed response to the Create StandalonePrice request.

`code` String	`"DuplicateStandalonePriceScope"`
`message` String	`"Duplicate standalone price scope for SKU: $sku. The combination of SKU, currency, country, customerGroup, channel, validFrom and validUntil must be unique for each standalone price."`
`conflictingStandalonePrice` StandalonePriceReference	Reference to the conflicting Standalone Price.
`sku` String	SKU of the ProductVariant to which the conflicting Standalone Price is associated.
`currency` CurrencyCode	Currency code of the country. Pattern: `^[A-Z]{3}$`
`country` CountryCode	Country code of the geographic location. Pattern: `^[A-Z]{2}$`
`customerGroup` CustomerGroupResourceIdentifier	CustomerGroup for which the Standalone Price is valid.
`channel` ChannelResourceIdentifier	Channel for which the Standalone Price is valid.
`validFrom` DateTime	Date and time (UTC) from which the Standalone Price is valid.
`validUntil` DateTime	Date and time (UTC) until which the Standalone Price is valid.

OverlappingStandalonePriceValidity

Returned when a given Price validity period conflicts with an existing one. Every Standalone Price associated with the same SKU and with the same combination of currency, country, Customer Group, and Channel, must have non-overlapping validity periods (validFrom and validUntil).

The error is returned as a failed response to the Create StandalonePrice request.

`code` String	`"OverlappingStandalonePriceValidity"`
`message` String	`Two standalone prices have overlapping validity periods."`
`conflictingStandalonePrice` StandalonePriceReference	Reference to the conflicting Standalone Price.
`sku` String	SKU of the ProductVariant to which the conflicting Standalone Price is associated.
`currency` CurrencyCode	Currency code of the country. Pattern: `^[A-Z]{3}$`
`country` CountryCode	Country code of the geographic location. Pattern: `^[A-Z]{2}$`
`customerGroup` CustomerGroupResourceIdentifier	CustomerGroup for which the Standalone Price is valid.
`channel` ChannelResourceIdentifier	Channel for which the Standalone Price is valid.
`validFrom` DateTime	Date and time (UTC) from which the Standalone Price is valid.
`validUntil` DateTime	Date and time (UTC) until which the Standalone Price is valid.
`conflictingValidFrom` DateTime	Date and time (UTC) from which the conflicting Standalone Price is valid.
`conflictingValidUntil` DateTime	Date and time (UTC) until which the conflicting Standalone Price is valid.

MissingRoleOnChannel

Returned when one of the following states occur:

Channel is added or set on a Store with missing Channel roles.
Standalone Price references a Channel that does not contain the ProductDistribution role.

The error is returned as a failed response to:

Add Distribution Channel, Set Distribution Channel, Add Supply Channel, and Set Supply Channel update actions.
Create StandalonePrice request.

`code` String	`"MissingRoleOnChannel"`
`message` String	`"Given channel with $idOrKeyOfChannel does not have the required role $role."`
`channel` ChannelResourceIdentifier	ResourceIdentifier to a given Channel.
`missingRole` ChannelRoleEnum	`ProductDistribution` for Product Distribution Channels allowed for the Store. Also required for Standalone Prices. `InventorySupply` for Inventory Supply Channels allowed for the Store.

Associate Roles B2B

400 Bad Request -AssociateMissingPermission

400 Bad Request

The following error codes specific to Associate Roles can appear in responses with the HTTP status code 400:

AssociateMissingPermission

Returned when an Associate is missing a Permission on a B2B resource.

`code` String	`"AssociateMissingPermission"`
`message` String	When an action is performed by an Associate: `"Associate '$idOfAssociate' has no rights to $action in business-unit '$idOrKeyOfBusinessUnit'. Needs '$requiredPermission'."` When an action is performed for another Associate, like viewing their Cart: `"Associate '$idOfAssociate' has no rights to $action for customer '$idOfCustomer' in business-unit '$idOrKeyOfBusinessUnit'. Needs '$requiredPermission'."` When viewing an entity: `"Associate '$idOfAssociate' has no rights to $action in business-unit '$idOrKeyOfBusinessUnit'. Needs '$requiredViewMyPermission' or '$requiredViewOthersPermission'."`
`associate` CustomerResourceIdentifier	ResourceIdentifier to the Associate that tried to perform the action.
`businessUnit` BusinessUnitResourceIdentifier	ResourceIdentifier to the BusinessUnit.
`associateOnBehalf` CustomerResourceIdentifier	ResourceIdentifier of the Associate on whose behalf the action is performed.
`permissions` Array of Permission	The Permissions that the Associate performing the action lacks. At least one of these Permissions is needed.

Audit Log-specific errors

429 Too Many Requests -Too Many Requests

429 Too Many Requests

The following error code specific to Change History can appear in responses with the HTTP status code 429:

Too Many Requests

Returned when the Query Records request exceeds the rate limit.

Reduce the date range and resource types in your query to minimize the token usage, or retry the request after some time (indicated in the Retry-After header).

`code` String	`"TooManyRequests"`
`message` String	`"You have made too many requests. Please try again later."`

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"` An error identifier.
`message` String	A plain language description of the cause of an error.

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"` An error identifier.
`message` String	A plain language description of the cause of an error.
`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"` An error identifier.
`message` String	A plain language description of the cause of an error.

DuplicateAttributeValueError

The Unique AttributeConstraintEnum was violated.

`code` String	`"DuplicateAttributeValue"` An error identifier.
`message` String	A plain language description of the cause of an error.
`attribute` Attribute	The attribute in conflict.

DuplicateAttributeValuesError

The CombinationUnique AttributeConstraintEnum was violated.

`code` String	`"DuplicateAttributeValues"` An error identifier.
`message` String	A plain language description of the cause of an error.
`attributes` Array of Attribute

DuplicateFieldError

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

`code` String	`"DuplicateField"` An error identifier.
`message` String	A plain language description of the cause of an error.
`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"` An error identifier.
`message` String	A plain language description of the cause of an error.
`variantValues` VariantValues	The offending variant values.

GenericError

`code` String	`"Generic"` An error identifier.
`message` String	A plain language description of the cause of an error.

NewMasterVariantAdditionNotAllowedError

Returned when attempting to create a ProductVariant and set it as the Master Variant in the same ProductVariantImport.

`code` String	`"NewMasterVariantAdditionNotAllowed"` An error identifier.
`message` String	`"Adding a new variant as master variant is not allowed."`

InsufficientScopeError

`code` String	`"insufficient_scope"` An error identifier.
`message` String	A plain language description of the cause of an error.

InvalidCredentialsError

`code` String	`"InvalidCredentials"` An error identifier.
`message` String	A plain language description of the cause of an error.

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"` An error identifier.
`message` String	A plain language description of the cause of an error.
`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	The index of the resource in the import request that contains the invalid field.

InvalidFieldsUpdateError

Returned when a field cannot be updated.

`code` String	`"InvalidFieldUpdate"` An error identifier.
`message` String	`"The following fields are currently not supported for changes/updates"`
`fields` Array of String	Fields that cannot be updated.

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"` An error identifier.
`message` String	A plain language description of the cause of an error.

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"` An error identifier.
`message` String	A plain language description of the cause of an error.

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"` An error identifier.
`message` String	A plain language description of the cause of an error.

InvalidScopeError

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

`code` String	`"invalid_scope"` An error identifier.
`message` String	A plain language description of the cause of an error.

InvalidStateTransitionError

`code` String	`"InvalidTransition"` An error identifier.
`message` String	A plain language description of the cause of an error.
`currentState` ProcessingState	Every Import Operation is assigned one of the following states.
`newState` ProcessingState	Every Import Operation is assigned one of the following states.

InvalidTokenError

`code` String	`"invalid_token"` An error identifier.
`message` String	A plain language description of the cause of an error.

RequiredFieldError

A required field is missing a value.

`code` String	`"RequiredField"` An error identifier.
`message` String	A plain language description of the cause of an error.
`field` String	The name of the field.

ResourceCreationError

`code` String	`"ResourceCreation"` An error identifier.
`message` String	A plain language description of the cause of an error.
`resource` Any	The resource that was created.

ResourceDeletionError

`code` String	`"ResourceDeletion"` An error identifier.
`message` String	A plain language description of the cause of an error.
`resource` Any	The resource that was deleted.

ResourceNotFoundError

`code` String	`"ResourceNotFound"` An error identifier.
`message` String	A plain language description of the cause of an error.
`resource` Any	The resource that was not found.

ResourceUpdateError

`code` String	`"ResourceUpdate"` An error identifier.
`message` String	A plain language description of the cause of an error.
`resource` Any	The resource that was updated.

Errors

Representations.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ErrorResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

AuthErrorResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ErrorObject.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

General errors.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

400 Bad Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

AnonymousIdAlreadyInUse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateField.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateFieldWithConflictingResource.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

FeatureRemoved.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

InvalidInput.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

InvalidJsonInput.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

InvalidOperation.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

InvalidField.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

InternalConstraintViolated.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

MaxResourceLimitExceeded.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

MoneyOverflow.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ObjectNotFound.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ReferenceExists.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ReferencedResourceNotFound.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

RequiredField.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ResourceSizeLimitExceeded.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

SemanticError.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

SyntaxError.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

QueryTimedOut.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

403 Forbidden.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

404 Not Found.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ResourceNotFound.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

409 Conflict.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ConcurrentModification.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

SearchNotReady.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

413 Content Too Large.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ContentTooLarge.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

500 Internal Server Error.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

General.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

502 Bad Gateway.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

BadGateway.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

503 Service Unavailable.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

OverCapacity.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

PendingOperation.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

HTTP API-specific errors.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Extensions.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ErrorByExtension.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExtensionError.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

400 Bad Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExtensionPredicateEvaluationFailed.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

502 Bad Gateway.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExtensionBadResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExtensionUpdateActionsFailed.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

504 Gateway Timeout.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExtensionNoResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

External OAuth.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

502 Bad Gateway or 504 Gateway Timeout.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ExternalOAuthFailed.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Products.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

400 Bad Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicatePriceKey.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicatePriceScope.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateVariantValues.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

VariantValues.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateAttributeValue.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateAttributeValues.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Types.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

400 Bad Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

AttributeDefinitionAlreadyExists.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

AttributeDefinitionTypeConflict.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

AttributeNameDoesNotExist.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DuplicateEnumValues.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

EnumKeyAlreadyExists.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

EnumKeyDoesNotExist.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

EnumValuesMustMatch.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

EnumValueIsUsed.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Carts and Orders.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

RecurringOrderFailureError.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

400 Bad Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

OutOfStock.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

PriceChanged.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

DiscountCodeNonApplicable.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

ShippingMethodDoesNotMatchCart.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Representations

ErrorResponse

AuthErrorResponse

ErrorObject

General errors

400 Bad Request

AnonymousIdAlreadyInUse

DuplicateField

DuplicateFieldWithConflictingResource

FeatureRemoved

InvalidInput

InvalidJsonInput

InvalidOperation

InvalidField

InternalConstraintViolated

MaxResourceLimitExceeded

MoneyOverflow

ObjectNotFound

ReferenceExists

ReferencedResourceNotFound

RequiredField

ResourceSizeLimitExceeded

SemanticError

SyntaxError

QueryTimedOut

403 Forbidden

404 Not Found

ResourceNotFound

409 Conflict

ConcurrentModification

SearchNotReady

413 Content Too Large

ContentTooLarge

500 Internal Server Error

General

502 Bad Gateway

BadGateway

503 Service Unavailable

OverCapacity

PendingOperation

HTTP API-specific errors

Extensions

ErrorByExtension

ExtensionError

400 Bad Request

ExtensionPredicateEvaluationFailed

502 Bad Gateway

ExtensionBadResponse

ExtensionUpdateActionsFailed

504 Gateway Timeout

ExtensionNoResponse

External OAuth

502 Bad Gateway or 504 Gateway Timeout

ExternalOAuthFailed

Products

400 Bad Request

DuplicatePriceKey

DuplicatePriceScope

DuplicateVariantValues

VariantValues

DuplicateAttributeValue

DuplicateAttributeValues

Product Types

400 Bad Request

AttributeDefinitionAlreadyExists

AttributeDefinitionTypeConflict

AttributeNameDoesNotExist

DuplicateEnumValues

EnumKeyAlreadyExists

EnumKeyDoesNotExist

EnumValuesMustMatch

EnumValueIsUsed

Carts and Orders

RecurringOrderFailureError

400 Bad Request

OutOfStock

PriceChanged

DiscountCodeNonApplicable

ShippingMethodDoesNotMatchCart

InvalidItemShippingDetails