Samenvatting
De invoering van rate limits op Exact Online in 2016 zal op korte termijn leiden tot storingen bij alle op Invantive SQL gebaseerde installaties. Deze notitie beschrijft het concept, de ondersteuning van rate limits door Invantive en de oorzaak van de dreigende storing. Gebruikers worden dringend verzocht te upgraden zodra hun omgeving dit toelaat, om een productiestop te voorkomen.
Op zoek naar Exact Online rate limits in 2021?
Voor de rate limits van 2021 verwijzen we u naar Itgeneor192/itgeneor229 Exact Online: no remaining capacity - 2 van forums (Nederlands).
Rate Limits
Het aantal API-aanroepen op Exact Online is de afgelopen jaren aanzienlijk toegenomen, ondanks inspanningen van grote afnemers om hun verkeer te verminderen en de introductie van nieuwe API’s zoals de bulk-API’s voor initiële belading. Deze compenseren een aantal slecht ontworpen API’s die frequente kleine aanroepen vereisen, zoals itemprijzen.
Naar verluidt worden er dagelijks meer dan 15 miljoen aanroepen gedaan. Om een meer gelijk speelveld te creëren, kondigde Exact in november 2017 aan dat zij API rate limits zouden invoeren om het dagelijkse maximumaantal aanroepen per combinatie van applicatie (geïdentificeerd door client-ID) en bedrijf te beperken tot 5.000. Boven dit volume kunnen geen aanroepen meer worden gedaan. Dit project lag stil vanwege stabiliteitsproblemen bij de implementatie.
Momenteel activeert Exact de rate limits in zijn gehele gebruikersbestand, beginnend met een rate limit van 500.000 aanroepen per dag per combinatie van applicatie en bedrijf. De officieel gepubliceerde verklaring van Exact Online is dat deze rate limits weer zullen worden teruggebracht naar 5.000 aanroepen per dag, tenzij er een uitzondering is overeengekomen.
Details over de daadwerkelijke implementatie en de dagelijkse rate limits zijn beschikbaar in de Exact Online API-documentatie.
Naast deze wijzigingen worden er ook een aantal beveiligingsgerelateerde aanpassingen doorgevoerd die, afhankelijk van uw configuratie, wijzigingen kunnen vereisen. Neem voor hulp contact op met uw lokale dealer.
Ondersteuning van Invantive voor Rate Limits
Invantive heeft haar softwareproducten in 2017 al conform deze rate limits en specificaties gemaakt. De oorspronkelijke plannen worden beschreven in Keep your lane on Exact Online.
Sterker nog, Invantive SQL maakt gebruik van een aantal geavanceerde functies om het aantal API-aanroepen met minstens één en soms twee ordegroottes te verminderen ten opzichte van concurrenten. Producten zoals Invantive Data Replicator voor massale replicatie van bedrijven maken eveneens gebruik van geavanceerde technieken zoals zelf-afstemmende webhooks (auto-tuning webhooks) en slimme steekproeven (smart sampling) om de prestaties verder te verbeteren en de belasting van het Exact Online API-systeem te verminderen.
Deze prestatiewinst van Invantive SQL met Exact Online geldt ook voor insert-, update- en delete-bewerkingen. Voorbeelden hiervan zijn te vinden in bijvoorbeeld Does Invantive SQL match the speed of Infinite Probability Drive, maar over het algemeen levert het enkel toevoegen van het sleutelwoord bulk vóór bijvoorbeeld insert into al een snelheidswinst op, gecombineerd met een vermindering van het aantal API-aanroepen per dag.
Storing op komst
Echter: de huidige daadwerkelijke implementatie van de rate limits door Exact wijkt op een essentieel punt af van de specificaties, waardoor ALLE installaties van Invantive de komende dagen bij eerstvolgend gebruik zullen falen.
De API-gateway retourneert de datum en tijd waarop het aantal resterende API-aanroepen zal worden teruggezet naar het dagelijkse toegestane aantal. De bijbehorende UNIX epoch time die wordt teruggegeven in de HTTP-header X-RateLimit-Reset is echter in milliseconden in plaats van de seconden zoals beschreven in de specificatie. Als bedrijf met mensen die hun oorsprong vinden in regelgevende en operationele rapportage, bevat onze software talrijke applicatiecontroles om de consistentie van gegevens te waarborgen (uiteraard proberen we ook zorg te dragen voor veiligheid en beschikbaarheid). Daarom controleerden alle releases of het reset-moment in UNIX epoch time binnen de toegestane waardereeks lag, en zouden anders falen met een foutmelding zoals (afkomstig uit onze gratis tool om wisselkoersen te laden in Exact Online bedrijven):
Deze fatale fout zal zich ergens de komende dagen voordoen wanneer u uw Invantive softwareproducten niet upgradet vóór gebruik.
U kunt uw softwareversie controleren op correcte verwerking van de rate limits door de nieuwe view RateLimits te bevragen. RateLimits toont per divisie de verbruikte aanroepen, beschikbare aanroepen en het reset-moment, zoals:
Zoals op deze afbeelding te zien is, hebben nog niet alle bedrijven en apps rate limits toegepast gekregen. Bovendien worden alleen van Exact Online-bedrijven waarop een aanroep is uitgevoerd de statistieken weergegeven.
Upgrades beschikbaar
Er is een nieuwe softwareversie van Invantive-merkproducten beschikbaar binnen abonnementen die na 1 januari doorlopen. Als uw abonnement niet doorloopt na 1 januari, neem dan contact op met Exact Support om een uitzondering voor API rate limits aan te vragen.
Consultancy om uw scripts, rapporten en configuraties compatibel te maken, kan worden afgenomen via onze dealers en Invantive op basis van Time & Material-tarieven en beschikbaarheid.
De momenteel aanbevolen softwareversies zijn:
- Invantive Control for Excel
- Invantive Composition for Word
- Invantive Business FTP Server
- Invantive Data Loader
- Invantive Query Tool
- Invantive Data Hub (ook voor Invantive Data Replicator)
- Invantive Studio
- Invantive Producer Runtime
- Invantive Business for Outlook
- Invantive Business for Windows
- Alle gebruikers van Invantive BusinessDrive en Invantive Data Access Point hebben al een upgrade uitgevoerd.
- Get My Report for Exact Online is al geüpgraded.
- Valuta Tools voor het laden van wisselkoersen is al geüpgraded.
- De problemen met Exact Online rate limits hebben geen invloed op gebruikers van Invantive Estate, Invantive Vision of andere platforms zoals Company.info of Teamleader.
Bijgewerkte overeenkomstsleutels kunnen worden verkregen door te bellen naar +31880026599.
De supportcapaciteit is beperkt, plan uw upgrade dus tijdig in en houd rekening met een doorlooptijd van maximaal 5 werkdagen voor de afhandeling van supportverzoeken in de komende weken.
Releasenotes zijn beschikbaar op https://releasenotes.invantive.com. Updates op deze releases worden aangekondigd in de bètasectie van releasenotes.invantive.com en op Twitter.
De uitgebrachte versies zijn bèta’s van de release 17.30, gepland voor de eerste week van januari. Momenteel zijn er slechts enkele bekende problemen hierin die ervoor zorgen dat eerder werkende configuraties falen met deze nieuwe versie.

