Help
App openenPlan een gesprek

DATEV-proef- en saldibalans en boekingshistorie via MCP

Vraag de DATEV-proef- en saldibalans en boekingen op via Cortena MCP.

Vraag Claude, ChatGPT of Dust, verbonden met Cortena, om de proef- en saldibalans van DATEV Rechnungswesen en de gesynchroniseerde boekingshistorie uit DATEV, Twinfield of Exact Online op te vragen, zonder spreadsheets of de boekhoudinterface te openen.

Gerelateerd: MCP-server, MCP-beveiliging en DATEV Rechnungswesen.

1. Vereisten

  1. MCP-toegang · Een tenantbeheerder schakelt MCP-toegang in onder Instellingen → Gebruikersrechten voor jouw gebruiker (zie MCP-server).
  2. Boekingen bekijken · Je hebt de machtiging Boekingen bekijken nodig voor de workspace die je bevraagt. Zonder deze machtiging geven boekingstools een foutmelding over onvoldoende rechten.
  3. Verbonden boekhoudgegevens
    • Proef- en saldibalans · DATEV Datenservice Export Rechnungswesen (zelfstandig of gecombineerd met DATEV Buchungsdatenservice). Importeer referentiegegevens via Instellingen → Integraties, zodat Cortena over gesynchroniseerde saldi beschikt.
    • Boekingshistorie · Gesynchroniseerde boekingshistorie uit DATEV, Twinfield of Exact Online (dezelfde integraties die je in de app gebruikt).

2. Tools voor de proef- en saldibalans (DATEV)

Je assistent kan het volgende aanroepen:

ToolDoel
cortena_datev_trial_balance_statusAantal rijen, boekjaren en tijdstip van de laatste synchronisatie
cortena_datev_trial_balance_listPlatte rijen met de kolommen month_01_balance … month_12_debit_credit

Typische werkwijze

  1. cortena_datev_trial_balance_status(tenantId) · controleer of er gegevens zijn en welke boekjaren beschikbaar zijn.
  2. cortena_datev_trial_balance_list(tenantId, fiscalYearId?, accountNumber?, page?, limit?) · blader door de rekeningen.

Rekeningnummers (SKL) · Filter en lees rekeningen in de vorm van de Sachkontenlänge (SKL) van jouw tenant (bijvoorbeeld 4400), niet in de nulopgevulde wire-indeling van DATEV (bijvoorbeeld 44000000). De assistent moet dezelfde rekeningnummers gebruiken als die je in het rekeningschema van Cortena ziet.

3. Tools voor de boekingshistorie (DATEV / Twinfield / Exact)

ToolDoel
cortena_accounting_postings_dimensionsVerbonden bronnen, dimensienamen en de syntaxis van groupBy
cortena_accounting_postings_statusAantallen rijen en laatste synchronisatie per bron
cortena_accounting_postings_listGefilterde boekingsregels
cortena_accounting_postings_aggregateTotalen met groupBy (bijvoorbeeld per kostenplaats of btw-tarief)
cortena_accounting_postings_transaction_getAlle regels voor één boeking (transactiesleutel)

Filters · Gebruik dimension=name:value (DATEV-voorbeelden: markOfOrigin, kost1, postingDescription, taxRate).

Bedragen · amountMode: debit, credit, both, net of gross. Voor Exact Online is amountCurrency: original (standaard) of normalized.

DATEV-rekeningen · accountNumber en contraAccountNumber in de resultaten zijn genormaliseerd naar SKL. Rekeningnummers van Twinfield en Exact worden weergegeven zoals ze in die systemen zijn opgeslagen.

4. Voorbeeldvragen voor je assistent

  • "Toon voor tenant {name} de status van de proef- en saldibalans en vermeld de rekeningen 4000-4999 voor het huidige boekjaar."
  • “Groepeer de DATEV-boekingen van vorige maand op dimension=kost1:901 en toon de nettobedragen.”
  • “Open transactie {key} en vermeld alle regels voor die DATEV-boeking.”

Noem altijd de tenant of geef tenantId mee, zodat de assistent de juiste workspace bevraagt.

Tips en beperkingen

  • Tools zijn alleen-lezen · ze exporteren geen facturen en wijzigen geen boekingen.
  • Voor de proef- en saldibalans is een synchronisatie van Datenservice Export vereist. Voor de boekingstools zijn de machtiging Boekingen bekijken en een geslaagde synchronisatie van de historie voor die bron vereist.
  • MCP past dezelfde rechten toe als de webapp. Je ziet alleen tenants waarvoor je MCP-toegang hebt.
  • Raadpleeg voor het instellen van connectors, OAuth en goedkeuringen voor voorbereiden/doorvoeren MCP-server.

Sneloverzicht

TaakWaar / tool
MCP inschakelenInstellingen → Gebruikersrechten → MCP-toegang
Leestoegang voor boekingen inschakelenMachtiging Boekingen bekijken
DATEV-gegevens voor de proef- en saldibalans verbindenInstellingen → Integraties → DATEV Datenservice Export Rechnungswesen · referentie-import
Status van de proef- en saldibalanscortena_datev_trial_balance_status
Rijen van de proef- en saldibalanscortena_datev_trial_balance_list (SKL-rekeningnummers)
Boekingsdimensiescortena_accounting_postings_dimensions
Boekingen vermelden / aggregerencortena_accounting_postings_list / _aggregate
Details van één boekingcortena_accounting_postings_transaction_get
Handleiding voor MCP-instellingenMCP-server