Exact Online API limieten: wat mag een koppeling per minuut en per dag?

De limieten op een rij

Exact Online telt per app en per administratie. De limieten gelden voor de REST API en voor de XML-webservice. De getallen hieronder zijn op 3 oktober 2026 nagelezen in de documentatie van Exact over API-limieten.

Daar komt een vast venster bij: Exact Online en de API zijn elke nacht van 04:00 tot 04:30 lokale tijd niet bereikbaar. Een nachtelijke ronde die om 04:00 start, mislukt elke nacht.

Volgens Exact raakt 97,5% van de klanten de daglimiet nooit. Een webshopkoppeling die per artikel een los verzoek doet, hoort bij de andere 2,5%: 8.000 artikelen één voor één opvragen is 8.000 verzoeken. Wat een rate limit in het algemeen is en hoe andere systemen tellen, staat in wat is een rate limit.

Wat telt als een verzoek?

Elk verzoek met het nummer van de administratie (de divisie) in het pad telt mee, lezen en schrijven. Vier regels bepalen hoe snel het budget opgaat:

• Elke pagina is een verzoek. Een gewoon endpoint geeft 60 records per antwoord. 600 open orders ophalen kost 10 verzoeken.
• Per app, per administratie. Een tweede app op dezelfde administratie heeft een eigen budget van 5.000. Eén app op twee administraties heeft er 5.000 per administratie. Alle gebruikers van dezelfde app op dezelfde administratie delen één budget.
• Zonder divisie telt het niet voor de daglimiet. Een verzoek aan /api/v1/current/Me gaat niet van de 5.000 af.
• Een webhook is geen verzoek, het ophalen erna wel. De melding bevat een verwijzing. Het gewijzigde record haalt de koppeling met een eigen verzoek op.

Het saldo staat in elk antwoord. Dit zijn de headers van het laatste verzoek dat op een dag nog doorgaat, met voorbeeldwaarden:

HTTP/1.1 200 OK
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1791331200000
X-RateLimit-Minutely-Limit: 60
X-RateLimit-Minutely-Remaining: 41

X-RateLimit-Reset is het moment waarop het dagvenster opnieuw begint, in milliseconden sinds 1 januari 1970 in UTC. De koppeling rekent die waarde om en plant het wachtende werk daarna in.

Wat kost één order?

Het aantal verzoeken per order bepaalt hoeveel orders er in een dag passen. Voor een webshoporder met drie artikelregels die als verkooporder in Exact landt:

De orderregels gaan mee in het verzoek dat de order aanmaakt. Het artikel staat in dat verzoek als GUID, en de webshop kent alleen de artikelcode. Een koppeling die elke code bij Exact opzoekt, betaalt per regel een verzoek. Een koppeling die de artikelen via het sync-endpoint binnenhaalt en de GUID's zelf bewaart, betaalt er geen.

Een nieuwe klant kost 1 verzoek extra voor de debiteur en 1 voor een afwijkend afleveradres in crm/Addresses. Dat maakt 4 tot 6 verzoeken per order met een opzoektabel.

De som per abonnement

Naast de orders lopen de vaste rondes. Een voorraadronde elke 5 minuten via het sync-endpoint is 12 x 24 = 288 verzoeken per dag. Artikelen, prijzen en relaties elk uur is 3 x 24 = 72. Samen 360.

Standaardabonnement. 5.000 - 360 = 4.640 verzoeken voor orders.

• Met 4 verzoeken per order: 4.640 / 4 = 1.160 orders per dag.
• Met 7 verzoeken per order: 4.640 / 7 = 662 orders per dag.

Premium. 30.000 - 360 = 29.640 verzoeken, dus 29.640 / 4 = 7.410 orders per dag. Die 30.000 is het totaal voor alle apps samen. Een tweede app op de administratie gaat ervan af.

De minuutlimiet. 60 per minuut is 3.600 per uur. In een piekuur passen er, na 15 verzoeken voor de rondes, 3.585 / 4 = 896 orders. Op volle snelheid is het dagbudget van 5.000 in 5.000 / 60 = 83 minuten en 20 seconden op. Bij 30.000 duurt dat 500 minuten, ofwel 8 uur en 20 minuten.

De fair use van 20.000 per dag telt over het hele contract. Vier apps die elk hun 5.000 op één administratie opmaken, zitten samen op die grens. Bij twee administraties met elk vier apps is het 40.000, en dat is het dubbele van wat Exact als redelijk gebruik noemt.

De som voor een gewone dag en een piekdag staat op de pagina over de Exact Online koppeling. De methode voor andere systemen staat in doorvoer berekenen.

API-verzoeken en boekingsregels: twee grenzen

Naast de API-limiet noemt Exact op de prijspagina een gemiddeld aantal boekingsregels per administratie per maand: minder dan 10.000 voor Essentials, Plus en Professional en minder dan 25.000 voor Premium, met de mogelijkheid tot uitbreiden. Dat getal staat los van de 5.000 verzoeken.

Eén verzoek kan veel regels opleveren. Een verkoopfactuur met drie artikelregels tegen één btw-tarief boekt vijf regels in het grootboek: drie op omzet, één op btw en één op de debiteur.

order 10482, drie artikelen, één btw-tarief
omzet artikel KB-2210        1 regel
omzet artikel KB-2214        1 regel
omzet artikel KB-3301        1 regel
btw 21%                      1 regel
debiteur 10432               1 regel
totaal                       5 regels, 1 verzoek voor het aanmaken

Bij 2.000 van zulke orders per maand zijn dat 10.000 regels. Dat is 66 orders per dag, ver onder de 1.160 die de API toelaat. Voor een webshop met kleine orders is het aantal boekingsregels dus eerder de grens dan het aantal verzoeken. Exact vermeldt op de prijspagina niet hoe het de regels telt; de som hierboven telt de regels in het grootboek.

Minder regels kan door orders samen te voegen tot één dagboeking per verkoopkanaal en btw-tarief. Dan staat de order niet meer per klant en per artikel in Exact. Die afweging hangt samen met de keuze voor een verzameldebiteur en met het pakket: zie Exact Online Boekhouden of Handel.

Wat er gebeurt bij een 429

De minuutlimiet. Het voorbeeld van Exact zelf: doet een app 60 verzoeken tussen 10:00:00 en 10:00:40, dan wordt elk volgend verzoek geweigerd tot 10:01:00. Sneller opnieuw proberen heeft geen zin. De koppeling houdt per administratie een teller van de laatste 60 seconden bij en verstuurt verzoek 61 pas in de volgende minuut.

De daglimiet. Na verzoek 5.000 weigert Exact alles voor die administratie tot het dagvenster opnieuw begint. Andere administraties van dezelfde app lopen door. Orders die in die uren binnenkomen blijven in de wachtrij en gaan daarna in volgorde door.

De foutlimiet. Een order met een onbekend artikel geeft een 400. Biedt de koppeling hem elke 5 minuten opnieuw aan, dan zijn dat 12 fouten per uur op SalesOrders. Boven de 10 blokkeert Exact de sleutel een uur, en bij herhaling langer. In dat uur komen ook de goede orders niet aan. Een afgekeurde order hoort daarom op een controlelijst en gaat pas opnieuw naar Exact als de oorzaak is opgelost.

Het token. Een access token is 10 minuten geldig, en een nieuw token is pas 570 seconden na het vorige op te vragen. Twee processen die elk een eigen token verversen, lopen daar tegenaan. Eén proces ververst en de rest leest het token uit dezelfde opslag.

Binnen het budget blijven: bulk, sync en webhooks

Exact biedt vier manieren om gegevens te lezen, beschreven in het artikel over API-typen. Welke je kiest, bepaalt het verbruik.

Een voorbeeld met 25.000 debiteuren. Via crm/Accounts kost een volledige lading 25.000 / 60 = 417 verzoeken. Via sync/CRM/Accounts zijn het er 25. De ronde van de volgende dag, met 150 gewijzigde debiteuren, kost via sync 1 verzoek en via het gewone endpoint opnieuw 417.

Een sync-endpoint werkt met een Timestamp, een versienummer per record. De koppeling bewaart de hoogste waarde uit het vorige antwoord en geeft die mee bij het volgende verzoek. Exact noemt dat betrouwbaarder dan filteren op wijzigingsdatum, omdat meerdere records dezelfde datum kunnen hebben. Op een groeiend aantal gewone en bulk-endpoints waar ook een sync-endpoint bestaat, is een filter verplicht: een verzoek zonder $filter geeft daar een foutmelding.

Elke dag dezelfde ongewijzigde gegevens opnieuw downloaden noemt Exact als voorbeeld van overmatig gebruik. Dat valt onder de fair use, ook als de app onder de 5.000 blijft.

Voor wijzigingen die snel in de webshop moeten staan, zoals voorraad en leveringen, vervangt een webhook het rondvragen. Een melding die niet aankomt probeert Exact 10 keer opnieuw, verspreid over 34 uur.

Wat betekent dit voor je koppeling?

Wij maken de som voordat de koppeling live gaat: verzoeken per order, verzoeken per ronde, je aantallen op een gewone dag en op je drukste dag. De koppeling leest het saldo uit de headers van elk antwoord, werkt met een wachtrij en een budget per stroom, en laat orders voorgaan op een volledige artikelronde. Wat Exact afkeurt komt op een controlelijst in het dashboard en wordt niet blind opnieuw ingestuurd.

Daarna hosten en bewaken we de koppeling, ook op de dag dat het verbruik de limiet nadert. Alles over stromen, pakketten en mapping staat op Exact Online koppeling met je webshop; de orderstroom zelf op orders, klanten en verzending. Stuur je aantallen en je pakket in, dan hoor je waar het plafond voor jouw administratie ligt.