QuickBooks-Automation (de)

Was macht QuickBooks-Automation (de)?

Automatisieren Sie QuickBooks Online-Operationen, darunter das Erstellen von Rechnungen, die Verwaltung von Kunden, das Abfragen von Konten und das Auflisten von Rechnungen für Finanzberichte.

Toolkit-Dokumentation: composio.dev/toolkits/quickbooks

---

Einrichtung

Diese Fertigkeit 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 QuickBooks-Toolkit besteht. Falls keine aktive Verbindung vorhanden ist, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.

---

Kern-Workflows

1. Eine Rechnung erstellen

Erstellen Sie eine neue Rechnung für einen Kunden mit Positionen.

Tool: QUICKBOOKS_CREATE_INVOICE

Wichtige Parameter:

• customer_id (erforderlich) – ID des Kunden (CustomerRef.value)
• lines (erforderlich) – Array von Positionsobjekten. Jedes muss enthalten:
  • DetailType – z. B. "SalesItemLineDetail"
  • Amount – Positionssumme
  • SalesItemLineDetail – Objekt mit ItemRef mit value (Artikel-ID)
• minorversion – Optionaler API-Versionsparameter

Beispiel:

Tool: QUICKBOOKS_CREATE_INVOICE
Argumente:
  customer_id: "21"
  lines: [
    {
      "DetailType": "SalesItemLineDetail",
      "Amount": 150.00,
      "SalesItemLineDetail": {
        "ItemRef": {"value": "1", "name": "Services"}
      }
    }
  ]

Voraussetzungen: Lösen Sie die Kunden-ID mit QUICKBOOKS_READ_CUSTOMER auf oder erstellen Sie einen Kunden mit QUICKBOOKS_CREATE_CUSTOMER. Lösen Sie Artikel-/Konto-IDs mit QUICKBOOKS_QUERY_ACCOUNT auf.

---

2. Kunden verwalten

Kundendatensätze erstellen und lesen.

Tools:

• QUICKBOOKS_CREATE_CUSTOMER – Neuen Kunden erstellen
• QUICKBOOKS_READ_CUSTOMER – Kunden nach ID lesen

Wichtige Parameter für QUICKBOOKS_CREATE_CUSTOMER:

• display_name – Anzeigename (muss eindeutig sein über Kunden, Lieferanten und Mitarbeiter; max. 500 Zeichen)
• given_name – Vorname (max. 100 Zeichen)
• family_name – Nachname (max. 100 Zeichen)
• middle_name – Zweiter Vorname (max. 100 Zeichen)
• title – Titel, z. B. "Herr", "Dr." (max. 16 Zeichen)
• suffix – Namenszusatz, z. B. "Jr." (max. 16 Zeichen)

Mindestens eines von display_name, title, given_name, middle_name, family_name oder suffix ist erforderlich.

Wichtige Parameter für QUICKBOOKS_READ_CUSTOMER:

• customer_id (erforderlich) – ID des zu lesenden Kunden

Beispiel:

Tool: QUICKBOOKS_CREATE_CUSTOMER
Argumente:
  display_name: "Acme Corporation"
  given_name: "John"
  family_name: "Doe"

---

3. Konten abfragen und lesen

Kontoinformationen für die Verwendung in Rechnungspositionen und Finanzberichten abrufen.

Tools:

• QUICKBOOKS_QUERY_ACCOUNT – Eine Abfrage gegen Konten ausführen
• QUICKBOOKS_READ_ACCOUNT – Ein bestimmtes Konto nach ID lesen

Wichtige Parameter für QUICKBOOKS_QUERY_ACCOUNT:

• query (erforderlich) – SQL-ähnliche Abfragezeichenfolge, z. B. "SELECT * FROM Account WHERE AccountType = 'Income'"

Beispiel:

Tool: QUICKBOOKS_QUERY_ACCOUNT
Argumente:
  query: "SELECT * FROM Account WHERE AccountType = 'Income' MAXRESULTS 10"

---

4. Rechnungen auflisten und filtern

Rechnungen mit optionaler Paginierung und Filterung abrufen.

Tool: QUICKBOOKS_LIST_INVOICES

Schritte:

1. Rufen Sie QUICKBOOKS_LIST_INVOICES mit Paginierungsparametern auf
2. Verwenden Sie start_position und max_results, um durch die Ergebnisse zu blättern
3. Filtern Sie bei Bedarf nach bestimmten Kriterien

---

Empfohlener Ausführungsplan

1. Lösen Sie den Kunden auf mit QUICKBOOKS_READ_CUSTOMER (falls Sie eine Kunden-ID haben) oder erstellen Sie einen mit QUICKBOOKS_CREATE_CUSTOMER
2. Lösen Sie Artikel-/Einnahmenkonten auf mit QUICKBOOKS_QUERY_ACCOUNT und QUICKBOOKS_READ_ACCOUNT, um Konto- oder Artikel-IDs für Rechnungspositionen zu erhalten
3. Erstellen Sie die Rechnung mit QUICKBOOKS_CREATE_INVOICE unter Verwendung der aufgelösten customer_id und wohlgeformter Positionen
4. Überprüfen Sie die Erstellung mit QUICKBOOKS_LIST_INVOICES, um die neue Rechnung anhand von ID oder Belegnummer zu finden

---

Bekannte Fallstricke

Fallstrick	Detail
Ungültige Referenzen	QUICKBOOKS_CREATE_INVOICE schlägt fehl, wenn customer_id oder ItemRef.value auf nicht vorhandene oder inaktive Datensätze verweisen. Lösen Sie IDs immer zuerst auf.
Positionsvalidierung	Falscher DetailType oder fehlende SalesItemLineDetail-Felder verursachen Schema-/Validierungsfehler bei der Rechnungserstellung.
Paginierung	QUICKBOOKS_LIST_INVOICES verwendet start_position und max_results. Unvollständige Paginierungseinstellungen können Rechnungen in größeren Büchern übersehen.
Sync-Token	Spätere Bearbeitungen erfordern das neueste SyncToken aus einer frischen Rechnungslese. Veraltete Sync-Token führen zu Aktualisierungsablehnungen.
Ratenlimits	QuickBooks erzwingt API-Limits pro Minute und pro Tag. Hochvolumige Ausführungen sollten Backoff enthalten, um Drosselungsfehler zu vermeiden.
Eindeutigkeit von DisplayName	Der display_name eines Kunden muss über alle Kunden-, Lieferanten- und Mitarbeiterobjekte hinweg eindeutig sein. Duplikate verursachen Erstellungsfehler.

---

Kurzreferenz

Tool-Slug	Beschreibung
QUICKBOOKS_CREATE_INVOICE	Neue Rechnung mit Positionen erstellen
QUICKBOOKS_READ_CUSTOMER	Kundendatensatz nach ID lesen
QUICKBOOKS_CREATE_CUSTOMER	Neuen Kundendatensatz erstellen
QUICKBOOKS_QUERY_ACCOUNT	Konten mit SQL-ähnlicher Syntax abfragen
QUICKBOOKS_READ_ACCOUNT	Bestimmtes Konto nach ID lesen
QUICKBOOKS_LIST_INVOICES	Rechnungen mit Paginierung auflisten

---

Bereitgestellt von Composio