Promptbibliotheek

Ik wil EenFactuurMaken.nl (facturatiesoftware) koppelen aan jou via MCP.
Lees eerst de handleiding: https://eenfactuurmaken.nl/docs/mcp.md

De MCP-server staat op: https://eenfactuurmaken.nl/mcp
Ik gebruik: [ChatGPT / Claude (desktop of web) / Claude Code / Cursor / Gemini CLI / VS Code met Copilot].

Leg me in genummerde stappen uit hoe ik de server toevoeg, waar ik inlog of mijn API-sleutel invul, en hoe ik daarna test of het werkt (bijvoorbeeld door mijn laatste 5 facturen op te vragen). Vraag me niet om mijn API-sleutel in deze chat te plakken.

Maak in EenFactuurMaken.nl een conceptfactuur voor [klantnaam].
- Regels: [bijv. 12 uur webdesign à € 85, 1 hosting-pakket à € 120]
- Btw: [21% / btw verlegd / geen btw (KOR)]
- Betaaltermijn: [14] dagen
- Kenmerk of PO-nummer van de klant: [optioneel]

Zoek de klant eerst op in mijn klanten. Bestaat hij nog niet, vraag me dan om naam, adres, KvK- en btw-nummer voordat je iets aanmaakt.
Maak de factuur NIET definitief en verstuur hem niet. Laat me daarna een overzicht zien met de regels, de btw en het totaal, plus de punten die de compliance-check nog meldt.

Zoek in EenFactuurMaken.nl al mijn verlopen facturen (status "overdue").
Laat ze eerst zien in een tabel: factuurnummer, klant, bedrag, vervaldatum en hoeveel dagen te laat.

Vraag me daarna welke ik een betalingsherinnering wil sturen. Stuur alleen herinneringen voor de facturen die ik bevestig, en meld per factuur of het gelukt is.

Zet de rijen hieronder (geplakt uit Excel) om naar factuurregels voor EenFactuurMaken.nl.
Geef per regel: omschrijving, aantal, eenheid (C62 = stuk, HUR = uur, DAY = dag, MON = maand), prijs per eenheid excl. btw in centen (unitPriceCents) en btw-tarief (21, 9 of 0).
Zijn bedragen incl. btw? Reken ze dan terug naar excl. btw en zeg dat erbij. Twijfel je over een regel, vraag het me dan in plaats van te gokken.

Geef het resultaat als JSON-array met de velden description, quantity, unit, unitPriceCents en vatRate. Is de MCP-server gekoppeld, vraag dan of je er een conceptfactuur van moet maken.

[plak hier je rijen]

Maak in EenFactuurMaken.nl een creditnota voor factuur [factuurnummer].
[Crediteer de hele factuur / Crediteer alleen: omschrijving en bedrag]
Reden: [bijv. dubbel gefactureerd, korting achteraf]

Maak alleen een concept, maak het niet definitief. Laat me daarna het creditbedrag, de btw en de verwijzing naar de originele factuur zien.

Haal in EenFactuurMaken.nl de compliance-check op van mijn conceptfactuur [factuurnummer of klantnaam].
Leg elk punt in gewone taal uit: wat ontbreekt er, waarom is het wettelijk nodig, en waar vul ik het in (bedrijfsgegevens, klant of factuur).
Pas zelf niets aan zonder het eerst te vragen.

Maak een btw-overzicht van mijn facturen in EenFactuurMaken.nl over het derde kwartaal van [jaar] (1 juli t/m 30 september).
Haal de btw-cijfers van dat kwartaal op met get_stats (year=[jaar], quarter=3) en controleer ze met de lijst met facturen in die periode (list_invoices met from en to).

Geef een tabel per btw-tarief (21%, 9%, 0%) met omzet excl. btw en btw-bedrag, en apart:
- omzet met btw verlegd
- intracommunautaire leveringen/diensten (ICP)
- export buiten de EU
- vrijgestelde omzet of KOR
Trek creditnota's af. Noem de factuurnummers die je meetelt, en zeg erbij dat dit een hulpmiddel is en geen ingediende aangifte.

Je bent een ervaren ontwikkelaar die een koppeling bouwt met de EenFactuurMaken.nl REST API.

Bronnen (lees deze eerst):
- OpenAPI-specificatie: https://eenfactuurmaken.nl/api/v1/openapi.json
- API-documentatie: https://eenfactuurmaken.nl/docs/api.md

Regels:
- Basis-URL: https://eenfactuurmaken.nl/api/v1. Authenticatie met een header "Authorization: Bearer efm_..." (API-sleutel). Lees de sleutel uit een omgevingsvariabele, zet hem nooit in code of logs.
- Bedragen zijn gehele centen (velden die eindigen op Cents). Datums zijn YYYY-MM-DD. Btw-tarieven zijn strings zoals "21".
- Lijsten geven { data, page, pageSize, total } terug. Gebruik paginering.
- Fouten hebben de vorm { statusCode, statusMessage, data: { code, message, details } }. Handel op data.code, niet op de tekst. Bij 422 invoice_not_compliant staan de ontbrekende velden in details.
- Een factuur is eerst een concept (POST /invoices), wordt definitief met POST /invoices/{id}/issue en daarna onveranderlijk. Correcties gaan via een creditnota (POST /invoices/{id}/credit-note).
- Respecteer 429-antwoorden met backoff.
- Schrijf kleine, geteste functies en leg kort uit wat je doet.

Mijn situatie: [taal/framework en wat je wilt bouwen, bijv. "facturen aanmaken vanuit mijn webshop in Laravel"]

Download en lees de OpenAPI-specificatie van EenFactuurMaken.nl: https://eenfactuurmaken.nl/api/v1/openapi.json

Schrijf op basis daarvan een kleine, getypeerde API-client in [TypeScript / Python / PHP / Go / C# / Ruby].
- Eén klasse of module met methodes voor klanten, producten en facturen (lijst, ophalen, aanmaken, bijwerken, definitief maken, versturen, herinneren, PDF en UBL downloaden).
- API-sleutel via de constructor of een omgevingsvariabele, als header "Authorization: Bearer ...".
- Fouten als een eigen exceptie met statusCode en de stabiele foutcode uit data.code.
- Automatisch opnieuw proberen bij 429 en 5xx, met exponentiële backoff.
- Gebruik bij voorkeur alleen de standaardbibliotheek, of de gangbare HTTP-library van de taal.
Lever ook een kort voorbeeld: maak een concept, maak het definitief en download de PDF.