ComposioHQ/FreshBooks-Automation

Was macht FreshBooks-Automation?

Automatisieren Sie FreshBooks-Operationen wie das Auflisten von Unternehmen, das Verwalten von Projekten, das Erfassen von Zeiten und das Überwachen von Budgets für die Buchhaltung kleiner und mittlerer Unternehmen.

Toolkit-Dokumentation: composio.dev/toolkits/freshbooks

---

Einrichtung

Diese Skill erfordert den Rube MCP-Server, der unter https://rube.app/mcp verbunden ist.

Stellen Sie vor der Ausführung von Tools sicher, dass eine aktive Verbindung für das freshbooks-Toolkit besteht. Falls keine aktive Verbindung vorhanden ist, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.

---

Kern-Workflows

1. Unternehmen auflisten

Rufen Sie alle Unternehmen ab, die mit dem authentifizierten Benutzer verknüpft sind. Die business_id aus dieser Antwort wird für die meisten anderen FreshBooks-API-Aufrufe benötigt.

Tool: FRESHBOOKS_LIST_BUSINESSES

Parameter: Keine erforderlich.

Beispiel:

Tool: FRESHBOOKS_LIST_BUSINESSES
Arguments: {}

Ausgabe: Gibt Informationen zur Unternehmensmitgliedschaft zurück, einschließlich aller Unternehmen, auf die der Benutzer Zugriff hat, sowie seiner Rolle in jedem Unternehmen.

Wichtig: Rufen Sie dies immer zuerst auf, um eine gültige business_id zu erhalten, bevor Sie projektspezifische Operationen durchführen.

---

2. Projekte auflisten und filtern

Rufen Sie alle Projekte für ein Unternehmen mit umfassenden Filter- und Sortieroptionen ab.

Tool: FRESHBOOKS_LIST_PROJECTS

Wichtige Parameter:

• business_id (erforderlich) – Unternehmens-ID, die von FRESHBOOKS_LIST_BUSINESSES abgerufen wurde
• active – Nach Aktivitätsstatus filtern: true (nur aktive), false (nur inaktive), weglassen für alle
• complete – Nach Abschluss filtern: true (abgeschlossen), false (nicht abgeschlossen), weglassen für alle
• sort_by – Sortierreihenfolge: "created_at", "due_date" oder "title"
• updated_since – UTC-Datumszeit im RFC3339-Format, z. B. "2026-01-01T00:00:00Z"
• include_logged_duration – true, um die gesamte protokollierte Zeit (in Sekunden) pro Projekt einzuschließen
• skip_group – true, um Team-Mitglied-/Einladungsdaten wegzulassen (verringert die Antwortgröße)

Beispiel:

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

Anwendungsfälle:

• Alle Projekte für Zeiterfassung oder Rechnungsstellung abrufen
• Projekte nach Kunde, Status oder Datumsbereich finden
• Projektabschluss und Budgetverfolgung überwachen
• Teamzuweisungen und Projektgruppen abrufen

---

3. Aktive Projekte überwachen

Verfolgen Sie den Projektfortschritt und die Budgets, indem Sie nach aktiven, nicht abgeschlossenen Projekten filtern.

Schritte:

1. Rufen Sie FRESHBOOKS_LIST_BUSINESSES auf, um die business_id zu erhalten
2. Rufen Sie FRESHBOOKS_LIST_PROJECTS mit active: true, complete: false, include_logged_duration: true auf
3. Analysieren Sie die protokollierte Dauer im Vergleich zum Budget für jedes Projekt

---

4. Kürzlich aktualisierte Projekte überprüfen

Prüfen Sie auf kürzliche Projektaktivitäten mithilfe des Filters updated_since.

Schritte:

1. Rufen Sie FRESHBOOKS_LIST_BUSINESSES auf, um die business_id zu erhalten
2. Rufen Sie FRESHBOOKS_LIST_PROJECTS mit updated_since auf Ihre Grenz-Datumszeit gesetzt auf
3. Überprüfen Sie die zurückgegebenen Projekte auf kürzliche Änderungen

Beispiel:

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

---

Empfohlener Ausführungsplan

1. Holen Sie sich die Unternehmens-ID, indem Sie FRESHBOOKS_LIST_BUSINESSES aufrufen
2. Listen Sie Projekte auf mit FRESHBOOKS_LIST_PROJECTS unter Verwendung der erhaltenen business_id
3. Filtern Sie nach Bedarf mit den Parametern active, complete, updated_since und sort_by

---

Bekannte Fallstricke

Fallstrick	Detail
business_id erforderlich	Die meisten FreshBooks-Operationen erfordern eine business_id. Rufen Sie immer zuerst FRESHBOOKS_LIST_BUSINESSES auf, um diese zu erhalten.
Datumsformat	Der Parameter updated_since muss im RFC3339-Format vorliegen: "2026-01-01T00:00:00Z". Andere Formate führen zu Fehlern.
Paginiertes Ergebnis	Projektlistenantworten sind paginiert. Prüfen Sie die Antwort auf zusätzliche Seiten.
Leere Ergebnisse	Gibt eine leere Liste zurück, wenn keine Projekte existieren oder den angewendeten Filtern entsprechen. Dies ist kein Fehler.
Einheit der protokollierten Dauer	Wenn include_logged_duration auf true gesetzt ist, wird die Dauer in Sekunden zurückgegeben. Konvertieren Sie für die Anzeige in Stunden (Division durch 3600).

---

Kurzreferenz

Tool-Slug	Beschreibung
FRESHBOOKS_LIST_BUSINESSES	Alle Unternehmen für den authentifizierten Benutzer auflisten
FRESHBOOKS_LIST_PROJECTS	Projekte mit Filtern und Sortierung für ein Unternehmen auflisten

---

Bereitgestellt von Composio