Youzan Guide

---
name: youzan-guide
version: 1.1.37
description: "导购、分销员、云分销渠道商及导购任务相关原始数据查询与导出；不提供账号、关系、佣金、任务或状态的远端数据变更能力，不做提成规则解读、经营结论、画像或推荐。"
---

# 导购与分销员

使用本 skill 前，确认当前授权范围和店铺上下文。本入口严格区分导购、分销员和云分销渠道商三个对象；用户只说“销售人员”或“推广人员”时，先确认对象类型。

## 查询数量限制

- 列表查询必须显式传入页码和每页数量，不得依赖接口默认分页；每页最多查询 20 条。
- 批量查询每批最多传入 20 个对象或标识；超过 20 个时必须拆分为多个批次依次查询，且每批均不得超过 20 个。

## 支持能力

- 查询导购名单、导购客户关系、导购订单业绩、月度关键绩效指标、任务定义、任务执行和任务分析结果。
- 查询导购部门及部门层级信息。
- 查询云分销渠道商账号、层级、推荐人、上级、签约和收益字段。
- 查询云分销分佣订单，并按分店、下单时间、订单号、渠道类型或渠道商筛选。
- 查询分销员账号、分组、团队、客户关系、等级、推广商品和商品或商品规格佣金配置。
- 批量导出导购业绩、客户分析或其他已支持的原始列表数据。
- 处理限定为导购体系的朋友圈任务；未限定为导购体系的企微朋友圈任务使用 `youzan-wecom`。

## 字段提示

- 查询参数和返回结果中的字段必须使用中文字段名，不展示接口英文原始字段名。

### 必填信息

- 查询单笔导购业绩时必须提供导购标识和订单号。
- 查询导购业绩、线索或时间段分析时必须同时提供开始时间和结束时间。
- 查询任务下的导购或任务分析时必须提供任务定义编号。
- 查询导购月度关键绩效指标时必须提供年份和导购标识。
- 查询指定客户的导购关系时必须提供客户手机号。查询指定导购的客户关系时必须提供导购标识。
- 查询单个分销员时必须提供分销员手机号或分销员标识；查询单个云分销渠道商时必须提供渠道商标识。

### 非必填信息

- 列表查询的关键词、部门、店铺、渠道类型、订单号、状态、分组和时间条件可选；分页参数必须按“查询数量限制”传入。
- 导出任务可补充文件格式、输出路径和筛选条件；未指定时使用默认值。
- 佣金配置查询可补充商品、商品规格、商品分组和推广状态筛选。

## 使用案例

- 用户说“查某导购近一个月的业绩”时，补齐导购标识、开始时间和结束时间；如果只给姓名，先查询导购列表确认唯一对象。
- 用户说“查这个客户归属于哪个导购”时，使用客户手机号查询关系；不要把客户手机号或订单买家标识当作导购标识。
- 用户说“查分销员订单”时，先确认是推广订单还是云分销渠道商分佣单，二者不要混用。
- 用户说“给导购绑定客户、调整佣金或结束任务”时，说明本 skill 只提供查询和原始导出。

## 边界

- 企微助手朋友圈群发任务、发送明细和群发结果使用 `youzan-wecom`。
- 订单交易详情使用 `youzan-order`。
- 本入口不提供导购资料、分销员账号、客户关系、等级、佣金、推广状态或任务状态的创建、更新、启停、绑定、解绑和其他远端数据变更。
- 不根据原始业绩或任务数据直接给出排名、提成规则解释、经营建议、画像或推荐。