收银员接口文档

查询收银员

POST

用于分页查询指定门店下的收银员信息，统一按 cashier.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。
• 分页按 cashier.id 游标推进，服务端按 limit + 1 预读判断是否还有下一页。
• 接口只返回单个门店维度的数据，不会因为总部身份自动扩展到其它门店。

请求示例

{
  "account": "store001",
  "uid": 90001,
  "jobNumber": "CASH001",
  "name": "张三",
  "tel": "13800138000",
  "enable": 1,
  "lastId": 0,
  "order": "asc",
  "limit": 100
}

返回示例

{
  "status": "success",
  "errorCode": 0,
  "result": {
    "list": [
      {
        "id": "1001",
        "uid": "90001",
        "jobNumber": "CASH001",
        "name": "张三",
        "tel": "13800138000",
        "enable": 1
      }
    ],
    "hasMore": false,
    "nextLastId": "1001"
  }
}

返回字段说明

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

字段	类型	说明
id	string	收银员 ID。
uid	string	收银员 UID。
jobNumber	string	收银员工号。
name	string	收银员姓名。
tel	string	收银员手机号。
enable	int	启用状态。