数字化供应链 接口文档
  1. 选品
数字化供应链 接口文档
  • 公共消息
  • 消息说明
  • 商品
    • 获取商品详情v2
      GET
    • 批量获取详情v2
      POST
    • 获取全量分类v2
      GET
    • 获取逐级类目v2
      GET
    • 批量更新商品v2
      POST
  • 选品
    • 选品分组列表v2
      GET
    • 在线选品v2(新版)
      POST
    • 选品分组商品列表v2
      POST
    • 选品库增加商品v2
      GET
    • 选品库商品列表v2
      GET
    • 选品库移除商品v2
      GET
  • 订单
    • 可售检测V2
      GET
    • 前置校验V2
      POST
    • 提交下单V2
      POST
    • 全平台订单列表V2
      GET
    • 各平台订单列表V2
      GET
  • 物流
    • 确认收货
      POST
    • 物流查询v2
      GET
    • 获取物流公司列表V2
      GET
  • 售后
    • 售后前置校验V2
      POST
    • 上传售后凭证(图片)V2
      POST
    • 申请售后V2
      POST
    • 售后列表V2
      GET
    • 售后详情V2
      GET
    • 退货商家邮寄信息
      PATCH
  • 消息
    • 店铺订单取消
    • 商品下架
    • 交易成功
    • 售后同意
    • 商品上架
    • 商品已收货
    • 售后拒绝
    • 商品修改
    • 商家已发货
    • 售后退款到账
    • 商品价格变更
    • 商品库添加
    • 移除商品库商品
  1. 选品

在线选品v2(新版)

POST
/v2/GoodsStorage/NewList

page最大为50,根据不同条件搜索获取商品,如果大于50会触发深度分页造成性能压力(大于50返回为50页数据)(如返回参数本身业务逻辑用不到忽略即可)#

#

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
Body 参数application/json
page
number 
页码
必需
search_words
string 
关键字搜素
可选
limit
number 
条数
必需
source
number 
可选
平台来源1生态云仓11自营云仓2鲸选6阿里16跨境一仓12特卖一仓14华东一仓18厂家直销19云仓优选20天猫优选21苏宁
category_id
number 
分类id
可选
brand_ids
array[number]
品牌id
可选
agreement_price
object 
协议价(元)
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
guide_price
object 
指导价(元)
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
activity_price
object 
营销价(元)
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
promotion_rate
object 
常规利润率
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
activity_rate
object 
营销利润率
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
profits
object 
利润区间
可选
from
number 
区间开始
可选
to
number 
区间结束
可选
created_time
object 
添加时间区间
可选
from
number 
添加时间开始区间
可选
to
number 
添加时间结束区间
可选
type
string 
可选
排序类型agreement_price协议价,guide_price指导价,activity_price营销价,promotion_rate常规利润率,activity_rate营销利润率。created_time最新上架,real_month_sale本月销量
sort
string 
可选
desc倒序asc正序
is_free_shipping
number 
可选
0不包邮1包邮-1全部
shop_words
string 
店铺id店铺名称
可选
group_id
number 
营销活动id
可选
recommend
number 
可选
默认为1,1代表精选商品,2代表全部商品
goods_type
number 
可选
当平台来源为京东时默认包含京东自营和厂直,1代表京东自营0厂直
cloud_shop_id
number 
可选
云仓店铺ID 0代表没有
示例
{
    "page": 0,
    "search_words": "string",
    "limit": 0,
    "source": 0,
    "category_id": 0,
    "brand_ids": [
        0
    ],
    "agreement_price": {
        "from": 0,
        "to": 0
    },
    "guide_price": {
        "from": 0,
        "to": 0
    },
    "activity_price": {
        "from": 0,
        "to": 0
    },
    "promotion_rate": {
        "from": 0,
        "to": 0
    },
    "activity_rate": {
        "from": 0,
        "to": 0
    },
    "profits": {
        "from": 0,
        "to": 0
    },
    "created_time": {
        "from": 0,
        "to": 0
    },
    "type": "string",
    "sort": "string",
    "is_free_shipping": 0,
    "shop_words": "string",
    "group_id": 0,
    "recommend": 0,
    "goods_type": 0,
    "cloud_shop_id": 0
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/GoodsStorage/NewList' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 0,
    "search_words": "string",
    "limit": 0,
    "source": 0,
    "category_id": 0,
    "brand_ids": [
        0
    ],
    "agreement_price": {
        "from": 0,
        "to": 0
    },
    "guide_price": {
        "from": 0,
        "to": 0
    },
    "activity_price": {
        "from": 0,
        "to": 0
    },
    "promotion_rate": {
        "from": 0,
        "to": 0
    },
    "activity_rate": {
        "from": 0,
        "to": 0
    },
    "profits": {
        "from": 0,
        "to": 0
    },
    "created_time": {
        "from": 0,
        "to": 0
    },
    "type": "string",
    "sort": "string",
    "is_free_shipping": 0,
    "shop_words": "string",
    "group_id": 0,
    "recommend": 0,
    "goods_type": 0,
    "cloud_shop_id": 0
}'

返回响应

🟢200成功
application/json
Body
id
string 
可选
code
number 
可选
msg
string 
可选
data
object 
可选
count
number 
可选
list
array [object {30}] 
可选
示例
{
    "id": "string",
    "code": 0,
    "msg": "string",
    "data": {
        "count": 0,
        "list": [
            {
                "third_category_name": "string",
                "sale": 0,
                "market_price": 0,
                "activity_rate": 0,
                "id": 0,
                "unit": "string",
                "total_stock": 0,
                "activity_price": 0,
                "created_time": 0,
                "source": 0,
                "cover": "string",
                "status": 0,
                "is_free_shipping": 0,
                "brand_id": 0,
                "agreement_price": 0,
                "stock": 0,
                "third_brand_name": "string",
                "real_sale": 0,
                "shop_id": 0,
                "third_id": 0,
                "updated_time": 0,
                "guide_price": 0,
                "sale_price": 0,
                "cost_price": 0,
                "origin": "string",
                "title": "string",
                "rate": 0,
                "category_id": [
                    "string"
                ],
                "min_profits": 0,
                "max_profits": 0
            }
        ]
    }
}
上一页
选品分组列表v2
下一页
选品分组商品列表v2
Built with