Harvest工时统计接口

技能简介

该技能提供与Harvest时间追踪平台的API对接能力，支持从Harvest系统提取项目工时记录、人员时间分配及费用报表数据。

业务背景

帮助企业打通Harvest工时数据，实现项目成本与人力投入的精细化管控。管理者可实时掌握各项目实际耗时与预算偏差，评估团队产能饱和度，为人力调配和项目报价提供数据支撑，避免人工统计的滞后与误差。

落地案例：某咨询公司季度结算前，项目经理通过该接口拉取过去90天全部顾问的工时明细，按客户项目自动汇总实际投入人天。对比签约预算后，快速识别超支风险项目，及时调整后续资源排期，并生成客户对账用的标准化时间报表。

能做什么

• 按项目/人员/日期范围拉取工时明细
• 生成可导出的时间报表数据
• 同步项目预算与实际耗时对比
• 获取团队产能利用率指标

使用说明

1. 在Harvest后台创建Personal Access Token
2. 配置环境变量：HARVEST_ACCOUNT_ID和HARVEST_ACCESS_TOKEN
3. 安装依赖：pip install harvest-api-client（若需Python SDK）
4. 调用接口时需指定日期范围参数，单次查询跨度不超过365天

输入与输出

见下方输入与输出表格。

风险提示

• API访问频率限制为每15分钟100次请求
• Token泄露可能导致全部项目数据暴露
• 历史数据修改后不会触发实时同步
• 时区处理不当会造成跨日数据错位

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/zachgodsell93/harvest-time-reporting-api/SKILL.md
来源类型：GitHub仓库