文档
测试

更新产品

PUT
/erp-product/:id

接口描述

用于更新产品信息。

请求头

参数名
类型
描述
必填
Device-Type
string
设备类型,示例:web
必填
Authorization
string
Token,示例:a3f2f638-5035-4bbe-ba12-8a5a6469ef2f
必填

请求参数

application/json
参数名
类型
描述
必填
id
int
产品ID,示例:94
必填
image
string
产品图片,示例:
可选
name
string(100)
产品名称,示例:印度带头虾
必填
product_no
string(20)
产品编号,示例:,默认:当前毫秒时间戳+随机数(0-9)
可选
price_unit
string
价格单位,示例:USD
可选
cost_price
string
成本价,示例:0.00
可选
market_price
string
市场价,示例:0.00
可选
is_spec
int
是否多规格,示例:1,可选值:{"0":"否","1":"是"}
可选
category_id
int
产品分类ID,示例:1
必填
unit
string(10)
产品单位,示例:
可选
spec
object
产品规格列表,说明:is_spec=1时必填*
可选
1-0:3-9
object
产品规格键名,格式:产品规格栏目键名,多个用英文冒号分割
必填
id
int
产品规格ID,示例:199,说明:不为空时更新
可选
spec_item_ids
string
产品规格栏目IDS,示例:980:989,说明:产品规格ID不为空时必填*
可选
product_no
string(20)
产品规格编号,示例:,默认:产品编号+索引
可选
cost_price
string
产品规格成本价,示例:0.00,默认:产品成本价
可选
market_price
string
产品规格市场价,示例:0.00,默认:产品市场价
可选
spec_item
object
产品规格栏目列表,说明:is_spec=1时必填*
可选
1-0
object
产品规格栏目键名,格式:分类规格ID-产品规格栏目列表索引
必填
id
int
产品规格栏目ID,示例:980,说明:不为空时更新
可选
category_spec_id
int
分类规格ID,示例:1
必填
name
string(25)
规格值,示例:13/15
必填
image
string
规格图片,示例:
可选
operation_mode
string
运算方式,示例:,可选值:{"add":"加","sub":"减","mul":"乘","div":"除"}
可选
operation_num
int
运算数,示例:0
可选

响应参数

application/json
参数名
类型
描述
必填
id
int
示例:94
必填
image
string
示例:
必填
name
string
示例:印度带头虾
必填
product_no
string
示例:163057339160877
必填
price_unit
string
价格单位,示例:USD
必填
cost_price
string
示例:0.00
必填
market_price
string
示例:0.00
必填
is_spec
int
示例:1
必填
category_id_path
string
示例:1
必填
category_id
int
示例:1
必填
unit
string
产品单位,示例:
必填
create_time
string
示例:2021-09-02 17:03:11
必填
update_time
string
示例:2021-09-02 17:03:11
必填
spec
array
数据列表
必填
id
int
示例:199
必填
product_id
int
示例:94
必填
spec_item_ids
string
示例:980:989
必填
product_no
string
示例:163057339160877-18
必填
cost_price
string
示例:0.00
必填
market_price
string
示例:0.00
必填
spec_item
array
数据列表
必填
id
int
示例:980
必填
product_id
int
示例:94
必填
category_spec_id
int
示例:1
必填
name
string
示例:13/15
必填
image
string
示例:
必填
operation_mode
string
示例:
必填
operation_num
int
示例:0
必填

说明 / 示例

## 注意事项 <blockquote class="danger"><p>新的产品索引需在产品栏目对象 <code>spec_item</code> 长度基础上增加*</p></blockquote> <blockquote class="danger"><p>旧的产品索引不能变更</p></blockquote> 接口响应时间会根据产品规格数量有所变动,前端可以呈现加载状态优化用户体验。 后端写入数据前会去除字段 `product_no` `name` `spec_item.list.name` `spec.product_no` 左右两侧空白字符。 当用户开启多规格需要显示用户选择的产品类别下的规格列表,可通过 [产品分类规格列表](doc:UaLgshtW) 获取。 根据产品分类规格列表返回的 `type` 判断当前规格是显示输入框或选择器,如果是选择器规格值使用 `value` 字段内的值。 根据产品分类规格列表返回的 `is_image` 判断当前规格是否允许上传图片。 根据产品分类规格列表返回的 `is_operation` 判断当前规格是否开启运算模式。 [编辑产品接口](doc:d21VUFJe) 会返回 `spec_item.id`、`spec.id`、`spec.spec_item_ids`。