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
- MCP-toegang · Een tenantbeheerder schakelt MCP-toegang in onder Instellingen → Gebruikersrechten voor jouw gebruiker (zie MCP-server).
- 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.
- 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:
| Tool | Doel |
|---|---|
cortena_datev_trial_balance_status | Aantal rijen, boekjaren en tijdstip van de laatste synchronisatie |
cortena_datev_trial_balance_list | Platte rijen met de kolommen month_01_balance … month_12_debit_credit |
Typische werkwijze
cortena_datev_trial_balance_status(tenantId)· controleer of er gegevens zijn en welke boekjaren beschikbaar zijn.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)
| Tool | Doel |
|---|---|
cortena_accounting_postings_dimensions | Verbonden bronnen, dimensienamen en de syntaxis van groupBy |
cortena_accounting_postings_status | Aantallen rijen en laatste synchronisatie per bron |
cortena_accounting_postings_list | Gefilterde boekingsregels |
cortena_accounting_postings_aggregate | Totalen met groupBy (bijvoorbeeld per kostenplaats of btw-tarief) |
cortena_accounting_postings_transaction_get | Alle 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:901en 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
| Taak | Waar / tool |
|---|---|
| MCP inschakelen | Instellingen → Gebruikersrechten → MCP-toegang |
| Leestoegang voor boekingen inschakelen | Machtiging Boekingen bekijken |
| DATEV-gegevens voor de proef- en saldibalans verbinden | Instellingen → Integraties → DATEV Datenservice Export Rechnungswesen · referentie-import |
| Status van de proef- en saldibalans | cortena_datev_trial_balance_status |
| Rijen van de proef- en saldibalans | cortena_datev_trial_balance_list (SKL-rekeningnummers) |
| Boekingsdimensies | cortena_accounting_postings_dimensions |
| Boekingen vermelden / aggregeren | cortena_accounting_postings_list / _aggregate |
| Details van één boeking | cortena_accounting_postings_transaction_get |
| Handleiding voor MCP-instellingen | MCP-server |