Kort antwoord: een Business Central API-koppeling verbindt Microsoft Dynamics 365 Business Central met een webshop, CRM, WMS, Power BI of maatwerksoftware. Leg vóór de bouw vast welk systeem leidend is voor klanten, artikelen, voorraad, orders en facturen. Kies daarna API, OData, webhooks of een workflowtool en regel rechten, veldmapping, logging, retries en foutenherstel.
Wanneer gebruik je de Business Central API?
| Doel | Logische route | Belangrijkste controle |
|---|---|---|
| Klanten, artikelen, orders of facturen lezen en schrijven | Business Central API v2.0 | OAuth-rechten, bedrijf, verplichte velden, externe ID en idempotentie |
| Data ontsluiten voor rapportage of Power BI | API-query of OData | Datamodel, filters, definities, volume en rate limits |
| Wijzigingen snel doorzetten | Webhooks plus gecontroleerde verwerking | Herlevering, volgorde, gemiste events en foutwachtrij |
| Notificaties en lichte processtappen | Power Automate, n8n of Make.com | Connectorbereik, logging, retries, eigenaar en testbaarheid |
Gebruik maatwerk API-integratie wanneer meerdere systemen dezelfde data wijzigen, custom velden of extensies belangrijk zijn, of fouten direct omzet-, voorraad- of boekhoudimpact hebben.
Welke data koppel je met Business Central?
De meest gebruikte Dynamics 365 Business Central-integraties verwerken klanten, contactpersonen, artikelen, prijzen, voorraad, verkooporders, facturen, betalingen, projecten en financiële dimensies. Maak per object een datacontract met bron, eigenaar, verplichte velden, synchronisatierichting en herstelroute.
- Webshop en portal: klanten, prijzen, voorraad, orders, retouren en fulfilmentstatus.
- CRM: account en contact, opportunity of deal, offerte, orderreferentie en factuurstatus.
- WMS en logistiek: artikel, locatie, voorraadmutatie, pickstatus en verzending.
- Power BI: omzet, marge, voorraad, openstaande posten en projecten volgens één afgesproken definitie.
Business Central API, OData of webhooks?
De Business Central API is meestal de eerste keuze voor gecontroleerde transacties. OData en query-objecten passen bij uitlezing en rapportage. Webhooks melden dat een record is gewijzigd, maar vervangen geen betrouwbare verwerking: de ontvangende koppeling moet het actuele record ophalen, duplicaten herkennen en gemiste meldingen kunnen herstellen.
- Gebruik een apart integratieaccount met minimale rechten.
- Bewaar de Business Central-ID én de ID uit het bronsysteem.
- Maak writes idempotent zodat herhaling geen dubbele order of factuur maakt.
- Log request, mappingversie, resultaat, fout en herstelactie.
- Test tokenvernieuwing, throttling, time-outs, gedeeltelijke fouten en rollback.
Hoe koppel je Business Central met CRM of webshop?
Bij een CRM-koppeling blijft het CRM vaak leidend voor leads, contacten en verkoopkansen, terwijl Business Central leidend is voor debiteuren, orders, facturen en betalingen. Spreek het overdrachtsmoment af: bijvoorbeeld na een gewonnen deal of goedgekeurde offerte. Stuur daarna alleen relevante financiële statussen terug.
Bij een webshopkoppeling moeten ordernummer, klant, btw, valuta, regels, korting, betaling en verzendstatus samen controleerbaar zijn. Valideer voorraad en artikelmapping vóór de boeking en stuur ongeldige orders naar een foutwachtrij in plaats van ze stil over te slaan.
Standaardconnector, workflowtool of maatwerk?
| Aanpak | Past wanneer | Let op |
|---|---|---|
| Standaardconnector | Proces en datamodel exact binnen de ondersteunde mapping passen | Controleer custom fields, logging, retries en eigenaarschap |
| Power Automate, n8n of Make.com | Er meerdere stappen, controles, meldingen of goedkeuringen nodig zijn | Beheer credentials, versies, foutpaden en testomgevingen |
| Maatwerk API | Volumes, security, extensies of bedrijfskritische logica specifiek zijn | Vraagt tests, monitoring, documentatie en structureel beheer |
Vergelijk hiervoor een API-integratie specialist met een workflow automation bureau. Voor concrete workflowkeuzes zijn ook n8n en Make.com relevant.
Hoe voorkom je stille synchronisatiefouten?
- Foutwachtrij: isoleer ongeldige records zonder de hele keten te stoppen.
- Retrybeleid: herhaal alleen tijdelijke fouten, begrensd en met wachttijd.
- Auditlog: registreer bron, doel, sleutel, mapping, resultaat en herstelactie.
- Monitoring: bewaak volumes, vertraging, foutpercentage, tokens en API-limieten.
- Beheer: wijs een functionele en technische eigenaar aan voor wijzigingen en incidenten.
Richt voor productie ook API-beheer in. Test vóór livegang normale records, duplicaten, ontbrekende velden, time-outs, tokenvernieuwing en herstel na uitval.
Officiële Microsoft-bronnen en uitvoering
- Business Central API v2.0
- Connect apps to Business Central
- Business Central webhook subscriptions
- Business Central en Power BI
Wil je de uitvoering uitbesteden? Bekijk dan Microsoft Dynamics-koppeling uitbesteden.