Introduction

Following documentation describes Seller Center (SC) Shop (Consumer) API.

Relation between Shop and SC

From the perspective of SC, Shop is a leading system which takes care about categories and attributes.

From the perspective of Shop, SC is a leading system, which takes care about products, sellers and its related data (product images, seller logos, promotions etc.).

Both systems are tightly coupled on the data level, which has to be always in sync.

API calls are initiated from SC side by "Update Worker" or "Update Price/Stock Worker" cron jobs (usually once every minute) or after the seller interaction and are executed synchronously or asynchronously by Gearman Job Server (depending on SC server and configuration).

Not all the fields in the request messages are required, some of them depends on the consumer, request purpose or SC configuration.

JSON request sample

{
  "api":1,
  "method":"Product.updatePrices",
  "params":{
    "productsInfo":[
      {
        "product_id":"13",
        "config_id":"7",
        "seller_sku":"duplicate",
        "sku":"ZI501OT89AAKANMY-13",
        "attribute_set":"1",
        "price":"100"
      },
      {
        "product_id":"14",
        "config_id":"7",
        "seller_sku":"Duplicate_1",
        "sku":"ZI501OT88AALANMY-14",
        "price":"150"
      },
      {
        "product_id":"15",
        "config_id":"8",
        "seller_sku":"14728-14378",
        "sku":"ZI501OT87AAMANMY-15",
        "attribute_set":"1",
        "price":"180",
        "price_special":"170",
        "special_from_date":"2014-05-01 00:00:00",
        "special_to_date":"2014-06-01 00:00:00"
      },
      {
        "product_id":"16",
        "config_id":"9",
        "seller_sku":"duplicate_2",
        "sku":"ZI501OT86AANANMY-16",
        "attribute_set":"2",
        "price":"1000",
        "price_special":"950",
        "special_from_date":"2014-06-01 00:00:00",
        "special_to_date":"2014-07-01 00:00:00"
      } 
    ]
  },
  "id":1
}

JSON response sample

[
   {
      "api":1,
      "result":[
         {
            "status":"success",
            "product":{
               "seller_sku":"DCSWS 1",
               "sku":"RA301OTADBFYEGAMZ-243427",
               "id":"243427",
               "config_id":"154798",
               "updated_at":"2014-04-14 12:44:06"
            }
         }
      ],
      "id":1
   }
]

Following chapters describes the structure of the message in more details.