Nieuw · API & koppelingen

Open API: koppel CivielControl aan je eigen systemen

Je gegevens blijven van jou — ook buiten het scherm. Met de open REST API haal je projecten, uren, meerwerk, materieel en facturen op en schrijf je ze weg. Je beheerder maakt de sleutels zelf aan en bepaalt precies wat een koppeling mag.

acme.civielcontrol.nl/api/v1
$ curl -H "Authorization: Bearer cc_live_7f3a91c2b4d6_…" \
       https://acme.civielcontrol.nl/api/v1/bookings?from=2026-08-01

{
  "data": [
    {
      "id": 5821,
      "work_date": "2026-08-11",
      "hours": 8.0,
      "project_id": 142,
      "user": { "id": 12, "name": "Ferry de Vries" },
      "locked": false
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total_count": 214 }
}

Zo werkt het

Koppelen zonder ons erbij te hoeven halen

Geen exportbestanden die je elke maand handmatig doorstuurt, en geen ontwikkeltraject bij ons op de planning. Je beheerder maakt een sleutel aan, jouw leverancier koppelt hem, klaar.

1

Sleutel aanmaken

De beheerder maakt onder Instellingen → API-sleutels een sleutel aan, met een herkenbare naam zoals ‘Urenkoppeling boekhouding’.

2

Rechten kiezen

Per onderdeel — projecten, uren, materieel, facturen — kies je lezen of ook schrijven. Een koppeling die alleen uren hoeft te lezen, kan verder niets.

3

Koppelen en klaar

Je leverancier zet de sleutel in zijn systeem. Werkt het niet meer, of vertrekt de partij? Eén klik en de sleutel is ingetrokken.

Waarvoor

Wat aannemers ermee koppelen

Je boekhouding en salarisverwerking

Goedgekeurde uren automatisch naar je salarispakket, zonder dat iemand ze overtypt. Naast de directe koppeling met Exact Online voor je facturen.

Je eigen rapportage

Haal projecten, kosten en uren op in Power BI, Excel of je eigen dashboard. Met ‘alleen wat sinds gisteren veranderd is’ hoef je niet elke keer alles op te halen.

Een portaal voor je opdrachtgever

Werkbonnen met foto’s en handtekening, per project, in je eigen klantportaal. De foto’s blijven achter de sleutel: geen openbare links.

Materieel en keuringen

Keuringen met vervaldatum, draaiuren en kosten per machine — in je onderhoudssysteem of je eigen overzicht, zonder dubbel bijhouden.

Uren importeren uit een ander systeem

Kom je van een ander pakket, of registreert een onderaannemer elders? Je stuurt honderd dagen uren in één keer in en krijgt per regel terug wat er gelukt is.

Bericht zodra er iets verandert

Met webhooks krijg je een ondertekend bericht zodra er uren geboekt of projecten gewijzigd worden. Geen koppeling die elke minuut staat te vragen of er nog iets is.

Veiligheid

Een sleutel die je zelf in de hand houdt

Een koppeling is toegang tot je administratie. Daarom is een sleutel beperkt tot wat hij nodig heeft, hoort hij bij één bedrijf, en zie je altijd wanneer hij voor het laatst gebruikt is.

Rechten per onderdeel

Lezen of schrijven, per onderdeel apart. Een sleutel die alleen uren mag lezen kan geen project wijzigen — ook niet per ongeluk.

Nooit bij een ander bedrijf

Een sleutel werkt alleen op het adres van jouw omgeving. Gegevens van een ander bedrijf zijn onbereikbaar, wat er ook opgevraagd wordt.

Intrekken wanneer je wilt

Sleutel kwijt, of stopt de samenwerking? Intrekken werkt direct. Je kunt ook een vervaldatum meegeven aan een tijdelijke koppeling.

Ook mogelijk

Of laat een AI-agent het koppelwerk doen

Dezelfde gegevens, zonder dat er iemand code hoeft te schrijven: koppel Claude of een andere AI-assistent aan je omgeving en stel je vraag in gewone taal. Dezelfde sleutels, dezelfde rechten, hetzelfde logboek — alleen de client is anders.

Naar AI-agenten

Veelgestelde vragen

Over de API en koppelingen

Ja. CivielControl heeft een gedocumenteerde REST API waarmee je projecten, uren, meerwerk, werkbonnen, materieel, planning en facturen kunt ophalen en wegschrijven. De API zit bij elk abonnement in, zonder meerprijs.
De beheerder van je eigen omgeving. Je maakt zelf een sleutel aan, bepaalt per onderdeel of die mag lezen of ook schrijven, geeft er eventueel een vervaldatum aan en trekt hem met één klik weer in. Je hoeft ons daar niet voor te bellen.
Nee. Een sleutel hoort bij één omgeving en werkt alleen op het adres van dat bedrijf. Gegevens van een ander bedrijf zijn onbereikbaar, ook als iemand een verkeerd nummer probeert.
Ja, met webhooks. Je geeft een adres op en kiest bij welke gebeurtenissen we een bericht sturen — bijvoorbeeld zodra er uren geboekt worden. Elk bericht is ondertekend, zodat je systeem kan controleren dat het echt van ons komt. Zo hoef je niet elke minuut te vragen of er iets nieuws is.
In je eigen omgeving, onder Instellingen → API-sleutels. Daar staat de documentatie met voorbeelden, een overzicht van alle endpoints en een machineleesbare OpenAPI-beschrijving die je in je eigen tooling kunt inlezen.
Nee. De API en webhooks zitten bij elk abonnement in. Je betaalt voor de modules die je gebruikt; koppelen kost niets extra.

Benieuwd of jouw koppeling erin past?

Neem je leverancier of je eigen ontwikkelaar mee naar de demo. In 30 minuten weten we of het kan — meestal is het antwoord ja.

Demo aanvragen