curl --request POST \
--url https://{host}/product-catalog/v2/articles/import \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "Coca-Cola Classic 1.5L",
"externalId": "EXT-1001",
"hierarchyId": "2001",
"imageLink": "https://example.com/images/cocacola-1-5l.jpg",
"brand": {
"id": "Coca-Cola",
"name": "BR-COCA"
},
"eans": [
"5449000131805"
],
"suppliers": [
{
"id": "Metro Cash & Carry",
"name": "SUP-201"
},
{
"id": "Retail Partners",
"name": "SUP-202"
}
],
"saleUnit": "bottle",
"units": null,
"unitOfMeasure": "liter",
"unitsPerPiece": 1,
"isWeightable": false,
"restrictions": [],
"metadata": {
"isSugarFree": false,
"volume": "1.5L"
},
"depositItemExternalId": null,
"hamperItemExternalIds": [],
"prices": [
{
"storeId": "-1",
"salePrice": 19.99,
"pricePerUnit": null,
"pricePerPiece": null,
"isWithoutBarcode": null,
"taxCode": "VAT20"
},
{
"storeId": "STORE-002",
"salePrice": 19.99,
"pricePerUnit": null,
"pricePerPiece": null,
"isWithoutBarcode": true,
"taxCode": "VAT10"
}
]
}
]
'{}{
"errors": [
{
"name": "<string>",
"message": "<string>",
"details": null
}
]
}Upsert articles
Import or update full article information(including prices) in bulk. Usually performed via direct integration with Data Import service.
curl --request POST \
--url https://{host}/product-catalog/v2/articles/import \
--header 'Content-Type: application/json' \
--data '
[
{
"name": "Coca-Cola Classic 1.5L",
"externalId": "EXT-1001",
"hierarchyId": "2001",
"imageLink": "https://example.com/images/cocacola-1-5l.jpg",
"brand": {
"id": "Coca-Cola",
"name": "BR-COCA"
},
"eans": [
"5449000131805"
],
"suppliers": [
{
"id": "Metro Cash & Carry",
"name": "SUP-201"
},
{
"id": "Retail Partners",
"name": "SUP-202"
}
],
"saleUnit": "bottle",
"units": null,
"unitOfMeasure": "liter",
"unitsPerPiece": 1,
"isWeightable": false,
"restrictions": [],
"metadata": {
"isSugarFree": false,
"volume": "1.5L"
},
"depositItemExternalId": null,
"hamperItemExternalIds": [],
"prices": [
{
"storeId": "-1",
"salePrice": 19.99,
"pricePerUnit": null,
"pricePerPiece": null,
"isWithoutBarcode": null,
"taxCode": "VAT20"
},
{
"storeId": "STORE-002",
"salePrice": 19.99,
"pricePerUnit": null,
"pricePerPiece": null,
"isWithoutBarcode": true,
"taxCode": "VAT10"
}
]
}
]
'{}{
"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.
Represents product's brand.
Show child attributes
Show child attributes
List of EANs associated with the product.
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).
Total weight of the product.
The measurement unit used to quantify the product (e.g., kg, 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.
Additional metadata associated with the product.
Show child attributes
Show child attributes
Deposit item's externa id (from external system) associated with the product.
Hamper item's external ids (from external system) associated with the product.
Artices prices per store.
Show child attributes
Show child attributes
Response
OK
The response is of type object.