Processing states indicate the status of a resource during the import process.
The references of a resource are resolved when, during the asynchronous import process, all the resources referenced by the resource are present in your Composable Commerce Project.
As the Import API does not duplicate the validation logic of other HTTP APIs, a successful reference resolution does not imply the data consistency in your Composable Commerce Project.
For example, the uniqueness of a Product Variant's
sku cannot be checked by the Import API but only by other HTTP APIs.
Every Import Operation is assigned one of the following states.
The initial state assigned if the request payload (JSON structure and fields) meets Import API specifications. The resource import is in progress.
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.
The import request contains KeyReferences to resources that do not exist in your Composable Commerce Project.
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.
The resource was successfully imported.
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.
The import request was canceled and the resource was not imported.
The Import state flow
A successful Import Operation goes through the following states:
processing: The initial state assigned to a resource if the format (JSON structure and fields) meets the Import API's specifications. This state indicates that the import is in progress.
imported: The resource is either created or updated in your Composable Commerce Project. The resource import is completed.
unresolved may be temporarily assigned.
An Import Operation in the following states requires your attention:
unresolved: Some referenced resources do not currently exist in Composable Commerce. This state is automatically resolved when missing resources are added to your Composable Commerce Project.
validationFailed: This state is assigned in two cases:
rejected: References were resolved, but the system could not import the data due to an internal server error and the retry limit was reached. Some problem with the data is likely to exist which must be addressed before a follow-up Import Request is made. You can check the error messages by querying the ImportOperation. You must retry importing
rejectedimport operations to successfully complete the resource import.