分销市场
使用本 skill 前,确认当前授权范围和店铺上下文。分销订单及交易信息使用 youzan-order,普通商品信息使用 youzan-item。
查询数量限制
- 列表查询必须显式传入页码和每页数量,不得依赖接口默认分页;每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识;超过 20 个时必须拆分为多个批次依次查询,且每批均不得超过 20 个。
支持能力
- 查询当前分销商品列表。
- 搜索分销市场商品,并按售罄状态或商品分组筛选。
- 搜索分销市场供货商,读取供货商名称和基础信息。
- 根据供货商名称查询其可供分销的商品。
- 返回分销商品、供货商和市场检索结果的原始结构。
字段提示
- 查询参数和返回结果中的字段必须使用中文字段名,不展示接口英文原始字段名。
必填信息
- 查询供货商商品时必须提供明确的供货商名称。
- 查询分销商品列表时无需额外提供店铺标识,范围由当前授权店铺确定;查询供货商商品时必须提供唯一供货商标识。
非必填信息
- 商品和供货商列表的关键词、商品分组和售罄状态可选;分页参数必须按“查询数量限制”传入。查询指定供货商商品时补充供货商名称。
使用案例
- 用户说“搜索分销市场里的茶叶商品”时,按关键词查询市场商品,不要走普通商品列表。
- 用户说“查某个供货商的商品”时,按供货商名称搜索;名称不唯一时先让用户确认,再查询商品。
- 用户说“把这个分销商品上架”或“修改分销价”时,说明本 skill 只支持读取商品和供货商信息。
边界
- 分销订单、结算和退款信息使用
youzan-order。 - 面向消费者售卖的商品主档、商品规格和库存信息使用
youzan-item。 - 分销商品上架、下架、推广状态调整和其他远端数据变更不在本入口范围内。
- 不对分销市场数据做经营趋势、收益判断、画像或推荐。