Developers

API-documentatie

Een voorbeeldoverzicht van hoe RitFactuur via een REST-API en webhook-events te koppelen is aan boordcomputers en boekhoudpakketten. Onderstaande endpoints zijn illustratief en bedoeld als documentatie-preview.

Authenticatie

Elk verzoek wordt geauthenticeerd met een API-sleutel per bedrijf, meegegeven als bearer-token.

curl https://api.ritfactuur.nl/v1/rides \
  -H "Authorization: Bearer <API-KEY>"

Voorbeeld-endpoints

Methode	Endpoint	Omschrijving
POST	/v1/rides	Rit aanmaken (alternatief voor CSV-upload).
GET	/v1/rides?status=unbilled	Onfactureerde ritten ophalen.
POST	/v1/invoices/generate	Factuur genereren uit een set ritten.
GET	/v1/invoices/:id	Status en PDF-link van een factuur ophalen.

Status-waarden

De volgende statussen worden gebruikt voor ritten en facturen — bruikbaar om je eigen integratie op te bouwen.

Rit-status

unbilledinvoiced

Factuur-status

draftgeneratedsentpaidoverduecancelled

Deze documentatie is een voorbeeldweergave van de API-mogelijkheden. Bekijk technische specificaties.