What is the text/code returned from "/import/import"?

This is a GUID used to identify the specific import. By sending the code to "/import/{guid}/status", you will receive the current status of the import.

Example of GUID structure: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx.

Do both "identifiers" need to be sent?

No, it is enough to send one of them to identify which product it concerns, provided that the product already exists. It is recommended to use "importCode" as this is a unique value. "productNo" is not a unique value and therefore multiple products can have the same value.

Please note that if you perform operations that require a unique product, such as an update, it will fail if you use "productNo" as the identifier and the specified value is not unique.

What is "importMode"?

"importMode" is a field that gives feed® an indication of whether a specific import should be able to create, update, or delete products depending on whether they exist already.

Possible values for "importMode" are:

  • CREATE_OR_UPDATE
    • Here, the import will attempt to update a product provided that an identifier is set in the input and uniquely identifies a product in feed®. If the identifier matches multiple products, the update will fail. If no match is found for the identifier, the import will create a new product.
  • CREATE
    • Here, the import will always attempt to create a new product. If "allowDuplicate" is set to "false", creation will fail if the specified "productNo" already exists. If "allowDuplicate" is set to true, a new (duplicate) product with the same "productNo" will be created.
      No updates to existing products will be performed when this mode is specified.
  • UPDATE
    • Here, the import will always attempt to edit an existing product. If the identifier matches multiple products, the update will fail. If no match is found for the identifier, a warning will be given that the product was not found.
      No new products will be created when this mode is specified.

What is the "importCode" for a product?

The "importCode" for a product is a unique internal ID for a product in the feed® installation. This can, for example, be included in an export of products. You cannot determine or change the "importCode" for a product in feed®.

This is included in API exports, and you can also see which "importCode" a product has by looking at the numbers in the last part of the URL when you are on a product in the web interface.

In the example above, the "importCode" for the product you're viewing is = 8.


How can I know what is valid input in an import? See the documentation of input (and output) in the swagger documentation for the endpoint you are using. Swagger documentation is available at https://<host URL>/import/swagger-ui/ where <host URL> is the address of your feed installation.

Do all fields for a product need to be sent when only one field needs to be updated?

No, it's sufficient to send only the fields you want to update.

How long does it take to import a product?

It's not possible to give a specific time. This depends on many factors such as the number of fields, specific fields, jobs already running on the feed® server, etc.

Why aren't error messages displayed in "/import/{guid}/status"?

To get more information about warnings or error messages for imported or attempted imported products, you can send the parameter "includeDeviationReport" equal to "true". By default, only an overview of progress and number of warnings and errors is returned.

Can you see the submitted JSON in "/import/{guid}/status"?

Yes, by setting "includeImportJSON" to "true", you can get the JSON from the import.

Why are there two different import and export endpoints for media?

"/import/media" is phased out and replaced with "/media/import". If you use the former, you should update the integration to use the correct media API for this. Phased-out endpoints ([deprecated]) may become unavailable in the future, but a notice will be sent out about this.

Is it possible to import structures via API?

Yes, separate endpoints have been introduced in the import API to create and maintain structures in feed®. See swagger documentation for further details on what is possible.

  • No labels