文档中心 - 有赞云

youzan.retail.open.sku.query.3.0.0

计费

2020-03-06 03:06:05

API名称：商品查询（基于sku）

API描述

商品查询(此接口查询最多支持3300条sku，如sku数量超过3300条请使用youzan.retail.open.spu.query接口)

公共参数

参数名称	参数类型	必须	参数说明	示例值
access_token	String	是	鉴权凭证，用于请求API详见如何获取access_token	9b510e232c9e3716b4c1e264fe04cdc6

请求地址

https://open.youzanyun.com/api/youzan.retail.open.sku.query/3.0.0

请求参数

全部展开全部收起

参数名称

参数类型

必须

参数说明

示例值

retail_source

java.lang.String

是

该字段已于2021-04-26号废弃取消校验，新接入开发者无需传值，已对接开发者不受影响。详情见：详见文档

已废弃

warehouse_code

java.lang.String

否

仓库编码，可通过youzan.retail.open.warehouse.query接口获取，如果不填，默认查总部商品库商品

TEST001

page_no

java.lang.Integer

否

页码，从1开始正

sku_codes

java.util.List<java.lang.String>

否

商品/规格编码列表，以“,”隔开

["BM50184126118","BM50184126111"]

page_size

java.lang.Integer

否

每页条数。默认20条，最大不能超过50，建议使用默认分页

返回参数

全部展开全部收起

参数名称

参数类型

参数说明

示例值

code

int

网关返回码，表示本次请求是否成功。200 :成功。

200

data

object

响应参数

paginator

object

分页信息

page

int

页码，从1开始正整数

total_count

int

总条数

page_size

int

每页条数。默认20条

skus

java.util.List

分页商品信息

stock_num

java.lang.String

库存数量

unit

java.lang.String

单位

件

specifications

java.lang.String

规格信息

白色

retail_price

java.lang.String

建议零售价，单位：元

0.01

update_time

java.lang.String

更新日期

2019-09-05 18:12:47

warehouse_code

java.lang.String

仓库编码

TEST001

category_name

java.lang.String

商品分类名称（该接口不返回，可通过youzan.retail.open.spu.query接口查询获取）

食品分组

sku_no

java.lang.String

规格条码，支持商家自定义参数，支持英文和数字组合，店铺下唯一

88888888

output_tax_rate

java.lang.String

销项税率

0.03

spu_no

java.lang.String

商品条码（该接口不返回，可通过youzan.retail.open.spu.query接口获取）

P2342312312

avg_stock_in_cost

java.lang.String

商品移动加权平均价即商品平均成本价，单位：元，计算逻辑：1.第一次采购单价是10，采购了10个，平均成本价就是10元/个 2.第二次采购单价是12，采购了10个，平均成本价就是（10*10+12*10）/20

order_num

java.lang.String

占用库存

create_time

java.lang.String

创建日期

2019-09-05 18:12:47

sell_stock_num

java.lang.String

销售库存

sku_id

java.lang.Long

规格Id（该接口不返回，可通过youzan.retail.open.spu.query接口查询获取）

1111

product_name

java.lang.String

商品名称

测试

input_tax_rate

java.lang.String

进项税率

0.03

category_id

java.lang.String

商品分类Id，有赞生成的店铺下商品分类唯一Id

2109160

spu_code

java.lang.String

商品编码（该接口不返回，可通过youzan.retail.open.spu.query接口查询获取）

BM45324124312

last_stock_in_cost

java.lang.String

最后一次入库成本价

bar_codes

java.util.List<java.lang.String>

一品多码

[233]

photo_url

java.lang.String

图片地址

[{\"url\":\"https://img.yzcdn.cn/public_files/2017/08/30/63a8d28bce4ca2e5d081e1e69926281e.jpg\"}]

sku_code

java.lang.String

规格编码，支持商家自定义参数，支持英文和数字组合，店铺下唯一

test88888888

message

java.lang.String

网关返回码描述

successful

success

boolean

表示本次请求是否成功。 true:成功 false：失败

true

request_id

java.lang.String

请求Id

请求id

请求示例

nodejs

java

php

const youzanyun = require('youzanyun-sdk');

const token = 'your token';
const params = {'paramKey': 'paramValue'};

const resp = youzanyun.client.call({
    api: 'youzan.retail.open.sku.query',
    version: '3.0.0',
    token,
    params,
});

响应示例

{
  "code": 200,
  "data": {
    "skus": [
      {
        "input_tax_rate": "0",
        "avg_stock_in_cost": "0",
        "category_name": null,
        "create_time": "2019-12-04 17:23:54",
        "spu_code": null,
        "warehouse_code": null,
        "stock_num": "0",
        "sku_id": null,
        "sell_stock_num": "0",
        "specifications": "1.1",
        "product_name": "红果果",
        "retail_price": "5",
        "update_time": "2019-12-04 17:23:54",
        "unit": "件",
        "bar_codes": [],
        "sku_no": "P191204585926274",
        "category_id": "1467206",
        "output_tax_rate": "0",
        "spu_no": null,
        "order_num": "0",
        "photo_url": "[{\"url\":\"https://img.yzcdn.cn/public_files/2017/08/30/63a8d28bce4ca2e5d081e1e69926288e.jpg\"}]",
        "sku_code": "BM5161975969715655606",
        "last_stock_in_cost": "0"
      },
      {
        "input_tax_rate": "0",
        "avg_stock_in_cost": "0",
        "category_name": null,
        "create_time": "2019-12-04 17:23:54",
        "spu_code": null,
        "warehouse_code": null,
        "stock_num": "0",
        "sku_id": null,
        "sell_stock_num": "0",
        "specifications": "1.0",
        "product_name": "红果果",
        "retail_price": "5",
        "update_time": "2019-12-04 17:23:54",
        "unit": "件",
        "bar_codes": [],
        "sku_no": "P191204066646618",
        "category_id": "1467206",
        "output_tax_rate": "0",
        "spu_no": null,
        "order_num": "0",
        "photo_url": "[{\"url\":\"https://img.yzcdn.cn/public_files/2017/08/30/63a8d28bce4ca2e5d081e1e69926288e.jpg\"}]",
        "sku_code": "BM5161975967415655605",
        "last_stock_in_cost": "0"
      }
    ],
    "paginator": {
      "total_count": 17202,
      "page": 1,
      "page_size": 2
    }
  },
  "success": true,
  "message": "successful",
  "request_id": null
}

异常示例

{
  "code": 234000003,
  "data": {
    "skus": []
  },
  "success": false,
  "message": "仓库信息不存在",
  "request_id": null
}

返回码

返回码	描述	解决方案
200	请求成功	请求成功
234000003	仓库信息不存在	请确认传入的仓库编码是否正确

如何获得此API权限

拥有此API的能力包	拥有此API的能力包分类	可获得此API能力包的应用类目
商品库商品管理	有赞零售	客户关系CRM、门店POS、iPaaS数据集成、有赞微商城、有赞零售、行业解决方案、跨境服务、电商ERP、打单发货、商品管理、场景解决方案、内容工具、订单/商品中台、系统打通（连接器）、功能定制、票务管理、

上一篇：根据房型ids查询房型聚合信息

下一篇：查询酒店信息

此篇文档是否对你有帮助？

文档反馈