Overzicht
Exact Online is het cloudgebaseerde boekhoud- en ERP-platform dat honderdduizenden Nederlandse en Belgische bedrijven gebruiken voor hun financiële administratie, facturering, inkoopbeheer, projectadministratie en CRM. Als één van de dominante bedrijfssoftwareplatforms in Nederland staat Exact Online centraal in de operationele data van veel organisaties.
Voor organisaties die Exact Online draaien als hun financieel systeem van record is integratie tussen Exact Online en de andere systemen die de organisatie gebruikt een veelvoorkomende vereiste. De maatwerk webapplicatie die klantdata moet lezen vanuit Exact Online. Het e-commerceplatform dat automatisch verkoopfacturen moet boeken naar Exact Online. Het operationele hulpmiddel dat inkooporders moet aanmaken in Exact Online wanneer de voorraad onder de drempel valt.
De Exact Online REST API biedt programmatische toegang tot het volledige bereik van Exact Online-data via een goed gestructureerde OAuth 2.0-geauthenticeerde API. Het begrijpen van het divisiemodel van de API — waarbij elk Exact Online-bedrijf wordt geïdentificeerd door een divisienummer dat bij elke API-aanroep moet worden opgenomen — en de OAuth 2.0-stroom die toegang autoriseert tot specifieke bedrijfsaccounts is het fundament voor betrouwbare Exact Online-integraties.
Wij bouwen Exact Online-integraties voor Nederlandse en Belgische bedrijven die hun maatwerk software, operationele tools en webapplicaties moeten verbinden met Exact Online.
Wat Exact Online Integratie Dekt
OAuth 2.0 authenticatie en autorisatie. De Exact Online REST API gebruikt standaard OAuth 2.0 voor authenticatie.
Autorisatiecodestroom: de gebruikersgericht OAuth-stroom voor integraties die Exact Online benaderen namens een specifieke gebruiker of bedrijf. De autorisatie-URL die de gebruiker doorverwijst naar de inlogpagina van Exact Online, het toestemmingsscherm, de autorisatiecode geretourneerd naar de redirect-URI en de tokenuitwisseling.
Toegangstoken vernieuwen: Exact Online-toegangstokens verlopen na 10 minuten — een kortere vervaldatum dan de meeste OAuth-implementaties. De tokenvernieuwingslogica die het vernieuwingstoken gebruikt om een nieuw toegangstoken te verkrijgen voor het huidige verloopt. Het vernieuwingstoken zelf heeft een langere levensduur maar moet binnen 30 dagen na het laatste toegangstoken verzoek worden gebruikt.
Divisie-identificatie: elk Exact Online API-eindpunt bevat het divisienummer in het URL-pad (/api/v1/{division}/...). Het divisienummer identificeert het specifieke Exact Online-bedrijf dat wordt benaderd. Het GET /api/v1/current/Me eindpunt dat de beschikbare divisies van de geauthenticeerde gebruiker retourneert.
Financiële administratie. De kern financiële data die de meeste Exact Online-integraties benaderen.
Grootboekrekeningen: het GET /api/v1/{division}/financial/GLAccounts eindpunt voor het rekeningschema — de rekencodes, beschrijvingen en rekeningtypen. De grootboekrekening opzoeking die de interne rekencodes van de integratie mapt naar de rekencodes van Exact Online.
Journaalboekingen: het POST /api/v1/{division}/financial/TransactionLines eindpunt voor het boeken van grootboekposten naar Exact Online. De transactiestructuur met de journaalcode, de boekingsdatum, de omschrijving, de grootboekrekening, het bedrag en de BTW-code. De gebalanceerde transactie met gelijke debet en creditbedragen.
Financiële perioden: het GET /api/v1/{division}/financial/FinancialPeriods eindpunt voor de open en gesloten financiële perioden. De periodestatus controle die boekingen naar gesloten perioden voorkomt.
BTW-codes: het GET /api/v1/{division}/financial/VATCodes eindpunt voor de BTW-tariefcodes geconfigureerd in de Exact Online administratie. De Nederlandse BTW-tarieven — 21% standaardtarief, 9% verlaagd tarief, 0% voor vrijgestelde en nultarief transacties.
Debiteuren — verkoopfacturen. Verkoopfacturen aanmaken en beheren in Exact Online.
Factuur aanmaken: het POST /api/v1/{division}/salesinvoice/SalesInvoices eindpunt voor het aanmaken van verkoopfacturen. De factuurheader met de account (klant) referentie, de factuurdatum, de betalingstermijnen, de valuta en de factuurregels met de artikelomschrijving, hoeveelheid, eenheidsprijs, BTW-code en grootboekrekening.
Factuur ophalen: het GET /api/v1/{division}/salesinvoice/SalesInvoices eindpunt voor het weergeven van verkoopfacturen met OData-filtering en -sortering.
Factuurstatus: de factuurstatuswaarden — 10 (Concept), 20 (Open), 50 (Verwerkt/Gesloten).
Creditnota's: het POST /api/v1/{division}/salesinvoice/SalesInvoices eindpunt met een negatief totaalbedrag voor het aanmaken van creditnota's.
Crediteuren — inkoopfacturen. Inkoopfacturen ontvangen en beheren van leveranciers.
Inkoopfactuur aanmaken: het POST /api/v1/{division}/purchaseinvoice/PurchaseInvoices eindpunt voor het registreren van inkoopfacturen van leveranciers.
Inkoopfactuur ophalen: het GET /api/v1/{division}/purchaseinvoice/PurchaseInvoices eindpunt voor het weergeven van inkoopfacturen met OData-filtering.
Accounts — klanten en leveranciers. Het klant- en leveranciersstamdata beheren in Exact Online.
Account aanmaken: het POST /api/v1/{division}/crm/Accounts eindpunt voor het aanmaken van nieuwe klant- of leveranciersaccounts. De accountrecord met de naam, het adres, het BTW-nummer, het KvK-nummer, de betalingstermijnen en de accountclassificatie.
Account ophalen: het GET /api/v1/{division}/crm/Accounts eindpunt voor het opvragen van accounts met OData-filtering. Zoeken op naam, e-mail, BTW-nummer, KvK-nummer of accountcode.
Account updates: het PUT /api/v1/{division}/crm/Accounts(guid) eindpunt voor het bijwerken van accountstamdata.
Contactpersonen: het GET /api/v1/{division}/crm/Contacts eindpunt voor de contactpersonen gekoppeld aan accounts.
Artikelen en voorraad. Product en voorraad stamdata.
Artikel ophalen: het GET /api/v1/{division}/logistics/Items eindpunt voor de productcatalogus — de artikelcodes, omschrijvingen, verkoopprijzen, inkoopprijzen en de grootboekrekeningen.
Voorraadposities: het GET /api/v1/{division}/inventory/ItemWarehouses eindpunt voor de huidige voorraadhoeveelheden per artikel per magazijn.
Goederenontvangst: het POST /api/v1/{division}/inventory/GoodsDeliveries eindpunt voor het registreren van voorraadmutaties.
Projecten. Projectdata voor organisaties die de projectadministratiemodule van Exact Online gebruiken.
Project ophalen: het GET /api/v1/{division}/project/Projects eindpunt voor de projectlijst met filtering op status, verantwoordelijke medewerker en datumbereik.
Uren registratie: het POST /api/v1/{division}/project/TimeTransactions eindpunt voor het indienen van medewerkersuren tegen projecten.
Projectfacturering: de GET /api/v1/{division}/project/ProjectPlanning en gerelateerde eindpunten voor projectfactureringsdata.
OData querying. De Exact Online REST API gebruikt OData-conventies voor het filteren, selecteren en pagineren van data.
OData filters: de $filter queryparameter met OData filterexpressies — $filter=Modified gt datetime'2024-01-01T00:00:00' voor delta-synchronisatie op wijzigingsdatum, $filter=Status eq 20 voor open facturen.
Veld selectie: de $select parameter die alleen specifieke velden van de API aanvraagt, waardoor de responsPayload grootte wordt verminderd.
Paginering: de $top en $skip parameters voor handmatige paginering en de @odata.nextLink URL in de respons voor de volgende pagina. De standaard paginagrootte van typisch 60 records per pagina.
Sortering: de $orderby parameter voor het sorteren van resultaten.
Delta-synchronisatie. De meeste Exact Online-integraties moeten data incrementeel synchroniseren.
Gewijzigde tijdstempelfiltering: de meeste Exact Online-entiteiten stellen een Modified veld bloot dat de laatste wijzigingstijdstempel registreert. De delta-synchronisatie die API-queries filtert om alleen records op te halen die zijn gewijzigd sinds de laatste synchronisatierun.
Webhooks: Exact Online biedt een webhookmechanisme dat externe applicaties kan notificeren van wijzigingen aan specifieke datatypen. De webhookabonnementconfiguratie in de Exact Online-administratie die HTTP POST-notificaties triggert naar het webhook-eindpunt van de integratie.
Integratiepatronen
Geplande financiële datasynchronisatie. Het meest voorkomende Exact Online-integratiepatroon — een geplande taak die met gedefinieerde intervallen draait, Exact Online bevraagt voor wijzigingen en de wijzigingen toepast op het verbonden systeem.
Event-gedreven boeken. Het operationele systeem dat transacties boekt naar Exact Online als reactie op bedrijfsevents — de e-commerceorder die een verkoopfactuur aanmaakt in Exact Online bij voltooiing.
Read-through rapportage. Het rapportagedashboard dat de financiële data van Exact Online in realtime bevraagt voor managementrapporten en cashflowdashboards.
Bidirectionele stamdata synchronisatie. De integratie die klant- en leveranciersstamdata consistent houdt tussen Exact Online en CRM, e-commerce of andere systemen.
Gebruikte Technologieën
- C# / ASP.NET Core — primaire Exact Online integratie implementatie, gebruikmakend van de .NET HTTP-client en de officiële Exact Online .NET SDK waar van toepassing
- Rust / Axum — hoge-prestatie Exact Online dataverwerking voor integraties met grote datavolumes
- TypeScript / Node.js — Exact Online integratie voor JavaScript-gebaseerde e-commerceplatforms en operationele tools
- OAuth 2.0 — Exact Online API-authenticatie met 10-minuten toegangstoken beheer
- REST / HTTP / OData — Exact Online REST API met OData queryconventies
- SQL (PostgreSQL / MySQL) — synchronisatiestatus, lokale datacaching, delta-tracking
- Redis — toegangstoken caching, synchronisatietaakcoördinatie
- Hangfire / geplande taken — geplande synchronisatie voor financiële data, facturen en stamdata
- Webhooks — event-gedreven synchronisatie via Exact Online webhook-notificaties
- Docker — gecontaineriseerde integratiedienst implementatie
- GitHub Actions — CI/CD pijplijn voor integratiedienst implementatie
Exact Online Integratie in de Nederlandse Bedrijfscontext
De dominante positie van Exact Online in Nederlandse MKB-financiële administratie betekent dat Exact Online-integratie een bijna-universele vereiste is voor maatwerk software gebouwd voor Nederlandse bedrijven. De e-commerceoperatie die verkoopfacturen automatisch naar Exact Online moet laten stromen zonder handmatige invoer. De veldserviceapplicatie die taakvoltooiingsrecords naar Exact Online-projectadministratie moet boeken. Het leveranciersportaal dat leveranciersdata moet verifiëren tegen het crediteurenstamdata van Exact Online.
In elk geval hebben de specifieke Exact Online-datadomeinen — financiële accounts, facturen, contacten, artikelen, projecten — goed gedefinieerde API-eindpunten die de integratie gebruikt. De OAuth-authenticatie, het divisiemodel, de OData-queryconventies en het 10-minuten toegangstoken beheer zijn de integratie-niveau details die specifieke kennis van het API-gedrag van Exact Online vereisen voor betrouwbare productie-integratie.
Verbonden met Exact Online, Werkend voor Uw Bedrijf
Exact Online-integraties gebouwd op productiestandaarden — correct OAuth 2.0 tokenbeheer met 10-minuten vervaldatumafhandeling, robuuste OData-queryconstructie, incrementele delta-synchronisatie, webhook-getriggerde updates en de monitoring die integratieproblemen oppervlakt voor ze financiële operaties beïnvloeden — houden uw systemen betrouwbaar verbonden met Exact Online in plaats van handmatige reconciliatie te vereisen.