用于分页查询指定组织下的商品列表。

pageNum

pageSize

商品状态 取值范围[0,2]。0-上架 1-下架 2-已售罄

goodsStatus

classifyId

search

排序方式，取值范围[1,4]。1-商品销量 2-上下架时间 3-商品价格 4-商品排序值。如果不传入默认按照商品创建时间排序。

sort

搜索类型，1.商品名称 2.商品编码 3.规格条码 4.商品编码， 默认值 1

searchType

minSalePrice

maxSalePrice

搜索匹配类型： 1-模糊匹配 2-精确匹配 （条码只支持精确匹配）， 默认值 1

searchOptionType

goodsTagIdList

商品更新起始时间, 时间戳，单位：毫秒

startUpdateTime

商品更新结束时间， 时间戳，单位：毫秒

endUpdateTime

排序类型，0-升序，1-倒序。配合sort字段一起使用。

sortType

queryParameter

basicInfo

errcode

errmsg

code

totalCount

goodsId

title

subTitle

createVid

defaultImageUrl

外部商品编码,商户自有ERP系统的商品编码

outerGoodsCode

goodsStock

goodsPrice

总销量：商品初始销量+商品支付量。

realSaleNum

销售类型，取值范围[1,3]。1-现货 2-预售 3-抽签购。

soldType

一级商品类型，取值范围[1,2]。1-实物商品. 2-虚拟商品

goodsType

二级商品类型，101-实物物流 102-海淘 201-虚拟无需配送 202-付费卷

subGoodsType

是否多规格，true-多规格，false-单规格

isMultiSku

是否上架，true-上架，false-下架

isOnline

是否可售，true-可售，false-不可售

isCanSell

onlineTime

pageList

data

每页包含的数据条数，上限为 20。

待查询商品的状态。不传值时，默认返回所有状态的商品。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 0-上架；1-下架；2-已售罄。

待查询商品所属分组的 ID，此处需传入二级分组 ID。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=2774&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/classify/getList</a> 接口返回参数中的 goodsClassifyList.classifyId 字段获取该 ID。

商品的搜索内容，该字段需要与 searchType 字段搭配使用。例如：当 searchType=1（商品名称）时，则 search 字段可传入商品名称进行搜索（支持模糊搜索）。

商品查询结果的排序方式，与 sortType 字段搭配使用（sortType 用于控制排序的升降）。不传值时默认按照商品创建时间排序。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 1-按商品销量排序；2-按商品上架时间排序；3-按商品价格排序；4-按商品在商家后台的排序值排序。

商品内容的搜索类型，与 search 字段搭配使用。当不传时默认为 1。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 1-根据商品名称搜索；2-根据商品编码搜索；3-根据规格条码搜索；4-根据规格编码搜索。

待查询商品的最小销售价，精确到 2 位小数，单位：元。例如：750.50 表示 750 元 5 角。当不传时将不筛选待查询商品的最小销售价。

待查询商品的最大销售价，精确到 2 位小数，单位：元。例如：800.15 表示 800 元 1 角 5 分。当不传时，将不筛选待查询商品的最大销售价。

搜索匹配类型。不传时默认为 1。当 searchType=2（商品编码）、3（规格条码）、4（规格编码）时，searchOptionType 只能为 2（精确匹配）。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 1-模糊匹配；2-精确匹配。

待查询商品的标签 ID，最多传入 20 个。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2403&id=3199&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/tag/getList</a> 接口返回参数中的 pageList.tagId 字段获取此 ID。

待查询商品的更新起始时间,，时间戳，单位：毫秒。

待查询商品的更新结束时间， 时间戳，单位：毫秒。

 <a style="background-color:#FBE4E7;border-radius:50px">&ensp;注意&ensp;</a> 

更新结束时间（endUpdateTime）必须大于更新起始时间（startUpdateTime），否则接口会报错。

排序类型，与 sort 字段搭配使用。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 0-升序；1-倒序。

查询条件，该字段不传时默认返回当前组织下的所有商品。

待查询商品所归属的组织 ID，是 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2850&isold=2" style="color:#0F72FF;" target="_blank">创建组织</a> 时自动生成的 ID。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2348&isold=2" style="color:#0F72FF;" target="_blank">bos/organization/getList</a> 接口返回参数中的 data.vid 字段获取该 ID。

外部商品编码，是商户自有 ERP 系统的商品编码。

商品总销量：商品初始销量+商品支付量。

销售类型。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 1-现货；2-预售；3-抽签购。

一级商品类型。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 1-实物商品；2-虚拟商品。

二级商品类型。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> 101-普通商品；102-海淘商品；103-无需物流实物商品；201-普通虚拟商品；202-付费券虚拟商品；203-预约到店。

商品是否多规格。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-多规格；false-单规格。

商品是否上架。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-上架；false-下架。

商品是否可售。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-可售；false-不可售。

商品上架时间。时间戳格式，单位毫秒。

用于通过 sku 规格编码或规格条码，获取某一指定商品的商品信息和规格信息。

规格条码，精确匹配（和规格编码必传一个）

skuBarCode

规格编码，精确匹配（和规格条码必传一个）

outerSkuCode

是否查询sku价格信息（销售价、市场价），默认不查询。如果需要查询传入true。

querySkuPriceInfo

querySkuCostPriceInfo

querySkuSpecInfo

skuId

销售价，querySkuPriceInfo = true会返回销售价。

salePrice

市场价，querySkuPriceInfo = true会返回市场价。

marketPrice

成本价，querySkuCostPriceInfo = true会返回成本价。

costPrice

sku规格值信息，querySkuSpecInfo = true会返回规格信息。

skuSpecList

skuList

待查询商品所归属的组织 ID，是 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2850&isold=2" style="color:#0F72FF;" target="_blank">创建组织</a> 时自动生成的 ID。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2348&isold=2" style="color:#0F72FF;" target="_blank">bos/organization/getList</a> 接口返回参数中的 data.vid 字段获取该 ID。

待查询商品的规格条码，该字段为精确匹配，且与规格编码二者必须选一传入。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2396&id=2642&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/get</a> 接口返回参数中的 skuList.skuBarCode 字段获取，也可以通过微盟商家后台商品编辑页获取。

待查询商品的规格编码，该字段为精确匹配，且与规格条码二者必选一传入。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2396&id=2642&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/get</a> 接口返回参数中的 skuList.outerSkuCode 字段获取，也可以通过微盟商家后台商品编辑页获取。

是否查询 SKU 价格信息（销售价、市场价）。默认为不查询，如果需要查询请传入 true。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-查询；false-不查询。

是否查询 SKU 成本价信息。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-查询；false-不查询。

是否查询 SKU 规格值信息。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-查询；false-不查询。

查询商品的销售价，querySkuPriceInfo = true 时会返回销售价。

查询商品的市场价，querySkuPriceInfo = true 时会返回市场价。

查询商品的成本价，querySkuCostPriceInfo = true 时会返回成本价。

查询商品的 SKU 规格值信息，querySkuSpecInfo = true 时会返回规格信息。

用于根据指定组织下的商品 ID 列表，批量查询对应的商品信息。

goodsIdList

商品可售库存(全部SKU库存之和)，精确到2位小数。如库存单位选择克，表示:600.10克。

goodsStockNum

最小销售价，精确到2位小数。单位:元。如750.50，表示:750元5角。

最大销售价，精确到2位小数。单位:元。如800.15，表示:800元1角5分。

payGoodsNum

待查询商品 ID 列表。列表长度最大不得超过 50。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=2776&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/getList</a> 接口返回参数中的 pageList.goodsId 字段获取所需商品 ID。

商品可售库存（全部 SKU 库存之和），精确到 2 位小数。例如：库存单位选择克，表示 600.10 克。

最小销售价，精确到 2 位小数。单位：元。例如：750.50，表示 750 元 5 角。

最大销售价，精确到 2 位小数。单位:元。例如：800.15，表示 800 元 1 角 5 分。

支付总销量，即买家下单并已完成支付的商品总数量。如果买家下了单，但并未完成支付，这部分商品数量将不会在该字段中体现。

商品是否为上架状态。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-上架；false-下架。

用于快速获取多个商品的 URL 分享链接。

是否生成小程序跳转页面携带参数

isQueryScene

h5Url

miniUrl

scene

goodsUrlOutputList

商品所属的组织 ID，是 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2850&isold=2" style="color:#0F72FF;" target="_blank">创建组织</a> 时自动生成的 ID。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 
可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2348&isold=2" style="color:#0F72FF;" target="_blank">bos/organization/getList</a> 接口获取该 ID。

商品 ID 列表，列表长度最大不得超过 20。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=2776&isold=2" style="color:#0F72FF;" target="_blank">weimob_shop/goods/getList</a> 接口返回参数中的 pageList.goodsId 字段获取该 ID。

是否生成小程序跳转页面携带参数。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;枚举值&ensp;</a> true-生成；false-不生成。

当修改商品销售价、市场价、成本价变更时，触发商品销售价变更消息。

topic

event

bosId

sign

msgBody

防篡改签名：md5(clientId+id+msgBody+clientSecret)

商品 ID，可通过接口 weimob_shop/goods/getList 获得。

规格 ID，可通过接口 weimob_shop/goods/getList 获得。

组织架构节点 ID。组织的唯一标识，是创建组织时自动生成的 ID，可以通过 bos/organization/getList 接口获取该 ID。

当商品 SKU 库存售罄时，触发 SKU 库存售罄消息。

防篡改签名：md5(clientId+id+msgBody+clientSecret)。

用于查询商详模板列表信息，包括商详模板 ID、商详模板名称。

targetProductInstanceId

merchantId

商详模板所归属组织的组织 ID，是 <a href="http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2850&isold=2" style="color:#0F72FF;" target="_blank">创建组织</a> 时自动生成的 ID。

 <a style="background-color:#E8E8FF;border-radius:50px">&ensp;获取方法&ensp;</a> 可以通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2348&isold=2" style="color:#0F72FF;" target="_blank">bos/organization/getList</a> 接口 data.vid 获取该 ID。

每页包含的数据条数，最大为 20 条。

微盟商业操作系统 ID。可通过 <a href="https://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=2253&id=2350&isold=2">bos/info/get</a> 接口获取该 ID。

用于将外部系统中的在售商品，添加到微盟系统中的店铺。


	<a href="http://doc.weimobcloud.com/word?tag=3215&amp;menuId=74&amp;childMenuId=76&amp;isold=2" target="_blank"></a>

商品品牌 ID，可以通过 weimob_shop/goods/brand/getList 接口获取该 ID。

brandId

商品类目 ID。可以通过 weimob_shop/goods/category/getList 接口获取该 ID。

categoryId

propId

propValueId

商品参数信息列表，建议不超过10个(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3134&isold=2)

categoryPropertyList

库存减扣方式：1-下单减扣，2-支付减扣

deductStockType

商品分组id， 建议不超过10个(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=2774&isold=2)

goodsClassifyIdList

goodsDesc

goodsImageUrl

属性值id(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3147&isold=2)

商品属性，建议不超过10个(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3149&isold=2)

goodsPropertyList

商品服务值id(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3137&isold=2)

商品服务，建议不超过10个(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3138&isold=2)

goodsRightsList

goodsTemplateId

商品类型：1-普通商品、2-虚拟商品

goodsVideoImageUrl

goodsVideoUrl

initSales

内部属性值id(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3147&isold=2)

商品内部属性，建议不超过10个(获取路径：http://doc.weimobcloud.com/detail?menuId=19&childMenuId=1&tag=1522&id=3149&isold=2)

innerPropertyList

invoiceTitle

商品开票名称类型，1-同商品名称， 2-自定义名称

invoiceTitleType

是否可售：false 禁售， true 可售, 。该字段无需传入，微商城默认可售，零售会读取后台配置来设置可售禁售状态。

是否多规格，如果是多规格则规格信息必传。

goodsLimitNum

限购周期：0～4 终身/每天/每周/每月/每年

goodsLimitCycle

限购信息， limitSwitch 为true才会生效

limitInfo

limitSwitch

deliveryId

deliveryNodeShipId

deliveryType

templateId

deliveryList

配送周期
1-"每日一次"
2-"每周一次"
3-"每月一次"
4-"多周一次"
5-"多月一次"
6-"每周多次"
7-"每月多次"

文档中心

开发者角色

快速开始

工具与帮助

能力中心

常用API

能力场景

解决方案

在售商品