修改/新增商品V2
POST
请求地址/router
接口描述
修改/新增商品V2。支持新增/修改普通商品、加工商品、套件商品、组合商品
系统相关界面
请求地址
公共参数
请求头
参数名
类型
描述
必填
Content-Type
string
application/x-www-form-urlencoded;charset=UTF-8
必填
API接口地址
参数名
类型
描述
必填
method
string
erp.item.general.addorupdate
必填
请求参数
参数名
类型
描述
必填
itemRequestType
integer
商品类型（0-普通商品，1-加工 2-套件 3-组合），除了普通商品类型，其他类型的商品都需要填写“单品”字段的值。注意：新增时为必填，修改时为非必填
可选
outerId
string
平台商家编码（主商家编码）
必填
title
string
商品名称
必填
propertiesName
string
规格真正的属性，包括颜色属性、其他属性、第三属性、第四属性，以分号分隔，如：“红色;XL”
必填
outerId
string
sku级别的规格商家编码
必填
id
long
平台skuID
可选
barcode
string
规格条形码（如果要更新为空，则传入字符串“empty”）
可选
weight
double
重量（单位：Kg），示例：0.05
可选
purchasePrice
double
成本价（单位：元），示例：100.99
可选
sellingPrice
double
销售价（单位：元），示例：100.99
可选
wholesalePrice
double
批发价（单位：元），示例：100.99
可选
picPath
string
sku的图片地址
可选
propertiesAlias
string
规格别名
可选
sellerCids
string
规格分类ID
可选
itemCategoryNames
string
规格分类名称，多个用逗号隔开； 支持指定多级分类 ， 格式：[["一级分类","二级分类","三级分类"],["一级分类","二级分类","三级分类1"]]
可选
brandId
string
规格品牌ID
可选
brand
string
规格品牌名称
可选
remark
string
规格备注
可选
skuComponent
string
规格成分
可选
marketPrice
double
规格市场价（单位：元），示例：100.99
可选
otherPrice1
double
规格其他价格1（单位：元），示例：100.99
可选
otherPrice2
double
规格其他价格2（单位：元），示例：100.99
可选
otherPrice3
double
规格其他价格3（单位：元），示例：100.99
可选
controlPurchase
boolean
是否维护历史成本价：默认为false，不维护历史成本价
可选
uniqueCodeType
integer
唯一码类型 * 0-弱唯一码 * 1-强唯一码
可选
activeStatus
boolean
商品状态，true-启用，false-停用
可选
sysItemId
long
系统主商品ID
可选
sysSkuId
long
系统商品skuID
可选
ratio
integer
比例，数量
可选
safekind
string
安全类别
可选
standard
string
执行标准
可选
place
string
产地
可选
code
string
供应商编码
必填
itemTitle
string
供应商商品名称
可选
itemOuterId
string
供应商的商品商家编码
可选
caigouUrl
string
采购链接
可选
discountRate
double
折扣率（不大于100不小于等于0的数字）示例 98.88
可选
returnRate
double
退货率或采退率 （不大于100不小于等于0的数字）示例 6.67
可选
supplierPurchasePrice
double
供应商报价信息（进价）（不大于9999999.99不小于0的数字） 示例 98.88
可选
shortTitle
string
商品简称
可选
barcode
string
商品条形码（当用户开启一品双码时，企业数据全局唯一，不能和商家编码重复）
可选
id
long
系统主商品ID （有值表示修改已存在的商品）
可选
catId
sting
商品类目属性ID
可选
itemCatName
string
商品类目名称，各类目层级中如果没有重复可以只传商品类目名称； 支持指定多级类目，类目层级格式：["根类目","一级类目","二级类目","三级类目"]
可选
sellerCids
string
商品分类ID
可选
itemCategoryNames
string
商品分类名称，各分类层级中如果没有重复可以只传商品分类名称，多个分类用逗号隔开； 支持指定多级分类，分类层级格式：[["一级分类","二级分类","三级分类","四级分类1"],["一级分类","二级分类","三级分类","四级分类2"]]
可选
picPath
string
预览图片URL
可选
brandId
long
商品品牌ID (通过品牌接口去查询)
可选
brand
string
商品品牌名称
可选
purchasePrice
double
成本价（单位：元），示例：100.99
可选
sellingPrice
double
销售价（单位：元），示例：100.99
可选
weight
double
商品重量（单位：Kg）， 示例：0.05
可选
remark
string
商品备注
可选
productFeature
int
申报产品特性 0:普货,1:带电池,2:侵权,3:带磁,4:非液体（化妆品）,5:液体（化妆品）,6:液体（非化妆品）,7:粉末,8:膏体
可选
makeGift
boolean
是否标记为赠品（默认为false）
可选
periodCast
integer
保质期（单位：天）
可选
unit
string
商品单位 ，示例：件、箱
可选
x
double
长（单位：cm） ，示例：0.01
可选
y
double
宽（单位：cm） ，示例：0.01
可选
z
double
高（单位：cm） ，示例：0.01
可选
wholesalePrice
double
批发价（单位：元），示例：100.99
可选
invoice
string
开票名称
可选
boxnum
integer
箱规
可选
place
string
产地
可选
component
string
成分
可选
standard
string
执行标准
可选
safekind
string
安全类别
可选
marketPrice
double
市场价（单位：元）
可选
otherPrice1
double
其他价格1（单位：元）
可选
otherPrice2
double
其他价格2（单位：元）
可选
otherPrice3
double
其他价格3（单位：元）
可选
listTime
string
上架时间 格式为：yyyy-MM-dd HH:mm:ss
可选
definedKey
string
属性名称
必填
definedValue
string
属性值
可选
activeStatus
boolean
商品状态，true-启用，false-停用（会影响下面所有规格的状态）
可选
sysItemId
long
系统主商品ID
可选
sysSkuId
long
系统商品skuID
可选
ratio
integer
比例，数量
可选
uniqueCodeType
integer
唯一码类型 * 0-弱唯一码 * 1-强唯一码
可选
code
string
供应商编码
必填
caigouUrl
string
采购链接
可选
discountRate
double
折扣率（不大于100不小于等于0的数字）示例 98.88
可选
returnRate
double
退货率或采退率 （不大于100不小于等于0的数字）示例 6.67
可选
itemTitle
string
供应商商品名称
可选
itemOuterId
string
供应商的商品商家编码
可选
supplierPurchasePrice
double
供应商报价信息（进价）（不大于9999999.99不小于0的数字） 示例 98.88
可选