This is documentation preview demonstrates how to use Product Search with GraphQL, a feature that is currently in early access. This preview might not be in sync with our official documentation available on https://docs.commercetools.com.

Import Operations

Get the import status of an individual resource.

Import Operations can be retrieved by id or be queried within a specific Import Container.

Both Import Operations and Import Summary can be used to monitor the progress of imports. Import Operations focus on the status of each import resource, and Import Summaries report the status of an Import Container by the number of resources in each ProcessingState.

Import Operations are automatically deleted 48 hours after they are created.

To achieve the best performance with the Import API, we recommend to use fewer than 200 000 Import Operations per Import Container.

Representations

ImportOperation

ImportOperationPagedResponse

ProcessingState

ImportResponse

ImportOperationStatus

ImportOperationState

UnresolvedReferences

ImportOperation

An Import Operation is automatically deleted in 48 hours after it is created.

Import Operation describes the import status of a specific resource.

`id` String	The ID of the ImportOperation.
`version` Int	The version of the ImportOperation.
`importContainerKey` String	The key of the ImportContainer.
`resourceKey` String	The key of the resource.
`state` ProcessingState	The import status of the resource. Set to `rejected` or `validationFailed` if the import of the resource was not successful.
`resourceVersion` Int	The version of the imported resource when the import was successful.
`errors` Array of ErrorObject	Contains an error if the import of the resource was not successful. See Errors.
`unresolvedReferences` Array of UnresolvedReferences	In case of unresolved status this array will show the unresolved references
`expiresAt` DateTime	The expiration time of the ImportOperation.
`createdAt` DateTime	The time when the ImportOperation was created.
`lastModifiedAt` DateTime	The last time When the ImportOperation was modified.

Example: json

{
  "version": 3,
  "state": "validationFailed",
  "errors": [
    {
      "code": "RequiredField",
      "message": "The required field 'key' is missing.",
      "field": "key"
    }
  ],
  "importContainerKey": "category-import-container",
  "id": "252c6ed3-c668-4610-afe9-87b9255e62e0",
  "resourceKey": "root-category",
  "resourceType": "category",
  "createdAt": "2018-02-05T09:47:16.648Z",
  "lastModifiedAt": "2018-02-05T09:47:16.649Z",
  "expiresAt": "2018-02-08T09:47:16.649Z"
}

ImportOperationPagedResponse

PagedQueryResult for Import Operations.

`limit` Int	Number of results requested. Default: `20`Minimum: `0`Maximum: `500`
`offset` Int	Number of elements skipped. Default: `0`Maximum: `10000`
`count` Int	The actual number of results returned.
`total` Int	The total number of import operations matching the query.
`results` Array of ImportOperation	The array of Import Operations matching the query.

Example: json

{
  "limit": 100,
  "offset": 0,
  "count": 1,
  "total": 1,
  "results": [
    {
      "version": 3,
      "state": "validationFailed",
      "errors": [
        {
          "code": "RequiredField",
          "message": "The required field 'key' is missing.",
          "field": "key"
        }
      ],
      "importContainerKey": "category-import-container",
      "resourceKey": "root-category",
      "resourceType": "category",
      "id": "252c6ed3-c668-4610-afe9-87b9255e62e0",
      "createdAt": "2018-02-05T09:47:16.648Z",
      "lastModifiedAt": "2018-02-05T09:47:16.649Z",
      "expiresAt": "2018-02-08T09:47:16.649Z"
    }
  ]
}

ProcessingState

Every Import Operation is assigned one of the following states.

processing: The initial state assigned if the request payload (JSON structure and fields) meets Import API specifications. The resource import is in progress.
validationFailed: Either the request payload is missing the data as per Import API specifications, or even though the references were resolved, the data does not meet validation constraints. Generates the ImportValidationFailed Event.
unresolved: The import request contains KeyReferences to resources that do not exist in your Composable Commerce Project. Generates the ImportUnresolved Event.
waitForMasterVariant: Products must have at least one Product Variant, also known as the Master Variant. If you import a Product without a Master Variant, the import request will have this status until another import request includes Master Variant data for the Product. Generates the ImportWaitForMasterVariant Event.
imported: The resource was successfully imported.
rejected: The resource could not be imported. References were resolved, but the system could not import the data due to an internal server error and the retry limit was reached. Generates the ImportOperationRejected Event.
canceled: The import request was canceled and the resource was not imported.

ImportResponse

The response of each resource import endpoint, such as Import Categories and Import ProductTypes.

operationStatus

Array of ImportOperationStatus

A list of the ID's and validation statuses of new ImportOperations.

MaxItems: 20

Example: json

{
  "operationStatus": [
    {
      "state": "processing",
      "operationId": "252c6ed3-c668-4610-afe9-87b9255e62e0"
    }
  ]
}

ImportOperationStatus

The ID and validation status of a new ImportOperation.

`operationId` String	The ID of the ImportOperation.
`state` ImportOperationState	The validation state of the ImportOperation.
`errors` Array of ErrorObject	The validation errors for the ImportOperation. See Errors.

Example: json

{
  "state": "processing",
  "operationId": "252c6ed3-c668-4610-afe9-87b9255e62e0"
}

ImportOperationState

Describes the validation state of a newly created ImportOperation.

processing: The import is in process. This is the initial state of the ImportOperation.
validationFailed: The validation of the import resource failed.

UnresolvedReferences

References a resource which could not be resolved.

`key` String	The `key` of the resource.
`typeId` ReferenceType	The type of resource.

Example: json

{
  "key": "key-of-unresolved-category-being-referenced",
  "typeId": "category"
}

Get ImportOperation

GET

https://import.{region}.commercetools.com/{projectKey}/import-operations/{id}

Retrieves the ImportOperation of a given ID.

OAuth 2.0 Scopes:

manage_import_containers:{projectKey}view_import_containers:{projectKey}

Path parameters:

`region` String	The Region in which the Project is hosted.
`projectKey` String	The Project key.
`id` String	The operation identifier

Response:

200

ImportOperation

asapplication/json

Request Example:cURL

curl --get https://import.{region}.commercetools.com/{projectKey}/import-operations/{id} -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ImportOperationjson

{
  "version": 3,
  "state": "validationFailed",
  "errors": [
    {
      "code": "RequiredField",
      "message": "The required field 'key' is missing.",
      "field": "key"
    }
  ],
  "importContainerKey": "category-import-container",
  "id": "252c6ed3-c668-4610-afe9-87b9255e62e0",
  "resourceKey": "root-category",
  "resourceType": "category",
  "createdAt": "2018-02-05T09:47:16.648Z",
  "lastModifiedAt": "2018-02-05T09:47:16.649Z",
  "expiresAt": "2018-02-08T09:47:16.649Z"
}

Query ImportOperations

GET

https://import.{region}.commercetools.com/{projectKey}/import-containers/{importContainerKey}/import-operations

Retrieves all ImportOperations of a given ImportContainer key.

OAuth 2.0 Scopes:

manage_import_containers:{projectKey}view_import_containers:{projectKey}

Path parameters:

`region` String	The Region in which the Project is hosted.
`projectKey` String	The Project key.
`importContainerKey` String	The key of the Import Container.

Query parameters:

`sort` String	See Sorting. The parameter can be passed multiple times.
`limit` Int	Number of results requested. Default: `20` Minimum: `0` Maximum: `500`
`offset` Int	Number of elements skipped. Default: `0` Maximum: `10000`
`resourceKey` String	The key of the ImportOperation to retrieve.
`state` ProcessingState	The state of the ImportOperations to retrieve.
`debug` Boolean	In case of `Unresolved`, it will show the unresolved references. Default: `false`

Response:

200

ImportOperationPagedResponse

asapplication/json

Request Example:cURL

curl --get https://import.{region}.commercetools.com/{projectKey}/import-containers/{importContainerKey}/import-operations -i \
--header "Authorization: Bearer ${BEARER_TOKEN}"

200 Response Example: ImportOperationPagedResponsejson

{
  "limit": 100,
  "offset": 0,
  "count": 1,
  "total": 1,
  "results": [
    {
      "version": 3,
      "state": "validationFailed",
      "errors": [
        {
          "code": "RequiredField",
          "message": "The required field 'key' is missing.",
          "field": "key"
        }
      ],
      "importContainerKey": "category-import-container",
      "resourceKey": "root-category",
      "resourceType": "category",
      "id": "252c6ed3-c668-4610-afe9-87b9255e62e0",
      "createdAt": "2018-02-05T09:47:16.648Z",
      "lastModifiedAt": "2018-02-05T09:47:16.649Z",
      "expiresAt": "2018-02-08T09:47:16.649Z"
    }
  ]
}

Import Operations

Representations.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ImportOperation.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ImportOperationPagedResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ProcessingState.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ImportResponse.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ImportOperationStatus.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

ImportOperationState.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

UnresolvedReferences.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Get ImportOperation.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Query ImportOperations.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}.css-ik49mw{-webkit-flex-shrink:0;-ms-flex-negative:0;flex-shrink:0;}.css-ik49mw *:not([fill='none']){fill:inherit;}.css-ik49mw,.css-ik49mw image{width:24px;height:24px;}

Representations

ImportOperation

ImportOperationPagedResponse

ProcessingState

ImportResponse

ImportOperationStatus

ImportOperationState

UnresolvedReferences

Get ImportOperation

Query ImportOperations