新建实物商品

curl --location --request POST 'https://api.xiaoe-tech.com/xe.goods.entity.create/1.0.0' \ --header 'Content-Type: application/json' \ --data-raw '{ "access_token":"xe_xxxxx", "resource_type":"21", "goods_name":"演示-实物商品", "spu_type":"ENT", "goods_category_id":"11659", "goods_img":[ "http:\/\/wechatapppro-1252524126.file.myqcloud.com\/appAKLWLitn7978\/image\/kowvxpk10dbo8dml0ike.png" ], "sell_type":"1", "goods_tag_is_show":"1", "has_distribute":"0", "sku":[ { "is_default":"1", "sku_price":"1", "setting_stock":"100000" } ], "is_display":"1", "is_stop_sell":"0", "is_forbid":"0", "is_ignore":"0", "show_stock":"0", "is_timing_sale":"0", "sale_status":"1", "is_uniform_freight":"1", "freight":"0", "stock_deduct_mode":"1", "is_best":"1", "is_hot":"1", "is_new":"1", "is_recom":"1" }'

请求参数

Body 参数application/json

access_token

string

专属token

必需

resource_id

string

资源ID

必需

resource_type

string

资源类型

必需

goods_name

string

商品编码

必需

spu_type

string

必需

商品中心类型（实物商品传ENT）

goods_category_id

string

实物商品类目id

必需

wx_goods_category_id

string

微信商品分类id

可选

goods_sn

string

商品编码

必需

goods_img

array[string]

必需

商品封面图（默认封面图）

sell_type

string

必需

付费类型：1 = 独立售卖，2 = 关联售卖

goods_tag_is_show

string

必需

商品标签是否展示;0:不展示;1:展示

has_distribute

string

必需

是否参与推广分销：0 = 否，1 = 是

sku

array [object {22}]

SKU信息

必需

is_default

string

可选

是否默认 0-否1-是

sku_price

string

价格

可选

setting_stock

string

设置库存

可选

sku_img

integer

sku默认图片

可选

sku_name

integer

sku名字

可选

sku_business_id

string

可选

资源侧的sku id

sku_desc

string

规格描述

可选

sku_line_price

integer

划线价

可选

sku_min_purchase

integer

可选

起购数量(最小购买数量,0为不限制)默认0

limit_purchase

integer

限购数量

可选

limit_purchase_type

string

可选

限购类型：0-无限制 1-每个用户购买次数 2-有效期内每个用户购买次数

period_value

string

有效期值

可选

period_type

integer

可选

有效期类型：0-长期有效；1-具体时间前有效；2-有效期时间范围（秒）

order_stock_limit

integer

可选

下单是否受库存限制：0 = 否，1 = 是

state

integer

1上架 0下架

可选

spec_value_id

string

规格值id

可选

sku_cost_price

integer

成本价单位分

可选

sku_weight

string

可选

商品sku重量kg为单位

sku_volume

string

可选

商品sku体积立方米为单位

sku_spec_code

string

商品sku规格编码

可选

remark

integer

sku库存备注

可选

attr

array [object {6}]

SKU对应规格信息

可选

is_display

string

必需

是否显示：0否(隐藏状态) 1是(显示状态) 默认0

is_stop_sell

string

必需

是否停售：0否 1是

is_forbid

string

必需

商品是否被封禁：0 = 否，1 = 是

is_ignore

string

必需

商品是否被忽略：0 = 否，1 = 是

show_stock

string

必需

是否展示库存 0-不展示 1-展示默认1

is_timing_sale

string

必需

是否定时上架：1是 0否

sale_status

string

必需

上架状态： 0下架 1上架 2待上架

is_uniform_freight

string

必需

是否是统一运费 1:统一运费 2:运费模板默认1

freight

string

运费（单位：分）

必需

stock_deduct_mode

string

必需

扣库存方式：0付款减库存 1拍下减库存默认0

is_best

string

必需

是否精品 0否 1是

is_hot

string

必需

是否热销产品 0否 1是

is_new

string

必需

是否新品 0否 1是

is_recom

string

必需

是否推荐 0否 1是

img_url_compressed

string

压缩图

可选

video_img_url

string

视频封面url

可选

video_url

string

视频文件url

可选

custom_cover

string

主图视频自定义封面

可选

goods_brief_text

string

商品简介/卖点

可选

goods_detail_text

string

商品详情

可选

price_low

integer

可选

商品最低价（取自sku中最低价值）

price_high

integer

可选

商品高价（取自最低价所在sku对应化线价）

price_line

integer

可选

划线价(取值price_low所在sku划线价)

is_goods_package

integer

必需

是否带货 0 否 1 是

period

integer

可选

有效期（-1 永久，大于等于0是真实有效期）

goods_tag

string

商品标签

可选

timing_sale

string

可选

定时上架的时间,没有传0000-00-00 00:00:00

sale_at

string

上架的时间

可选

limit_purchase

integer

可选

限购数量(最大购买数量,0为不限制)默认0

appraise_num

integer

评价数

可选

distribution_pattern

integer

可选

配送方式-1:全部 1:快递配送 2:自提

freight_template_id

integer

运费模板ID

可选

is_password

integer

可选

是否加密（0-不加密 1—加密）默认不加密

can_sold_start

string

可售开始时间

可选

can_sold_end

string

可售结束时间

可选

sell_mode

integer

可选

售卖类型（1-自营 2-内容市场 3-课程商品) 默认1

is_public

integer

可选

是否公开售卖(0-不公开 1-公开) 默认 1

is_single

integer

可选

是否为单品（0-否 1-是）默认 1

is_free

integer

可选

是否免费（0-收费 1-免费）默认 0

atta_spu_info

array [object {3}]

可选

知识商品关联售卖信息

attach_spu_id

string

可选

实物商品id（ atta_spu_info，则该字段必填）

sku_id

string

可选

实物商品sku（atta_spu_info，则该字段必填）

attach_spu_type

string

可选

需要绑定资源的类型（atta_spu_info，则该字段必填）

attach_entity_spu_info

array [object {3}]

可选

实物商品关联知识商品售卖信息

attach_spu_id

string

可选

资源id（attach_entity_spu_info，则该字段必填）

sku_id

string

可选

实物商品，超级会员需要填写（attach_entity_spu_info，则该字段必填）

attach_spu_type

string

可选

知识商品类型（attach_entity_spu_info，则该字段必填）

示例

application/json

Body

code

integer

必需

状态码（0为请求成功，其它为请求失败）

msg

string

请求状态描述信息

必需

data

object

必需

app_id

string

店铺id

必需

spu_id

string

spu_id

必需

resource_id

string

必需

请求参数

返回响应