# 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.

**Voor wie dit is:** Voor ervaren gebruikers en financiële assistenten die de **Cortena MCP-server** al gebruiken en rekening­saldi, maandelijkse debet-/creditkolommen of detailinformatie over boekingen nodig hebben voor analyse- en aansluitingsvragen.

Gerelateerd: [MCP-server](https://help.cortena.ai/guides/advanced/mcp-server), [MCP-beveiliging](https://help.cortena.ai/guides/advanced/mcp-security) en [DATEV Rechnungswesen](https://help.cortena.ai/guides/integrations/datev-rechnungswesen).

## 1. Vereisten

1. **MCP-toegang** · Een tenantbeheerder schakelt **MCP-toegang** in onder **Instellingen → Gebruikersrechten** voor jouw gebruiker (zie [MCP-server](https://help.cortena.ai/guides/advanced/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:

| 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**

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)

| 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: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](https://help.cortena.ai/guides/advanced/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](https://help.cortena.ai/guides/advanced/mcp-server) |