curl --request POST \
--url https://{host}/product-catalog/v1/Products/import \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "White Sandwich Bread 500 g",
"externalId": "EXT-1001",
"hierarchyId": "1001",
"imageLink": "https://example.com/images/bread_white_500.jpg",
"eans": [
"4820001000006"
],
"brand": {
"id": "Daily Loaf",
"name": "BR-001"
},
"suppliers": [
{
"id": "Fresh Market",
"name": "SUP-001"
},
{
"id": "Local Bakery Co.",
"name": "SUP-002"
}
],
"saleUnit": "piece",
"weightUnit": "kg",
"unitOfMeasure": "piece",
"unitsPerPiece": 1,
"isWeightable": false,
"restrictions": [],
"metadata": null
}
]
'{}{
"errors": [
{
"name": "<string>",
"message": "<string>",
"details": null
}
]
}Upsert products
Imports products (upserts existing products and adds new products). Usually performed via direct integration with Data Import service.
curl --request POST \
--url https://{host}/product-catalog/v1/Products/import \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "White Sandwich Bread 500 g",
"externalId": "EXT-1001",
"hierarchyId": "1001",
"imageLink": "https://example.com/images/bread_white_500.jpg",
"eans": [
"4820001000006"
],
"brand": {
"id": "Daily Loaf",
"name": "BR-001"
},
"suppliers": [
{
"id": "Fresh Market",
"name": "SUP-001"
},
{
"id": "Local Bakery Co.",
"name": "SUP-002"
}
],
"saleUnit": "piece",
"weightUnit": "kg",
"unitOfMeasure": "piece",
"unitsPerPiece": 1,
"isWeightable": false,
"restrictions": [],
"metadata": null
}
]
'{}{
"errors": [
{
"name": "<string>",
"message": "<string>",
"details": null
}
]
}Body
Name of the product.
Identifier of the product in external system.
Identifier of the hierarchy node the product belongs to.
URL of the image associated with the entity.
List of EANs associated with the product.
Represents product's brand.
Show child attributes
Show child attributes
List of suppliers associated with the product.
Show child attributes
Show child attributes
The unit in which the product is sold (e.g., piece, pack, box).
The unit of weight measurement for the product (e.g., kg, g, lb).
The measurement unit used to quantify the product (e.g., liter, meter, piece).
The number of units contained in a single piece of the product.
Indicates if the product is sold by weight.
List of restrictions (e.g., Age16, Age18, etc.) associated with the product.
The restriction type applied to a product.
Age16, Age18, Age20, AlcoholOnElections Additional metadata associated with the product.
Show child attributes
Show child attributes
Response
OK
The response is of type object.