文档
测试

添加产品

POST
/erp-product

接口描述

用于添加产品。

请求头

参数名
类型
描述
必填
Device-Type
string
设备类型,示例:web
必填
Authorization
string
Token,示例:28d9044e-ca32-469f-8c89-e0209fdb3b52
必填

请求参数

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

响应参数

参数名
类型
描述
必填
id
int
产品ID,示例:82
必填
image
string
产品图片,示例:
必填
name
string
产品名称,示例:印度带头虾
必填
product_no
string
产品编号,示例:163055204883807
必填
price_unit
string
价格单位,示例:USD
必填
cost_price
string
产品成本价,示例:0.00
必填
market_price
string
产品市场价,示例:0.00
必填
is_spec
int
是否多规格,示例:1,值:{"0":"否","1":"是"}
必填
category_id_path
string
产品分类ID路径,示例:1
必填
category_id
int
产品分类ID,示例:1
必填
unit
string
产品单位,示例:
必填
create_time
string
创建时间,示例:2021-09-02 11:07:28
必填
update_time
string
更新时间,示例:2021-09-02 11:07:28
必填
spec
array
产品规格列表
必填
id
int
产品规格ID,示例:73
必填
product_id
int
产品ID,示例:82
必填
spec_item_ids
string
产品规格栏目IDS,示例:892:901
必填
product_no
string
产品规格编号,示例:163055204883807-1
必填
cost_price
string
产品规格成本价,示例:0.00
必填
market_price
string
产品规格市场价,示例:0.00
必填
spec_item
array
产品规格栏目列表
必填
id
int
产品规格栏目ID,示例:892
必填
product_id
int
产品ID,示例:82
必填
category_spec_id
int
产品分类规格ID,示例:1
必填
name
string
规格值,示例:13/15
必填
image
string
规格图片,示例:
必填
operation_mode
string
运算方式,示例:,值:{"add":"加","sub":"减","mul":"乘","div":"除"}
必填
operation_num
int
运算数,示例:0
必填

## 注意事项 接口响应时间会根据产品规格数量有所变动,前端可以呈现加载状态优化用户体验。 产品规格栏目键名 `spec_item>key` 必须按索引升序排序。 后端写入数据前会去除字段 `product_no` `name` `spec_item.list.name` `spec.product_no` 左右两侧空白字符。 当用户开启多规格需要显示用户选择的产品类别下的规格列表,可通过 [产品分类规格列表](doc:UaLgshtW) 获取。 根据产品分类规格列表返回的 `type` 判断当前规格是显示输入框或选择器,如果是选择器规格值使用 `value` 字段内的值。 根据产品分类规格列表返回的 `is_image` 判断当前规格是否允许上传图片。 根据产品分类规格列表返回的 `is_operation` 判断当前规格是否开启运算模式。