Om de stabiliteit en beschikbaarheid van Exact Online te garanderen, worden er enkele beperkingen toegepast op de XML-API, afhankelijk van het type aanvraag (Export of Download)
Een veel gestelde vraag betreft download, export, XML-API en Ontwikkelaars
Welke restricties zijn er voor het exporteren en downloaden met de XML-API van Exact Online?
Exporteren / Downloaden
Het downloaden gebeurt in afzonderlijke delen indien het aantal gedownloade entiteiten/records het maximum aantal records van het onderwerp overschrijdt:
- maximaal 100 – 1000 records per aanvraag
- verschilt per XML-onderwerp, bijv. GLTransactions = 100 records, Documents = 1000 records
- neem contact op met de klantenservice voor specifieke limieten per XML-onderwerp
Wanneer een download wordt gedaan, wordt ook het maximum aantal records per onderdeel geretourneerd. Dus in het geval van transacties zal elk onderdeel maximaal 100 transacties bevatten. Als er gegevens worden gevonden, zal elk XML-bestand de tijdstempel van het laatste record bevatten. Deze moet in de URL in de parameter TSPaging worden doorgegeven om de volgende pagina op te halen. Het XML-bestand zal een Topics node bevatten met de huidige tijdstempel, het aantal gevonden records en de paginagrootte die het maximum aantal records per onderdeel is. Het aantal gevonden records is ook een indicatie of er een volgende pagina beschikbaar is: wanneer deze gelijk is aan het paginagrootte-attribuut, is er waarschijnlijk een volgende pagina beschikbaar.
- Tijdstempel paging
- pas de laatst ontvangen tijdstempel om de volgende pagina te krijgen
- als aantal records = paginagrootte >> meer records beschikbaar zijn
- indien tijdstempel = vorige tijdstempel >> geen records meer beschikbaar
Voorbeeld binnen XML-export/download:
<Topics>
<Topiccode=”Documents”ts_d=”0x000000000000b858″count=”1000″ pagesize=”1000″/>
<Topics>
Bron : Welke restricties zijn er voor …
Veel gestelde vragen over Ontwikkelaars
Kort antwoord: de Exact Online XML API is de oudere XML-route voor import en export via onder meer XMLDownload.aspx en XMLUpload.aspx. Voor nieuwe koppelingen is de Exact Online REST API meestal de betere basis, maar XML blijft relevant bij bestaande administraties, legacy imports, migraties en processen die nog op XML-bestanden of vaste topics draaien.
Exact Online XML API of REST API?
Gebruik de Exact Online XML API vooral wanneer je een bestaande XML-koppeling onderhoudt, een oude export/import stroom moet stabiliseren of een migratiepad nodig hebt. Start met de REST API wanneer je een nieuwe webshop-, CRM-, BI- of financekoppeling bouwt en resources via moderne endpoints, OAuth, filtering en beheer wilt aansturen.
| Keuze | Wanneer gebruiken | Beheerpunt |
|---|---|---|
| Exact Online XML API | Legacy XML-import, XML-export, bestaande topics, migratie of tijdelijke overbrugging | Valide XML, topic-keuze, logging, foutbestand en herstelstap |
| Exact Online REST API | Nieuwe API-koppeling voor webshop, CRM, Pipedrive, Power BI, Exact Online data of maatwerksoftware | OAuth, rate limits, scopes, foutwachtrij, retrybeleid en auditlog |
| Hybride route | Bestaande XML-koppeling blijft draaien terwijl nieuwe onderdelen naar REST gaan | Datacontract, bron van waarheid, monitoring en API-beheer |
Wat doet XMLDownload.aspx en XMLUpload.aspx?
XMLDownload.aspx wordt gebruikt om gegevens uit Exact Online als XML op te halen. XMLUpload.aspx wordt gebruikt om XML-gegevens aan te leveren. Daarbij moet je goed vastleggen welk topic, welke administratie, welke authenticatie en welke controles horen bij de koppeling. Zonder monitoring zie je fouten vaak pas wanneer facturen, relaties, boekingen of stamgegevens ontbreken.
Praktische route voor een Exact XML koppeling
- Inventariseer of de bestaande koppeling XMLDownload.aspx, XMLUpload.aspx of beide gebruikt.
- Leg vast welke Exact Online administratie, topic en datavelden leidend zijn.
- Controleer of de koppeling nog XML nodig heeft of naar de Exact Online REST API kan worden gemigreerd.
- Voeg foutwachtrij, retrybeleid en auditlog toe, zodat gemiste imports of exports herstelbaar zijn.
- Maak API-beheer eigenaar van wijzigingen in scopes, credentials, rate limits en datacontracten.
Bronnen en vervolgroutes
Exact publiceert voorbeeldinformatie voor XML-code en aparte REST API-documentatie. Voor een nieuwe koppeling kun je starten bij Exact Online XML code examples, de Exact Online REST API introductie en de REST API reference documentation. Brixxs helpt met Exact Online maatwerk koppelingen, Exact Online specialisten, API-integratie en structureel API-beheer.
Het is de beste manier om te werken met bijna realtime gegevens in uw app. Zodra bijvoorbeeld uw voorraadpositie verandert, weet uw webwinkel dat. Wanneer een GLTransactie wordt verwijderd, worden uw rapporteringstools geüpdatet en zullen ze altijd de juiste cijfers tonen.
Het wordt aanbevolen dat apps in staat zijn om API-aanvragen in de wachtrij te plaatsen. Dit zorgt ervoor dat uw app zich gedraagt binnen de door Exact Online ondersteunde grenzen en dat uw app kan blijven werken, zelfs als de Exact Online API tijdelijk niet beschikbaar is.
Bron:
De oData $batch operatie wordt niet ondersteund voor REST API’s. Het framework accepteert alle geldige oData operaties, inclusief $batch
Als u wilt dat uw app door externe klanten wordt gebruikt, moet u zorgen voor een upgrade naar een productie-applicatie.
Het API-supportteam van Exact Online kan u helpen met problemen op het gebied van authenticatie, API en App Centre. Bekijk de onderstaande taken om te zien hoe u contact kunt opnemen met het API-supportteam.
Bron:
Hoe kan ik openstaande items ophalen met behulp van de Exact Online API?
Kort antwoord: openstaande items of openstaande posten uit Exact Online haal je op via de officiële Exact Online REST API nadat OAuth-autorisatie, administratie/division, rechten en veldmapping goed zijn ingericht. Bouw dit niet als losse API-call, maar als gecontroleerde financiële datastroom met logging, foutafhandeling en beheer.
TL;DR voor besluitvorming: wil je openstaande posten, debiteuren, crediteuren, factuurstatussen of betaalinformatie uit Exact Online gebruiken in een dashboard, klantportaal, CRM, Power BI of workflow? Start met de officiële API-documentatie en bepaal eerst welke administratie, relatie, factuurstatus en rapportagedefinitie leidend is.
Zoek je op Exact Online API openstaande posten, openstaande items Exact Online API, Exact Online API koppeling, Exact Online API documentation of Exact Online API Power BI? Dan gaat het meestal om financiële rapportage of automatisering waarbij datakwaliteit belangrijker is dan alleen snel data ophalen.
Stappenplan voor openstaande items via Exact Online API
- Bepaal de financiële vraag: gaat het om openstaande verkoopfacturen, inkoopfacturen, debiteuren, crediteuren, betaalstatussen of aging?
- Controleer administratie/division: Exact Online werkt per administratiecontext; verkeerde division betekent verkeerde data.
- Richt OAuth veilig in: gebruik de juiste appregistratie, tokens, scopes/rechten en tokenverversing.
- Kies de juiste API-resource: gebruik de actuele Exact Online REST API-documentatie en test eerst met beperkte data.
- Map velden en statussen: leg vast hoe factuurnummer, relatie, bedrag, valuta, vervaldatum, betaaldatum en status worden geïnterpreteerd.
- Bouw foutafhandeling: log API-fouten, time-outs, rate limits, ontbrekende rechten en lege resultaten.
- Voorkom stille afwijkingen: vergelijk periodiek API-output met Exact Online rapportage of financiële controle.
- Borg beheer: wijs een eigenaar aan voor tokens, rechten, alerts, mappings en wijzigingen in Exact Online.
Waar gebruik je openstaande posten uit Exact Online voor?
| Gebruik | Praktisch doel | Belangrijk aandachtspunt |
|---|---|---|
| Power BI of dashboard | Debiteuren, cashflow, aging en openstaande facturen volgen. | Definieer welke factuurstatussen meetellen. |
| CRM of klantportaal | Sales of klanten inzicht geven in betaalstatus. | Toon alleen data waarvoor rechten en context kloppen. |
| Debiteurenbeheer | Automatisch herinneringen, taken of alerts voorbereiden. | Voorkom dubbele acties bij deelbetalingen of correcties. |
| Workflow automation | Openstaande posten verwerken via n8n, Make.com of maatwerk. | Logging, retries en menselijke controle zijn nodig. |
| AI-analyse | Afwijkingen samenvatten of prioriteit voorstellen. | AI mag financiële output niet zonder controle wijzigen. |
Exact Online API: technische aandachtspunten
- OAuth en tokens: tokenverversing moet betrouwbaar zijn, anders valt de koppeling stil.
- Division/administratie: test altijd met de juiste administratiecontext.
- Rate limits en paging: verwerk grotere datasets in batches en controleer of alle pagina’s zijn opgehaald.
- Datums en valuta: leg peildatum, vervaldatum, boekdatum en valuta-conversie expliciet vast.
- Correcties en deelbetalingen: controleer hoe creditnota’s, verrekeningen en gedeeltelijke betalingen worden weergegeven.
- Beheer: documenteer endpoints, velden, filters, credentials, foutcodes en herstelprocedure.
API, Power BI, n8n, Make.com of maatwerk?
Voor een eenmalige analyse kan export of Power BI genoeg zijn. Voor terugkerende financiële processen is een beheerde API-koppeling beter. n8n of Make.com kan helpen bij workflowstappen, maar de financiële kernlogica rond openstaande posten moet zorgvuldig worden gevalideerd.
| Route | Wanneer gebruiken? | Let op |
|---|---|---|
| Power BI | Rapportage en analyse. | Datamodel, refresh en definitie van openstaand bedrag. |
| n8n / Make.com | Alerts, taken, uitzonderingen en workflowstappen. | Credentials, logging en foutpaden. |
| Maatwerk API-koppeling | Klantportalen, debiteurenbeheer, finance dashboards of bedrijfskritische flows. | Validatie, monitoring, retries en beheer. |
| AI-agent | Samenvatten, prioriteren of afwijkingen signaleren. | Menselijke controle bij financiële acties. |
Wanneer schakel je Brixxs in?
Schakel Brixxs in wanneer openstaande items uit Exact Online onderdeel worden van een dashboard, klantportaal, debiteurenproces, CRM-koppeling, Power BI-rapportage of workflow automation. We helpen met API-architectuur, OAuth, datamapping, foutafhandeling, monitoring en beheer, zodat financiële data betrouwbaar blijft.
Praktische vervolgroutes: Exact Online API-koppeling maken, Exact Online specialist, kosten van een Exact Online koppeling, Exact Online koppelen met Power BI, bank koppelen aan Exact Online, API integratie specialist, API koppeling laten maken, workflow automation bureau, n8n bureau, Make.com specialist en wat is API-beheer?.
Officiële bronnen
- Exact Developers
- Exact Online REST API introductie
- Exact Online knowledge base
- OAuth 2.0
- OWASP API Security Top 10
FAQ
Kan ik openstaande posten uit Exact Online ophalen via API?
Ja, mits de juiste administratie, rechten, OAuth-autorisatie en API-resource zijn ingericht. Gebruik altijd de actuele Exact Online API-documentatie en test met beperkte data voordat je live processen koppelt.
Kan ik Exact Online openstaande posten in Power BI tonen?
Ja. Belangrijk is dat je datamodel, refresh, administratiecontext en definitie van openstaande posten goed vastlegt. Anders kunnen rapportages afwijken van wat finance in Exact Online ziet.
Is n8n of Make.com geschikt voor openstaande posten?
Ja, vooral voor alerts, taken en workflowstappen. Voor de financiële kernlogica blijft API-beheer, validatie en logging belangrijk.
Wat is het grootste risico?
Het grootste risico is stille afwijking: verkeerde administratie, ontbrekende rechten, onvolledige paging, foutieve statusinterpretatie of mislukte synchronisatie zonder alert. Daarom hoort monitoring en API-beheer bij elke productiekoppeling.
Bron:
Kort antwoord: Exact Online API-limieten bepalen hoeveel API-calls je per administratie/divisie binnen een tijdvenster kunt doen. Voor een stabiele koppeling moet je daarom niet alleen endpoints bouwen, maar ook rate limiting, wachtrijen, retries, logging en foutafhandeling goed ontwerpen.
TL;DR voor besluitvorming: zie je meldingen rond Exact Online API rate limit, Exact Online API limits of HTTP 429? Stop met blind opnieuw proberen. Meet verbruik per administratie, beperk polling, cache waar mogelijk en werk met gecontroleerde retries en monitoring.
Zoek je op exact online api limits, exact online api rate limit, exact online api rate limits, exact online api status of exact online rate limit? Dan gaat het meestal om dezelfde praktijkvraag: hoe houd je Exact Online-koppelingen betrouwbaar zonder tegen limieten of tijdelijke blokkades aan te lopen?
Welke Exact Online API-limieten zijn belangrijk?
Exact Online werkt met rate limits om de stabiliteit van integraties te beschermen. De exacte limieten en headers kunnen per API, endpoint of situatie verschillen, dus controleer altijd de actuele officiële documentatie. In de praktijk zijn vooral deze onderdelen belangrijk:
- Limiet per tijdvenster: hoeveel requests mogen binnen korte tijd naar dezelfde administratie?
- Daglimiet: hoeveel calls zijn per administratie/divisie beschikbaar voordat requests worden geweigerd?
- HTTP 429: signaal dat je te veel requests doet of te snel opnieuw probeert.
- Rate-limit headers: gebruik headers om resterende ruimte en resetmomenten te monitoren.
- Status en incidenten: combineer eigen monitoring met Exact-statusinformatie en foutlogs.
Waarom lopen Exact-koppelingen tegen limits aan?
- te vaak pollen in plaats van gericht synchroniseren
- geen wachtrij of throttling per administratie gebruiken
- bij fouten oneindig blijven retryen
- te brede dataselecties zonder filters of gewijzigde-sinds logica
- meerdere processen tegelijk op dezelfde administratie laten schieten
- geen monitoring op API-verbruik, foutcodes en retrygedrag
30/60/90-dagen aanpak voor stabiele Exact API-koppelingen
- Dag 1-30: log API-calls, foutcodes, administratie/divisie, endpoint en doorlooptijd per koppeling.
- Dag 31-60: voeg throttling, wachtrijen, backoff, retry-limieten en alerts toe.
- Dag 61-90: optimaliseer dataselecties, cache vaste data, documenteer eigenaar en voeg API-beheer toe.
Deze route voorkomt dat een koppeling alleen werkt op rustige momenten, maar instabiel wordt bij piekbelasting, batchverwerking of meerdere administraties.
Wat moet je doen bij HTTP 429 of rate-limit fouten?
- stop automatische retries zonder wachttijd
- lees rate-limit headers uit en respecteer resetmomenten
- plaats requests in een wachtrij per administratie
- maak onderscheid tussen tijdelijke vertraging en echte datamismatch
- meld bedrijfskritische blokkades aan de proceseigenaar
- laat support-, finance- of orderteams weten welke stromen tijdelijk vertraagd zijn
Bronnen en vervolgstappen
- Exact Online REST API documentatie
- Exact statuspagina
- OWASP API Security Top 10
- Exact Online API koppeling maken
- Exact Online specialist
- API integratie specialist
- Wat is API-beheer?
- Workflow automation bureau
Conclusie
Exact Online API-limieten zijn geen detail voor developers, maar een belangrijk onderdeel van betrouwbare bedrijfsautomatisering. Ontwerp koppelingen met monitoring, throttling, retrybeleid en API-beheer, zodat finance-, order- en backofficeprocessen ook bij piekbelasting blijven werken.
Bron:
Filtering kan worden toegepast op basis van parameters per entiteit. Ga naar Bedrijfsnaam > Importeren/exporteren > Methode > XML > Algemeen > XML Onderwerp Parameters om een lijst met beschikbare parameters te bekijken.nnGa naar Code voorbeelden om te zien hoe u XML-API filters kunt toepassen.
Ga naar Exacte Online REST API – Referentie-informatie om de REST API referentiedocumentatie te bekijken.