FreshBooks Automation

FreshBooks 自动化技能

技能概述

FreshBooks Automation 是一个帮助用户自动化管理 FreshBooks 云会计平台的技能，支持企业管理、项目追踪、时间记录和预算监控等核心财务操作。

适用场景

1. 多企业统一管理

适用于需要同时管理多个 FreshBooks 企业账户的会计师或财务人员。通过一次调用即可获取所有关联企业及其角色信息，无需逐个登录切换。

2. 项目进度与预算监控

项目经理可以使用该技能实时追踪所有活跃项目的状态，筛选活跃或已完成的项目，并分析已记录工时与预算的对比情况，及时识别超支风险。

3. 批量项目数据处理

适合需要按时间范围、状态或更新时间筛选项目数据的场景，如生成月度报表、统计近期活动或准备发票数据。

核心功能

1. 企业列表获取

通过 FRESHBOOKS_LIST_BUSINESSES 工具快速获取用户有权访问的所有 FreshBooks 企业，返回每个企业的 ID、名称和用户角色。这是执行其他项目操作的前置步骤。

2. 项目筛选与排序

使用 FRESHBOOKS_LIST_PROJECTS 工具按多种条件筛选项目：

按活跃状态筛选（活跃/非活跃）

按完成状态筛选（已完成/未完成）

按更新时间筛选（支持 RFC3339 格式）

自定义排序（按创建时间、截止日期或标题）

包含已记录工时统计

3. 时间追踪集成

可获取项目中已记录的总工时（以秒为单位），便于转换为小时用于计费和预算分析，支持团队分配和项目组数据查询。

常见问题

FreshBooks Automation 是什么？

FreshBooks Automation 是一个通过 Rube MCP 服务器连接 FreshBooks API 的技能，允许用户自动化执行企业管理、项目列表查询、时间追踪和预算监控等操作，适用于小型和中型企业的财务和项目管理需求。

如何使用 FreshBooks Automation 列出所有企业？

首先需要通过 Rube MCP 服务器（https://rube.app/mcp）建立与 FreshBooks 工具包的连接，然后调用 FRESHBOOKS_LIST_BUSINESSES 工具即可获取所有关联企业。获取到的 business_id 是后续执行项目操作所必需的。

FreshBooks Automation 支持哪些项目筛选功能？

该技能支持按活跃状态（active）、完成状态（complete）、更新时间（updated_since）筛选项目，并可按创建时间、截止日期或标题进行排序。还可以选择是否包含已记录工时（include_logged_duration）和是否跳过团队成员数据（skip_group）来优化响应大小。

怎么获取 FreshBooks 项目的 business_id？

必须首先调用 FRESHBOOKS_LIST_BUSINESSES 工具，该工具会返回用户有权访问的所有企业及其对应的 business_id。大多数 FreshBooks API 操作都需要这个 ID 作为参数。

FreshBooks Automation 适合哪些用户？

该技能适合会计师、项目经理、自由职业者以及需要管理多个 FreshBooks 企业的小型和中型企业。特别适合需要批量处理项目数据、监控预算或自动化生成报表的用户。

FreshBooks 项目数据如何用于时间追踪？

调用 FRESHBOOKS_LIST_PROJECTS 时设置 include_logged_duration: true，响应中会包含每个项目的已记录工时（单位为秒）。将秒数除以 3600 即可转换为小时，用于计费、发票或预算分析。