Product Recommended Prices

This resource accepts the data for the "Recommended Prices" feature. It uses the same authorisation mechanism as it described here: API Specifications.

Endpoint

https://SELLERCENTER-API/shop-api/v1/recommended-prices

Example:

https://SELLERCENTER-API/shop-api/v1/recommended-prices/?ServiceName=SHOP&Timestamp=2016-10-14T22%3A56%3A11%2B0200&Signature=2c93bd83586b212f9f29a3af4bc25f5ba4d0b754687b3082ed821be1d92b993

Parameters

Field

Title

Example

Description

shopSku required

Shop Product SKU (aka Shop SKU)

AD108FFAJRI0BDBID-596769

Product SKU unique in a venture scope

recommendedPrice required

Recommended Price

45.55

The price which is recommended for the product

reason optional

Reason

This price is the most successful

The reason for recommending the value for the price

status optional

Status

active

Price recommendation status.

Accepts 2 possible values: ["active", "deleted"]. Default value is "active".

If you set up "deleted" status, price recommendation will not appear on the SC UI.

Request Example

{  
   "Request":{  
      "RecommendedPrices":[  
         {  
            "shopSku":"sku-123",
            "recommendedPrice":45.55,
            "reason":"Above 50 is too expensive",
            "status":"active"
         }
      ]
   }
}

Success response

Request was successfully interpreted:

{  
   "SuccessResponse":{  
      "Head":{  
         "RequestId":"",
         "RequestAction":"RecommendedPrices",
         "ResponseType":"",
         "Timestamp": "2016-10-15T06:45:37+0200"
      },
      "Body":{  
         "processed": {  
            "0": {"shopSku": "sku-123"}
         },
         "failed": {
            "1": {
               "shopSku": "sku-1234",
               "reason": "Object validation failed: Empty shopSku provided."
            }
         }
      }
   }
}

Error response

In case request message was improperly formatted:

{
  "ErrorResponse": {
    "Head": {
      "RequestAction": "RecommendedPrices",
      "ErrorType": "",
      "ErrorCode": "1001",
      "ErrorMessage": "Empty products list"
    },
    "Body": ""
}