编辑实物商品

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

请求方式及url

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

在线调试工具

请求

响应

请求参数

参数名 必选 类型 说明
access_token 是 string 专属token
spu_id 是 string 商品ID
resource_id 是 string 资源ID
resource_type 是 int 资源类型
spu_type 是 string 资源类型
goods_category_id 否 string 实物商品类目id
goods_name 否 string 商品名称
goods_sn 否 string 商品编号（商家录入）
wx_goods_category_id 否 string 微信商品分类id
goods_img 否 array 商品封面图（默认封面图）
img_url_compressed 否 string 压缩图
video_img_url 否 string 视频封面url
custom_cover 否 string 主图视频自定义封面
video_url 否 string 视频文件url
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 是
is_display 否 int 是否显示：0否(隐藏状态) 1是(显示状态)
is_stop_sell 否 int 是否停售：0否 1是
period 否 int 有效期（-1 永久，大于等于0是真实有效期）
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 限购数量
stock_deduct_mode 否 int 扣库存方式：0付款减库存 1拍下减库存
appraise_num 否 int 评价数
show_stock 否 int 是否展示库存 0-不展示 1-展示
is_best 否 int 是否精品 0否 1是
is_hot 否 int 是否热销产品 0否 1是
is_new 否 int 是否新品 0否 1是
is_recom 否 int 是否推荐 0否 1是
distribution_pattern 否 int 配送方式: -1-全部 1-快递配送 2-自提
freight 否 int 运费（单位：分）
is_uniform_freight 否 int 是否是统一运费 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-内容市场
is_public 否 int 是否公开售卖(0-不公开 1-公开)
is_single 否 int 是否为单品(0-否 1-是)
is_free 否 int 是否免费（0-收费 1-免费） 默认 0
skus 是 array SKU 数组
skus[].sku_id 否 int SKU ID
sku[].sku_business_id 否 string 资源侧的sku id
skus[].sku_img 否 string sku默认图片
skus[].sku_name 否 int sku名字
skus[].sku_desc 否 string 规格描述
skus[].sku_price 否 int 价格
skus[].limit_purchase 否 int 限购数量
skus[].sku_line_price 否 int 划线价
skus[].order_stock_limit 否 int 下单是否受库存限制：0 = 否，1 = 是
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-有效期时间范围（秒）
skus[].state 否 int 1上架 0下架
skus[].is_default 否 string 是否默认 0-否1-是
skus[].setting_stock 否 int 设置库存
skus[].remark 否 int sku备注
skus[].attr 否 array SKU对应规格信息
skus[].attr[].attr_id 否 int 属性ID
skus[].attr[].attr_field 否 string 属性字段名
skus[].attr[].attr_name 否 string 属性名称
skus[].attr[].attr_value 否 string 属性值
skus[].attr[].attr_img 否 string 属性图片
skus[].attr[].remark 否 string 属性备注
skus[].attr[].sort 否 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",
    "spu_id": "SPU_ENT_164515956xxxxxxx",
    "resource_id": "g_620f2489a8xxxxxxxx",
    "resource_type": 21,
    "goods_name": "1111111",
    "spu_type": "ENT",
    "skus": [
    ]
}

返回参数

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

返回示例


{
    "code": 0,
    "msg": "Success",
    "data": {
        "app_id": "appoq7xxxxxxx",
        "spu_id": "GS105928xxxxxxxxx"
    }
}

results matching ""

    No results matching ""