ERP via de API
Vanaf Premium
Je ERP of facturatiesoftware haalt de tijdregistraties op via de REST-API en meldt terug welke registraties zijn gefactureerd. De delta-sync levert alleen wat sinds de vorige aanroep is veranderd; een factureringsronde markeert registraties met je factuurnummer en vergrendelt ze. Beide horen bij Premium.
- Maak als eigenaar of admin onder Instellingen, API en apparaten een token aan met de abilities
readenbilling. Hij wordt maar één keer getoond. - Haal bij de eerste aanroep alle registraties op zonder cursor en bewaar
meta.next_cursoruit het antwoord. - Vraag vanaf dan altijd met de opgeslagen cursor. Je krijgt alleen gewijzigde registraties, verwijderde met
deleted_atingevuld. Antwoordt de API met 410, dan is de cursor ouder dan 90 dagen: begin opnieuw zonder cursor en vervang je bestand. - Maak na het factureren een factureringsronde aan, eerst met
"dry_run": trueom het te proberen. De registraties zijn dan gefactureerd en vergrendeld.
Tijdregistraties ophalen, eerst zonder, dan met cursor:
curl "https://api.horaka.com/v1/time-entries/changes?cursor=0" -H "Authorization: Bearer JOUW_TOKEN"
curl "https://api.horaka.com/v1/time-entries/changes?cursor=CURSOR" -H "Authorization: Bearer JOUW_TOKEN"Klanten met hun ID's, daarna alles wat open staat van één klant tot het einde van de maand factureren:
curl https://api.horaka.com/v1/clients -H "Authorization: Bearer JOUW_TOKEN"
curl -X POST https://api.horaka.com/v1/billing-runs \
-H "Authorization: Bearer JOUW_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filter": {"client_id": 4, "until": "2026-10-31"}, "invoice_ref": "RE-2026-0042", "dry_run": true}'In plaats van regelmatig te vragen, kan Horaka je ERP ook bij elke wijziging op de hoogte brengen: maak een webhook aan onder Instellingen, Webhooks. Elk veld, filter en elke foutcode staat beschreven in de API-documentatie.