新建组合商品

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

请求方式及url

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

在线调试工具

请求

响应

请求参数

参数名 必选 类型 说明
access_token 是 string 专属token
resource_type 是 int 资源类型标识（69:组合商品）
action_type 是 int 操作类型（1:创建商品,2:编辑商品）
spu_name 是 string 商品名称
goods_img 是 array[string] 商品主图URL列表
goods_brief_text 否 string 商品卖点简述
goods_detail_text 否 string 商品详情文本
tags 否 array[int] 商品分组标签列表
sale_status 否 int 商品上架状态（0:下架,1:上架,2:定时上架还未上架阶段,3:待上架,4:强制下架）
is_display 否 int 是否在店铺内展示（0:隐藏,1:展示）
is_stop_sell 否 int 是否停止销售（0:否,1:是）
is_timing_sale 否 int 是否定时上架（0:否,1:是）
timing_sale 否 string 定时上架的时间
is_timing_off 否 int 是否定时下架（0:否,1:是）
timing_off 否 string 定时下架的时间
created_at 否 string 创建时间(格式：YYYY-MM-DD HH:mm:ss)
sku 是 array[object] SKU列表
sku[].sku_name 是 string SKU规格名称
sku[].sku_img 否 string SKU规格图片URL
sku[].sku_price 是 int SKU规格价格
sku[].distribution_pattern 是 int 配送方式（-1:全部 1:快递配送 2:自提）
sku[].is_uniform_freight 是 int 是否是统一运费 (1:统一运费 2:运费模板)
sku[].freight 是 int 运费金额，is_uniform_freight=1时必传，单位分
sku[].goods_img 否 array[string] SKU关联商品图片列表
sku[].freight_template_id 否 int 运费模板ID，is_uniform_freight=2时必传
sku[].attr 是 array[object] SKU属性组合列表
sku[].attr[].spu_id 是 string SPU唯一标识
sku[].attr[].sku_id 是 string SKU唯一标识
sku[].attr[].period_type 是 int 有效期类型（-1:跟随原商品,0:长期有效,1:具体时间前有效,2:有效期时间范围（秒））
sku[].attr[].period_value 否 string 有效期值,例period_type=1时，值为日期(格式：YYYY-MM-DD HH:mm:ss),period_type=2时，值为秒数
sku[].attr[].sku_num 是 int SKU包含商品数量，不能小于1

请求示例

{
    "access_token":"xe_xxxxx",
    "resource_type": 69,
    "action_type": 1,
    "spu_name": "xxxx组合商品",
    "goods_img": [
        "https://xxxx.jpg"
    ],
    "goods_brief_text": "123123123123",
    "goods_detail_text": "",
    "tags": [],
    "sale_status": 1,
    "is_display": 1,
    "is_stop_sell": 0,
    "is_timing_sale": 0,
    "timing_sale": "",
    "is_timing_off": 0,
    "timing_off": "",
    "created_at":"",
    "sku": [
        {
            "sku_name": "默认规格",
            "sku_img": "https://xxxx.jpg",
            "sku_price": 1,
            "distribution_pattern": -1,
            "is_uniform_freight": 1,
            "freight": 100,
            "goods_img": [],
            "freight_template_id": 0,
            "attr": [
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                },
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                }
            ]
        },
        {
            "sku_name": "规格2",
            "sku_img": "https://xxxx.jpg",
            "sku_price": 1,
            "distribution_pattern": -1,
            "is_uniform_freight": 1,
            "freight": 0,
            "goods_img": [],
            "freight_template_id": 0,
            "attr": [
                {
                    "spu_id": "g_676535ce9028e_JByDSqf0",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1
                },
                {
                    "spu_id": "SPU_ENT_xxxx",
                    "sku_id": "SKU_ENT_xxxx",
                    "period_value": "",
                    "period_type": -1,
                    "sku_num": 1,
                }
            ]
        }
    ]
}

返回参数

参数名 必选 类型 说明
code 是 int 状态码（0表示成功）
msg 是 string 消息描述（"ok"表示成功）
data 是 object 响应数据对象
data.app_id 是 string app_id
data.spu_id 是 string SPU唯一ID

备注

  • code=0时，msg:
  • code!=0时，msg:拉取数据错误

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "app_id": "appxxxx",
        "spu_id": "SPU_COP_xxxx"
    }
}

results matching ""

    No results matching ""