ComposioHQ/Xero-Automation

Xero Automation

Automatisieren Sie Xero-Buchhaltungsvorgänge, einschließlich der Verwaltung von Rechnungen, Kontakten, Zahlungen, Banktransaktionen und Kontenplänen für die Buchhaltung kleiner Unternehmen.

Toolkit-Dokumentation: composio.dev/toolkits/xero

---

Einrichtung

Diese Fertigkeit erfordert den Rube MCP Server, der unter https://rube.app/mcp erreichbar ist.

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

Multi-Tenant: Wenn Sie mehrere Xero-Organisationen verwalten, rufen Sie zunächst XERO_GET_CONNECTIONS auf, um aktive Tenants aufzulisten und die korrekte tenant_id für nachfolgende Aufrufe zu erhalten.

---

Kern-Workflows

1. Rechnungen auflisten und filtern

Rechnungen mit Filterung nach Status, Kontakt, Datumsbereich und Paginierung abrufen.

Tool: XERO_LIST_INVOICES

Wichtige Parameter:

• Statuses -- Kommagetrennter Statusfilter: "DRAFT", "SUBMITTED", "AUTHORISED", "PAID"
• ContactIDs -- Kommagetrennte Kontakt-IDs zum Filtern
• InvoiceIDs -- Kommagetrennte Rechnungs-IDs zum Filtern
• where -- OData-ähnlicher Filter, z.B. "Status==\"AUTHORISED\" AND Total>100"
• order -- Sortierausdruck, z.B. "Date DESC", "InvoiceNumber ASC"
• page -- Seitennummer für Paginierung
• If-Modified-Since -- UTC-Zeitstempel; gibt nur Rechnungen zurück, die seit diesem Datum geändert wurden
• tenant_id -- Xero-Organisations-ID (verwendet den ersten Tenant, falls nicht angegeben)

Beispiel:

Tool: XERO_LIST_INVOICES
Argumente:
  Statuses: "AUTHORISED,PAID"
  order: "Date DESC"
  page: 1

---

2. Kontakte verwalten

Kontakte für die Verwendung in Rechnungen und Transaktionen abrufen und durchsuchen.

Tool: XERO_GET_CONTACTS

Wichtige Parameter:

• searchTerm -- Groß-/Kleinschreibung nicht beachtende Suche über Name, FirstName, LastName, Email, ContactNumber
• ContactID -- Einzelnen Kontakt anhand der ID abrufen
• where -- OData-Filter, z.B. "ContactStatus==\"ACTIVE\""
• page, pageSize -- Paginierungssteuerung
• order -- Sortierung, z.B. "UpdatedDateUTC DESC"
• includeArchived -- Archivierte Kontakte einschließen, wenn true
• summaryOnly -- Leichtgewichtige Antwort, wenn true

Beispiel:

Tool: XERO_GET_CONTACTS
Argumente:
  searchTerm: "acme"
  page: 1
  pageSize: 25

Hinweis: Bei Konten mit hohem Volumen können einige where-Filter (z.B. IsCustomer, IsSupplier) von Xero abgelehnt werden. Fallen Sie auf searchTerm oder Paginierung zurück.

---

3. Zahlungen erstellen

Verknüpfen Sie eine Rechnung mit einem Bankkonto, indem Sie einen Zahlungseintrag erstellen.

Tool: XERO_CREATE_PAYMENT

Wichtige Parameter:

• InvoiceID (erforderlich) -- Xero-Rechnungs-ID, auf die sich die Zahlung bezieht
• AccountID (erforderlich) -- Bankkonto-ID für die Zahlung
• Amount (erforderlich) -- Zahlungsbetrag (Zahl)
• Date -- Zahlungsdatum im Format YYYY-MM-DD
• Reference -- Zahlungsreferenz oder -beschreibung
• CurrencyRate -- Wechselkurs für Fremdwährungszahlungen

Beispiel:

Tool: XERO_CREATE_PAYMENT
Argumente:
  InvoiceID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  AccountID: "b2c3d4e5-f6a7-8901-bcde-f12345678901"
  Amount: 1500.00
  Date: "2026-02-11"
  Reference: "Zahlung für INV-0042"

---

4. Banktransaktionen erstellen

Erfassen Sie Ausgaben (Auszahlungen) oder Einnahmen (Einzahlungen) als Banktransaktionen.

Tool: XERO_CREATE_BANK_TRANSACTION

Wichtige Parameter:

• Type (erforderlich) -- "SPEND" (Auszahlung) oder "RECEIVE" (Einzahlung)
• ContactID (erforderlich) -- Xero-Kontakt-ID
• BankAccountCode (erforderlich) -- Bankkontocode aus dem Kontenplan
• LineItems (erforderlich) -- Array von Positionen, jede mit:
  • Description (erforderlich) -- Positionsbeschreibung
  • UnitAmount (erforderlich) -- Stückpreis
  • AccountCode (erforderlich) -- Kontocode für die Kategorisierung
  • Quantity -- Menge (Standard 1)
  • TaxType -- Steuerart: "OUTPUT", "INPUT", "NONE"
• Date -- Transaktionsdatum im Format YYYY-MM-DD
• Reference -- Transaktionsreferenz
• Status -- "AUTHORISED" oder "DELETED"
• CurrencyCode -- z.B. "USD", "EUR"

Beispiel:

Tool: XERO_CREATE_BANK_TRANSACTION
Argumente:
  Type: "SPEND"
  ContactID: "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  BankAccountCode: "090"
  LineItems: [
    {
      "Description": "Büromaterial",
      "UnitAmount": 75.00,
      "AccountCode": "429",
      "Quantity": 1,
      "TaxType": "INPUT"
    }
  ]
  Date: "2026-02-11"
  Reference: "Büromaterial Februar"

---

5. Zahlungen und Banktransaktionen auflisten

Vorhandene Zahlungen und den Verlauf von Banktransaktionen einsehen.

Tools:

• XERO_LIST_PAYMENTS -- Zahlungen auflisten, die Rechnungen mit Banktransaktionen verknüpfen
• XERO_LIST_BANK_TRANSACTIONS -- Ausgabe-/Einnahme-Banktransaktionen auflisten

Gemeinsame Parameter:

• where -- OData-Filter, z.B. "Status==\"AUTHORISED\""
• order -- Sortierausdruck, z.B. "Date DESC"
• page -- Seitennummer für Paginierung
• If-Modified-Since -- Inkrementelle Aktualisierungen seit Zeitstempel
• tenant_id -- Organisations-ID

---

6. Kontenplan und Verbindungen anzeigen

Tools:

• XERO_LIST_ACCOUNTS -- Alle Kontocodes zur Kategorisierung von Transaktionen abrufen
• XERO_GET_CONNECTIONS -- Aktive Xero-Tenant-Verbindungen auflisten
• XERO_LIST_ATTACHMENTS -- Anhänge zu einer Entität (Rechnung, Kontakt usw.) auflisten

---

Bekannte Fallstricke

Fallstrick	Detail
Multi-Tenant-Routing	Wenn tenant_id weggelassen wird, wird der erste verbundene Tenant verwendet. Überprüfen Sie bei der Verwaltung mehrerer Organisationen immer den korrekten Tenant mit XERO_GET_CONNECTIONS.
Filterablehnung bei hohem Volumen	Bei großen Konten können einige where-Filter wie IsCustomer/IsSupplier abgelehnt werden. Fallen Sie auf searchTerm mit Paginierung zurück.
OData-Filtersyntax	Verwenden Sie Doppelgleich (==) in OData-Filtern, z.B. Status==\"AUTHORISED\". Einfaches = führt zu Fehlern.
Paginierung erforderlich	Die meisten List-Endpunkte paginieren Ergebnisse. Überprüfen Sie immer auf zusätzliche Seiten und setzen Sie das Abrufen fort, bis alle Daten vollständig sind.
Datumsformat	Alle Daten müssen im Format YYYY-MM-DD vorliegen. Zeitstempel für If-Modified-Since müssen als vollständiger ISO 8601 UTC-Datums-/Uhrzeitwert angegeben werden.
Bankkontocodes	BankAccountCode in Banktransaktionen muss mit einem gültigen Code aus dem Kontenplan übereinstimmen. Verwenden Sie XERO_LIST_ACCOUNTS, um gültige Codes zu ermitteln.

---

Kurzreferenz

Tool-Slug	Beschreibung
XERO_LIST_INVOICES	Rechnungen mit Filterung und Paginierung auflisten
XERO_GET_CONTACTS	Kontakte abrufen und durchsuchen
XERO_CREATE_PAYMENT	Zahlung erstellen, die Rechnung mit Bankkonto verknüpft
XERO_CREATE_BANK_TRANSACTION	Ausgabe- oder Einnahme-Banktransaktion erfassen
XERO_LIST_PAYMENTS	Zahlungseinträge auflisten
XERO_LIST_BANK_TRANSACTIONS	Banktransaktionen auflisten
XERO_LIST_ACCOUNTS	Kontenplan abrufen
XERO_GET_CONNECTIONS	Aktive Xero-Tenant-Verbindungen auflisten
XERO_LIST_ATTACHMENTS	Anhänge zu einer Entität auflisten

---

Bereitgestellt von Composio