商品是卖家的核心数据,商品管理应用的基本功能是保证商品库存数量、价格、SKU和描述等信息的及时性、完整性。平台提供了多个接口来解决库存同步,商品价格更新,商品SKU更新,商品上下架等需求。
商品营销价格是根据使用的营销工具或参与平台大促活动,而有不同的优惠逻辑,一般由店铺运营人员在淘宝卖家中心里配置,不在商品API场景介绍。
淘宝商品管理会因为个别类目的规则或者平台活动临时要求,可能出现无法通过API编辑和更新商品的情况,以实际接口报错和平台规则为准。
1)淘宝商品id,它均由数字构成,且如同身份证号码一样具有唯一性,属于商品链接中的一部分。在淘宝页面可以以下方式查看。
直接打开商品的详情页面,看到浏览器地址栏中的宝贝链接,链接中找到“id=”,后面紧跟的一串数字就是商品id,如图:
2)SKU是商品的最小库存量单位,简单的可理解为商品的具体规格:颜色、尺码等信息,比如:鞋子的黑色-39码就是一个SKU,下图中每一个颜色和尺码的组合都是一个SKU;
3)商品上下架状态。卖家发布的商品可以选择上架或者下架,上架才能让展示在店铺中,让消费者访问正式售卖;下架的商品会放在商品列表中无法对外展示,此时的商品状态为库中。
1)通用方案,先获取接口获取卖家商品列表,再通过商品列表中的商品id查询单个商品的详细信息。
当商品包含sku时,更新商品总量无效,始终等于各sku数量之和。
带sku的商品,有一口价和sku价格两个价格,如下图红框标识:
基本规则:商品一口价必须与有库存的sku价格一致,sku库存数量大于0的称为有效sku。
在淘宝页面发布或者编辑商品时,会根据商品的销售属性自动组合出完整的sku,如图:
如果先通过淘宝页面发布了商品,则系统会自动根据颜色和尺码的组合保存四个sku矩阵:蓝1、蓝2、桔1、桔2。当时只有蓝1、蓝2、桔1有库存,则设置了桔2数量为0。
但是在商家自有系统中,可能只保存了蓝1、蓝2、桔1三个sku;再新增SKU-桔2时,API将返回错误,重复添加sku属性,因为桔2已经存在。针对这种情况,
1)自有系统采用与淘宝相同的逻辑,在入库时只要有存在的销售属性就进行枚举完全,保存完整SKU矩阵。
2)新增sku前先获取淘宝商品的sku数据,如果存在此sku则直接修改,不存在则添加。
API名称
描述
获取当前会话用户出售中的商品列表
得到当前会话用户库存中的商品列表
根据商家编码取商品
根据sku的商家编码取商品sku
全量编辑商品信息
增量编辑商品信息
更新SKU信息
商品下架
商品上架
获取单个商品详细信息
如果需要系统对接可以使用图片上传管理接口,需要先开通卖家图片空间。