产品新建/编辑

POST/v1/product/push

如何创建一个无规格产品

新建无规格产品

{
  "images": [],
  "name": "testname",
  "product_no": "testno",
  "product_type": 1,
  "package_remark": "remark"
  }

参数列表中有罗列可传入参数以及数据类型

如何编辑一个无规格产品

编辑无规格产品

``` { "product_id":xxxxxx, "images": [], "name": "testname", "product_no": "test", "product_type": 1, "package_remark": "remark" } ```

编辑无规格产品，需要获取info接口中的product_id传入，参数列表中有罗列可传入参数以及数据类型。

===========================================================================================

如何创建一个多规格产品

新建多规格产品

{
    "images": [],
    "name": "测试23",
    "product_no": "编号12",
    "product_type": 2,
    "sku_items": [{
        "sku_code": "测试11",
        "attributes": [{
            "item_id": 2056386462650, --规格类型id
            "value": {
                "item_id": 2268631617468  --规格值id
            }
        }],
        "fob_price": 123,
        "disable_flag": 0
    }, {
        "sku_code": "测试21",
        "attributes": [{
            "item_id": 2056386462650, --规格类型id
            "value": {
                "item_id": 2268631617469 --规格值id
            }
        }],
        "fob_price": 123,
        "disable_flag": 0
    }],
    "package_remark": "备注",
    "sku_attributes": [{
    --需要包含sku_items使用的规格值与类型，如item_id规格类型 2056386462650有使用规格值2268631617469/2268631617468，则都需要填写进来
        "item_id": 2056386462650,
        "value": [{
            "item_id": 2268631617469
        }, {
            "item_id": 2268631617468
        }]
    }]
}

创建多规格需要通过https://api-sandbox.xiaoman.cn/v1/product/push-sku-attribute ，创建规格后，item_id是由https://api-sandbox.xiaoman.cn/v1/product/sku-attribute-list 获得，用于创建多规格产品。多规格sku_attributes与sku_items必填，参数列表中有罗列可传入参数以及数据类型。

如何编辑一个多规格产品

编辑多规格产品

    {
  "images": [],
  "name": "测试2",
  "product_no": "编号1",
  "product_type": 2,
    "product_id":xxxxxx,
  "sku_items": [
    {
      "sku_id":xxxxxx,
      "sku_code": "测试1",
      "attributes": [
        {
          "item_id": 2056386462650, --规格类型id
          "value": {
            "item_id": 2268631617468 --规格值id
          }
        }
      ],
      "fob_price": 123,
      "disable_flag": 0
    }
  ],
  "package_remark": "备注",
  "sku_attributes": [
    {
      "item_id": 2056386462650,   --规格类型id
      "value": [
        {
          "item_id": 2268631617468 --规格值id
        }
      ]
    }
  ]
}

编辑多规格产品，需要获取info接口中的product_id与sku_id传入，参数列表中有罗列可传入参数以及数据类型。

请求参数

product_id

integer

产品ID

可选

编辑时必填

product_no

string

产品编码(产品SPU编号)

可选

最长256个字符

name

string

产品名称

可选

最长256个字符

cn_name

string

产品中文名称

可选

最长256个字符

create_user

integer

创建人

可选

product_type

enum<integer>

产品类型

必需

1无规格、2多规格、3组合

枚举值:

123

model

string

产品型号

可选

最长256个字符

description

string

产品描述

可选

intro

string

产品介绍

可选

product_remark

string

产品备注

可选

images

array[string]

产品主图片(url)

可选

from_url

string

产品链接

可选

hs_code

string

海关编码

可选

place

string

产地

可选

info_json

array [object {2}]

产品属性

可选

name

string

属性名称

可选

value

string

属性值

可选

quantity

string

最小起订数量

可选

quantity_unit

string

最小起订量单位

可选

price_currency

string

离岸价货币币种

可选

price_min

number <float>

离岸价最小价格

可选

price_max

number <float>

离岸价最大价格

可选

price_unit

string

离岸价单位

可选

package_gross_weight

string

包装毛重

可选

package_unit

string

包装单位

可选

package_size_length

number <float>

包装长

可选

单位cm

package_size_weight

number <float>

包装宽

可选

单位cm

package_size_height

number <float>

包装高

可选

单位cm

package_volume

number <float>

包装体积

可选

单位m³

product_size_length

number <float>

产品长

可选

单位cm

product_size_weight

number <float>

产品宽

可选

单位cm

product_size_height

number <float>

产品高

可选

单位cm

product_volume

number <float>

产品体积

可选

单位m³

group_id

integer

产品分组

可选

disable_flag

enum<integer>

是否停售

可选

1-是，0-否

枚举值:

fob_type

enum<integer>

离岸价设置类型

可选

1单一区间定价,2阶梯定价,3规格定价

枚举值:

123

gradient_price

array [object {2}]

阶梯定价

可选

quantity

integer

区间数量

可选

price

number <float>

区间价格

可选

sku_items

array [object {6}]

产品SKU明细

可选

sku_id

integer

SKU ID

可选

sku_code

string

SKU编号

可选

不能与SPU编号重复

sku_image_url

string

SKU图片URL

可选

fob_price

number <float>

SKU规格定价

可选

多规格必填

disable_flag

enum<integer>

SKU是否停售

可选

0:否 1:停售

枚举值:

attributes

array [object {2}]

产品规格

必需

sub_product_sku_items

array [object {3}]

组合产品子产品列表

可选

sub_sku_id

integer

子产品SKU ID

可选

sub_product_id

integer

子产品ID

可选

count

integer

子产品数量

可选

images_base64

array [object {2}]

可选

file_name

string

图片名称

必需

data

string

base64编码的图片数据

必需

sku_attributes

array [object {2}]

多规格产品则必填

可选

item_id

string

规格类型id

必需

规格类型id 可以从规格接口获取 /v1/product/sku-attribute-list

value

array [array]

必需

count_per_carton

number

每箱产品数

可选

count_per_package

number

每包装产品数

可选

{
  "product_id": 0,
  "product_no": "string",
  "name": "string",
  "cn_name": "string",
  "create_user": 0,
  "product_type": 1,
  "model": "string",
  "description": "string",
  "intro": "string",
  "product_remark": "string",
  "images": "string",
  "from_url": "string",
  "hs_code": "string",
  "place": "string",
  "info_json": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "quantity": "string",
  "quantity_unit": "string",
  "price_currency": "string",
  "price_min": 0,
  "price_max": 0,
  "price_unit": "string",
  "package_gross_weight": "string",
  "package_unit": "string",
  "package_size_length": 0,
  "package_size_weight": 0,
  "package_size_height": 0,
  "package_volume": 0,
  "product_size_length": 0,
  "product_size_weight": 0,
  "product_size_height": 0,
  "product_volume": 0,
  "product_net_weight": 0,
  "customs_name": 0,
  "customs_cn_name": 0,
  "package_remark": "string",
  "count_per_package": "string",
  "cost_currency": "string",
  "cost": 0,
  "cost_unit": "string",
  "unit": "string",
  "group_id": 0,
  "disable_flag": 0,
  "fob_type": 1,
  "gradient_price": [
    {
      "quantity": 0,
      "price": 0
    }
  ],
  "category_ids": null,
  "sku_attributes": [
    {
      "item_id": 0,
      "value": [
        {
          "item_id": 0
        }
      ]
    }
  ],
  "sku_items": [
    {
      "sku_id": 0,
      "sku_code": "string",
      "sku_image_url": "string",
      "fob_price": 0,
      "disable_flag": 0,
      "attributes": [
        {
          "item_id": 0,
          "value": {
            "item_id": 0
          }
        }
      ]
    }
  ],
  "sub_product_sku_items": [
    {
      "sub_sku_id": 0,
      "sub_product_id": 0,
      "count": 0
    }
  ],
  "images_base64": [
    {
      "file_name": "string",
      "data": "string"
    }
  ]
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

code

integer

必需

message

string

必需

now

string

必需

data

object

必需

product_id

integer

产品spu唯一id

必需

product_no

string

产品spu编号

必需

sku_items

array [object {2}]

必需

{
  "code": 200,
  "message": "success",
  "now": "2025-03-05 20:01:36",
  "data": {
    "product_id": 5203231500,
    "product_no": "2",
    "sku_items": [
      {
        "sku_id": 5203231501,
        "sku_code": "2"
      }
    ]
  }
}

最后修改时间： 13 天前