说明:
本帖主要介绍商品相关的常见参数以及常见的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 编辑
|