铱云开放API 2.0
易订货2.0
易订货2.0
  1. 商品
  • 开发指南
    • 开发须知
    • 更新历史
  • 登录授权
    • 获取 access_token
      GET
  • 基础数据
    • 区域列表
      GET
    • 仓库列表
      GET
    • 员工列表
      POST
    • 客户分类列表
      GET
    • 商品单位列表
      GET
    • 商品分类列表
      GET
    • 商品品牌列表
      GET
    • 商品展示分类列表
      GET
    • 商品授权方案列表
      GET
    • 查询价格等级
      GET
    • 查询组织(店铺)信息
      GET
  • 公共
    • 省市区域
      • 获取国家城市列表
      • 获得国家列表
      • 获取市区列表
      • 获取省份列表
    • 物流公司
      • 获取物流公司列表
  • 客户
    • 客户列表
      POST
    • 创建客户
      POST
    • 修改客户
      PUT
  • 商品
    • 商品列表
      GET
    • 增量更新的skuId列表
      GET
    • 新增商品
      POST
    • 新增商品-新增规格
      POST
    • 更新商品
      PUT
    • 新增等级调价单并审核
      POST
    • 新增客户调价单并审核
      POST
  • 订单
    • 订单列表
    • 订单出库
    • 关闭一个B2B订单
    • 创建订单
    • 订单审核
    • 商家订单列表
    • 商家订单发货记录
  • 退单
    • 退单列表
    • 商家退单列表
    • 退单审核
    • 退单收货审核
    • 退单入库
  • 采购
    • 直发采购单和销售单关系
    • 采购订单列表
    • 采购退单列表
    • 创建采购单
    • 采购单入库
    • 采购退单审核
    • 采购退单出库
  • 库存
    • 库存列表
    • 同步库存(同步失败看接口返回)
    • 签收单列表
    • 出库签收
    • 创建其它入库单
    • 审核其它入库单
    • 创建其它出库单
    • 新增盘点单
    • 审核其它出库单
    • 采购入库单列表
    • 销售退货入库单列表
    • 采购退货出库单列表
    • 销售出库单列表
    • 查询供应商列表
    • 查询供应商商品
  • 资金-收付款
    • 收付款单列表
    • 收款记录列表
    • 往来对象核销触发
    • 新增收款单(强鉴权)
    • 查询核销单列表
    • 添加其他应付单
    • 查询其他应付单列表
    • 添加其他应收单
    • 查询其他应收单列表
    • 查询其他应收/应付收费用类型列表
  • 常见问题与解答
    • 常见问题与解答
  • 开放接口-商家端-商家订单管理
  1. 商品

更新商品

PUT
/product-aggregation/products/{spuId}
openapi商品接口

请求参数

Path 参数
spuId
string 
必需
商品spuId,不是skuId
Header 参数
access_token
string 
必需
oauth2接口获取的access_token
x-client-id
string 
必需
申请对接时的clientId
Body 参数application/json
brandId
integer <int64>
必需
商品品牌(为null时会清除商品品牌)
categoryId
integer <int64>
商品分类
必需
showCategoryIds
array[integer <int64>]
可选
展示分类,最多可指定20个
<= 20 items
description
string 
描述
可选
enableMultiSpec
boolean 
可选
是否开启多规格商品(启用后不可关闭)
name
string 
商品名称
必需
skuUpdateList
array [object {22}] 
更新的规格
可选
auxUnit
object (新增/修改商品信息-辅助单位) 
可选
enableAuxUnit
boolean 
可选
商品是否启用辅助计量单位
enableMultiUnit
boolean 
商品是否启用多单位
必需
enableMultiUnitSeparatePricing
boolean 
可选
商品是否启用多单位单独定价
freeFreight
boolean 
是否包邮
可选
freightUnitName
string 
运费单位名称
可选
id
integer <int64>
修改的sku id
必需
irObjects
object 
可选
自定义字段Key-Value键值对, key见自定义字段apiName,想将值修改为空时传空字符串({"c_xxxx":""})
keyword
string 
商品关键字
可选
minimum
number 
起订量
可选
multiUnitList
array[object (修改商品信息-单位-单位顺序按换算比例升序) {9}] 
可选
商品单位信息(非多单位商品传基础单位)
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]
可选
多规格属性,例如["黑","12寸"]
status
integer <int32>
必需
商品状态, 1:正常,2:停采,3:淘汰,4:停售
weight
number 
商品重量
可选
sortNum
integer <int32>
商品排序值
可选
specList
array[string]
可选
多规格信息,例如["颜色","尺寸"]
示例
{
  "brandId": 0,
  "categoryId": 0,
  "showCategoryIds": [
    0
  ],
  "description": "string",
  "enableMultiSpec": true,
  "name": "string",
  "skuUpdateList": [
    {
      "auxUnit": {
        "rate": 0,
        "unitName": "string"
      },
      "enableAuxUnit": true,
      "enableMultiUnit": true,
      "enableMultiUnitSeparatePricing": true,
      "freeFreight": true,
      "freightUnitName": "string",
      "id": 0,
      "irObjects": {
        "property1": "string",
        "property2": "string"
      },
      "keyword": "string",
      "minimum": 0,
      "multiUnitList": [
        {
          "barcode": "string",
          "enableOrderUnit": true,
          "enablePurchaseUnit": true,
          "id": 0,
          "maximumPrice": 0,
          "minimumPrice": 0,
          "orderMultiple": 0,
          "rate": 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
    }
  ],
  "sortNum": 0,
  "specList": [
    "string"
  ]
}

返回响应

🟢200OK
application/json
Body
object {0}
示例
{}
修改于 2024-01-26 03:31:40
上一页
新增商品-新增规格
下一页
新增等级调价单并审核
Built with