|
|
param
object
否
创建商品请求参数集合
presale_param
object
否
预售商品信息
etd_start
java.lang.Long
否
预计发货开始时间，Unix时间戳，单位：毫秒
1596365854000
etd_days
java.lang.Integer
否
付款成功后发货天数,默认0，当全款预售时，表示全款付款后的发货天数，当订金预售时，表示尾款付款后的发货天数
0
etd_type
java.lang.Integer
否
发货类型: 0- xxx 时间开始发货(默认), 1-付款 n 天后发货
0
deposit_ratio
java.lang.Integer
否
表示订金预售时，订金所占全款的百分比，范围为1-20的整数
5
pre_sale_start
java.lang.Long
否
预售开始时间,Unix时间戳，单位：毫秒
1596365854000
pre_sale_type
java.lang.Integer
否
预售类型：-1-非预售，0-全款预售，1-订金预售,默认非预售
-1
deposit_type
java.lang.Integer
否
预售定金类型：当预售类型为定金预售时，这个字段用于区分是按比例预售还是按金额预售 ,定金预售类型:0-表示按比例预售，1-表示按金额预售
0
deposit
java.lang.String
否
表示定金预售时，用户设置的定金金额，单位:元，范围为1~（商品价格-1）举例：一个商品价格100元，定金最大可以设置为1~99元
5
balance_due_end
java.lang.Long
否
尾款支付结束时，Unix时间戳，单位：毫秒
1596366046000
pre_sale_end
java.lang.Long
否
预售结束时间,Unix时间戳，单位：毫秒
1596365854000
balance_due_start
java.lang.Long
否
尾款支付开始时，Unix时间戳，单位：毫秒
1596366046000
video_id
java.lang.Long
否
主图视频id(当前仅支持购买大客定制使用)，先使用【youzan.material.general.video.custom.upload.token.1.0.0】获取令牌和上传地址，然后根据上传地址和token上传视频。上传成功后使用 【youzan.material.general.video.custom.upload.create.1.0.0】创建视频，然后使用【youzan.material.general.video.custom.upload.publish.1.0.0】发布视频，发布成功后将接口的响应参数media_id作为video_id。
354678902323
item_delivery_param
object
否
配送属性集（电子卡券，虚拟商品类型无需填写物流，实物商品，蛋糕烘焙必填）
postage
java.lang.Long
否
统一运费金额，单位：分。当express为true时，delivery_template_id和postage 二个参数至少传一个。当express为false时，delivery_template_id和postage 请勿传值。
200
delivery_template_id
java.lang.Long
否
运费模板Id，在物流API列表，使用youzan.logistics.template.search获取店铺所有模板列表接口运费模板Id详情。当express为true时，delivery_template_id和postage 二个参数至少传一个。当express为false时，delivery_template_id和postage 请勿传值。
869037
delivery_setting
object
否
商品纬度物流配送方式
heavy_continued
java.lang.Boolean
否
是同城配送费用续重是否收费，true-收取，false-不收取，不设置默认为不收取
false
express
java.lang.Boolean
否
是否支持快递发货，true-支持，false-不支持，不设置默认为不支持 。express、city_delivery，self_pick 三个参数至少传一个
true
city_delivery
java.lang.Boolean
否
是否支持同城配送，true-支持，false-不支持，不设置默认为不支持。express、city_delivery，self_pick 三个参数至少传一个
true
self_pick
java.lang.Boolean
否
是否支持到店自提，true-支持，false-不支持，不设置默认为不支持。express、city_delivery，self_pick 三个参数至少传一个
true
prepare_time
java.lang.Long
否
（字段已废弃请勿使用）商品备货时间，单位分钟（茶饮烘焙类型商品使用）
60
item_weight
java.lang.Long
否
商品重量，单位：克，没有SKU时用。如果传delivery_template_id，且这个运费模板Id是按重量计算的item_weight需要传。取值区间1~10000000之间的整数
100
category_param
object
否
类目相关信息1.categoryProperties新类目属性2.cid老类目1或2填写一个就可以了推荐使用1新类目；注意：店铺主营类目是医药类的，这个商品类目都必填
cid
java.lang.Long
否
商品类目(V2版本)Id：使用youzan.itemcategories.get获取商品类目二维列表接口获取。 推荐使用新版类目
1000000
category_properties
object
是
新类目属性值公域+私域
publics
java.util.List
否
公域类目属性；注意：店铺主营类目是医药类的，这个商品类目都必填
id
java.lang.Long
是
公域类目属性项id
7940
val_names
java.util.List<java.lang.String>
是
公域类目属性值
["盒装"]
leaf_category_id
java.lang.Long
否
新版商品类目（V4版本）叶子类目id：使用【youzan.category.listchildren】接口获取类目id 必须是叶子类目。（如何判断是新版类目请在文档中心搜索：“新版类目”，如何获取请搜索“更新新版类目”）
1000001
privates
java.util.List
否
私域类目属性（不支持超过20个）
val_names
java.util.List<java.lang.String>
否
私域类目属性值
["上海", "杭州"]
id
java.lang.Long
否
私域类目属性项id
7733
item_no
java.lang.String
否
商品自定义编码，商家可以自定义参数，支持英文和数字组合，一般用于和外部商品对应字段,最多不可超过100个字符
xh001
sku_list
java.util.List
否
商品规格(有规格商品需要填写，无规格无需填写)
weight
java.lang.Long
否
（暂不可用，请勿传值）规格重量，单位：克，取值范围：1-10000000克
200
barcode
java.lang.String
否
商品SKU维度的条形码，用于扫码快速搜索商品，使用场景如：扫码购、扫码搜索商品（仅支持实物商品）。支持英文和数字组合，最多不超过32个字符
0001
barcodes
java.util.List<java.lang.String>
否
更多条码，连锁L-专业版店铺发布商品到网店或门店时使用
["0002","0003"]
sku_props
java.util.List
否
规格属性，建议最大传值sku数量在400个以内。注意：有规格商品，prop_name、prop_value_name、prop_name_id、prop_value_id都是必传的。
prop_value_name
java.lang.String
否
规格值名称，多规格场景下这个字段是必填，需要和sku_value_props.name字段值对应
1号
prop_name
java.lang.String
否
规格名名称，多规格场景下这个字段是必填
红色
prop_name_id
java.lang.Long
否
规格名名称id，开发者自定义
323242
prop_value_id
java.lang.Long
否
规格值名称id，开发者自定义
373634
price
java.lang.Long
否
商品sku价格,单位:分
88
max_guide_price
java.lang.Long
否
建议售价区间最大建议售价，有赞连锁非分销商品使用，单位：分
100
cost_price
java.lang.Long
否
商品sku成本价,单位:分
50
min_guide_price
java.lang.Long
否
建议售价区间最小建议售价，有赞连锁非分销商品使用，单位：分
200
delivery_price
java.lang.Long
否
配送价（配销价）单位：分
100
standard_price
java.lang.Long
否
标准价单位：分
100
prepare_time
java.lang.Long
否
商品sku级别备货时间，单位分钟（茶饮烘焙类型商品使用）
120
sku_no
java.lang.String
否
商品sku编码，商家自定义参数
xh101
stock_num
java.lang.Long
否
商品sku库存数量
100
extra_param
object
否
商品扩展参数
ecard_extra
object
否
电子卡券扩展参数
item_validity_day
java.lang.Integer
否
生效后可用天数（单位：天）。validity_type=1时，必须填写大于0且不能超过9999的整数
1
sync_wechat_bag
object
否
卡券同步微信卡包的参数。仅validity_type=2时且为微商城单店时，sync_wechat_bag可传值；零售和连锁都不支持设置微信卡包相关的参数
card_service_tel_code
java.lang.String
否
客服电话区号
010
use_address
java.lang.String
否
使用地点
浙江省杭州市
code_type
java.lang.Integer
是
核销码类型。0：二维码；1：条形码。同步至微信卡包时必填。
0
card_color
java.lang.String
是
微信卡券颜色。同步至微信卡包时必填。卡券颜色，Color010("浅绿色"),Color020("深绿色"),Color030("浅蓝色"),Color040("深蓝色"),Color050("紫色"),Color060("深黄色"),Color070("浅黄色"),Color080("浅橘色"),Color081("深橘色"),Color082("亮绿色"),Color090("橘红色"),Color100("深红色"),Color101("浅红色"),Color102("灰色")
Color010
card_service_tel
java.lang.String
否
客服电话
12345678
card_title
java.lang.String
是
卡券标题
卡券标题1
holidays_available
java.lang.Boolean
是
节假日是否可用
false
item_validity_start
java.lang.Long
否
有效期开始时间, 1970-01-01 开始的秒数。当validity_type= 2时必传。如：1607529600，表示2020-12-10 00:00:00
1607529600
effective_delay_hours
java.lang.Integer
否
电子凭证自定义推迟时间。单位：小时。电子凭证生效类型是自定义推迟时间时，必须填写大于0且不能超过10000。
1
item_validity_end
java.lang.Long
否
有效期结束时间, 1970-01-01 开始的秒数。当validity_type= 2时必传。如：1608048000，表示2020-12-16 00:00:00
1608048000
effective_type
java.lang.Integer
是
电子凭证生效类型，0 立即生效， 1 自定义推迟时间， 2 隔天生效
0
item_pre_order_time
java.lang.String
否
提前预定时间。可用类型是3(使用日期当天有效)时才能用。格式：{提前x天}-{x点}-{x分}，比如，0-16-37:代表当天16点37分；1-14-26：代表前一天14点26分，以此类推）
1-14-26
instructions
java.lang.String
否
使用说明。同步微信卡包时必填。
使用说明。同步微信卡包时必填。
validity_type
java.lang.Integer
是
生效后可用类型 0 长期可用，1 生效后设置天数可用， 2 生效后一定日期内可用，3 使用日期当天有效（配合价格日历功能使用）。当validity_type= 2时item_validity_start和item_validity_end必传，且其他互斥条件参数请勿传
0
retail_param
object
否
零售商品参数:仅零售使用
sell_type
java.lang.Integer
否
销售类型，1-单个销售。创建零售网店商品时必传。
1
is_multi_unit
java.lang.Boolean
否
多单位,false-关闭多单位,true开启多单位
false
display_on_kdt_ids
java.util.List<java.lang.Long>
否
商品需要上架的网店店铺id（kdt_id）列表，有赞连锁店铺类型使用
[8663234]
item_channel_params
否
channel_sku_list
否
cost_price
java.lang.Long
否
成本价元保留两位小数
5000
sku_props
否
prop_name_id
java.lang.Long
否
规格名id
16785164
prop_value_id
java.lang.Long
否
规格值id
16785163
prop_name
java.lang.String
否
规格名name
颜色
prop_value_name
java.lang.String
否
规格值text
红色
delivery_price
java.lang.Long
否
配送价（配销价）单位：分
1000
price
java.lang.Long
否
价格,单位:分保留两位小数
8800
standard_price
java.lang.Long
否
标准价单位：分
5000
weight
java.lang.Long
否
重量g
10
min_guide_price
java.lang.Long
否
连锁店铺使用最小建议售价(分)
1000
max_guide_price
java.lang.Long
否
连锁店铺使用最大建议售价
20000
no_sale_kdt_ids
java.util.List<java.lang.Long>
否
连锁模式下总店渠道商品编辑，不可售店铺列表
[8663234]
join_level_discount
java.lang.Integer
否
是否参加会员折扣。默认1，设置为1参加会员折扣
1
item_price_param
object
否
渠道商品价格属性
max_guide_price
java.lang.Long
否
最大建议售价(无规格时）(连锁非分销商品使用对应PC页面模块->价格库存-建议售价区间)
2000
origin
java.lang.String
否
划线价(元)
18
price
java.lang.Long
否
价格(分)
800
min_guide_price
java.lang.Long
否
最小建议售价（无规格时)
700
cost_price
java.lang.Long
否
成本价(分)
500
display_on_kdt_ids
java.util.List<java.lang.Long>
否
连锁模式下总店渠道商品编辑，上架店铺列表
[8663234]
tag_ids
java.util.List<java.lang.Long>
否
分组列表
[106223895]
item_props
否
prop_text_ids
java.util.List<java.lang.Long>
否
商品关联的属性值id列表
[931198, 931173]
prop_id
java.lang.Long
否
商品添加的规格项id
217092
sell_point
java.lang.String
否
商品卖点信息
商品卖点
title
java.lang.String
否
商品标题。不能超过100字，受违禁词控制
可乐
channel
java.lang.Integer
否
渠道类型，0:网店 1:门店
0
measurement
java.lang.Integer
否
计价方式0:计件10:计重 仅门店渠道使用
0
display_off_kdt_ids
java.util.List<java.lang.Long>
否
连锁模式下总店渠道商品编辑，下架店铺列表
[8663234]
summary
java.lang.String
否
子标题
好的商品需要分享
item_page_setting_model
object
否
商品详情页下单模式配置
item_page_mode
java.lang.String
否
商品详情页浏览模式 : 0-普通下单 , 1-商详页极速下单,2-分步极速下单
0
model_switch_config
java.lang.Integer
否
是否启用商详页独立下单模式，0-不启用，1-启用
0
barcode
java.lang.String
否
商品SPU维度的条形码，用于扫码快速搜索商品，使用场景如：扫码购、扫码搜索商品（仅支持实物商品）。支持英文和数字组合，最多不超过32个字符
0001
item_props
否
prop_id
java.lang.Long
否
商品属性项id
217092
prop_text_ids
java.util.List<java.lang.Long>
是
商品属性值id
[931198, 931173]
desc
java.lang.String
是
商品详情页内容。字数要大于5个字符，小于25000个字符（含html格式编码），受违禁词控制，敏感词说明：详见文档
我是商品描述
auto_listing_time
java.lang.Long
否
开始出售时间，默认为0，0—立即出售，传值表示定时开售时间，注意：定时开售时间一定要大于当前时间，Unix时间戳，单位：毫秒。当is_display=0时，定时开售时间设置不生效。
1596353008000
purchase_permission
object
否
购买权限
ump_tags
java.util.List<java.lang.String>
否
可购买该商品的用户标签id，用英文逗号分隔
1544166479128
quota_cycle
java.lang.Integer
否
限购周期：0-终身限购， 1-按天限购，2-按周限购，3-按月限购，不传默认不限购
0
ump_level
java.util.List<java.lang.String>
否
可购买该商品的用户等级
110936137
purchase_right
java.lang.Boolean
否
是否设置商品限购，true-已设置，false-未设置，默认false
false
ump_real_level
java.util.List<java.lang.String>
否
可购买该商品的粉丝等级
4604678
buy_quota
java.lang.Integer
否
每人限购多少件，0-无限购，默认为0
0
buy_btn_label
java.lang.String
否
自定义立即购买按钮文案，支持6个字以内。当buy_btn_config=1时，该字段必传
立即抢购
start_sale_num
java.lang.Integer
否
商品起售数,默认为1，起售数量超出商品库存时，买家无法购买该商品
5
buy_btn_config
java.lang.Integer
否
商详立即购买按钮 : 立即购买按钮配置 0.默认 1.自定义
1
stock_deduct_mode
java.lang.Integer
否
库存扣减方式,0：拍下减库存，买家提交订单，扣减库存数量。1-付款减库存，买家支付成功，扣减库存数量.不传默认拍下减库存
0
join_level_discount
java.lang.Integer
否
是否参加会员折扣：1-支持，0-不支持，默认不支持
1
post_sale_param
object
是
售后信息
refund_param
object
是
退款参数
support_refund
java.lang.Boolean
是
是否支持退款。true：支持；false：不支持。仅对虚拟商品、电子卡券有效
false
period_mill_seconds
java.lang.Long
否
电子卡券有效期剩余时间，单位：毫秒。仅支持退款类型是未核销卡券在过期前若干时间前可退款，且仅对电子卡券有效。
100000
refund_type
java.lang.Integer
否
退款方式：0：未核销卡券即支持退款，1：未核销卡券在过期前若干时间前可退款。仅对电子卡券有效，且电子卡券是长久有效时值不能是 1。
0
is_support_barter
java.lang.Integer
否
商品是否支持换货：0. 不支持，1. 支持。仅支持实物商品，其他商品类型忽略
0
support_unconditional_return
java.lang.Boolean
否
是否支持七天无理由退换货：false：不支持，true：支持,不传默认为false。仅支持实物商品，其他商品类型无需使用。
true
messages
java.util.List
否
留言信息
type
java.lang.String
否
留言格式：text-文本格式，tel-数字格式，email-邮箱格式，date-日期格式，id_no-身份证号格式，image-图片格式，mobile-手机号格式，time-时间格式
text
name
java.lang.String
否
留言名称，不能多于10个字
手机号
image_ids
java.util.List<java.lang.Long>
是
商品图片Id列表，用英文逗号分隔，最多上传15张。使用【youzan.materials.storage.platform.img.upload】接口上传获取图片id。注：测试店铺最大支持上传30M，以","进行分割
[23123]
sku_value_props
java.util.List
否
仅支持为第一组规格设置规格图片（最多40张图），买家选择不同规格会看到对应规格图片。注意：sku_picture_display_config=ture时候才会展示
name
java.lang.String
否
sku属性值name，需要与sku_list下sku_props下prop_value_name字段值对应
颜色
img_id
java.lang.Long
否
sku图片Id，使用【youzan.materials.storage.platform.img.upload】接口上传获取图片id
2326438912
id
java.lang.Integer
否
规格属性值id。开发者自定义id字段sku_value_props[].id 和prop_value_id要传相同值
21313
display_off_kdt_ids
java.util.List<java.lang.Long>
否
商品需要下架的网店店铺id（kdt_id）列表，有赞连锁店铺类型使用
[8665234]
item_type
java.lang.Integer
是
商品类型，0-实物商品,60-虚拟商品,61-电子卡劵，63-茶饮烘焙
0
summary
java.lang.String
否
分享描述，微信分享给好友时会显示，建议36个字以内，最多不能超出100个字
好的商品要分享
brand_id
java.lang.String
否
商品品牌id，连锁L-专业版店铺发布商品到网店或门店时使用
13512
item_price_param
object
否
价格属性集
origin
java.lang.String
否
商品划线价，单位：元
18
min_guide_price
java.lang.Long
否
建议售价区间最小建议售价(无规格时），有赞连锁非分销商品使用，单位：分
7
cost_price
java.lang.Long
否
商品成本价，单位：分
5
price
java.lang.Long
是
商品价格，单位：分
8
max_guide_price
java.lang.Long
否
建议售价区间最大建议售价(无规格时），有赞连锁非分销商品使用，单位：分
20
title
java.lang.String
是
商品标题。不能超过100字，受违禁词控制，敏感词说明：详见文档
可乐
no_sale_kdt_ids
java.util.List<java.lang.Long>
否
商品不可售的网店店铺id（kdt_id）列表，有赞连锁店铺类型使用
[8234764]
is_display
java.lang.Integer
否
是否上架商品，1—上架商品，0—不上架商品(管理端显示为仓库中)，新增若不传该字段默认传1
1
barcodes
java.util.List<java.lang.String>
否
更多条码，连锁L-专业版店铺发布商品到网店或门店时使用
["0002","0003"]
prepare_time
java.lang.Long
否
商品备货时间，单位分钟（茶饮烘焙类型商品使用）
100
template_id
java.lang.Integer
否
商品页模板Id，使用【youzan.item.template.list.search】接口获得商品页模板ID
62680909
yz_open_id
java.lang.String
否
有赞用户id，用户在有赞的唯一id。推荐使用
43873121
quantity
java.lang.Long
是
商品库存， 无sku情况下库存必填，如果有sku则无效
100
category_id
java.lang.Long
否
商品分类id，连锁L-专业版店铺发布商品到网店或门店时使用
8976632
hide_stock
java.lang.Integer
是
是否隐藏商品库存，在商品展示时不显示商品的库存，0-显示库存，1-不显示库存，默认0
1
tag_ids
java.util.List<java.lang.Long>
否
商品分组：即商品标签Id列表，使用youzan.itemcategories.tags.get查询商品分组接口获取,以","进行分割。有赞连锁网店店铺注意,请使用网店自建的分组id
106223895
sku_picture_display_config
java.lang.Boolean
否
是否展示规格图片展示在商详页和规格选择页，true-是，false-否
false
shop_org_id
java.lang.Long
否
商品店内组织ID，仅当店铺购买云上专柜插件时使用，查询当前店铺的店内组织ID：详见文档
1
specifications
java.lang.String
否
规格型号，最多100个字，连锁L-专业版店铺发布商品到网店或门店时使用
8613123123
sell_point
java.lang.String
否
商品卖点信息：在商品详情页标题下面展示卖点信息，建议60字以内，最多不能超出80个字
我是商品卖点
node_kdt_id
java.lang.Long
否
有赞连锁网店店铺id，仅供有赞连锁场景下使用。有赞平台生成，在有赞平台唯一，用于判断信息属于哪一个网店
9400666
size_group_id
java.lang.Long
否
商品尺码组id，连锁L-专业版店铺发布商品到网店或门店时使用
98763 |
|
用手机打开
收藏
赞
···
回复
1
跳至页
复制链接
新浪微博
QQ空间
微信扫码
赞 
回复
