新建实物商品

拥有此API的权限集
商品管理-增删改

请求方式及url

  • 请求方式：POST
  • 请求头：Content-Type:application/json
  • 接口地址：https://api.xiaoe-tech.com/xe.goods.entity.create/1.0.0
  • 频率限制：10秒500次

在线调试工具

请求

响应

请求参数

参数名 必选 类型 说明
access_token 是 string 专属token
resource_type 是 int 资源类型
spu_type 是 string 商品中心类型 （实物商品传ENT）
goods_category_id 是 string 实物商品类目id
wx_goods_category_id 否 string 微信商品分类id
goods_sn 否 string 商品编码
goods_name 是 string 商品名称
goods_img 是 array 商品封面图（默认封面图）
img_url_compressed 否 string 压缩图
video_img_url 否 string 视频封面url
video_url 否 string 视频文件url
custom_cover 否 string 主图视频自定义封面
goods_brief_text 否 string 商品简介/卖点
goods_detail_text 否 string 商品详情
sell_type 是 int 付费类型：1 = 独立售卖，2 = 关联售卖
price_low 否 int 商品最低价（取自sku中最低价值）
price_high 否 int 商品高价（取自最低价所在sku对应划线价）
price_line 否 int 划线价(取值price_low所在sku划线价)
goods_tag_is_show 是 int 商品标签是否展示;0:不展示;1:展示
sale_status 是 int 上架状态： 0下架 1上架 2待上架
is_timing_sale 是 int 是否定时上架：1是 0否
has_distribute 是 int 是否参与推广分销：0 = 否，1 = 是
is_goods_package 是 int 是否带货 0 否 1 是
period 否 int 有效期（-1 永久，大于等于0是真实有效期）
is_display 是 int 是否显示：0否(隐藏状态) 1是(显示状态) 默认0
is_stop_sell 是 int 是否停售：0否 1是
is_forbid 是 int 商品是否被封禁：0 = 否，1 = 是
is_ignore 是 int 商品是否被忽略：0 = 否，1 = 是
goods_tag 否 string 商品标签
timing_sale 否 string 定时上架的时间,没有传0000-00-00 00:00:00
sale_at 否 string 上架的时间
limit_purchase 否 int 限购数量(最大购买数量,0为不限制)默认0
stock_deduct_mode 是 int 扣库存方式：0付款减库存 1拍下减库存 默认0
appraise_num 否 int 评价数
show_stock 是 int 是否展示库存 0-不展示 1-展示 默认1
is_best 是 int 是否精品 0否 1是
is_hot 是 int 是否热销产品 0否 1是
is_new 是 int 是否新品 0否 1是
is_recom 是 int 是否推荐 0否 1是
freight 是 int 运费（单位：分）
is_uniform_freight 是 int 是否是统一运费 1:统一运费 2:运费模板 默认1
distribution_pattern 否 int 配送方式-1:全部 1:快递配送 2:自提
freight_template_id 否 int 运费模板ID
is_password 否 int 是否加密（0-不加密 1—加密）默认不加密
can_sold_start 否 string 可售开始时间
can_sold_end 否 string 可售结束时间
sell_mode 否 int 售卖类型（1-自营 2-内容市场 3-课程商品) 默认1
is_public 否 int 是否公开售卖(0-不公开 1-公开) 默认 1
is_single 否 int 是否为单品（0-否 1-是） 默认 1
is_free 否 int 是否免费（0-收费 1-免费） 默认 0
sku 是 array SKU信息
sku[].sku_img 否 int sku默认图片
sku[].sku_name 否 int sku名字
sku[].sku_business_id 否 string 资源侧的sku id
sku[].sku_desc 否 string 规格描述
sku[].sku_price 是 int 价格
sku[].sku_line_price 否 int 划线价
sku[].sku_min_purchase 否 int 起购数量(最小购买数量,0为不限制)默认0
sku[].limit_purchase 否 int 限购数量
sku[].limit_purchase_type 否 int 限购类型：0-无限制 1-每个用户购买次数 2-有效期内每个用户购买次数
sku[].period_value 否 string 有效期值
sku[].period_type 否 int 有效期类型：0-长期有效；1-具体时间前有效；2-有效期时间范围（秒）
sku[].order_stock_limit 否 int 下单是否受库存限制：0 = 否，1 = 是
sku[].state 否 int 1上架 0下架
sku[].spec_value_id 否 string 规格值id
sku[].setting_stock 是 int 设置库存
sku[].sku_cost_price 否 int 成本价单位分
sku[].sku_weight 否 string 商品sku重量kg为单位
sku[].sku_volume 否 string 商品sku体积立方米为单位
sku[].sku_spec_code 否 string 商品sku规格编码
sku[].is_default 是 int 是否默认 0-否1-是
sku[].remark 否 int sku库存备注
sku[].attr 否 array SKU对应规格信息
sku[].attr[].attr_name 否 string 属性名称
sku[].attr[].attr_value 否 string 属性值
sku[].attr[].attr_field 否 string 属性字段名
sku[].attr[].attr_img 否 string 属性图片
sku[].attr[].remark 否 string 属性备注
sku[].attr[].sort 否，商品多规格需要，单规格默认0 int 排序
atta_spu_info 否 array 知识商品关联售卖信息
atta_spu_info[].attach_spu_id 否 atta_spu_info，则该字段必填 int 实物商品id
atta_spu_info[].sku_id 否 atta_spu_info，则该字段必填 string 实物商品sku
atta_spu_info[].attach_spu_type 否 atta_spu_info，则该字段必填 string 需要绑定资源的类型
attach_entity_spu_info 否 array 实物商品关联知识商品售卖信息
attach_entity_spu_info[].attach_spu_id 否 attach_entity_spu_info，则该字段必填 string 资源id
attach_entity_spu_info[].sku_id 否 attach_entity_spu_info，则该字段必填 string 实物商品，超级会员需要填写
attach_entity_spu_info[].attach_spu_type 否 attach_entity_spu_info，则该字段必填 string 知识商品类型

请求示例

{
    "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"
}

返回参数

参数名 类型 说明 备注
code int 状态码 0为请求成功，其它为请求失败
msg string 请求状态描述信息 无
data.app_id string 店铺id 无
data.spu_id string spu_id 无

返回示例


{
    "code": 0,
    "msg": "Success",
    "data": {
        "app_id": "appoq7ZnTxxxxxx",
        "spu_id": "GS10592882xxxxxx",
        "resource_id":"g_6213303b9a1xxxxxxxxx"

    }
}

results matching ""

    No results matching ""