diff --git a/_raml/apps/products/examples/get_product_productid_crossselling_response.json b/_raml/apps/products/examples/get_product_productid_crossselling_response.json
index c02e53fcb..14803ed31 100644
--- a/_raml/apps/products/examples/get_product_productid_crossselling_response.json
+++ b/_raml/apps/products/examples/get_product_productid_crossselling_response.json
@@ -225,6 +225,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
@@ -355,6 +360,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/get_product_productid_response.json b/_raml/apps/products/examples/get_product_productid_response.json
index 20f7a524e..36a2224aa 100644
--- a/_raml/apps/products/examples/get_product_productid_response.json
+++ b/_raml/apps/products/examples/get_product_productid_response.json
@@ -226,6 +226,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/get_product_response.json b/_raml/apps/products/examples/get_product_response.json
index db167d128..d117e9f83 100644
--- a/_raml/apps/products/examples/get_product_response.json
+++ b/_raml/apps/products/examples/get_product_response.json
@@ -113,6 +113,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
@@ -252,6 +257,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
@@ -516,6 +526,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/get_product_updated_property_response.json b/_raml/apps/products/examples/get_product_updated_property_response.json
index 9cb0d557f..4f12c34e5 100644
--- a/_raml/apps/products/examples/get_product_updated_property_response.json
+++ b/_raml/apps/products/examples/get_product_updated_property_response.json
@@ -223,6 +223,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/patch_product_productid_crossselling_response.json b/_raml/apps/products/examples/patch_product_productid_crossselling_response.json
index cb5af5964..78142b0cb 100644
--- a/_raml/apps/products/examples/patch_product_productid_crossselling_response.json
+++ b/_raml/apps/products/examples/patch_product_productid_crossselling_response.json
@@ -161,6 +161,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/Cust001",
"productNumber": "Cust001",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
@@ -286,6 +291,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/HP-003",
"productNumber": "HP-003",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/patch_product_productid_request.json b/_raml/apps/products/examples/patch_product_productid_request.json
index 496dfa9f7..4578f4202 100644
--- a/_raml/apps/products/examples/patch_product_productid_request.json
+++ b/_raml/apps/products/examples/patch_product_productid_request.json
@@ -35,4 +35,64 @@
"op": "replace",
"path": "/producttype",
"value": "6489A241-7B85-54B0-0B69-C0A8020205ED"
+},
+{
+ "op": "add",
+ "path": "/isNew",
+ "value": true
+},
+{
+ "op": "add",
+ "path": "/newnessDate",
+ "value": "2023-08-08T22:00:00Z"
+},
+{
+ "op": "add",
+ "path": "/video",
+ "value": { "type":"YouTube", "id":"XXXXXXXXXXX" }
+},
+{
+ "op": "add",
+ "path": "/isManufacturerPriceRRP",
+ "value": false
+},
+{
+ "op": "add",
+ "path": "/referencePriceInfo",
+ "value": {"refAmount":1, "refUnit":"piece", "refContentAmount":2}
+},
+{
+ "op": "add",
+ "path": "/isShippingLinkVisible",
+ "value": true
+},
+{
+ "op": "add",
+ "path": "/customisationInfo",
+ "value": {"isCustomizable":1, "customizableTextLength":50, "customizableHeadlineText":"headline text"}
+},
+{
+ "op": "add",
+ "path": "/title",
+ "value": "My title"
+},
+{
+ "op": "add",
+ "path": "/productDataSheet",
+ "value": {"fileName":"myfilename.jpg", "url":"https://www.example.com/file.jpg"}
+},
+{
+ "op": "add",
+ "path": "/shippingMethodsRestrictedTo",
+ "value": ["64BDD860-786B-D5AB-F659-AC1200030B22"]
+},
+{
+ "op": "add",
+ "path": "/isVATInfoVisible",
+ "value": true
+},
+{
+ "op": "add",
+ "path": "/productCode",
+ "value": "examplecode"
}]
\ No newline at end of file
diff --git a/_raml/apps/products/examples/patch_product_productid_response.json b/_raml/apps/products/examples/patch_product_productid_response.json
index b633318e0..87d487dc1 100644
--- a/_raml/apps/products/examples/patch_product_productid_response.json
+++ b/_raml/apps/products/examples/patch_product_productid_response.json
@@ -195,6 +195,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/post_product_find_response.json b/_raml/apps/products/examples/post_product_find_response.json
index f8fb73cde..ccaa1fdda 100644
--- a/_raml/apps/products/examples/post_product_find_response.json
+++ b/_raml/apps/products/examples/post_product_find_response.json
@@ -107,6 +107,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/Cust001",
"productNumber": "Cust001",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
@@ -240,6 +245,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/HP-003",
"productNumber": "HP-003",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
@@ -440,6 +450,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/HS-001",
"productNumber": "HS-001",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/post_product_response.json b/_raml/apps/products/examples/post_product_response.json
index be110315b..aea338ce1 100644
--- a/_raml/apps/products/examples/post_product_response.json
+++ b/_raml/apps/products/examples/post_product_response.json
@@ -64,6 +64,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Awesome Products Company",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/examples/put_product_productid_crossselling_response.json b/_raml/apps/products/examples/put_product_productid_crossselling_response.json
index cb5af5964..78142b0cb 100644
--- a/_raml/apps/products/examples/put_product_productid_crossselling_response.json
+++ b/_raml/apps/products/examples/put_product_productid_crossselling_response.json
@@ -161,6 +161,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/Cust001",
"productNumber": "Cust001",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
@@ -286,6 +291,11 @@
"sfUrl": "http://pm.epages.com/epages/apidocu.sf/?ObjectPath=/Shops/apidocu/Products/HP-003",
"productNumber": "HP-003",
"isProductNumberVisible": true,
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Bass by Dr.Boom",
"upc": null,
"ean": null,
diff --git a/_raml/apps/products/products.raml b/_raml/apps/products/products.raml
index aac241511..65e18783b 100644
--- a/_raml/apps/products/products.raml
+++ b/_raml/apps/products/products.raml
@@ -108,6 +108,17 @@ post:
- /productImage⁴
- /stocklevel²³
- /visible¹
+ - /isNew
+ - /newnessDate
+ - /video
+ - /isManufacturerPriceRRP
+ - /referencePriceInfo
+ - /isShippingLinkVisible
+ - /customisationInfo
+ - /title
+ - /productDataSheet
+ - /shippingMethodsRestrictedTo
+ - /productCode
**¹** supports *add* only
**²** value will not be replaced, but changed, i.e. if the stocklevel is 3 and you add 1, you will get 4; if you add -5, you will get -2.
diff --git a/_raml/apps/search/examples/post_search_products_response.json b/_raml/apps/search/examples/post_search_products_response.json
index 479d3aff6..b6307414f 100644
--- a/_raml/apps/search/examples/post_search_products_response.json
+++ b/_raml/apps/search/examples/post_search_products_response.json
@@ -113,6 +113,11 @@
"isCustomizable": true,
"customizableTextLength": 50,
"customizableHeadlineText": "Customize your product",
+ "newnessDate": "2023-08-08T00:00:00Z",
+ "refAmount": 1,
+ "refUnit": "piece",
+ "refContentAmount": 2,
+ "productCode": null,
"manufacturer": "Dr. Boom",
"upc": null,
"ean": null,
diff --git a/apps/data-types.md b/apps/data-types.md
index 4a34fe9bd..2d2c70cb5 100644
--- a/apps/data-types.md
+++ b/apps/data-types.md
@@ -627,6 +627,11 @@ This object is used for the attributes of basePrice, depositPrice, ecoParticipat
| isCustomizable | boolean | Indicates if the product is customizable in the storefront. |
| customizableTextLength | number | The maximum length of the custom text the customer can enter for a product in the storefront. |
| customizableHeadlineText | string | The headline for the customization text field in the storefront. |
+| newnessDate | string | The date when the 'New' marker is set to expire. Expressed according to ISO 8601. |
+| refAmount | string | The product reference amount with respect to the product price (e.g. every 1 'piece' costs 10,00 €) |
+| refUnit | string | The product reference unit. Can be *byte*, *kilobyte*, *megabyte*, *gigabyte*, *terrabyte*, *gram*, *kilogram*, *milligram*, *ounce*, *pound*, *tone*, *litre*, *cubicfoot*, *cubicinch*, *cubicmetre*, *cubicyard*, *fluidounce*, *gallon*, *millilitre*, *quart*, *metre*, *centimetre*, *foot*, *inch*, *kilometre*, *millimetre*, *yard*, *piece*, *bottle*, *box*, *can*, *capsule*, *carton*, *glass*, *kit*, *pack*, *packet*, *pair*, *roll*, *set*, *sheet*, *ticket*, *unit*, *second*, *day*, *hour*, *minute*, *month*, *night*, *week*, *year*, *squaremetre*, *squarecentimetre*, *squarefoot*, *squareinch*, *squaremillimetre*, *squareyard* |
+| refContentAmount | string | The number of reference units that is packaged within the product itself (e.g. the product contains 2 'piece(s)') |
+| productCode | string | The product code (e.g. EAN, UPC, ASIN und ISBN) |
## product (create request)
@@ -752,6 +757,11 @@ This object is used for the attributes of basePrice, depositPrice, ecoParticipat
| isCustomizable | boolean | Indicates if the product is customizable in the storefront. |
| customizableTextLength | number | The maximum length of the custom text the customer can enter for a product in the storefront. |
| customizableHeadlineText | string | The headline for the customization text field in the storefront. |
+| newnessDate | string | The date when the 'New' marker is set to expire. Expressed according to ISO 8601. |
+| refAmount | string | The product reference amount with respect to the product price (e.g. every 1 'piece' costs 10,00 €) |
+| refUnit | string | The product reference unit. Can be *byte*, *kilobyte*, *megabyte*, *gigabyte*, *terrabyte*, *gram*, *kilogram*, *milligram*, *ounce*, *pound*, *tone*, *litre*, *cubicfoot*, *cubicinch*, *cubicmetre*, *cubicyard*, *fluidounce*, *gallon*, *millilitre*, *quart*, *metre*, *centimetre*, *foot*, *inch*, *kilometre*, *millimetre*, *yard*, *piece*, *bottle*, *box*, *can*, *capsule*, *carton*, *glass*, *kit*, *pack*, *packet*, *pair*, *roll*, *set*, *sheet*, *ticket*, *unit*, *second*, *day*, *hour*, *minute*, *month*, *night*, *week*, *year*, *squaremetre*, *squarecentimetre*, *squarefoot*, *squareinch*, *squaremillimetre*, *squareyard* |
+| refContentAmount | string | The number of reference units that is packaged within the product itself (e.g. the product contains 2 'piece(s)') |
+| productCode | string | The product code (e.g. EAN, UPC, ASIN und ISBN) |
| query | string | The search query. |
| fallbackQuery | string | The fallback used if the original query did not produce any results. |
| facets | array of [facet](page:apps-data-types#facet) | The refined search filter options. |