ComposioHQ/Zoho-Bücher-Automatisierung

Zoho Bücher Automatisierung

Automatisiere Zoho Books Buchhaltungsabläufe – erstelle und verwalte Rechnungen, verfolge Ausgaben und Zahlungen, suche Kontakte, exportiere PDFs und handhabe Multi-Organisations-Setups – alles durch natürliche Sprache.

Toolkit-Dokumentation: composio.dev/de/toolkits/zoho_books

---

Einrichtung

1. Füge den Rube MCP-Server zu deiner Umgebung hinzu: https://rube.app/mcp
2. Verbinde dein Zoho Books-Konto, wenn du dazu aufgefordert wirst (OAuth-Flow über Composio)
3. Beginne, natürliche Sprachbefehle für die Zoho Books-Automatisierung zu geben

---

Kern-Workflows

1. Organisationen entdecken

Rufe alle Organisationen für den authentifizierten Benutzer ab. Dies ist eine Voraussetzung, da organization_id von fast jedem anderen Endpunkt benötigt wird.

Tool: ZOHO_BOOKS_LIST_ORGANIZATIONS

Keine Parameter erforderlich. Gibt Organisations-IDs, Namen und Metadaten zurück.

Rufe dies immer zuerst auf, um die organization_id zu erhalten, die von allen anderen Zoho Books-Tools benötigt wird.

Beispielaufforderung:

"Liste meine Zoho Books-Organisationen auf"

---

2. Rechnungen erstellen und verwalten

Erstelle Rechnungen mit Einzelposten, verwalte vorhandene Rechnungen und exportiere sie als PDFs.

Erstellen: ZOHO_BOOKS_CREATE_INVOICE

Wichtige Parameter:

• organization_id – Zielorganisation (erforderlich)
• customer_id – zu belastender Kunde (erforderlich)
• line_items – Array von Einzelposten (erforderlich), jeder mit:
  • item_id oder name – vorhandenen Artikel referenzieren oder Ad-hoc-Zeile erstellen
  • quantity, rate – Mengendetails
  • description, tax_id, discount – optionale Details
• date / due_date – Daten im Format JJJJ-MM-TT
• invoice_number – benutzerdefinierte Nummer (ignore_auto_number_generation=true setzen)
• discount / discount_type – Rabatt auf Rechnungsebene (entity_level oder item_level)
• notes / terms – werden auf der Rechnung gedruckt
• send – Rechnung sofort nach Erstellung per E-Mail versenden
• payment_terms – Anzahl der Tage bis zur Zahlung

Auflisten: ZOHO_BOOKS_LIST_INVOICES

Wichtige Parameter:

• organization_id (erforderlich)
• status – sent, draft, overdue, paid, void, unpaid, partially_paid, viewed
• customer_id / customer_name – nach Kunde filtern
• date_start / date_end – Datumsbereichsfilter (JJJJ-MM-TT)
• search_text – Rechnungsnummer, Referenz oder Kundennamen durchsuchen
• sort_column / sort_order – sortieren nach date, due_date, total, balance usw.
• page / per_page – Paginierung (max. 200 pro Seite)

Details abrufen: ZOHO_BOOKS_GET_INVOICE – nach invoice_id abrufen mit accept-Format: json, pdf oder html

Löschen: ZOHO_BOOKS_DELETE_INVOICE – nach invoice_id entfernen

Massenexport: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF – bis zu 25 Rechnungen in einer einzigen PDF zusammenführen

Massendruck: ZOHO_BOOKS_BULK_PRINT_INVOICES – eine kombinierte druckfertige PDF für bis zu 25 Rechnungen erzeugen

Beispielaufforderung:

"Erstelle eine Rechnung für Kunde 1234567890 mit 2 Positionen: 10 Einheiten von Widget A zu je 25 $ und 5 Einheiten von Widget B zu je 50 $, fällig in 30 Tagen"

---

3. Ausgaben verfolgen und verwalten

Ausgaben (Bills) von Lieferanten mit umfassenden Filtermöglichkeiten auflisten, anzeigen und aktualisieren.

Auflisten: ZOHO_BOOKS_LIST_BILLS

Wichtige Parameter:

• organization_id (erforderlich)
• status – paid, open, overdue, void, partially_paid
• vendor_id / vendor_name_contains – nach Lieferant filtern
• bill_number / bill_number_contains – nach Ausgabennummer filtern
• date_start / date_end – Datumsbereichsfilter
• total_greater_than / total_less_than – Betragsbereichsfilter
• sort_column / sort_order – sortieren nach vendor_name, bill_number, date, due_date, total usw.
• page / per_page – Paginierung (max. 200)

Details abrufen: ZOHO_BOOKS_GET_BILL – vollständige Ausgabe nach bill_id und organization_id abrufen

Aktualisieren: ZOHO_BOOKS_UPDATE_BILL – vorhandene Ausgabe ändern (erfordert bill_id, organization_id, vendor_id, bill_number)

Beispielaufforderung:

"Liste alle überfälligen Ausgaben für meine Organisation auf, sortiert nach Fälligkeitsdatum"

---

4. Kontakte suchen

Kontakte (Kunden und Lieferanten) für Rechnungen und Ausgaben suchen und filtern.

Tool: ZOHO_BOOKS_LIST_CONTACTS

Wichtige Parameter:

• organization_id (erforderlich)
• contact_type – customer oder vendor
• contact_name_contains / contact_name_startswith – Namensfilter
• email_contains / email_startswith – E-Mail-Filter
• company_name_contains – Firmenname-Filter
• filter_by – Statusfilter: Status.Active, Status.Inactive, Status.Duplicate usw.
• search_text – Suche nach Kontaktnamen oder Notizen (max. 100 Zeichen)
• sort_column – sortieren nach contact_name, email, outstanding_receivable_amount, created_time usw.
• page / per_page – Paginierung (max. 200)

Beispielaufforderung:

"Finde alle aktiven Kunden, deren Firmenname 'Acme' enthält"

---

5. Rechnungszahlungen verfolgen

Alle Zahlungen auflisten, die gegen eine bestimmte Rechnung verbucht wurden.

Tool: ZOHO_BOOKS_LIST_INVOICE_PAYMENTS

Wichtige Parameter:

• invoice_id – die zu prüfende Rechnung (erforderlich)
• organization_id – die Organisation (erforderlich)

Gibt alle auf die Rechnung angewandten Zahlungstransaktionen zurück, einschließlich Beträge, Daten und Zahlungsmethoden.

Beispielaufforderung:

"Zeige alle Zahlungen an, die gegen Rechnung 451025000000123045 verbucht wurden"

---

6. Vollständiger Rechnungsworkflow

Kombiniere Tools für die durchgängige Rechnungsverwaltung:

1. Organisation: ZOHO_BOOKS_LIST_ORGANIZATIONS – organization_id abrufen
2. Kontakte: ZOHO_BOOKS_LIST_CONTACTS – customer_id finden oder überprüfen
3. Erstellen: ZOHO_BOOKS_CREATE_INVOICE – Rechnung mit Einzelposten erstellen
4. Prüfen: ZOHO_BOOKS_GET_INVOICE – Rechnungsdetails oder PDF abrufen
5. Verfolgen: ZOHO_BOOKS_LIST_INVOICE_PAYMENTS – Zahlungsstatus überwachen
6. Exportieren: ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF – Stapelexport für Unterlagen

Beispielaufforderung:

"Finde die Kunden-ID für 'Acme Corp', erstelle eine Rechnung für sie mit Beratungsleistungen und hole dann das PDF ab"

---

Bekannte Fallstricke

Fallstrick	Details
Organisations-ID immer erforderlich	Fast jeder Endpunkt benötigt organization_id – rufe immer zuerst ZOHO_BOOKS_LIST_ORGANIZATIONS auf
Einzelposten für Rechnungen erforderlich	ZOHO_BOOKS_CREATE_INVOICE erfordert mindestens einen Einzelposten mit entweder item_id oder name
Rechnungs-ID-Format	Verwende die numerische invoice_id aus dem Rechnungsobjekt (z. B. 7472322000000264123), nicht die codierte ID aus invoice_url
Massengrenzen	Sowohl ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF als auch ZOHO_BOOKS_BULK_PRINT_INVOICES akzeptieren maximal 25 Rechnungs-IDs
Paginierung max. 200	Alle Listenendpunkte begrenzen auf 200 Datensätze pro Seite – iteriere über Seiten für vollständige Ergebnisse
Ausgabenaktualisierung benötigt alle Felder	ZOHO_BOOKS_UPDATE_BILL erfordert bill_id, organization_id, vendor_id und bill_number, selbst für Teilaktualisierungen
Datumsformat	Alle Datumsparameter verwenden das Format JJJJ-MM-TT
response_option undokumentiert	ZOHO_BOOKS_LIST_INVOICES hat einen undokumentierten Parameter response_option (0=vollständig, 1=vollständig+Summen, 2=nur Anzahl), der sich ohne Vorankündigung ändern kann

---

Kurzreferenz

Aktion	Tool-Slug	Wichtige Parameter
Organisationen auflisten	ZOHO_BOOKS_LIST_ORGANIZATIONS	(keine)
Rechnung erstellen	ZOHO_BOOKS_CREATE_INVOICE	organization_id, customer_id, line_items
Rechnungen auflisten	ZOHO_BOOKS_LIST_INVOICES	organization_id, status, date_start
Rechnung abrufen	ZOHO_BOOKS_GET_INVOICE	invoice_id, organization_id, accept
Rechnung löschen	ZOHO_BOOKS_DELETE_INVOICE	invoice_id, organization_id
PDF-Massenexport	ZOHO_BOOKS_BULK_EXPORT_INVOICES_PDF	organization_id, invoice_ids
Massendruck	ZOHO_BOOKS_BULK_PRINT_INVOICES	organization_id, invoice_ids
Ausgaben auflisten	ZOHO_BOOKS_LIST_BILLS	organization_id, status, vendor_id
Ausgabe abrufen	ZOHO_BOOKS_GET_BILL	bill_id, organization_id
Ausgabe aktualisieren	ZOHO_BOOKS_UPDATE_BILL	bill_id, organization_id, vendor_id
Kontakte auflisten	ZOHO_BOOKS_LIST_CONTACTS	organization_id, contact_type, search_text
Zahlungen auflisten	ZOHO_BOOKS_LIST_INVOICE_PAYMENTS	invoice_id, organization_id

---

Powered by Composio