服务目录

公告栏

接入流程

开发指南

常用工具

业务流程

常见问题

面向买家服务

面向商家服务

京麦服务市场

供应商服务

京东云服务

【SKU服务】接口导航


1. 增加SKU信息 2. 修改SKU信息
3. 修改SKU库存信息 4. 修改SKU价格信息
5. 删除SKU信息 6. 获取单个SKU信息
7. 根据外部ID获取商品SKU 8. 根据商品ID列表获取商品SKU信息

1. 增加SKU信息
  

l  接口名称 

    360buy.ware.sku.add

 

l  功能说明

             通过api   增加sku信息

 

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

ware_id

long

是

1100000015

商品id

attributes

String

是

100041:150041^1000046:15844

Sku属性

jd_price

String

是

100

京东价格

stock_num

long

是

20

库存

outer_id

String

否

 

 sku外部id

trade_no

String

 

 

 

l  返回结果

名称

类型

是否必须

示例值

描述

sku_id

String

 

 

Sku id

created

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

l  返回示例

  JSON数据格式

{

    "ware_sku_add_response": {

        "code": "0"

        "sku_id": "1100050413",

        "created": "2012-01-06 13:08:59",

    }

}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuAddRequest wareSkuAddRequest= new WareSkuAddRequest();

wareSkuAddRequest.setAttributes("1000000046:150028556^1000000041:150027909");

wareSkuAddRequest.setJdPrice("30");

wareSkuAddRequest.setStockNum("3");

wareSkuAddRequest.setWareId("1100016736");

WareSkuAddResponse res = client.execute(wareSkuAddRequest);

  
2. 修改SKU信息
  

l  接口名称 

    360buy.ware.sku.update

 

l  功能说明

             通过api 根据sku_id 修改sku

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

sku_id

long

是

1100000015

sku的id

outer_id

String

 

12345

外部id

ware_id

long

是

1100000015

商品id

jd_price

long

是

100

京东价格

stock_num

long

是

20

库存

trade_no

String

否

Asdf23

流水号

l  返回结果

名称

类型

是否必须

示例值

描述

sku_id

String

 

 

Sku id

modified

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

l  返回示例 

JSON数据格式

{

    "ware_sku_update_response": {

        "code": "0"

        "sku_id": "1100050413",

        "modified": "2012-01-06 13:08:59",

    }

}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuUpdateRequest wareSkuUpdateRequest= new WareSkuUpdateRequest ();

wareSkuUpdateRequest.setJdPrice("30");

wareSkuUpdateRequest. setOuterId ("1354");

wareSkuUpdateRequest.setStockNum("3");

wareSkuUpdateRequest.setWareId("1100016736");

wareSkuUpdateRequest.setSkuId("1100050413");

WareSkuUpdateResponse res = client.execute(WareSkuUpdateResponse);

  
3. 修改SKU库存信息
  

l  接口名称

    360buy.sku.stock.update

l  功能说明 

           通过api 根据sku_id /outer_id修改库存接口，skuId和outerId 至少填一个，如果都有则以sku_id为准。

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

sku_id

long

否

（sku_id与outer_id至少填写一项，两者都填写时，以sku_id为准）

1100000015

sku的id

outer_id

String

否

（sku_id与outer_id至少填写一项，两者都填写时，以sku_id为准）

12345

外部id

quantity

long

是

100

需要更新的库存数量

trade_no

String

否

 

流水号

l  返回结果

名称

类型

是否必须

示例值

描述

sku_id

String

 

 

Sku id

outer_id

String

 

 

outer_id

modified

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

l  返回示例 

JSON数据格式

{

    "ware_sku_stock_update_response": {

        "code": "0"

        "sku_id": "1100050413",

"outer_id": "11asfd50afdf3",

        "modified": "2012-01-06 13:08:59",

    }

}

 

 

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuStockUpdateRequest request =

new WareSkuStockUpdateRequest();

request.setSkuId("1100051093");

request.setOuterId("12345");

request.setQuantity("66");

WareSkuStockUpdateResponse res = client.execute(request);

  
4. 修改SKU价格信息

l  接口名称

     360buy.sku.price.update

 

l  功能说明 

              通过api 根据sku_id /outer_id修改价格接口，skuId和outerId 至少填一个，如果都有则以sku_id为准

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

sku_id

long

否

（sku_id与outer_id至少填写一项，两者都填写时，以sku_id为准）

1100000015

sku的id

outer_id

String

否

（sku_id与outer_id至少填写一项，两者都填写时，以sku_id为准）

12345

外部id

price

String

是

100

sku京东价

1、只有【虚拟类 】商家以及以下实物类目支持小数点价格。
（1）“图书”（1713）
（2）“音乐”（4051）
（3）“影视”（4052）
（4）“影视音像“（4053）
（5）“个护化妆“（1316）

2、其他实物类目，小于100元的，可以支持小数点价格（精确到2位），大于等于100元的，不支持小数点价格。

market_price

String

否

 

市场价

jd_price

String

否

 

商品京东价

trade_no

String

 

 

 

l  返回结果

名称

类型

是否必须

示例值

描述

sku_id

String

 

 

Sku id

outer_id

String

 

 

outer_id

modified

String

 

 

修改时间

code

string

 

 

0为正常，其它值参见错误代码一览表

l  返回示例

JSON数据格式

{

    "ware_sku_price_update_response": {

        "code": "0"

          "sku_id": "1100050413",

"outer_id": "11asfd50afdf3",

        "modified": "2012-01-06 13:08:59",

    }

}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuPriceUpdateRequest request = new

WareSkuPriceUpdateRequest();

request.setSkuId("1100051093");

request.setOuterId("12345");

request.setPrice("11");

WareSkuPriceUpdateResponse res = client.execute(request);

  
5. 删除SKU 信息
  

l  接口名称 

     360buy.ware.sku.delete

 

l  功能说明 

              通过api 根据sku_id 删除sku

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

sku_id

String

是

1100000015

sku的id

trade_no

long

 

 

流水号

l  返回结果 

名称

类型

是否必须

示例值

描述

sku_id

long

 

 

Sku id

modified

String

 

 

时间

code

string

 

 

0为正常，其它值参见错误代码一览表

l  返回示例

JSON数据格式

{

    "ware_sku_delete_response": {

        "code": "0"

        "sku_id": 1100000015,

        "modified": "2012-01-06 01:23:12",

    }

}


l  SDK调用示例（java） 

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuDeleteRequest  wareSkuDeleteRequest= new WareSkuDeleteRequest();

wareSkuDeleteRequest.setSkuId("1100000022");

WareSkuDeleteResponse res = client.execute(wareSkuDeleteRequest);

  
6. 获取单个SKU信息
  

l  接口名称

360buy.ware.sku.get

 

l  功能说明 

根据sku_id获取所对应的sku数据，sku_id对应的sku要属于传入的vender_id对应的商家

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

fields

String

是

sku_id,ware_id,

status,attributes

需返回的字段列表。可选值：Sku结构体中的所有字段；字段之间用","分隔

sku_id

String

是

100000012

sku id

l  返回结果

名称

类型

示例值

描述

sku

Sku

 

Sku

code

string

 

0为正常，其它值参见错误代码一览表

SKU结构

名称

类型

示例值

描述

sku_id

number

2323

sku的id

shop_id

number

12314

店铺id

ware_id

number

123122

sku所属商品id

status

String

Valid

sku状态

有效：Valid

无效：Invalid

删除：Delete

attributes

string

1001:1501^1006:1504

sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是aid1:vid1;aid2:vid2

stock_num

number

10

库存

jd_price

string

12.13

京东价,精确到2位小数，单位元

cost_price

string

123.13

进货价, 精确到2位小数，单位元

market_price

string

123.13

市场价, 精确到2位小数，单位元

outer_id

string

Af1315

外部id,商家设置的外部id

created


string

2011-11-04 15:24:43

sku创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified                               

string

2011-11-04 15:34:43

sku修改时间

时间格式：yyyy-MM-ddHH:mm:ss


color_value                               

string


颜色对应的值


size_value                               

string


尺码对应的值


l  返回示例

JSON数据格式

{

"ware_sku_get_response": {

"code": "0"

"sku": {

      "attributes": "1000000041:1000000172^1000000046:1000000146",

      "status": "Delete",

      "sku_id": 1100013262,

      "ware_id": 1100006774,

      "shop_id": 6,

      "cost_price": "0.00",

      "market_price": "1.00",

      "jd_price": "1.00",

      "stock_num": 1,

      "created": "2010-10-09 14:21:27",

      "modified": "2011-07-26 14:00:24",

      "outer_id": ""

},

}

}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkuGetRequest wareSkuGetRequest = new WareSkuGetRequest();

wareSkuGetRequest.setSkuId("1100013262");

wareSkuGetRequest.setFields("");

WareSkuGetResponse res = client.execute(wareSkuGetRequest);

  
7. 根据外部ID获取商品SKU

l  接口名称 

      360buy.sku.custom.get

l  功能说明 

      根据商家设定的sku的外部id获取所对应的sku数据，一个sku的外部id对应一个sku数据。

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数

名称

类型

是否必须

示例值

描述

fields

String

是

sku_id,ware_id,

status,attributes

需返回的字段列表。可选值：Sku结构体中的所有字段；字段之间用","分隔

outer_id

String

是

21asf234

sku的外部商家ID

对应商家后台“商家SKU”字段

l  返回结果

名称

类型

示例值

描述

sku

Sku

 

Sku

code

string

 

0为正常，其它值参见错误代码一览表

SKU结构

名称

类型

示例值

描述

sku_id

number

2323

sku的id

shop_id

number

12314

店铺id

ware_id

number

123122

sku所属商品id

status

String

Valid

sku状态

有效：Valid

无效：Invalid

attributes

string

1001:1501^1006:1504

sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是aid1:vid1;aid2:vid2

stock_num

number

10

库存

jd_price

string

12.13

京东价,精确到2位小数，单位元

cost_price

string

123.13

进货价, 精确到2位小数，单位元

market_price

string

123.13

市场价, 精确到2位小数，单位元

outer_id

string

Af1315

外部id,商家设置的外部id

created

string

2011-11-04 15:24:43

sku创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

string

2011-11-04 15:34:43

sku修改时间

时间格式：yyyy-MM-ddHH:mm:ss

color_value

string


颜色对应的值

size_value

string


尺码对应的值

l  返回示例 

JSON数据格式

{

"sku_custom_get_response": {

       "code": "0"

       "sku": {

              "attributes": "",

              "status": "Valid",

              "sku_id": 1100000196,

              "ware_id": 1100000141,

              "shop_id": 6,

              "cost_price": "0.00",

              "market_price": "100.00",

              "jd_price": "90.00",

              "stock_num": 27,

              "created": "2010-07-27 20:19:26",

              "modified": "2011-10-28 01:22:23",

              "outer_id": "222fffff"

       },

}

}

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

SkuCustomGetRequest skuCustomGetRequest = new SkuCustomGetRequest();

skuCustomGetRequest.setOuterId("222fffff");

skuCustomGetRequest.setFields("ware_id");

SkuCustomGetResponse res = client.execute(skuCustomGetRequest);

  
8. 根据商品ID列表获取商品SKU信息

l  接口名称 

360buy. ware.skus.get

l  功能说明 

获取多个商品下的所有sku。

l  系统级别输入参数

名称

类型

是否必须

描述

method

String

是

API接口名称

access_token

String

是

采用OAuth授权方式为必填参数

app_key

String

是

应用的app_key

sign

String

是

签名

timestamp

String

是

时间戳，格式为yyyy-MM-ddHH:mm:ss，例如：2011-06-16 13:23:30。京东API服务端允许客户端请求时间误差为6分钟

v

String

是

API协议版本，可选值:2.0.

l  应用级输入参数 

名称

类型

是否必须

示例值

描述

fields

String

是

sku_id,ware_id,

status,attributes

需返回的字段列表。可选值：Sku结构体中的所有字段；字段之间用","分隔

ware_ids

String

是

1311,12312,1212

sku所属商品id，必选。ware_ids个数不能超过10个

l  返回结果 

名称

类型

示例值

描述

sku

Sku

 

Sku

code

string

 

0为正常，其它值参见错误代码一览表

SKU结构

名称

类型

示例值

描述

sku_id

number

2323

sku的id

shop_id

number

12314

店铺id

ware_id

number

123122

sku所属商品id

status

String

Valid

sku状态

有效：Valid

无效：Invalid

attributes

string

1001:1501^1006:1504

sku的销售属性组合字符串（颜色，大小，等等，可通过类目API获取某类目下的销售属性）,格式是aid1:vid1;aid2:vid2

stock_num

number

10

库存

jd_price

string

12.13

京东价,精确到2位小数，单位元

cost_price

string

123.13

进货价, 精确到2位小数，单位元

market_price

string

123.13

市场价, 精确到2位小数，单位元

outer_id

string

Af1315

外部id,商家设置的外部id

created

string

2011-11-04 15:24:43

sku创建时间

时间格式：yyyy-MM-ddHH:mm:ss

modified

string

2011-11-04 15:34:43

sku修改时间

时间格式：yyyy-MM-ddHH:mm:ss

color_value

string


颜色对应的值

size_value

string


尺码对应的值

l  返回示例

JSON数据格式

{

"ware_skus_get_response": {

       "code": "0"

       "skus": [

              {

                     "attributes": "1000000041:1000000172^1000000046:1000000146",

                     "status": "Valid",

                     "sku_id": 1100013262,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 1,

                     "created": "2010-10-09 14:21:27",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              },

              {

                     "attributes": "1000000041:1000000141^1000000046:1000000146",

                     "status": "Valid",

                     "sku_id": 1100013250,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 3123,

                     "created": "2010-10-09 13:34:18",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              },

              {

                     "attributes": "1000000041:1000000141^1000000046:1000000173",

                     "status": "Valid",

                     "sku_id": 1100013251,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 1,

                     "created": "2010-10-09 13:34:18",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              },

              {

                     "attributes": "1000000041:1000000142^1000000046:1000000146",

                     "status": "Valid",

                     "sku_id": 1100013252,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 2,

                     "created": "2010-10-09 13:34:18",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              },

              {

                     "attributes": "1000000041:1000000142^1000000046:1000000173",

                     "status": "Valid",

                     "sku_id": 1100013253,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 2,

                     "created": "2010-10-09 13:34:18",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              },

              {

                     "attributes": "1000000041:1000000172^1000000046:1000000173",

                     "status": "Valid",

                     "sku_id": 1100013263,

                     "ware_id": 1100006774,

                     "shop_id": 6,

                     "cost_price": "0.00",

                     "market_price": "1.00",

                     "jd_price": "1.00",

                     "stock_num": 1,

                     "created": "2010-10-09 14:21:27",

                     "modified": "2011-07-26 14:00:24",

                     "outer_id": ""

              }

       ],

}

}

 

l  SDK调用示例（java）

public JdClient client = new DefaultJdClient(SERVER_URL,

"c7b82199-f26d-459e-a4b3-d6f6cec4b869","36AB8642CCEF66293AD391EE7E4E9515","0da953632d0a4741beb0bbd096214605");

WareSkusGetRequest wareSkusGetRequest= new WareSkusGetRequest();

wareSkusGetRequest.setWareIds("1100027761");

wareSkusGetRequest.setFields("ware_id");

WareSkusGetResponse res = client.execute(wareSkusGetRequest);