# 3、商品管理 ### 商品管理 ### 3.1 获取商品列表接口 获取商品列表接口 ### item.l istQuery 接口介绍： 获取商品列表 请求参数： | 参数名称 参数类型 | 是否必填 示例 | 参数描述 |------------------|------------------|------------------|------------|------------------| | itemStatus | integer | Y | | 1.商品状态，包括：在售:1；下架：2；待发布：100010； 2.原字段名为 status, 旧版本接口仍可兼容使用 | | editStatus integer | N | 1.商品审核状态，包括 601：存草稿；603：审核中；604：审核不通过；605：审核通过； 2.原字段名为 auditStatus, 旧版本接口仍可兼容使用 |------------------------------------|---------------------------|---------|------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | pageNo | integer | N | | 需要查询的页数，默认第一页 | | pageSize integer | N | 每页查询的上新数量(最多查询100条,超过按100算) |------------------------------|---------------------------|---------|------|---------------------------------------------------------------------------------------| | itemId | ingeger | N | | 商品id搜索 | | createStart date | N | 创建时间开始于，yyyy-MM-dd hh:mm:ss |---------------------------------------|------------------|---------|------|---------------------------------------------------------------------------------------| | createEnd | date | N | | 创建时间结束于，yyyy-MM-dd hh:mm:ss | 响应数据： | 参数名称 参数类型 | 示例 参数描述 | |------------------|------------------|------------|------------------| | data | ItemPageDTO | | 分页信息 | | code string | 错误码 | |------------------|------------------------|------|---------------| | msg | string | | 信息 | ### ### 3.2 更新价格接口 更新价格接口 ### item.editSkuPurchasePrice 接口介绍： 更新单商品多sku价格（针对预估收入定价） 请求参数： | 参数名称 参数类型 | 是否必填 示例 | 参数描述 |------------------|------------------|------------------|------------|------------------| | itemId | string | Y | | fordeal商品id | | skuPurchasePriceMap json | Y SKU的价格信息(一个或着多个),格式{skuid1:price1,skuid2:price2} e.g:{1232:12.32} | 商品sku与价格映射表。 单位美元,两位小数 |---------------------------------------------------------------|------------------|---------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------| | ├─ skuId1 | decimal(16,2) | Y | | key:skuId ,value:采购价 | | ├─ ... | | |------------------------|------|------|------|------| 响应数据： | 参数名称 参数类型 | 示例 参数描述 | |------------------|------------------|------------|------------------| | data | object | | 数据 | | ├─ operationResult ItemOperationResultDTO[] | 操作结果 | |------------------------------------------------------------|------------------------------------------------------------------------------|------|------------------| | code | integer | | 见通用返回码 | | msg string | 返回消息 | |---------------|------------------------|------|------------------| ### 3. 3 更新库存接口 更新库存接口 ### item.editSkuStock 接口介绍： 更新单个商品的多sku库存,本接口只支持修改虚库库存(销售库存) 请求参数： | 参数名称 参数类型 | 是否必填 示例 | 参数描述 |------------------|------------------|------------------|------------|------------------| | itemId | string | Y | | fordeal平台商品唯⼀编号 | | skuStockMap json | Y e.g:{id:number1,id:number2} | SKU的库存信息(一个或着多个),格式(number 为要编辑的可售库存数量) key:skuId,value:库存值 |---------------------------------------|------------------|---------|---------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | ├─ skuId1 | Integer | Y | | key:int 类型，skuId 信息 value:库存值 | 响应数据： | 参数名称 参数类型 | 示例 参数描述 | |------------------|------------------|------------|------------------| | data | object | | 数据 | | ├─ operationResult ItemOperationResultDTO[] | 操作结果 | |------------------------------------------------------------|------------------------------------------------------------------------------|------|------------------| | code | integer | | 见通用返回码 | | msg string | 返回消息 | |---------------|------------------------|------|------------------| ### 3. 4 上架商品接口 上架商品接口 ### item.onlineItem 接口介绍： 上架商品 请求参数： | 参数名称 参数类型 | 是否必填 示例 | 参数描述 |------------------|------------------|------------------|------------|------------------| | itemIds | String | Y | | 需要上架的商品id列表。可输入多个，使用英文逗号分隔 | 响应数据： | 参数名称 参数类型 | 示例 参数描述 | |------------------|------------------|------------|------------------| | data | object | | 数据 | | ├─ operationResult ItemOperationResultDTO[] | 操作结果 | |------------------------------------------------------------|------------------------------------------------------------------------------|------|------------------| | code | integer | | 见通用返回码 | | msg string | 返回消息 | |---------------|------------------------|------|------------------| ### 3. 5 下架商品接口 下架商品接口 ### item.offlineItem 接口介绍： 下架商品 请求参数： | 参数名称 参数类型 | 是否必填 示例 | 参数描述 |------------------|------------------|------------------|------------|------------------| | itemIds | String | Y | | 需要下架的商品id列表。可输入多个，使用英文逗号分隔 | 响应数据： | 参数名称 参数类型 | 示例 参数描述 | |------------------|------------------|------------|------------------| | data | object | | 数据 | | ├─ operationResult ItemOperationResultDTO[] | 操作结果 | |------------------------------------------------------------|------------------------------------------------------------------------------|------|------------------| | code | integer | | 见通用返回码 | | msg string | 返回消息 | |---------------|------------------------|------|------------------|