Appearance
编辑实物商品
| 拥有此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(该字段传"0"空字符串，需要传最新类目id) |
| new_category_id_v2 | 是 | int | 实物商品类目id(最新，从获取实物商品类目列表3.0接口获取三级类目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"
}
}