有赞新零售社区

发帖
API使用问题»商品相关的常见参数以及常见的FAQ答疑

商品相关的常见参数以及常见的FAQ答疑

有赞-妮子 2019-04-03 1802 浏览 0 评论 | 只看楼主 [打印]
说明:

本帖主要介绍商品相关的常见参数以及常见的FAQ答疑

PART1:商品常见参数

名词
解释
商品规格sku
通常表示:规格、颜色、款式,通过创建商品接口youzan.item.create生成
商品规格ID
通过创建商品接口youzan.item.create设置SKU信息后生成的ID
规格编码

通过这个接口去查商品详情https://www.youzanyun.com/apilist/detail/group_item/item/youzan.skus.custom.get

SPU
属性值、特性相同的商品就可以称为一个SPU
商品编码

商家为商品设置的外部编号,可与商家外部系统对接
通过这个接口去查商品详情https://www.youzanyun.com/apilist/detail/group_item/item/youzan.items.custom.get
商品ID
1.微商城后台编辑商品,查看链接部分最后的“id=“
2.或者通过创建商品接口youzan.item.create生成



商品别名alias
商品链接最后的部分

cid
商品分类的叶子类目id,通过youzan.itemcategories.get接口获取
商品成本价
是指将产品生产等成本录入到商品信息中,商家可以在数据-数据概况-管理视窗中,查看利润额。
oids-交易商品id
sku_stocks商品的规格信息
商品的规格信息(价格、库存、规格值以及规格名),格式如下:
[{"price":10000,"quantity":100,"skus":[{"k":"颜色","kid":1,"v":"绿色","vid":1217}]}]
注:无规格时建议传[]
vid最多不能超过5个


sku_weight:商品的重量
商品的重量,有规格时使用,无规格时使用itemWeight字段,格式如下:
"1000,2000"
注:这里的顺序与sku_stocks中传入的规格顺序相同
商品重量与模版相关联,若运费模版不是按重的,那么就算传了重量信息也不会存储
sku_images:规格的图片
规格的图片,格式如下:
{\"v\":\"绿色\",\"img_url\":\"http://img.yzcdn.cn/upload_files/2019/03/31/FhdTbnAzCH3YqxK3a1IJWuMXNHoI.jpg\"}
注:v为首规格关联图片的规格值,图片url后端不做校验,接口传入什么就存储什么



PART2.

Q:返回错误码ITEM_SKU_INFO_INVALID(121006063, "请按照组合传入完整sku信息"),sku应该如何传?
A:我们会对传入的sku数量做校验,比如sku里有选规格【颜色】:红色、绿色;【尺寸】:大、小 那么传入的sku数量就必须是2*2=4

Q:更新中remove_image_ids、image_ids怎么用?
A:remove_image_ids:需要移除的商品图片
   image_ids:需要新增的图片id

Q:message字段怎么传?
A:
例子:[{"datetime":0,"editable":true,"multiple":1,"name":"留言1","required":1,"type":"text"},{"datetime":0,"editable":true,"multiple":0,"name":"留言2","required":0,"type":"tel"},{"datetime":0,"editable":true,"multiple":0,"name":"留言3","required":0,"type":"email"},{"datetime":0,"editable":true,"multiple":0,"name":"留言4","required":0,"type":"date"},{"datetime":0,"editable":true,"multiple":0,"name":"留言5","required":0,"type":"time"},{"datetime":0,"editable":true,"multiple":0,"name":"留言6","required":0,"type":"id_no"},{"datetime":0,"editable":true,"multiple":0,"name":"留言7","required":0,"type":"image"},{"datetime":0,"editable":true,"multiple":0,"name":"留言8","required":0,"type":"mobile"}]


其中type与页面中的类型对应,比如:文本格式、日期、邮件等;required表示是否必须;





有更多关于商品接口的问题,欢迎在本帖继续追问!


本帖最后由 有赞-妮子 于 2019-4-4 19:07 编辑
用手机打开
收藏 ··· 回复
    您需要登录后才可以回帖 登录 | 立即注册

    本版积分规则

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

    • 评分

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

    复制成功