创建商品

请求 #

接口概述 #

创建商品,商品需要运营端审核才能在前端展示，商品创建成功后，商品状态为待审核。

注意
只能创建平台授权类目的商品

请求URL # 

POST {{host}}/products/create

请求头(header) #

参数名 类型 是否必填 说明
Authorization string 是 token

请求参数(body) #

参数名 类型 必选 验证规则 参数路径 说明
code string 是 max=60,unique 自行编码
title string 是 max=90 商品标题
sub_title string 否 max=90 商品副标题
cate_id int 是 平台类目最底层ID
brand string 是 max=30 品牌名称
unit_name string 是 max=10 单位名称
inventory_method int 是 oneof(-1,1,2) 库存扣减方式，1 提交订单减库存 2 付款减库存 -1 虚拟库存
line_price float 否 划线价格
tax_code string 是 税收分类编码 商品对应的税收分类编码
tax_rate float 是 税率 商品开票税率,免税商品0，其他0.06,0.13等
is_sale int 是 oneof(-1,1) SPU是否上架（前端展示）1上架，-1 下架
images StringArray 是 url 商品图片(默认第一张为商品主图)
pc_content string 是 PC端商品详情
mobile_content string 是 移动端商品详情
refer_url string 否 参考商品连接
attrs array 是 商品属性
label string 是 max=30 attrs 属性名称
value string 是 max=100 attrs 属性值
sort int 否 attrs 属性排序，升序
sku_attrs array 否 商品规格集
name string 是 max=60 sku_attrs 规格名称
values StringArray 是 max=60 sku_attrs 规格值数组
skus array 是 min=1 商品SKU
sku_code string 是 max=60 skus SKU自行编码
attributes array 否 skus SKU规格集
name string 是 max=60 skus.attributes 规格名称
value string 是 max=60 skus.attributes 规格值
attr_values StringArray 否 skus sku规格值集合
sale_price float 是 skus 销售价格
market_price float 否 skus 市场价格(第三方参考价)
inventory int 是 skus 库存
is_sale int 是 oneof(-1,1) skus 是否上架，1 上架 -1 下架
images StringArray 否 url skus SKU图片
min_order_num int 是 skus 最小起订量
upc_code string 否 max=60 skus UPC编码

请求示例 #

单规格商品 # 

{
  "code": "API-TEST-001",
  "title": "API测试商品",
  "sub_title": "--subtitile",
  "cate_id": 37,
  "brand_id": 1,
  "unit_name": "个",
  "inventory": 100,
  "is_sale": 1,
  "inventory_method": -1,
  "line_price": 100.00,
  "images": [
    "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIarf8AA/641",
    "https://inews.gtimg.com/om_bt/O6B8z3TRANzX36ut8z4sgDJt0Rbh2Xv1ZbGlCCED7XmUUAA"
  ],
  "pc_content": "<p>商品详情</p>",
  "mobile_content": "<p>商品详情</p>",
  "attrs": [
    {
      "label": "产地",
      "value": "北京",
      "sort": 1
    },
    {
      "label": "品牌",
      "value": "中车",
      "sort": 2
    }
  ],
  "skus": [
    {
      "sku_code": "API-TEST-001-001",
      "name": "测试商品SKU",
      "sale_price": 100.00,
      "market_price": 200.00,
      "inventory": 1000,
      "is_sale": 1,
      "images": [
        "https://inews.gtimg.com/om_bt/OrMpVlRiNYrhEguaKDCMIlZsS55hdV-D-et1bOaKIarf8AA/641",
        "https://inews.gtimg.com/om_bt/O6B8z3TRANzX36ut8z4sgDJt0Rbh2Xv1ZbGlCCED7XmUUAA"
      ],
      "min_order_num": 1,
      "upc_code": "upc_code"
    }
  ]
}

多规格商品 # 

{
  "code": "multi-001",
  "title": "多规格商品",
  "sub_title": "",
  "cate_id": 37,
  "brand_id": 6,
  "unit_name": "套",
  "is_sale": 1,
  "inventory_method": -1,
  "line_price": 0,
  "images": [
    "http://192.168.10.18:9910/cadmin/api/storage/static/1715329781_WechatIMG54.png",
    "http://192.168.10.18:9910/cadmin/api/storage/static/1715329784_WechatIMG52.png"
  ],
  "refer_url": "",
  "pc_content": "<p><img src=\"http://192.168.10.18:9910/cadmin/api/storage/static/1715329796_WechatIMG54.png\" /><img src=\"http://192.168.10.18:9910/cadmin/api/storage/static/1715329796_WechatIMG52.png\" /></p>",
  "mobile_content": "<p><img src=\"http://192.168.10.18:9910/cadmin/api/storage/static/1715329796_WechatIMG54.png\" /><img src=\"http://192.168.10.18:9910/cadmin/api/storage/static/1715329796_WechatIMG52.png\" /></p>",
  "sku_attrs": [
    {
      "name": "颜色",
      "values": [
        "蓝色",
        "红色",
        "白色"
      ]
    },
    {
      "name": "尺码",
      "values": [
        "XL",
        "XXL"
      ]
    }
  ],
  "skus": [
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "蓝色"
        },
        {
          "name": "尺码",
          "value": "XL"
        }
      ],
      "sku_code": "1",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "蓝色",
        "XL"
      ],
      "upc_code": "",
      "min_order_num": 1
    },
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "蓝色"
        },
        {
          "name": "尺码",
          "value": "XXL"
        }
      ],
      "sku_code": "225",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "蓝色",
        "XXL"
      ],
      "upc_code": "",
      "min_order_num": 1
    },
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "红色"
        },
        {
          "name": "尺码",
          "value": "XL"
        }
      ],
      "sku_code": "111",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "红色",
        "XL"
      ],
      "upc_code": "",
      "min_order_num": 1
    },
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "红色"
        },
        {
          "name": "尺码",
          "value": "XXL"
        }
      ],
      "sku_code": "222",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "红色",
        "XXL"
      ],
      "upc_code": "",
      "min_order_num": 1
    },
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "白色"
        },
        {
          "name": "尺码",
          "value": "XL"
        }
      ],
      "sku_code": "321",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "白色",
        "XL"
      ],
      "upc_code": "",
      "min_order_num": 1
    },
    {
      "inventory": 999,
      "sale_price": 12,
      "attributes": [
        {
          "name": "颜色",
          "value": "白色"
        },
        {
          "name": "尺码",
          "value": "XXL"
        }
      ],
      "sku_code": "123",
      "is_sale": 1,
      "images": [],
      "attr_values": [
        "白色",
        "XXL"
      ],
      "upc_code": "",
      "min_order_num": 1
    }
  ],
  "attrs": [
    {
      "label": "产地",
      "value": "江苏",
      "sort": 1
    },
    {
      "label": "重量",
      "value": "10KG",
      "sort": 2
    },
    {
      "label": "体积",
      "value": "1M3",
      "sort": 3
    }
  ]
}

响应 #

返回参数 #

参数名 类型 参数路径 说明
code int 错误码
msg string 错误详情
data object 结果集
uid string data 平台商品UID
code string data 自行编码
skus array data 商品SKU
sku_uid string data.skus 平台商品SKU ID
sku_code string data.skus SKU自行编码

响应示例 #

单规格 # 

{
  "code": 10000,
  "msg": "操作成功",
  "data": {
    "uid": "26931071266332672",
    "code": "API-TEST-001",
    "skus": [
      {
        "sku_uid": "26931071635431424",
        "sku_code": "API-TEST-001-001"
      }
    ]
  }
}

多规格 # 

{
  "code": 10000,
  "msg": "操作成功",
  "data": {
    "uid": "26948651259535360",
    "code": "multi-001",
    "skus": [
      {
        "sku_uid": "26948652110979072",
        "sku_code": "1"
      },
      {
        "sku_uid": "26948652110979073",
        "sku_code": "225"
      },
      {
        "sku_uid": "26948652110979074",
        "sku_code": "111"
      },
      {
        "sku_uid": "26948652110979075",
        "sku_code": "222"
      },
      {
        "sku_uid": "26948652110979076",
        "sku_code": "321"
      },
      {
        "sku_uid": "26948652110979077",
        "sku_code": "123"
      }
    ]
  }
}