## [ERR-20260425-001] ADP `/hr/v2/workers` API 不支持 `$filter`

**日期**: 2026-04-25
**类别**: ADP API
**严重度**: 低（绕行容易，但不绕行会卡住）

### 问题描述
对 `GET /hr/v2/workers` 加 `$filter=workerStatus/statusCode/codeValue eq 'Active'` 直接 400：

```json
{ "userMessage": { "messageTxt": "$filter is invalid." } }
```

### 根本原因
ADP HR `/hr/v2/workers` 端点本身就不支持 `$filter` 参数（不仅是和 `count=true` 不能共存的问题——单独使用也不行）。memory `adp-api-findings.md` 之前只记录了"配合 count=true 不生效"，实际范围更广。

### 解决方法
分页拉取后在客户端按 `workerStatus.statusCode.codeValue` 过滤：
```bash
curl ".../hr/v2/workers?$top=50&$skip=0"
# 然后 python/js 端 filter Active
```

### 影响范围
- 同步服务设计：必须全量分页拉取再客户端过滤，不能依赖服务端 filter 减负载
- 2775 总员工 / 50 每页 = 56 次请求一轮

### 后续
已更新 memory `adp-api-findings.md` 这一条的范围。

---