Documentatie
Ontwikkelaars
De Handleiding legt uit hoe elk onderdeel van Cijfr werkt, van eerste factuur tot btw-rapport. Ontwikkelaars vinden de REST API, webhooks en de OpenAPI-specificatie.
Begin hier
- Beginnen met de APIWat de Cijfr API is, wat je nodig hebt en je eerste verzoek in drie stappen.
- Authenticatie en sleutelsBearer-sleutels, scopes per resource, profielbeperking en hoe je sleutels veilig beheert.
- ConventiesJSON-conventies, centen, datums, fouten, rate limits en idempotency. Lees dit één keer en de rest is voorspelbaar.
Resources
- Klanten
GET,POST,PATCHenDELETE /api/v1/customers. Klanten zijn de ontvangers van facturen en checkouts;externalIdhoudt je eigen id's bij. - Producten
GET,POST,PATCHenDELETE /api/v1/products. Producten zijn herbruikbare factuurregels met een prijs en btw-tarief. - Facturen
GET,POST,PATCHenDELETE /api/v1/invoicesplus versturen, betalingen, creditnota's, herinneringen, betaallink, PDF en UBL. Versturen nummert en vergrendelt. - Abonnementen
GET,POST,PATCHenDELETE /api/v1/subscriptions. Terugkerende schema's die zelf facturen maken. - Hosted checkout
GETenPOST /api/v1/checkoutsplusGET /{id}. Een betaallink op jouw huisstijl; na betaling staat de factuur er automatisch. - BoekhoudingHoe het grootboek werkt: wat automatisch boekt, hoe de btw-aangifte wordt voorbereid en wat de grenzen zijn.
Integratie
- WebhooksCijfr POST gebeurtenissen naar jouw HTTPS-endpoint, ondertekend met een eigen secret. Tot vijf pogingen met oplopende pauze.
- MCP-serverClaude, ChatGPT en andere MCP-clients koppelen aan Cijfr via OAuth. De server kan alleen wat jij mag, en verstuurde facturen blijven onaantastbaar.
- ReferentieAlle endpoints in één tabel, gegenereerd uit de OpenAPI-beschrijving. Dezelfde beschrijving draait live.
- Voor AI-agentenDeze documentatie is ook platte Markdown. Geef een agent één URL of één bestand en hij kent de hele API.
.md toe aan de URL, of geef een agent llms-full.txt in één keer.