Do you have to retrieve all products?

No, you don't have to retrieve all products. There are many ways to filter a product export so that only the desired products are returned.

  • Search filters (e.g., "freeText", "showInactive", "missingEtimForVersion") are effective for excluding irrelevant products.
  • It's possible to specify a list of products you want to export. You can do this by providing a comma-separated list of which "importCode", "productNo" or "altProductNo" you want.
  • You can search for products that match a specified product name or description (name or alternativeName)
  • You can also filter the result to only match products with a specified product owner, status, product template, product group or supplier by providing a list of corresponding "importCodes" for these
    • productOwnerImportCodes
    • productStatusImportCodes
    • productTypeImportCodes
    • productGroupImportCodes
    • supplierImportCodes

See the swagger documentation for comprehensive information on how to filter which products you want to export.

Do you have to retrieve all information on products?

No, you can choose to exclude information you don't need from the response. This is recommended to achieve faster response, reduce load on the feed® server, and reduce the amount of data that needs to be transported.

  • The query parameter "excludeData" is used to filter out information you don't need. By default, complete information about the product is returned, but by entering which information you don't need here, you can reduce data volume and significantly increase performance.
    The following values can be excluded: PRODUCT_HEAD, ATTRIBUTE, TEXT, MEDIA, RELATION, LINKED_TO, VARIANT, STRUCTURE, PACKAGING, ETIM.
    If you enter all of the above as filters, you will get a response that only contains a list of identifiers for the products you have exported. This is a quick way to retrieve the ID for products if you only need to do a lookup to verify if a product exists.

In addition, you can significantly reduce the amount of data, especially if you have many attributes of type "data register" or export ETIM data, by choosing not to include available/legal choices on these beyond what is actually specified as a value.

  • The query parameter "includeOptions" equal to "false" can be used to only retrieve the selected value on an attribute with its associated list of legal values.
    This should be used if you don't need to retrieve information about what other values (options) an attribute can have.

Can you retrieve information about a deleted product?

  • You can include deleted products by setting "includeDeleted" to true.

How can you only retrieve what has changed since last time (delta export)? 

To only retrieve what has changed, you must set a specific time interval and set the "changesOnly" flag.
If an "exportTo" date is not set, it will be assumed to apply up to and including today. It is recommended to primarily retrieve data with "changesOnly" to prevent unnecessary repeated retrieval of products.
Ref params: "changesOnly", "exportFrom", "exportTo".

Is "basedata" the same as a product? 

Basedata is not the same as a product, but it defines what a product contains. Basedata is the master data that the customer has created for custom fields in feed®, this is what defines what information, relationships, roles, product templates and statuses are available on a product in feed®.
Via basedata export, you can retrieve attributes, texts, statuses, relationships and much more. See swagger documentation for further information.

I'm getting an error message 401: Unauthorized. What should I do?

The error message is common with incorrect or lack of authentication. For example, a bearer token has expired. You can check this page: Authentication.

Can you retrieve products from a specific folder in a structure?

Yes, it's possible to retrieve a specific folder with "importCode", but you don't get a list of all products in the subfolders. You therefore need to traverse down through all subfolders to get hold of the products belonging to the corresponding folders. Ref api: "/export/structure/structures/{importCode}".

What comes out in a structure export?

When you do a structure export, you will get information about which products, media, and attributes are there, but not all information about them. To get this information, you need to do a product/media export.

How can I know what comes out in an export?

In the swagger documentation, you will see an example of what a successful export will look like. Swagger documentation is available at https://<host URL>/export/swagger-ui/ where <host URL> is the address of your feed installation.

  • No labels