有赞新零售社区

发帖
有赞云历史板块»【商品接口】场景一:商品创建及更新场景

【商品接口】场景一:商品创建及更新场景

有赞-大羽 2018-10-25 4685 浏览 0 评论 | 只看楼主 [打印]

场景说明:
商家需要将外部系统的商品同步至有赞,在有赞商城出售,同时在后期能够对商品的信息进行维护更新。

——微商城后台-商品-商品管理界面,点击“发布商品”可以添加需要出售的商品;填写商品详细信息后点击下一步,对商品添加一些详情描述就可以发布商品了;



——添加完成后,即可在商品管理中看到已添加的商品,如果想推广该商品,可以点击商品右侧的“推广商品”获取推广二维码及推广链接;


——通过哪个接口可以将外部系统的商品一键同步到有赞?或者如何通过接口在商城后台新增商品?
(1)商品创建接口:youzan.item.create
(3)重要字段说明:
》》cid:商品分类的叶子类目id,可以通过 https://www.youzanyun.com/apilist/detail/group_item/item_category/youzan.itemcategories.get 获取到,此处的cid也就是商品分组id,也叫商品标签id;
》》delivery_template_id:运费模板ID,可以通过接口 https://www.youzanyun.com/apilist/detail/group_trade/logistics/youzan.logistics.template.search 获取到;
》》desc:商品描述,字数要大于5个字符,小于25000个字符 ,受违禁词控制;格式如: <p>详情描述测试</p><p><imgdata-origin-width="800" data-origin-height="800"src="https://img.yzcdn.cn/test.jpg" /></p>,如果有多张图片需要添加,可以将多张图片放在一个<p>…</p>结构中;当然,此处格式不固定,如果自身有前端开发同事,也可以自己写内容模板;
》》image_ids:图片id列表,用逗号分隔。可以通过 https://www.youzanyun.com/apilist/detail/group_shop/storage/youzan.materials.storage.platform.img.upload 上传图片接口去上传图片后获取图片id;
》》item_no:商品货号,商家为商品设置的外部编号,对应有赞微商城后台-商品管理-商品编辑信息中的商品编码;主要用于外部系统也有自己的商品编号的场景,用于和有赞的商品ID形成关联,方便运营管理;
》》price:价格,此字段需要注意的点是单位是“分”;
》》tag_ids:商品分组ID列表,可以通过分组列表接口获取,如 https://www.youzanyun.com/apilist/detail/group_item/item_category/youzan.itemcategories.taglist.search
》》title:商品标题,不能超过100字,受违禁词控制;
》》sku_stocks:sku 的JSON字符串,传入一定要按照这个格式:
[ { "price":10000, "quantity":100,"item_no":"MOYU-1", "skus":[ { "k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"1024G", }] }, { "price":10000, "quantity":100,"item_no":"MOYU-2","skus":[ {"k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"16G", } ]} ]
price是 sku 价格,quantity 是sku 的库存,item_no 是 sku 的商家编码,k 是规格名称,v 是规格值名称,要注意:sku_stocks数量=规格1数量 * 规格2数量 * 规格3数量,即使有的SKU搭配是没有的,也要以库存0的形式传进来,否则会报错sku信息不完整;
》》sku_images:SKU图片,仅支持第一级规格, 参数一定要与sku_stocks参数匹配, 如sku_stocks参数是这样的 [ {"price":10000, "quantity":100,"item_no":"MOYU-1", "skus":[ { "k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"1024G", }] }, { "price":10000, "quantity":100,"item_no":"MOYU-2","skus":[ {"k":"颜色", "v":"绿色", }, {"k":"尺寸", "v":"l", }, { "k":"内存", "v":"16G", } ]} ] 颜色就是第一级规格。它下面的规格只有“绿色”这一项,sku_images应该与之一一对应,如下 :
[{“v":"绿色","img_url":"www.youzan.com"}]
请务必按此格式传参数,不然校验通不过,无法新增商品
(4)调用格式,通过(2)中链接访问后:
(5)HTTP调用示例:
(6)JAVA调用示例:
YZClient client = new DefaultYZClient(new Token("token")); //new Sign(appKey, appSecret)
YouzanItemCreateParams youzanItemCreateParams= new YouzanItemCreateParams();
youzanItemCreateParams.setTitle("aaatest-standard5566");
youzanItemCreateParams.setPrice(10000L);
youzanItemCreateParams.setImageIds("9518");
youzanItemCreateParams.setDesc("http://n.sinaimg.cn/mil/8_img/upload/f8bc40b5/20180929/-Bec-fyhwret0362019.jpg");
youzanItemCreateParams.setItemNo("6933285600396");
youzanItemCreateParams.setSkuImages("[{"v":"22","img_url":"https://img.yzcdn.cn/upload_files/2018/09/24/1a6004ee7c5ecd970affba1999c7e0e1.jpg"}]");
youzanItemCreateParams.setSkuStocks("[{"sku_id":3337,"code":"sdsfdsfs","price":10000,"quantity":100,"skus":[{"k":"颜色","kid":1,"v":"22","vid":1196}]}]");
youzanItemCreateParams.setAutoListingTime(332222L);
YouzanItemCreate youzanItemCreate = new YouzanItemCreate();
youzanItemCreate.setAPIParams(youzanItemCreateParams);
YouzanItemCreateResult result =client.invoke(youzanItemCreate);

——商品信息发生变化,如何更新商品信息?微商城后台-商品管理,点击编辑按钮即可修改商品信息;

——通过哪个接口可以更新商品信息?
(1)商品信息更新接口:youzan.item.update
(3)重要字段说明:
》》item_id:商品ID,通过商品创建接口创建商品后返回的ID,也可以通过接口https://www.youzanyun.com/apilist/detail/group_item/item/youzan.item.search 批量获取;
其他字段同以上商品创建接口,不再做说明;
(4)调用格式,通过(2)中链接访问后:
(5)HTTP请求示例:
(6)JAVA请求示例:
YZClient client = new DefaultYZClient(new Token("token")); //new Sign(appKey, appSecret)
YouzanItemUpdateParams youzanItemUpdateParams= new YouzanItemUpdateParams();
youzanItemUpdateParams.setTitle("有赞测试");
youzanItemUpdateParams.setPrice(9999L);
youzanItemUpdateParams.setItemId(5260002L);
youzanItemUpdateParams.setNum(44L);
youzanItemUpdateParams.setDesc("测试测试测试");
YouzanItemUpdate youzanItemUpdate = new YouzanItemUpdate();
youzanItemUpdate.setAPIParams(youzanItemUpdateParams);
YouzanItemUpdateResult result =client.invoke(youzanItemUpdate);




用手机打开
收藏 ··· 回复
    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

    复制链接
    新浪微博
    QQ空间
    微信扫码
    • 回复

    • 评分

    客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

    复制成功