Product Competition Prices

This resource accepts the data for the "Price Competition" feature along with the "Marketplace Subsidies" data. It uses the same authorization mechanism as it described here: API Specifications.

Endpoint

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

Example:

https://SELLERCENTER-API/shop-api/v1/competition-prices/?ServiceName=SHOP&Timestamp=2013-08-27T15%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

psin optional

PSIN

WZHBD1301RD05164114-12345-01-01

Product identifier unique among all the marketplaces

competitorName required

Competitor Name

Lazada TH

The name of the competitor marketplace

competitorPrice required

Competitor Price

12499.00

The lowest competitor price for the moment

competitorUrl required

Competitor URL

http://www.lazada.co.th/gopro-hero4-silver-adventure-edition-4643752.html

The full competitor page URL

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.

⚠️new. Was added on April 26, 2016.

updatedAt required

Date of updating

2016-03-18T13:10:05+0100

ISO8601 compatible date

Request Example

{  
   "Request":{  
      "CompetitionPrices":[  
         {  
            "shopSku":"sku-123",
            "psin":"psin-123",
            "competitorPrice":99,
            "competitorName":"RocketInternet",
            "competitorUrl":"http:\/\/www.rocket-internet.de",
            "status":"active",
            "updatedAt":"2016-01-26T09:07:33+0100"           
         }
      ]
   }
}

Success response

Request was successfully interpreted:

{  
   "SuccessResponse":{  
      "Head":{  
         "RequestId":"",
         "RequestAction":"CompetitionPrices",
         "ResponseType":""
      },
      "Body":{  
         "processed": {  
            "1": {"shopSku": "P1-1"}
         },
         "failed": {
            "0": {
               "shopSku": "sku-123",
               "reason": "Object validation failed: `competitorPrice` is not a valid price"
            }
         }
      }
   }
}

Error response

In case request message was improperly formatted:

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