Menu

Samenvatting van de Officient API

De Officient REST API stelt je in staat om HR-, payroll- en onkostenprocessen te integreren met externe bedrijfssystemen. Hiermee koppel je medewerker-, verlof-, declaratie- en asset-data aan je boekhoudpakket, planningssysteem of BI-platform.
  • Personeelsadministratie: Medewerkers en contracten beheren, role-history volgen, managers toewijzen en personal data audit-log raadplegen voor GDPR-compliance.
  • Kalender, verlof en kloktijden: Yearly/monthly/daily calendar-views, verlofaanvragen, event-types met limits, dagen-off-verwerking, lock/unlock calendar en verzuim-perioden voor ziekte-administratie.
  • Payroll en wage components: Current wages, functions, one-off wage components per persoon/maand, dimona-aangiftes (Belgische meldingsplicht) en priority-schemes.
  • Onkostenbeheer en budgetten: Expense claims met categorieën, budgets per project/cost-center, cost-units en custom-expense-categorieën.
  • Assets, fleet en documenten: Bedrijfsmiddelen beheren (met custom asset-types), voertuigenfleet, documentopslag en download.
  • Webhooks voor realtime sync: Registreer webhook-endpoints om push-notificaties te ontvangen bij wijzigingen in personeel, contracten, verlof en expenses.
API Quick Facts REST
  • Authenticatie OAuth2
  • Methods POST (19)PATCH (9)GET (46)PUT (2)DELETE (10)
  • Rate limits Documentatie bevat een specifieke Rate-Limiting-sectie op apidocs.officient.io/docs/rate-limiting. Exacte drempels zijn niet publiek en kunnen per scope verschillen.
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • Versionering URL-based

Laatste ontwikkelingen bij de Officient API

Officient is ontstaan als Belgisch HR-softwarebedrijf met sterke lokale integratie (dimona-aangiftes, Belgische sociale zekerheid). De REST API is incrementeel uitgebreid van basis-medewerker-endpoints naar een uitgebreide 1.0-suite die personeelsadministratie, payroll-voorbereiding, kalenderbeheer, onkostenregistratie, asset-management en webhook-subscriptions integreert. Authenticatie verliep aanvankelijk via statische API-keys; later werd OAuth 2.0 met scope-gebaseerde permissions (basics:read/write, hr:read/write, expenses:write, etc.) geïntroduceerd. Webhooks, priority-schemes en personal-data-audit-logs zijn recentere toevoegingen gericht op compliance en realtime sync. Docs staan op ReadMe.io (apidocs.officient.io).

API versies

OAuth 2.0 + scopes Major release

Overgang van statische API-key-authenticatie naar OAuth 2.0 met scope-gebaseerde permissions (basics:read/write, hr:read/write, expenses:write, calendar:*).

Webhooks Major release

Webhook-subscriptions voor realtime notificaties bij wijzigingen in personeel, contracten, kalender-events en expenses.

Personal Data Audit Log

Endpoint voor het raadplegen van de audit-log per medewerker (GDPR-compliance) met wijzigingshistorie en actor-informatie.

Dimona + priority schemes

Uitbreidingen voor Belgische payroll: dimona-aangiftes per persoon en priority-schemes voor geautomatiseerde wage-component-berekeningen.