导购员接口文档

查询导购员

POST

用于分页查询指定门店下的导购员信息，统一按 guider.id 做游标翻页，适合对接方分批同步门店导购员档案。

范围规则：请求体里传哪个 account，就查该门店自己的导购员；即使调用方是总部账号，也只返回这个门店的数据。

筛选规则：uid、jobNumber、name、tel、enable 都是可选精确过滤条件，可单独传，也可组合传。

请求参数

参数	类型	必填	说明
account	string	是	目标门店账号。传哪个账号，就查哪个门店的导购员数据。
uid	long	否	导购员 UID，精确匹配。
jobNumber	string	否	工号，精确匹配。
name	string	否	姓名，精确匹配。
tel	string	否	手机号，精确匹配。
enable	int	否	启用状态，仅支持 0 或 1。
lastId	long	否	分页游标。首次传 0 或不传；后续传上一次响应中的 nextLastId。
order	string	否	排序方向，仅支持 asc、desc，默认 asc。
limit	int	否	分页大小，默认 100，最大 100。

业务说明

• 固定消耗 100 token。
• 分页按 guider.id 游标推进，服务端按 limit + 1 预读判断是否还有下一页。
• 接口只返回单个门店维度的数据，不会因为总部身份自动扩展到其它门店。
• 返回的 uid 可与销售单据、网单、会员等接口中的 guiderUid 直接关联。
• uid 与 enable 在库中允许为空，按这两个字段过滤时空值记录不会被命中。

请求示例

{
  "account": "store001",
  "uid": 90001,
  "jobNumber": "GUIDE001",
  "name": "李四",
  "tel": "13800138000",
  "enable": 1,
  "lastId": 0,
  "order": "asc",
  "limit": 100
}

返回示例

{
  "status": "success",
  "errorCode": 0,
  "result": {
    "list": [
      {
        "id": 2001,
        "uid": 90001,
        "jobNumber": "GUIDE001",
        "name": "李四",
        "tel": "13800138000",
        "enable": 1,
        "remarks": "美妆区"
      }
    ],
    "hasMore": false,
    "nextLastId": 2001
  }
}

返回字段说明

status、errorCode 及分页公共字段请参考《公共响应格式》，此处仅补充 result.list[] 字段。

字段	类型	说明
id	long	导购员 ID，同时作为分页游标使用。
uid	long	导购员 UID，与其它接口的 guiderUid 对应。
jobNumber	string	导购员工号。
name	string	导购员姓名。
tel	string	导购员手机号。
enable	int	启用状态。
remarks	string	备注。为空时该字段不返回。