零售商品接口使用答疑

说明:

本文档主要为零售商户在使用零售版本的接口使用过程中遇到的一些接口问题和业务问题答疑。

问题:
Q: 为什么youzan.retail.open.online.spu.query的接口返回数据没有 category_id 这个字段呢?
A: 这个接口是网店商品的,零售的网店端是分组的概念,而商品库是分类的概念;这个接口已经有 group_ids 分组查询这个字段了;
接口文档链接:
https://open.youzan.com/v3/apice … en.online.spu.query

Q: 为什么使用youzan.retail.open.online.spu.query该接口,入参传入的 spu_id 查询商品不存在,应该传的是哪个码?
A: 由于零售商品是两套模型的,分别是网店商品和门店商品;因此需要先确认下传的 id 是商品库的还是网店的,这个接口需要传网店的商品 id;

Q: 该接口youzan.retail.open.spu.query是所有商品都能查还是只能查门店的?
A: 目前逻辑商品库这一层,商品信息部分总部和门店时一样的,没有区别,只有查库存那边库存会不一样;在我们系统页面上也只展示了总部的商品库商品信息,而销售端会展示门店和网店商品;

Q: 那如果要查商品的库存就要分开用商品接口查吗?
A: 是的,底层后面查商品的时候不返回库存的,因为需要库存是分布到仓库的。所以我们要单独查 sku 接口,那边会返回;

Q: 接口youzan.retail.open.sku.get 可以查库存信息,那如何区分是门店还是网店商品呢?
A: 商品库的库存不关心门店还是网店的,所有的库存都是放在仓库里的,所以通过传仓库编码实现;独立仓或者门店仓给门店或者网店供货;

Q: 该接口youzan.retail.open.spu.query中的 "sell_channels":[2,4],这个字段是什么意思?指的是渠道是门店,网店都有吗?
A: 目前这个字段非必填的,直接查总部就行;

Q: 商品库和门店、网店的区别是什么?在接口的使用上如何区分?
A: 商品库:商品模型是从商品库商品发布到门店或者网店,所以是两套东西,商品库商品是真正管控仓库里库存的;门店还是网店我们会在接口上通过 online 还是 offline 区分的,文档说明里也会说明;不说明的一般都是查商品库商品的;
参考如图: