21. 商品列表
1. 接口
/mtop/aftersale/openapi/product/list
2. 接口参数
公共参数
请求参数
data:
字段 | 类型 | 是否必填 | 备注 |
---|---|---|---|
pid | Long | 否 | 商品型号ID |
gid | Long | 否 | 商品ID |
status | Integer | 否 | 商品状态,0:上架未开售,1:上架已开售,-1:未上架 |
beginTime | Long | 否 | 商品创建开始时间,unix timestamp 秒 |
endTime | Long | 否 | 商品创建结束时间,endTime-beginTime 不超过30天 |
updateBeginTime | Long | 否 | 商品更新开始时间,unix timestamp 秒 |
updateEndTime | Long | 否 | 商品更新结束时间,updateEndTime-updateBeginTime 不超过30天 |
pageNo | Integer | 否 | 当前页号,默认1,从1开始 |
pageSize | Integer | 否 | 页大小,默认50, pageSize <= 100 |
3. 请求示例
4. 返回示例
{
"code": 0,
"message": "ok",
"data": {
"pageNo": 1,
"pageSize": 50,
"total": 2000,
"productList":[{
"pid": 19558, // 商品PID
"pidPrice": 5900, // 商品单价, 单位分
"pidName": "魔法趣味圣诞帽 红色", // 商品PID名称
"isPackage": 1, // 是否为套装商品标识:1-套装,0-非套装
"gid": 104223, // 商品GID
"merchantId": 88, // 商家id
"merchantName": "青岛小驴智慧网络科技有限公司", // 商家名称
"consignor": 65, // 发货主体 (65为有品配送,非65为商家自发)
"createTime": 1541151235, // 创建时间,时间戳(秒)
"updateTime": 0, // 更新时间,时间戳(秒)
"type": 0 , // 商品类型 0-普通, 1-外链, 2-众筹, 3-一元购, 6-拼团, 102-内测, 103-内购
"status": 0 , // 商品状态 0-上架未开售, 1-上架已开售, -1-未上架
"skuList": [{
"skuId": 3000054, // skuid
"skuName": "遇荐魔法趣味圣诞帽 红色", // sku名称
"skuPrice": 5900, // sku价格
"skuCount": 1, // sku数量
"code69": "6925662262372" // sku 69编码
}]
}]
}
}
5. 注意
- 有品商品暂不支持外部编码,商家入驻有品创建商品时会生成统一的商品skuid,skuid需要商家ERP维护。
- 有品订单中的最小售卖单位是pid。skuId 是仓库库存单位,套装商品上线后,pid与skuId的关系为1对1。升级详情见 套装商品升级指南
- gid是产品站编号,一个gid下有多个pid。