Simplicate API: v2 en v3, authenticatie, filters en limieten

Wat kun je met de Simplicate API?

Met de Simplicate API lees en schrijf je relaties, projecten, diensten, uren, kosten, offertes, facturen, medewerkers en verlof. Bureaus gebruiken hem om Simplicate te koppelen aan hun boekhouding, planning of website, en om uren- en projectdata naar een datawarehouse of rapportagetool te halen.

DigiData synchroniseert met deze API dagelijks Simplicate-omgevingen van klanten. Dit artikel beschrijft wat wij in de praktijk tegenkomen; de officiële bron is de documentatie van Simplicate.

Stap 1: maak een API-sleutel

API-sleutels maak je in Simplicate onder Algemene instellingen, in het onderdeel API. Je krijgt een key en een secret. Een sleutel erft de rechten van de gebruiker voor wie je hem aanmaakt: maak hem dus aan voor een gebruiker die precies mag zien wat de koppeling nodig heeft. Verwijder je de sleutel, dan werkt hij direct niet meer.

Stap 2: v2 of v3?

Simplicate adviseert v2 te blijven gebruiken voor alles wat v3 nog niet dekt; de twee kunnen naast elkaar draaien en gebruiken dezelfde ID's. Voor een volledige export van uren, projecten en facturen is v2 vandaag de praktische keuze.

Stap 3: data ophalen met v2

Een voorbeeld dat organisaties ophaalt die sinds een bepaald moment zijn gewijzigd, nieuwste eerst:

GET https://{domein}.simplicate.nl/api/v2/crm/organization?q[updated_at][ge]=2026-10-01 00:00:00&sort=-updated_at&limit=100&offset=0
Authentication-Key: {key}
Authentication-Secret: {secret}

Filters schrijf je als q[veld][operator]=waarde. Met limit en offset blader je door de resultaten: verhoog de offset tot je minder records terugkrijgt dan je limit. De belangrijkste endpoints voor rapportages:

Rate limits en valkuilen

• Limiet. Simplicate garandeert minstens 60 verzoeken per minuut en kan per endpoint afwijken. Bij een overschrijding krijg je HTTP 429. Lees de header X-RateLimit-Remaining en vertraag tijdig.
• Verschuivende pagina's. Wijzigt er tijdens het bladeren een record, dan kunnen offsets verschuiven en mis of dubbel je records. Sorteer vast en controleer na afloop het totaal.
• Uren in grote aantallen. Bij veel medewerkers is de urentabel de grootste. Haal uren per periode op in plaats van alles in één keer.
• Eigen velden. Vrije velden staan in een aparte structuur en hebben per omgeving andere ID's.

Wanneer je de API niet zelf hoeft te bouwen

Wil je declarabiliteit, projectmarge of omzet per klant zien, dan hoef je de API niet zelf te koppelen. Met de Simplicate connector van DigiData staan je projecten, uren en facturen klaar voor Power BI, Excel, dashboards en AI. Zie Simplicate aan Power BI koppelen. Je declarabiliteit reken je ook snel na met de rekenhulp declarabiliteit.

Combineer je Simplicate met een boekhoudpakket, lees dan ook hoe de API's van Exact Online en Twinfield werken.