如何通过ActiveCollab API获取用户内部小时费率？
2026-7-7
解决ActiveCollab API获取用户内部小时费率及成员成本盈利的问题
获取单个用户的内部小时费率
你尝试的/users/{userId}端点默认不会返回内部费率数据，需要通过指定include参数来加载关联的费率信息：
- 发送GET请求到：
/users/{userId}?include=hourly_rates - 响应中会包含
hourly_rates字段，其中internal_rate就是你设置的用户内部小时费率（注意区分billable_rate，那是对外计费费率）
如果上述参数不生效，试试这个未完全在公开文档中列出的专用端点：
- GET请求：
/users/{userId}/hourly-rates - 该端点会直接返回用户的所有费率配置，包括内部费率、不同项目的自定义费率等
注意：请求需要携带拥有
manage_finances权限的API令牌，否则会返回权限不足或隐藏敏感财务数据。
获取成员的成本与盈利情况
要计算成员的成本和盈利，需要结合工时记录、用户内部费率和项目计费费率，有两种方式：
方式1：用现成的盈利统计端点
发送GET请求到项目的盈利分析端点：/projects/{projectId}/profitability
响应会按成员分组，返回每个成员的：
- 总工时
- 总成本（内部费率×工时）
- 总计费金额（项目费率×工时）
- 总盈利（计费金额-总成本）
方式2：自行计算（适合自定义需求）
- 先通过
/users/{userId}?include=hourly_rates获取用户的内部费率 - 发送GET请求到项目工时记录端点并加载关联数据：
/projects/{projectId}/time-records?include=user,rate - 对每条工时记录，用
user.hourly_rates.internal_rate × time_record.hours计算该条记录的成本，用rate.value × time_record.hours计算计费金额，两者差值就是单条记录的盈利，最后按成员汇总即可。
补充验证点
- 确认你的API令牌拥有财务管理权限，这是获取内部费率和盈利数据的前提
- 如果使用的是ActiveCollab云版本，确保你的订阅包含预算/盈利分析模块（部分基础版可能没有此功能）
内容的提问来源于stack exchange，提问作者Herbert
相关产品推荐
相关产品推荐
