Fragen Sie Claude, ChatGPT oder Dust, die mit Cortena verbunden sind, nach der DATEV-Rechnungswesen-Summen- und Saldenliste und der synchronisierten Buchungshistorie aus DATEV, Twinfield oder Exact Online · ohne Tabellenkalkulationen oder die Buchhaltungsoberfläche zu öffnen.
Verwandte Inhalte: MCP-Server, MCP-Sicherheit und DATEV Rechnungswesen.
1. Voraussetzungen
- MCP-Zugriff · Ein Tenant-Administrator aktiviert MCP access unter Settings → User permissions für Ihren Benutzer (siehe MCP-Server).
- Buchungen anzeigen · Sie benötigen die Berechtigung View accounting postings für den Workspace, den Sie abfragen. Ohne diese Berechtigung geben Buchungstools „Forbidden“ zurück.
- Verbundene Buchhaltungsdaten
- Summen- und Saldenliste · DATEV Datenservice Export Rechnungswesen (eigenständig oder kombiniert mit DATEV Buchungsdatenservice). Importieren Sie Referenzdaten unter Settings → Integrations, damit Cortena synchronisierte Summen und Salden verfügbar hat.
- Buchungshistorie · Synchronisierte Buchungshistorie aus DATEV, Twinfield oder Exact Online (dieselben Integrationen, die Sie in der App verwenden).
2. Tools für die Summen- und Saldenliste (DATEV)
Ihr Assistent kann Folgendes aufrufen:
| Tool | Zweck |
|---|---|
cortena_datev_trial_balance_status | Anzahl der Zeilen, Geschäftsjahre, Zeitpunkt der letzten Synchronisierung |
cortena_datev_trial_balance_list | Flache Zeilen mit den Spalten month_01_balance … month_12_debit_credit |
Typischer Ablauf
cortena_datev_trial_balance_status(tenantId)· Bestätigen Sie, dass Daten vorhanden sind und welche Geschäftsjahre verfügbar sind.cortena_datev_trial_balance_list(tenantId, fiscalYearId?, accountNumber?, page?, limit?)· Rufen Sie die Konten seitenweise ab.
Kontonummern (SKL) · Filtern und lesen Sie Konten in der Sachkontenlänge (SKL) Ihres Tenants (z. B. 4400), nicht im mit Nullen aufgefüllten DATEV-Übertragungsformat (z. B. 44000000). Der Assistent sollte dieselben Kontonummern verwenden, die Sie im Kontenplan von Cortena sehen.
3. Tools für die Buchungshistorie (DATEV / Twinfield / Exact)
| Tool | Zweck |
|---|---|
cortena_accounting_postings_dimensions | Verbundene Quellen, Dimensionsnamen, Syntax für groupBy |
cortena_accounting_postings_status | Zeilenanzahl und letzte Synchronisierung je Quelle |
cortena_accounting_postings_list | Gefilterte Buchungszeilen |
cortena_accounting_postings_aggregate | Summen mit groupBy (z. B. nach Kostenstelle oder Steuersatz) |
cortena_accounting_postings_transaction_get | Alle Zeilen für eine Buchung (Transaktionsschlüssel) |
Filter · Verwenden Sie dimension=name:value (DATEV-Beispiele: markOfOrigin, kost1, postingDescription, taxRate).
Beträge · amountMode: debit, credit, both, net oder gross. Für Exact Online: amountCurrency: original (Standard) oder normalized.
DATEV-Konten · accountNumber und contraAccountNumber in den Ergebnissen sind SKL-normalisiert. Twinfield- und Exact-Kontonummern werden so angezeigt, wie sie in diesen Systemen gespeichert sind.
4. Beispielfragen für Ihren Assistenten
- "Für den Tenant
{name}: Zeige den Status der Summen- und Saldenliste und liste die Konten 4000-4999 für das aktuelle Geschäftsjahr auf." - „Aggregiere die DATEV-Buchungen des letzten Monats nach
dimension=kost1:901, Nettobeträge.“ - „Öffne die Transaktion
{key}und liste alle Zeilen für diese DATEV-Buchung auf.“
Nennen Sie immer den Tenant (oder übergeben Sie tenantId), damit der Assistent den richtigen Workspace abfragt.
Tipps und Einschränkungen
- Die Tools sind schreibgeschützt · Sie exportieren keine Rechnungen und ändern keine Buchungen.
- Die Summen- und Saldenliste erfordert eine Synchronisierung über Datenservice Export. Die Buchungstools erfordern die Berechtigung View accounting postings und eine erfolgreiche Synchronisierung der Historie für die jeweilige Quelle.
- MCP erzwingt dieselben Berechtigungen wie die Web-App. Sie sehen nur Tenants, für die Sie MCP access haben.
- Informationen zur Einrichtung von Konnektoren, zu OAuth sowie zu Genehmigungen für Prepare und Commit finden Sie unter MCP-Server.
Kurzübersicht
| Aufgabe | Ort / Tool |
|---|---|
| MCP aktivieren | Settings → User permissions → MCP access |
| Lesen von Buchungen aktivieren | Berechtigung View accounting postings |
| DATEV-Daten für die Summen- und Saldenliste verbinden | Settings → Integrations → DATEV Datenservice Export Rechnungswesen · Referenzdatenimport |
| Status der Summen- und Saldenliste | cortena_datev_trial_balance_status |
| Zeilen der Summen- und Saldenliste | cortena_datev_trial_balance_list (SKL-Kontonummern) |
| Buchungsdimensionen | cortena_accounting_postings_dimensions |
| Buchungen auflisten / aggregieren | cortena_accounting_postings_list / _aggregate |
| Drill-down auf eine Buchung | cortena_accounting_postings_transaction_get |
| Anleitung zur MCP-Einrichtung | MCP-Server |