Boekhouding & administratie

Business Central-koppeling laten maken

Ik koppel Microsoft Dynamics 365 Business Central aan je webshop, CRM, betaalprovider, scan-app of eigen software via de REST API v2.0. Klanten, artikelen, orders, facturen en betalingen gaan heen en weer, met een app in je eigen Microsoft Entra-tenant en webhooks waar Business Central ze biedt. Draait je koppeling nog op SOAP of OData op een pagina van Microsoft, dan zet ik hem om: SOAP op die pagina’s is sinds versie 29 weg en OData volgt in versie 30.

Alle integraties

Zo loopt de data

voorbeeldopzet

Sync-log, zoals je hem in het logboek terugziet (voorbeeld)

Bestellingen uit de webshop worden verkooporders, betalingen van de betaalprovider komen in het betalingsdagboek, klanten blijven gelijk met het CRM en facturen en artikelen gaan naar je eigen software.
  • Order, wordt Verkooporder: van Webshop naar Microsoft Dynamics 365 Business Central, direct, via webhook.
  • Betaling, wordt Dagboek: van Betaalprovider naar Microsoft Dynamics 365 Business Central, direct, via webhook.
  • Klant: tussen CRM en Microsoft Dynamics 365 Business Central, in beide richtingen, direct, via webhook.
  • Factuur, Artikel: van Microsoft Dynamics 365 Business Central naar Eigen software, direct, via webhook.

Kort antwoord

Werkgebied: Nederland · Bijgewerkt op door Alisina Nawabi

Wat het is
Een Business Central-koppeling verbindt Business Central online met je andere systemen via de REST API v2.0, op OData V4. Klanten, leveranciers, artikelen, verkoop- en inkoopdocumenten, dagboeken en betalingen zijn te lezen en te schrijven, met webhooks voor wijzigingen. De koppeling meldt zich aan via OAuth met een app in je eigen Microsoft Entra-tenant.
Voor wie
Bedrijven op Business Central online met een webshop, CRM, betaalprovider, scan-app of eigen software ernaast, en softwarebedrijven die Business Central in hun product of met een app in de Microsoft Marketplace willen ondersteunen.
Doorlooptijd
Een eerste koppeling tussen twee systemen staat meestal binnen 2 weken live. Meer objecten, richtingen of administraties kosten meer tijd; dat staat vooraf in de offerte.
Prijsindicatie
vanaf €4.000 voor een basisopzetEen basisopzet is één koppeling tussen twee systemen, gebouwd, getest en gedocumenteerd. Meer objecten, richtingen, administraties of uitzonderingen maken het groter. Je krijgt vooraf een vaste prijs.

Welke data synchroniseer ik?

Zo richt ik het meestal in. De tabel is ook het startpunt van de intake: jij bepaalt per object de richting en de bron.

Welke data de koppeling synchroniseert, in welke richting, wie de bron is en hoe vaak
ObjectRichtingBron van waarheidFrequentie
Klanten en contactpersonenContactpersonen hebben geen webhook; die haal ik op met een filter op lastModifiedDateTime.beide kantenCRM of Business Central, per veld afgesprokenDirect via een webhook, plus een nachtelijke controle
Artikelen en prijzenvan Microsoft Dynamics 365 Business CentralBusiness CentralDirect via een webhook
VerkoopordersEen order met regels gaat in één aanroep.naar Microsoft Dynamics 365 Business CentralWebshop of CRMDirect
Verkoopfacturen en creditnota’svan Microsoft Dynamics 365 Business CentralBusiness CentralNa boeking, via een webhook
Klantbetalingennaar Microsoft Dynamics 365 Business CentralBetaalprovider of bankPer betaling
InkoopfacturenBoeken gaat met de actie post, na controle.naar Microsoft Dynamics 365 Business CentralScan- of inkoopsysteemPer factuur
GrootboekpostenAlleen lezen.van Microsoft Dynamics 365 Business CentralBusiness CentralDagelijks

Wat je met een Microsoft Dynamics 365 Business Central-koppeling doet

Voor bedrijven die zelf met de software werken, en voor wie er een product op bouwt voor eigen klanten.

  1. Webshoporders als verkooporder in Business Central

    Webwinkel op Shopify of WooCommerce met Business Central als ERP

    1. Bestelling binnen in de webshop
    2. Klant gevonden of aangemaakt
    3. Verkooporder met regels in één aanroep
    4. Verzenden en factureren met shipAndInvoice

    Elke bestelling staat meteen goed in Business Central, zonder overtypen en zonder dubbele klanten.

    Wat de API hiervoor biedt: Klanten en verkooporders zijn via API v2.0 aan te maken, een order met zijn regels in één aanroep. De verkooporder kent de actie shipAndInvoice. Voor Shopify heeft Business Central zelf de Shopify Connector, bij nieuwe aanmeldingen al geïnstalleerd, die Shopify-orders als verkooporder kan aanmaken; maatwerk past bij WooCommerce, of als die connector niet doet wat je nodig hebt.

  2. Betalingen uit je betaalprovider klaar in het dagboek

    Webwinkel of dienstverlener met Mollie, Stripe of een bankfeed

    1. Betaling ontvangen bij de betaalprovider
    2. Klant en factuurnummer erbij gezocht
    3. Regel in het betalingsdagboek van Business Central
    4. Financiële administratie controleert en boekt

    Betalingen staan klaar bij de juiste klant, zonder ze één voor één over te nemen.

    Wat de API hiervoor biedt: Klantbetalingen zijn via API v2.0 aan te maken in een betalingsdagboek, en webhooks melden wijzigingen op dat dagboek.

    Lees de uitwerking in de gids
  3. Inkoopfacturen uit je scan- of AI-tool

    Bedrijf dat inkoopfacturen digitaal laat uitlezen

    1. Factuur uitgelezen in de scan- of AI-tool
    2. Leverancier gevonden of aangemaakt
    3. Inkoopfactuur met regels in Business Central
    4. Na controle geboekt met de actie post

    Inkoopfacturen staan met de juiste leverancier en regels klaar; een mens boekt ze.

    Wat de API hiervoor biedt: Leveranciers en inkoopfacturen zijn via API v2.0 te lezen en aan te maken, en een inkoopfactuur kent de actie post.

    Lees de uitwerking in de gids
  4. Een SOAP- of paginakoppeling naar de API

    Bedrijf met een oudere Business Central-koppeling

    1. Koppelingen op SOAP en op Microsoft-pagina’s in kaart
    2. Per koppeling de endpoints van API v2.0 bepaald
    3. Een eigen API-pagina waar de standaard-API tekortschiet
    4. Getest in een sandbox met een kopie van productie

    Geen koppeling die stilvalt bij de update van april 2027.

    Wat de API hiervoor biedt: Een pagina van Microsoft werkt sinds versie 29 niet meer als SOAP-endpoint, en vanaf versie 30 ook niet meer als OData-endpoint. Extra velden kan de standaard-API niet; daarvoor publiceer je een eigen API.

    Lees de uitwerking in de gids

Wat de API van Microsoft Dynamics 365 Business Central ondersteunt

Per object wat er via de API kan. Dit bepaalt wat een koppeling wel en niet kan doen.

Per object: lezen, aanmaken, wijzigen, verwijderen en webhook-ondersteuning in de Microsoft Dynamics 365 Business Central-API
ObjectLezenAanmakenWijzigenVerwijderenWebhook
KlantencustomersZoals alle resources onder een bedrijf: /companies({id})/customers.jajajajaja
Leveranciersvendorsjajajajaja
Artikelenitemsjajajajaja
ContactpersonencontactsStaat niet in de lijst met webhook-entiteiten.jajajajanee
VerkoopoffertessalesQuotesMet regels in één aanroep.jajajajaja
VerkooporderssalesOrdersMet de actie shipAndInvoice.jajajajaja
VerkoopfacturensalesInvoicesMet acties zoals boeken, versturen en annuleren.jajajajaja
Verkoopcreditnota’ssalesCreditMemosjajajajaja
InkooporderspurchaseOrdersStaat niet in de lijst met webhook-entiteiten.jajajajanee
InkoopfacturenpurchaseInvoicesMet de actie post.jajajajaja
Dagboekregelsjournals/journalLinesDe webhook geldt voor het dagboek, niet per regel.jajajajadeels
KlantbetalingencustomerPaymentJournals/customerPaymentsDe webhook geldt voor het betalingsdagboek.jajajajadeels
GrootboekpostengeneralLedgerEntriesAlleen lezen.janeeneeneeja
GrootboekrekeningenaccountsAlleen lezen.janeeneeneeja
Werknemersemployeesjajajajaja
BedrijvencompaniesAlleen lezen; een tenant kan meerdere bedrijven hebben.janeeneeneenee

ja kan via de APIdeels kan met beperkingennee kan niet

Techniek en deadlines

De feiten waar een koppeling op rust, met de bron erbij. En wat er de komende tijd verandert.

API
REST API v2.0 op OData V4, via api.businesscentral.dynamics.com met de naam van de omgeving en het bedrijf in het pad. De standaard-API’s staan online standaard aan en krijgen maandelijks updates. Extra velden kan de standaard-API niet; daarvoor publiceer je een eigen API-pagina.
Authenticatie
OAuth 2.0 via Microsoft Entra ID. Voor onbewaakte koppelingen client credentials met de scope API.ReadWrite.All, met een app die je in je eigen Entra-tenant registreert en in Business Central toelaat op de pagina Microsoft Entra-toepassingen. De machtigingenset SUPER kan een app niet krijgen.
Licenties
Het app-account zelf heeft volgens Microsoft geen licentie nodig. De Licensing Guide zegt wel dat je eigen medewerkers en andere interne gebruikers die via zo’n koppeling gegevens invoeren, opvragen of bekijken, een licentie moeten hebben; externe gebruikers, zoals klanten in je webshop, hebben er geen nodig. Volgens de Nederlandse prijspagina kost Essentials € 69,30 en Premium € 95,30 per gebruiker per maand, jaarlijks betaald, exclusief btw.
Limieten
Per gebruiker 6.000 OData-aanroepen in een schuivend venster van 5 minuten, 5 tegelijk, hoogstens 100 verbindingen en een wachtrij van 95; daarboven volgt 429. Voor apps gelden dezelfde limieten. Een pagina geeft hoogstens 20.000 records en een $batch hoogstens 100 bewerkingen. Over de time-out verschillen de pagina’s: 8 minuten met 408, of 10 minuten met 504.
Limieten per gebruiker
De limieten per gebruiker vervingen vanaf eind december 2023 de limieten per omgeving: 300 aanroepen per minuut voor een sandbox en 600 voor productie.
Webhooks
Abonnementen op onder meer klanten, leveranciers, artikelen, verkoopdocumenten, inkoopfacturen en grootboekposten, hoogstens 200. Ze verlopen na drie dagen en verleng je met een PATCH. Een melding volgt standaard na 30 seconden en draagt geen handtekening, alleen een eigen clientState. Bij een fout probeert Business Central het 36 uur opnieuw, maar alleen na 408, 429 of een 5xx; elke andere foutcode verwijdert het abonnement.
Omgevingen
Essentials en Premium hebben één productieomgeving en drie sandboxen zonder meerprijs. Een sandbox kan starten met een kopie van productie, maar draait op een andere prestatiestand.
Versies
Twee grote updates per jaar, in april en oktober, en online verplicht. Versie 29 kwam in oktober 2026.
SOAP
Volgens de lijst met verouderde functies is SOAP verouderd sinds 2021 release wave 1; de pagina met operationele limieten spreekt nog van verouderen in de toekomst. Een einddatum voor SOAP als geheel noemt Microsoft niet. Pagina’s van Microsoft als SOAP-endpoint zijn sinds versie 29 wel al weg.
Hosting
Nederlandse omgevingen draaien in de Azure-geografie Europa. De EU Data Boundary geldt voor Dynamics 365 alleen als de tenant en alle omgevingen in de regio EU en EVA staan en het factuuradres in een EU Data Boundary-land ligt.
MCP
Een officiële MCP-server op mcp.businesscentral.dynamics.com, algemeen beschikbaar sinds 1 april 2026 en standaard alleen-lezen. De Data Query Tools heten op de overzichtspagina nog preview, maar in de notities van versie 29 algemeen beschikbaar.
Nederland
De Nederlandse versie levert een XAF-auditbestand, elektronische btw- en ICP-aangifte via Digipoort en SEPA-betalingen.

Deadlines en wijzigingen

Wat de leverancier heeft aangekondigd, en wat het voor een bestaande koppeling betekent.

  1. al ingegaan

    Basic auth met toegangssleutels gestopt

    Online werkt alleen OAuth nog. Eén ontwikkelpagina noemt basic auth nog voor verkennen, maar de lijst met verdwenen functies zegt dat een koppeling met een toegangssleutel na 1 oktober 2022 niet meer werkt.

  2. al ingegaan

    API v1.0 verwijderd (versie 28)

    Alleen API v2.0 werkt nog, en die bevat alles uit v1.0. De referentie van v1.0 staat nog online, maar de lijst met verouderde functies noemt v1.0 verwijderd in update 28.0.

  3. al ingegaan

    Pagina’s van Microsoft niet meer als SOAP-endpoint (versie 29)

    Sinds versie 29 werkt SOAP op pagina’s van Microsoft niet meer. Een koppeling die zo’n pagina gebruikte, moet naar de API of naar een eigen pagina.

  4. komt eraan

    Pagina’s van Microsoft niet meer als OData-endpoint (versie 30)

    Vanaf versie 30, de update van 2027 release wave 1, kun je een pagina van Microsoft niet meer als OData-endpoint publiceren. Een koppeling daarop moet naar de standaard-API of naar een eigen pagina in een extensie.

  5. komt eraan

    Extensies uploaden via Extensiebeheer stopt

    Per-tenant-extensies installeer je dan via het beheercentrum of zijn API, niet meer via de pagina Extensiebeheer of het extensionUpload-endpoint van de Automation API.

App, iPaaS of maatwerk?

Niet elke koppeling hoeft maatwerk te zijn. Zo kies je de route die past.

Een app uit de Microsoft Marketplace

Past als: Voor Shopify heeft Business Central zelf de Shopify Connector. Voor andere gangbare webshops, betaalproviders en banken bestaan vaak al Business Central-apps in de Marketplace.

Grens: Je volgt de logica van de app. Een app is ook een extensie in je omgeving, die mee moet met de updates van april en oktober.

Zapier, Make of n8n

Past als: Voor een losse melding of een eenvoudige stap, zoals een seintje bij een nieuwe klant.

Grens: Ook een iPaaS valt onder de limiet van 6.000 aanroepen per 5 minuten en moet webhooks elke drie dagen verlengen. Voor orders, betalingen en boekingen is een losse flow kwetsbaar.

Maatwerk op API v2.0

Past als: Als orders, betalingen en facturen precies moeten kloppen, als je van SOAP of OData op Microsoft-pagina’s af moet, of als je Business Central in je eigen product inbouwt.

Grens: Een hogere eenmalige investering dan een app, en iemand moet de koppeling bijhouden bij de updates van april en oktober. Dat kan ik zijn, maar het hoeft niet.

Standaard-app, iPaaS of maatwerk voor Microsoft Dynamics 365 Business Central?

Bestaat er al een app in de marktplaats die precies doet wat je met Microsoft Dynamics 365 Business Central wilt?

Zo pak ik het aan

Vier stappen, met een vaste prijs vooraf. Een basisopzet begint vanaf €4.000.

  1. 1

    Dag 1

    Intake

    Een kort gesprek over je systemen, je proces en wat er misgaat. Ik vul samen met jou de sync-tabel in: welk object, welke richting, wie de bron is en hoe vaak.

  2. 2

    Binnen een paar dagen

    Vaste offerte

    Je krijgt een voorstel met scope, vaste prijs en planning. Geen uurtje-factuurtje: je weet vooraf wat het kost en wat je krijgt.

  3. 3

    Week 1-2

    Bouwen en testen

    Ik bouw de koppeling op jouw eigen account en test met echte voorbeelden, inclusief de randgevallen: creditnota's, dubbele records, een API die even niet antwoordt. Een eerste koppeling staat binnen 2 weken live.

  4. 4

    Daarna

    Live en beheer

    De koppeling gaat live met monitoring en een foutenlijst die je kunt inzien. Je krijgt documentatie en een overdracht. Onderhoud kan, maar hoeft niet bij mij.

Veilig, en van jou

Hoe ik met je toegang omga, en waarom de koppeling op jouw account draait.

Ik vraag nooit om je Business Central-wachtwoord.

  • De koppeling meldt zich aan als app in je eigen Entra-tenant, met alleen de machtigingensets die nodig zijn en nooit SUPER. Jij kunt de toegang van de app op elk moment intrekken.
  • Een webhookmelding controleer ik op de geheime clientState, en de gegevens haal ik daarna zelf op. Een vervalste melding doet dus niets.
  • Gegevens gaan rechtstreeks tussen jouw systemen en Business Central, zonder omweg via derden.
  • Ik bouw en test in een sandbox, desnoods met een kopie van productie, nooit eerst in productie.

Wie beheert de koppeling

De koppeling draait op jouw account, niet op dat van mij. Ik bouw, documenteer en onderhoud hem; jij houdt het eigendom en de toegang.

Account
De koppeling draait op een app-registratie in jouw eigen Microsoft Entra-tenant, die je in Business Central toelaat op de pagina Microsoft Entra-toepassingen, met eigen machtigingensets. Licenties en omgevingen staan op jouw naam.
Sleutels
Client ID en clientgeheim of certificaat staan in jouw omgeving. Jij kunt de app in Entra of in Business Central op elk moment intrekken; de koppeling stopt dan meteen.
Goedkeuring door de leverancier
Wil je als softwarebedrijf een app in de Microsoft Marketplace, dan moet die door de technische validatie van Microsoft, op naam van jouw uitgeversaccount. Ik bereid dat met je voor; ik publiceer niets op mijn eigen naam.
  • Jouw account en jouw app-registratie bij de leverancier. Ik verkoop geen eigen koppel-abonnement en zit er niet tussen.
  • Jij bent eigenaar van de code en de documentatie. Stop je met mij, dan kan een andere ontwikkelaar verder.
  • Bouw je zelf een product voor jouw klanten? Dan draait het op jouw toegang en, waar de leverancier dat vraagt, op jouw certificering.

Onderhoud en monitoring

Een koppeling is pas af als je merkt dat er iets misgaat voordat je klant het merkt.

Foutenlijst met herkansing
Wat niet lukt, verdwijnt niet. Het komt in een wachtrij met de reden erbij en wordt opnieuw geprobeerd, met steeds langere tussenpozen.
Geen dubbele of gemiste records
Elke boeking krijgt een vaste sleutel, zodat een herhaalde poging nooit een tweede factuur of order maakt.
Alarm bij stilte
Komt er een tijd geen data binnen terwijl dat wel zou moeten, dan krijg je een melding. Een stilgevallen koppeling merk je zo voordat je klant belt.
Logboek
Per record zie je wanneer het ging, wat er ging en wat het andere systeem antwoordde. Handig voor je boekhouder en voor jezelf.
Webhooks op tijd verlengd
Een webhookabonnement van Business Central verloopt na drie dagen. De koppeling verlengt het ruim op tijd en maakt een nieuw abonnement als Business Central er een heeft verwijderd.
Mee met april en oktober
Business Central krijgt twee verplichte grote updates per jaar. Ik test de koppeling in een sandbox met de nieuwe versie voordat productie overgaat.
Binnen de limieten per gebruiker
Ik bundel aanroepen met $batch en een order met regels in één keer, haal alleen op wat sinds lastModifiedDateTime veranderde en wacht netjes bij een 429.
Van pagina’s naar API’s
SOAP op pagina’s van Microsoft is al weg en OData volgt in versie 30. Ik bouw op API v2.0 of een eigen API-pagina, nooit op een pagina van Microsoft.

Verder lezen

Mijn gidsen en artikelen die dieper ingaan op Microsoft Dynamics 365 Business Central.

Cash application automatiseren: remittances matchen en uitzonderingen vrijgeven
Gids
Uitgebreide gids20 min

10 okt 17:00

Cash application automatiseren: remittances matchen en uitzonderingen vrijgeven

Leer hoe je bank- en PSP-betalingen met remittance-informatie veilig koppelt aan openstaande facturen, deel- en overbetalingen apart behandelt en pas na menselijke controle in Exact Online, AFAS of een ander ERP aflettert.

Twee PSP’s koppelen aan één ERP: van routing tot menselijke vrijgave
Gids
Uitgebreide gids18 min

15 okt 09:00

Twee PSP’s koppelen aan één ERP: van routing tot menselijke vrijgave

Twee PSP’s koppelen aan één ERP vraagt meer dan twee API’s. Bouw één canoniek transactiedossier voor routing, provider-ID’s, payouts, fees, refunds en chargebacks, met beperkte ERP-writes en menselijke vrijgave voor uitzonderingen.

Factuurplatform kiezen: test 3-way match en vrijgave
Gids
Uitgebreide gids15 min

27 okt 09:00

Factuurplatform kiezen: test 3-way match en vrijgave

Vergelijk een boekhoudpakket, gespecialiseerde matchlaag en maatwerk met dezelfde gedeeltelijk gematchte factuur. Test bewijs, eigenaar, menselijke vrijgave, boeking en read-back voordat je koopt.

Legacy ERP koppelen zonder API: route kiezen en herstellen
Gids
Uitgebreide gids18 min

16 okt 17:00

Legacy ERP koppelen zonder API: route kiezen en herstellen

Een legacy ERP zonder publieke API hoeft geen handwerk te blijven. Kies per datastroom de juiste ingang, leg eigenaar en support vast, test met bewijs en zorg dat je veilig stopt, herstelt of vervangt.

Een WMS kiezen: test de mislukte pick van ontvangst tot ERP
Gids
Uitgebreide gids17 min

27 okt 17:00

Een WMS kiezen: test de mislukte pick van ontvangst tot ERP

Een WMS kies je niet op een groene demo. Test ontvangstverschil, blinde telling, mislukte pick, menselijke correctievrijgave en de terugmelding naar ERP en webshop met exact dezelfde proef.

Waar mag je klantdata staan? Stappenplan voor data-residency en verwerkersovereenkomsten
Gids
9 min

30 jun 17:00

Waar mag je klantdata staan? Stappenplan voor data-residency en verwerkersovereenkomsten

Inventariseer welke klantdata op Amerikaanse clouds staat, kies per systeem een EU-residency-optie en werk je verwerkersovereenkomsten bij, zonder in paniek je hele stack te verhuizen.

FAQ

Veelgestelde vragen over de Microsoft Dynamics 365 Business Central-koppeling

Antwoorden op wat het vaakst gevraagd wordt over Microsoft Dynamics 365 Business Central koppelen.

Klaar om Microsoft Dynamics 365 Business Central te koppelen?

Vertel me welke systemen je gebruikt en wat er nu misgaat. Ik denk mee en zeg eerlijk wat er kan, vrijblijvend.

Bekijk alle integraties

Liever eerst zelf kijken waar de winst zit? Doe de gratis automatiseringsscan