Automação FreshBooks

Automatize operações do FreshBooks, incluindo listar empresas, gerenciar projetos, rastrear tempo e monitorar orçamentos para contabilidade de pequenas e médias empresas.

Documentação do Toolkit: composio.dev/toolkits/freshbooks

Configuração

Esta skill requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existe uma conexão ativa para o toolkit freshbooks. Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Fluxos de Trabalho Principais

1. Listar Empresas

Recupere todas as empresas associadas ao usuário autenticado. O business_id desta resposta é necessário para a maioria das outras chamadas da API do FreshBooks.

Ferramenta: FRESHBOOKS_LIST_BUSINESSES

Parâmetros: Nenhum necessário.

Exemplo:

Tool: FRESHBOOKS_LIST_BUSINESSES
Arguments: {}

Saída: Retorna informações de associação de empresas, incluindo todas as empresas às quais o usuário tem acesso, juntamente com sua função em cada empresa.

Importante: Sempre chame esta ferramenta primeiro para obter um business_id válido antes de realizar operações específicas de projeto.

2. Listar e Filtrar Projetos

Recupere todos os projetos de uma empresa com opções abrangentes de filtragem e ordenação.

Ferramenta: FRESHBOOKS_LIST_PROJECTS

Parâmetros Principais:

• business_id (obrigatório) -- ID da empresa obtido de FRESHBOOKS_LIST_BUSINESSES
• active -- Filtrar por status ativo: true (apenas ativos), false (apenas inativos), omitir para todos
• complete -- Filtrar por conclusão: true (concluídos), false (incompletos), omitir para todos
• sort_by -- Ordem de classificação: "created_at", "due_date" ou "title"
• updated_since -- Data/hora UTC no formato RFC3339, por exemplo, "2026-01-01T00:00:00Z"
• include_logged_duration -- true para incluir o tempo total registrado (em segundos) por projeto
• skip_group -- true para omitir dados de membros da equipe/convites (reduz o tamanho da resposta)

Exemplo:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  active: true
  complete: false
  sort_by: "due_date"
  include_logged_duration: true

Casos de Uso:

• Obter todos os projetos para rastreamento de tempo ou faturamento
• Encontrar projetos por cliente, status ou intervalo de datas
• Monitorar a conclusão de projetos e o acompanhamento do orçamento
• Recuperar atribuições de equipe e grupos de projetos

3. Monitorar Projetos Ativos

Acompanhe o progresso e os orçamentos dos projetos filtrando por projetos ativos e incompletos.

Etapas:

1. Chame FRESHBOOKS_LIST_BUSINESSES para obter business_id
2. Chame FRESHBOOKS_LIST_PROJECTS com active: true, complete: false, include_logged_duration: true
3. Analise a duração registrada versus o orçamento para cada projeto

4. Revisar Projetos Atualizados Recentemente

Verifique a atividade recente do projeto usando o filtro updated_since.

Etapas:

1. Chame FRESHBOOKS_LIST_BUSINESSES para obter business_id
2. Chame FRESHBOOKS_LIST_PROJECTS com updated_since definido para sua data/hora de corte
3. Revise os projetos retornados para alterações recentes

Exemplo:

Tool: FRESHBOOKS_LIST_PROJECTS
Arguments:
  business_id: 123456
  updated_since: "2026-02-01T00:00:00Z"
  sort_by: "created_at"

Plano de Execução Recomendado

1. Obtenha o ID da empresa chamando FRESHBOOKS_LIST_BUSINESSES
2. Liste os projetos usando FRESHBOOKS_LIST_PROJECTS com o business_id obtido
3. Filtre conforme necessário usando os parâmetros active, complete, updated_since e sort_by

Armadilhas Conhecidas

Referência Rápida

Alimentado por Composio