新增商品

请求参数

Header 参数

access_token

string

必需

oauth2接口获取的access_token

x-client-id

string

必需

申请对接时的clientId

Body 参数application/json

brandId

integer <int64>

商品品牌

可选

categoryId

integer <int64>

商品分类

必需

showCategoryIds

array[integer <int64>]

可选

展示分类,最多可指定20个

<= 20 items

description

string

商品描述

可选

enableMultiSpec

boolean

必需

是否启用多规格(启用后不可关闭)

name

string

商品名称

必需

skuAddList

array [object {22}]

必需

openapi 新增规格，单商品最多200个规格

auxUnit

object (新增/修改商品信息-辅助单位)

可选

code

string

商品编码

可选

enableAuxUnit

boolean

可选

商品是否启用辅助计量单位

enableMultiUnit

boolean

商品是否启用多单位

必需

enableMultiUnitSeparatePricing

boolean

必需

商品是否启用多单位单独定价

freeFreight

boolean

是否包邮

可选

freightUnitName

string

运费单位名称

可选

keyword

string

商品关键字

可选

minimum

number

起订量

可选

multiUnitList

array[object (新增商品信息-单位-单位顺序按换算比例升序) {20}]

可选

商品单位信息(非多单位商品传基础单位)

orderUnitName

string

分销默认单位

必需

origin

string

商品产地

可选

purchaseUnitName

string

采购默认单位

必需

qualityGuaranteePeriod

integer <int32>

可选

商品保质期天数，必须全数字小于10000

qualityGuaranteePeriodUnit

integer

可选

SKU保质期时间单位, 1:天,2:月,3:年

shelfStatus

integer <int32>

必需

商品上下架状态, 1:上架,2:下架

shortCode

string

商品简称

可选

sortNum

integer <int32>

可选

规格排序，0-999之间

specValueList

array[string]

可选

多规格属性,非多规格商品留空，例如["黑","1寸"]

status

integer <int32>

必需

商品状态, 1:正常,2:停采,3:淘汰,4:停售

weight

number

商品重量

可选

irObjects

object

可选

自定义字段Key-Value键值对, key见自定义字段apiName

sortNum

integer <int32>

商品排序值

可选

specList

array[string]

可选

多规格信息,非多规格商品留空,例如["颜色","尺寸"]

示例

{
  "brandId": 0,
  "categoryId": 0,
  "showCategoryIds": [
    0
  ],
  "description": "string",
  "enableMultiSpec": true,
  "name": "string",
  "skuAddList": [
    {
      "auxUnit": {
        "rate": 0,
        "unitName": "string"
      },
      "code": "string",
      "enableAuxUnit": true,
      "enableMultiUnit": true,
      "enableMultiUnitSeparatePricing": true,
      "freeFreight": true,
      "freightUnitName": "string",
      "keyword": "string",
      "minimum": 0,
      "multiUnitList": [
        {
          "barcode": "string",
          "basePrice": 0,
          "enableOrderUnit": true,
          "enablePurchaseUnit": true,
          "maximumPrice": 0,
          "minimumPrice": 0,
          "orderMultiple": 0,
          "price1": 0,
          "price10": 0,
          "price2": 0,
          "price3": 0,
          "price4": 0,
          "price5": 0,
          "price6": 0,
          "price7": 0,
          "price8": 0,
          "price9": 0,
          "rate": 0,
          "supplierPrice": 0,
          "unitName": "string"
        }
      ],
      "orderUnitName": "string",
      "origin": "string",
      "purchaseUnitName": "string",
      "qualityGuaranteePeriod": 0,
      "qualityGuaranteePeriodUnit": 0,
      "shelfStatus": 0,
      "shortCode": "string",
      "sortNum": 0,
      "specValueList": [
        "string"
      ],
      "status": 0,
      "weight": 0,
      "irObjects": {}
    }
  ],
  "sortNum": 0,
  "specList": [
    "string"
  ]
}

application/json

Body

integer <int64>

商品spu id

必需

skuList

array[object (新增商品SKU响应) {1}]

商品sku响应

必需

integer <int64>

商品sku id

必需

示例

{
  "id": 0,
  "skuList": [
    {
      "id": 0
    }
  ]
}

请求参数

返回响应