# Koppelingen

Bron: https://goldmary.eu/koppelingen

Met een koppeling werkt Goldmary samen met een AI-assistent, met je eigen software of met je bank.

## AI-assistent

Een AI-assistent die met MCP werkt, zoals Claude, ChatGPT of Cursor, beantwoordt vragen over je boekhouding. Hij leest facturen, klanten, uren, bonnen, boekingen, de btw per periode, de winst-en-verliesrekening en de balans.

Je maakt een token onder **Instellingen**, bij **AI-assistenten**. Zonder vinkje mag het token alleen lezen. Met het vinkje voegt de assistent ook klanten, uren, conceptfacturen en bonnen toe. Versturen, definitief maken en boeken doe je zelf in de app.

Werk je met Claude of ChatGPT in de browser, dan heb je geen token nodig. Je voegt daar een eigen connector toe en logt in bij Goldmary. Wil je eerst oefenen, klik dan bij **AI-assistenten koppelen** op **Sandbox maken**. Je krijgt een administratie met verzonnen cijfers.

Hoe je het token in je assistent zet, staat bij [AI-assistenten koppelen](https://goldmary.eu/ontwikkelaars/mcp) en in de handleiding [AI-assistenten en webhooks koppelen](https://goldmary.eu/handleiding/koppelingen).

## REST API

Hetzelfde token werkt als sleutel voor de REST API, op de routes van je eigen administratie. Met een token dat alleen mag lezen, lees je je gegevens. Met een token dat ook mag schrijven, voeg je net als de assistent klanten, uren, conceptfacturen en bonnen toe. Per token zijn 60 aanroepen per minuut mogelijk.

De routes staan in [openapi.json](https://goldmary.eu/ontwikkelaars/openapi.json), in OpenAPI 3.1.

## Webhooks

Met een webhook krijgt je eigen software een bericht van Goldmary als een van deze dingen gebeurt:

- Een factuur wordt definitief.
- Een factuur is betaald.
- Een betaalde factuur staat weer open, omdat er een betaling is weggehaald of terugbetaald.
- Er komt een klant bij.

Een eigenaar of beheerder zet het adres van de software onder **Instellingen**, op de pagina **Webhooks**. Het adres begint met https://, en een administratie heeft hoogstens vijf adressen. Hoe je software een bericht controleert, staat bij [Webhooks](https://goldmary.eu/ontwikkelaars/mcp#webhooks).

## Bankafschrift en bankkoppeling

Je downloadt bij je bank een afschrift en leest dat in bij **Facturen**, onder **Betalingen**. Past een ontvangen bedrag bij een open factuur, dan koppel je de betaling aan die factuur. Welk bestand je bij jouw bank kiest, staat bij [Bankafschrift per bank](https://goldmary.eu/bankafschrift).

Je bank koppelen via Ponto kan nog niet.

Een afschrift van je bank inlezen als CAMT.053 (XML), MT940 of CSV is gratis.

## Betaallinks

Wil je dat klanten met iDEAL betalen via je eigen Mollie-account, open dan bij **Instellingen** de pagina **Betaallinks** en koppel daar Mollie. Het geld komt dan op je eigen account.

## Verwant

- [AI-assistenten en webhooks koppelen](https://goldmary.eu/handleiding/koppelingen)
- [Bankafschrift inlezen en koppelen](https://goldmary.eu/handleiding/bankafschrift)
- [Bankafschrift per bank](https://goldmary.eu/bankafschrift)
- [AI-assistenten koppelen](https://goldmary.eu/ontwikkelaars/mcp)

_Bijgewerkt op 17 november 2026._