# SnelStart MCP - Tool Response Formats
> Documentatie van alle 37 MCP tools en hun response formats
> Laatst bijgewerkt: 25 januari 2026
## Inhoudsopgave
1. [Administratie Tools](#administratie-tools)
2. [Relatie Tools](#relatie-tools)
3. [Grootboek Tools](#grootboek-tools)
4. [Factuur Tools](#factuur-tools)
5. [Boeking Tools](#boeking-tools)
6. [Artikel Tools](#artikel-tools)
7. [Order & Offerte Tools](#order--offerte-tools)
8. [BTW Tools](#btw-tools)
9. [Overige Tools](#overige-tools)
10. [Diagnostische Tools](#diagnostische-tools)
---
## Administratie Tools
### `list_administrations`
Toon alle geconfigureerde SnelStart administraties.
**Parameters:** Geen
**Response:**
```json
{
"administrations": [
{
"id": "vca",
"name": "VCA Company BV",
"active": true
},
{
"id": "holding",
"name": "Holding BV",
"active": false
}
],
"active": "vca",
"total": 2
}
```
---
### `switch_administration`
Wissel naar een andere administratie.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `admin_id` | string | Yes | ID van de administratie (bijv. 'vca', 'holding') |
**Response (success):**
```json
{
"success": true,
"message": "Switched to: Holding BV",
"active": {
"id": "holding",
"name": "Holding BV"
}
}
```
**Response (error):**
```json
{
"error": "Administration 'unknown' not found",
"available": ["vca", "holding"]
}
```
---
### `get_admin_status`
Toon status en bedrijfsinformatie van huidige administratie.
**Parameters:** Geen
**Response:**
```json
{
"admin": {
"id": "vca",
"name": "VCA Company BV"
},
"connected": true,
"companyInfo": {
"id": "uuid-123",
"naam": "VCA Company BV",
"kvkNummer": "12345678",
"btwNummer": "NL123456789B01",
"adres": {
"straat": "Hoofdstraat",
"huisnummer": "1",
"postcode": "1234 AB",
"plaats": "Amsterdam",
"land": "Nederland"
}
}
}
```
---
### `test_connection`
Test de verbinding met de SnelStart API.
**Parameters:** Geen
**Response:**
```json
{
"success": true,
"admin": {
"id": "vca",
"name": "VCA Company BV"
},
"companyInfo": {
"id": "uuid-123",
"naam": "VCA Company BV"
}
}
```
---
## Relatie Tools
### `list_relaties`
Lijst van klanten en leveranciers.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `type` | string | No | "beide" | Filter: "klant", "leverancier", "beide" |
| `search` | string | No | - | Zoekterm voor naam of email |
| `limit` | number | No | 100 | Maximum aantal resultaten |
**Response:**
```json
{
"relaties": [
{
"id": "uuid-456",
"naam": "Klant BV",
"relatiesoort": ["Klant"],
"email": "info@klant.nl",
"telefoon": "020-1234567",
"btwNummer": "NL987654321B01"
}
],
"count": 1,
"filter": {
"type": "klant",
"search": null
}
}
```
---
### `get_relatie`
Details van een specifieke relatie.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `relatie_id` | string | Yes | UUID van de relatie |
**Response:**
```json
{
"relatie": {
"id": "uuid-456",
"modifiedOn": "2026-01-20T10:30:00Z",
"naam": "Klant BV",
"relatiesoort": ["Klant"],
"email": "info@klant.nl",
"telefoon": "020-1234567",
"contactpersoon": "Jan Jansen",
"adres": {
"straat": "Kerkstraat",
"huisnummer": "10",
"postcode": "1234 CD",
"plaats": "Rotterdam"
},
"btwNummer": "NL987654321B01",
"kvkNummer": "87654321",
"iban": "NL91ABNA0417164300"
}
}
```
---
## Grootboek Tools
### `list_grootboeken`
Lijst van grootboekrekeningen (rekeningschema).
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `category` | string | No | "alle" | Filter: "balans", "resultaat", "alle" |
| `search` | string | No | - | Zoekterm voor nummer of omschrijving |
**Response:**
```json
{
"grootboeken": [
{
"id": "uuid-789",
"nummer": 1000,
"omschrijving": "Kas",
"grootboeksoort": "Balans",
"nonactief": false
},
{
"id": "uuid-790",
"nummer": 8000,
"omschrijving": "Omzet binnenland",
"grootboeksoort": "WinstEnVerlies",
"nonactief": false
}
],
"count": 2,
"filter": {
"category": "alle",
"search": null
}
}
```
---
### `list_grootboekmutaties`
Lijst van grootboekmutaties (debet/credit boekingen).
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from_date` | string | Yes | Begindatum (YYYY-MM-DD) |
| `to_date` | string | Yes | Einddatum (YYYY-MM-DD) |
| `grootboek_id` | string | No | Filter op grootboekrekening |
| `limit` | number | No | Maximum resultaten (default: 200) |
**Response:**
```json
{
"mutaties": [
{
"id": "uuid-mut-1",
"boekdatum": "2026-01-15",
"omschrijving": "Bankboeking #123",
"grootboek": {
"id": "uuid-789",
"nummer": 1000,
"omschrijving": "Kas"
},
"debet": 500.00,
"credit": 0.00,
"relatie": {
"id": "uuid-456",
"naam": "Klant BV"
}
}
],
"count": 1,
"period": {
"from": "2026-01-01",
"to": "2026-01-31"
}
}
```
---
### `get_grootboekmutatie`
Details van een specifieke grootboekmutatie.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `mutatie_id` | string | Yes | UUID van de mutatie |
**Response:**
```json
{
"mutatie": {
"id": "uuid-mut-1",
"modifiedOn": "2026-01-15T14:30:00Z",
"boekdatum": "2026-01-15",
"omschrijving": "Bankboeking #123",
"boekstuknummer": "BNK-2026-0001",
"dagboek": {
"id": "uuid-db-1",
"nummer": 10,
"omschrijving": "ABN AMRO"
},
"grootboek": {
"id": "uuid-789",
"nummer": 1000,
"omschrijving": "Kas"
},
"debet": 500.00,
"credit": 0.00,
"relatie": {
"id": "uuid-456",
"naam": "Klant BV"
}
}
}
```
---
## Factuur Tools
### `list_invoices`
Lijst van verkoop- en/of inkoopfacturen.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `type` | string | No | "beide" | Filter: "verkoop", "inkoop", "beide" |
| `status` | string | No | "alle" | Filter: "open", "betaald", "alle" |
| `from_date` | string | No | - | Begindatum (YYYY-MM-DD) |
| `to_date` | string | No | - | Einddatum (YYYY-MM-DD) |
| `limit` | number | No | 50 | Maximum aantal resultaten |
**Response:**
```json
{
"invoices": [
{
"id": "uuid-inv-1",
"type": "verkoop",
"factuurnummer": "2026-0001",
"factuurdatum": "2026-01-10",
"relatie": {
"id": "uuid-456",
"naam": "Klant BV"
},
"factuurbedrag": 1210.00,
"openstaandSaldo": 0.00,
"status": "betaald"
}
],
"count": 1,
"filter": {
"type": "verkoop",
"status": "alle",
"period": {
"from": "2026-01-01",
"to": "2026-01-31"
}
}
}
```
---
### `get_invoice`
Details van een specifieke factuur.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `invoice_id` | string | Yes | UUID van de factuur |
| `type` | string | Yes | "verkoop" of "inkoop" |
**Response:**
```json
{
"invoice": {
"id": "uuid-inv-1",
"modifiedOn": "2026-01-10T09:00:00Z",
"factuurnummer": "2026-0001",
"factuurdatum": "2026-01-10",
"klant": {
"id": "uuid-456",
"naam": "Klant BV"
},
"omschrijving": "Consultancy diensten",
"factuurbedrag": 1210.00,
"openstaandSaldo": 0.00,
"betalingstermijn": 30,
"boekingsregels": [
{
"omschrijving": "Consultancy",
"grootboek": {
"id": "uuid-790",
"nummer": 8000,
"omschrijving": "Omzet binnenland"
},
"bedrag": 1000.00,
"btwSoort": "Hoog"
}
],
"btw": [
{
"btwSoort": "VerkopenHoog",
"btwBedrag": 210.00
}
]
}
}
```
---
### `sync_invoices_to_folder`
Sync facturen naar een lokale map als JSON bestanden.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `folder` | string | No | ./data/invoices/{admin_id} | Doelmap |
| `type` | string | No | "beide" | Filter: "verkoop", "inkoop", "beide" |
| `from_date` | string | No | - | Begindatum (YYYY-MM-DD) |
| `to_date` | string | No | - | Einddatum (YYYY-MM-DD) |
**Response:**
```json
{
"synced": 25,
"folder": "/Users/albert/projecten/snelstart-mcp/data/invoices/vca",
"files": [
"verkoop/2026/2026-0001.json",
"verkoop/2026/2026-0002.json",
"inkoop/2026/INK-001.json"
],
"period": {
"from": "2026-01-01",
"to": "2026-01-31"
}
}
```
---
## Boeking Tools
### `list_boekingen`
Lijst van bank-, kas- en memoriaalboekingen.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string | No | Filter: "bank", "kas", "memoriaal", "alle" |
| `from_date` | string | Yes | Begindatum (YYYY-MM-DD) |
| `to_date` | string | Yes | Einddatum (YYYY-MM-DD) |
| `grootboek_id` | string | No | Filter op grootboekrekening |
| `limit` | number | No | Maximum resultaten (default: 200) |
**Response:**
```json
{
"boekingen": {
"bank": [
{
"id": "uuid-bnk-1",
"boekdatum": "2026-01-15",
"omschrijving": "Betaling factuur 2026-0001",
"dagboek": {
"id": "uuid-db-1",
"nummer": 10,
"omschrijving": "ABN AMRO"
},
"boekingsregels": [
{
"omschrijving": "Betaling",
"grootboek": {
"id": "uuid-789",
"nummer": 1100,
"omschrijving": "Debiteuren"
},
"debet": 0.00,
"credit": 1210.00
}
]
}
],
"kas": [],
"memoriaal": []
},
"totals": {
"bank": 1,
"kas": 0,
"memoriaal": 0,
"total": 1
},
"period": {
"from": "2026-01-01",
"to": "2026-01-31"
}
}
```
---
### `get_inkoopboeking`
Details van een specifieke inkoopboeking.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `boeking_id` | string | Yes | UUID van de inkoopboeking |
**Response:**
```json
{
"boeking": {
"id": "uuid-ink-1",
"modifiedOn": "2026-01-12T11:00:00Z",
"factuurnummer": "INK-001",
"factuurdatum": "2026-01-12",
"leverancier": {
"id": "uuid-lev-1",
"naam": "Leverancier BV"
},
"factuurbedrag": 605.00,
"boekingsregels": [
{
"omschrijving": "Kantoorbenodigdheden",
"grootboek": {
"id": "uuid-791",
"nummer": 4100,
"omschrijving": "Kantoorkosten"
},
"bedrag": 500.00,
"btwSoort": "Hoog"
}
],
"btw": [
{
"btwSoort": "InkopenHoog",
"btwBedrag": 105.00
}
]
}
}
```
---
## Artikel Tools
### `list_artikelen`
Lijst van producten/artikelen.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `search` | string | No | - | Zoekterm voor artikelcode of omschrijving |
| `include_inactive` | boolean | No | false | Inclusief inactieve artikelen |
| `limit` | number | No | 100 | Maximum aantal resultaten |
**Response:**
```json
{
"artikelen": [
{
"id": "uuid-art-1",
"artikelcode": "CONS-001",
"omschrijving": "Consultancy uur",
"verkoopprijs": 150.00,
"eenheid": "uur",
"isNonActief": false
}
],
"count": 1,
"filter": {
"search": null,
"includeInactive": false
}
}
```
---
### `get_artikel`
Details van een specifiek artikel.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `artikel_id` | string | Yes | UUID van het artikel |
**Response:**
```json
{
"artikel": {
"id": "uuid-art-1",
"modifiedOn": "2026-01-01T08:00:00Z",
"artikelcode": "CONS-001",
"omschrijving": "Consultancy uur",
"verkoopprijs": 150.00,
"inkoopprijs": 0.00,
"eenheid": "uur",
"artikelOmzetgroep": {
"id": "uuid-omz-1",
"nummer": 1,
"omschrijving": "Diensten"
},
"isNonActief": false
}
}
```
---
### `get_artikel_customfields`
Custom velden van een artikel.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `artikel_id` | string | Yes | UUID van het artikel |
**Response:**
```json
{
"customFields": [
{
"naam": "Categorie",
"waarde": "Premium"
},
{
"naam": "SKU",
"waarde": "CONS-001-PRE"
}
]
}
```
---
### `list_artikelomzetgroepen`
Lijst van artikelomzetgroepen.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Zoekterm voor nummer of omschrijving |
**Response:**
```json
{
"omzetgroepen": [
{
"id": "uuid-omz-1",
"nummer": 1,
"omschrijving": "Diensten",
"grootboek": {
"id": "uuid-790",
"nummer": 8000,
"omschrijving": "Omzet binnenland"
}
}
],
"count": 1
}
```
---
### `get_artikelomzetgroep`
Details van een specifieke artikelomzetgroep.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `omzetgroep_id` | string | Yes | UUID van de omzetgroep |
**Response:**
```json
{
"omzetgroep": {
"id": "uuid-omz-1",
"modifiedOn": "2025-12-01T10:00:00Z",
"nummer": 1,
"omschrijving": "Diensten",
"grootboek": {
"id": "uuid-790",
"nummer": 8000,
"omschrijving": "Omzet binnenland"
}
}
}
```
---
### `list_actieprijzen`
Lijst van actieprijzen (promotionele prijzen).
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `artikel_id` | string | No | - | Filter op artikel |
| `active_only` | boolean | No | true | Alleen actieve acties |
| `limit` | number | No | 100 | Maximum resultaten |
**Response:**
```json
{
"actieprijzen": [
{
"id": "uuid-act-1",
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001",
"omschrijving": "Consultancy uur"
},
"vanafDatum": "2026-01-01",
"totEnMetDatum": "2026-03-31",
"actieprijs": 125.00,
"omschrijving": "Q1 korting"
}
],
"count": 1,
"filter": {
"activeOnly": true
}
}
```
---
### `list_prijsafspraken`
Lijst van prijsafspraken met klanten.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `relatie_id` | string | No | Filter op klant/relatie |
| `artikel_id` | string | No | Filter op artikel |
| `limit` | number | No | Maximum resultaten (default: 100) |
**Response:**
```json
{
"prijsafspraken": [
{
"id": "uuid-pa-1",
"relatie": {
"id": "uuid-456",
"naam": "Klant BV"
},
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001"
},
"prijs": 140.00,
"korting": 10.00,
"vanafDatum": "2026-01-01"
}
],
"count": 1
}
```
---
### `list_artikel_prijsafspraken`
Prijsafspraken gekoppeld aan artikelen.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `artikel_id` | string | No | Filter op artikel |
| `relatie_id` | string | No | Filter op relatie |
| `limit` | number | No | Maximum resultaten (default: 100) |
**Response:**
```json
{
"prijsafspraken": [
{
"id": "uuid-apa-1",
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001"
},
"relatie": {
"id": "uuid-456",
"naam": "Klant BV"
},
"prijs": 140.00,
"vanafAantal": 10
}
],
"count": 1
}
```
---
## Order & Offerte Tools
### `list_verkooporders`
Lijst van verkooporders.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `from_date` | string | No | - | Begindatum (YYYY-MM-DD) |
| `to_date` | string | No | - | Einddatum (YYYY-MM-DD) |
| `status` | string | No | "alle" | Filter: "Concept", "Open", "Verwerkt", "Geannuleerd", "alle" |
| `search` | string | No | - | Zoekterm voor ordernummer |
| `limit` | number | No | 100 | Maximum resultaten |
**Response:**
```json
{
"orders": [
{
"id": "uuid-vo-1",
"verkoopordernummer": "VO-2026-001",
"datum": "2026-01-08",
"klant": {
"id": "uuid-456",
"naam": "Klant BV"
},
"totaalbedrag": 1500.00,
"status": "Open"
}
],
"count": 1,
"filter": {
"status": "Open"
}
}
```
---
### `get_verkooporder`
Details van een specifieke verkooporder.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_id` | string | Yes | UUID van de verkooporder |
**Response:**
```json
{
"order": {
"id": "uuid-vo-1",
"modifiedOn": "2026-01-08T14:00:00Z",
"verkoopordernummer": "VO-2026-001",
"datum": "2026-01-08",
"klant": {
"id": "uuid-456",
"naam": "Klant BV"
},
"omschrijving": "Consultancy project Q1",
"totaalbedrag": 1500.00,
"status": "Open",
"regels": [
{
"id": "uuid-vor-1",
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001"
},
"omschrijving": "Consultancy uur",
"aantal": 10,
"stuksprijs": 150.00,
"totaal": 1500.00
}
]
}
}
```
---
### `list_verkoopordersjablonen`
Lijst van verkoopordersjablonen.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Zoekterm voor naam of omschrijving |
**Response:**
```json
{
"sjablonen": [
{
"id": "uuid-vos-1",
"naam": "Standaard consultancy",
"omschrijving": "Template voor consultancy orders"
}
],
"count": 1
}
```
---
### `get_verkoopordersjabloon`
Details van een specifiek verkoopordersjabloon.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sjabloon_id` | string | Yes | UUID van het sjabloon |
**Response:**
```json
{
"sjabloon": {
"id": "uuid-vos-1",
"modifiedOn": "2025-06-01T10:00:00Z",
"naam": "Standaard consultancy",
"omschrijving": "Template voor consultancy orders",
"regels": [
{
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001"
},
"aantal": 8,
"stuksprijs": 150.00
}
]
}
}
```
---
### `list_offertes`
Lijst van offertes.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `from_date` | string | No | - | Begindatum (YYYY-MM-DD) |
| `to_date` | string | No | - | Einddatum (YYYY-MM-DD) |
| `status` | string | No | "alle" | Filter: "Concept", "Verstuurd", "Geaccepteerd", "Afgewezen", "Verlopen", "alle" |
| `search` | string | No | - | Zoekterm voor offertenummer |
| `limit` | number | No | 100 | Maximum resultaten |
**Response:**
```json
{
"offertes": [
{
"id": "uuid-off-1",
"offertenummer": "OFF-2026-001",
"datum": "2026-01-05",
"klant": {
"id": "uuid-456",
"naam": "Klant BV"
},
"totaalbedrag": 3000.00,
"status": "Verstuurd",
"vervaldatum": "2026-02-05"
}
],
"count": 1,
"filter": {
"status": "Verstuurd"
}
}
```
---
### `get_offerte`
Details van een specifieke offerte.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `offerte_id` | string | Yes | UUID van de offerte |
**Response:**
```json
{
"offerte": {
"id": "uuid-off-1",
"modifiedOn": "2026-01-05T16:00:00Z",
"offertenummer": "OFF-2026-001",
"datum": "2026-01-05",
"klant": {
"id": "uuid-456",
"naam": "Klant BV"
},
"omschrijving": "Projectvoorstel Q1",
"totaalbedrag": 3000.00,
"status": "Verstuurd",
"vervaldatum": "2026-02-05",
"regels": [
{
"artikel": {
"id": "uuid-art-1",
"artikelcode": "CONS-001"
},
"omschrijving": "Consultancy uur",
"aantal": 20,
"stuksprijs": 150.00,
"totaal": 3000.00
}
]
}
}
```
---
## BTW Tools
### `get_btw_summary`
BTW overzicht voor een periode (voor aangifte).
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `from_date` | string | Yes | Begindatum (YYYY-MM-DD) |
| `to_date` | string | Yes | Einddatum (YYYY-MM-DD) |
**Response:**
```json
{
"period": {
"from": "2026-01-01",
"to": "2026-03-31",
"label": "Q1 2026"
},
"verkopen": {
"hoog": {
"basis": 50000.00,
"btw": 10500.00
},
"laag": {
"basis": 5000.00,
"btw": 450.00
},
"verlegd": {
"basis": 0.00
}
},
"inkopen": {
"hoog": {
"basis": 20000.00,
"btw": 4200.00
},
"laag": {
"basis": 1000.00,
"btw": 90.00
},
"verlegd": {
"basis": 0.00
}
},
"totaal": {
"verschuldigdeBtw": 10950.00,
"voorbelasting": 4290.00,
"teBetalen": 6660.00
}
}
```
---
### `list_btwaangiftes`
Lijst van BTW aangiftes.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `jaar` | number | No | - | Filter op jaar (bijv. 2026) |
| `status` | string | No | "alle" | Filter: "Concept", "Ingediend", "Definitief", "alle" |
| `limit` | number | No | 50 | Maximum resultaten |
**Response:**
```json
{
"aangiftes": [
{
"id": "uuid-btw-1",
"jaar": 2026,
"periode": 1,
"periodeSoort": "Kwartaal",
"status": "Concept",
"afdrachtBedrag": 6660.00
}
],
"count": 1,
"filter": {
"jaar": 2026
}
}
```
---
### `get_btwaangifte`
Details van een specifieke BTW aangifte.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `aangifte_id` | string | Yes | UUID van de BTW aangifte |
**Response:**
```json
{
"aangifte": {
"id": "uuid-btw-1",
"modifiedOn": "2026-04-01T10:00:00Z",
"jaar": 2026,
"periode": 1,
"periodeSoort": "Kwartaal",
"status": "Concept",
"afdrachtBedrag": 6660.00,
"omzetHoogTarief": 50000.00,
"btwHoogTarief": 10500.00,
"omzetLaagTarief": 5000.00,
"btwLaagTarief": 450.00,
"voorbelasting": 4290.00
}
}
```
---
## Overige Tools
### `list_dagboeken`
Lijst van dagboeken (journalen).
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `soort` | string | No | "alle" | Filter: "Bank", "Kas", "Inkoop", "Verkoop", "Memoriaal", "alle" |
**Response:**
```json
{
"dagboeken": [
{
"id": "uuid-db-1",
"nummer": 10,
"omschrijving": "ABN AMRO",
"dagboeksoort": "Bank",
"grootboek": {
"id": "uuid-789",
"nummer": 1100
}
},
{
"id": "uuid-db-2",
"nummer": 20,
"omschrijving": "Kas",
"dagboeksoort": "Kas"
}
],
"count": 2,
"filter": {
"soort": "alle"
}
}
```
---
### `list_kostenplaatsen`
Lijst van kostenplaatsen.
**Parameters:**
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `include_inactive` | boolean | No | false | Inclusief inactieve kostenplaatsen |
**Response:**
```json
{
"kostenplaatsen": [
{
"id": "uuid-kp-1",
"nummer": 100,
"omschrijving": "Hoofdkantoor",
"nonactief": false
}
],
"count": 1
}
```
---
### `list_landen`
Lijst van landen met ISO codes.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `search` | string | No | Zoekterm voor landnaam of ISO code |
**Response:**
```json
{
"landen": [
{
"id": "uuid-land-nl",
"naam": "Nederland",
"landcodeISO": "NL",
"landcodeISO3": "NLD"
},
{
"id": "uuid-land-be",
"naam": "België",
"landcodeISO": "BE",
"landcodeISO3": "BEL"
}
],
"count": 2
}
```
---
### `get_document`
Details van een specifiek document.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `document_id` | string | Yes | UUID van het document |
**Response:**
```json
{
"document": {
"id": "uuid-doc-1",
"modifiedOn": "2026-01-10T09:00:00Z",
"naam": "Factuur 2026-0001",
"bestandsnaam": "factuur-2026-0001.pdf",
"documentType": "Factuur",
"contentType": "application/pdf",
"grootte": 125430
}
}
```
---
## Diagnostische Tools
### `echo_test`
Test endpoint voor API connectiviteit.
**Parameters:**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `input` | string | Yes | Tekst om te echoën |
**Response:**
```json
{
"result": "Hello, SnelStart!"
}
```
---
### `check_access`
Controleer of de gebruiker toegang heeft tot de administratie.
**Parameters:** Geen
**Response:**
```json
{
"hasAccess": true,
"admin": {
"id": "vca",
"name": "VCA Company BV"
}
}
```
---
## Error Responses
Alle tools kunnen de volgende error response teruggeven:
```json
{
"error": "Error description",
"message": "Detailed error message",
"statusCode": 400
}
```
Mogelijke error codes:
- `400` - Bad Request (ongeldige parameters)
- `401` - Unauthorized (geen toegang)
- `404` - Not Found (resource niet gevonden)
- `429` - Too Many Requests (rate limit bereikt)
- `500` - Internal Server Error
---
## OData Filtering
Tools die OData ondersteunen accepteren filters in de volgende formaten:
**Datum filtering:**
```
factuurdatum ge 2026-01-01 and factuurdatum le 2026-01-31
```
**Status filtering:**
```
openstaandSaldo gt 0
```
**Naam zoeken:**
```
contains(naam, 'Klant')
```
---
*Documentatie gegenereerd: 25 januari 2026*
