铱云开放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. 商品

新增商品-新增规格

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

请求参数

Path 参数
spuId
integer 
商品id
必需
Header 参数
access_token
string 
必需
oauth2接口获取的access_token
x-client-id
string 
必需
申请对接时的clientId
Body 参数application/json
auxUnit
object (新增/修改商品信息-辅助单位) 
可选
rate
number 
辅助单位换算比率
必需
unitName
string 
辅助单位名称
必需
code
string 
商品编码
可选
enableAuxUnit
boolean 
可选
商品是否启用辅助计量单位
enableMultiUnit
boolean 
商品是否启用多单位
必需
enableMultiUnitSeparatePricing
boolean 
必需
商品是否启用多单位单独定价
freeFreight
boolean 
是否包邮
可选
freightUnitName
string 
运费单位名称
可选
keyword
string 
商品关键字
可选
minimum
number 
起订量
可选
multiUnitList
array[object (新增商品信息-单位-单位顺序按换算比例升序) {20}] 
可选
商品单位信息(非多单位商品传基础单位)
barcode
string 
可选
条形码(仅基础单位设置有效)
basePrice
number 
必需
基准订货价(非多单位单独定价商品副单位参数无效)
enableOrderUnit
boolean 
是否是分销单位
必需
enablePurchaseUnit
boolean 
是否是采购单位
必需
maximumPrice
number 
可选
最高限价(非多单位单独定价商品副单位参数无效)
minimumPrice
number 
可选
最低限价(非多单位单独定价商品副单位参数无效)
orderMultiple
integer 
可选
订货倍数,订货业务下单数量必须为该值的整数倍
price1
number 
必需
等级订货价1(非多单位单独定价商品副单位参数无效)
price10
number 
可选
等级订货价10(非多单位单独定价商品副单位参数无效)
price2
number 
必需
等级订货价2(非多单位单独定价商品副单位参数无效)
price3
number 
可选
等级订货价3(非多单位单独定价商品副单位参数无效)
price4
number 
可选
等级订货价4(非多单位单独定价商品副单位参数无效)
price5
number 
可选
等级订货价5(非多单位单独定价商品副单位参数无效)
price6
number 
可选
等级订货价6(非多单位单独定价商品副单位参数无效)
price7
number 
可选
等级订货价7(非多单位单独定价商品副单位参数无效)
price8
number 
可选
等级订货价8(非多单位单独定价商品副单位参数无效)
price9
number 
可选
等级订货价9(非多单位单独定价商品副单位参数无效)
rate
number 
换算比率
可选
supplierPrice
number 
必需
基准进货价(非多单位单独定价商品副单位参数无效)
unitName
string 
单位名称
必需
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
示例
{
  "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": {}
}

返回响应

🟢200OK
application/json
Body
id
integer <int64>
商品sku id
必需
示例
{
  "id": 0
}
修改于 2024-01-26 03:31:40
上一页
新增商品
下一页
更新商品
Built with