Your Tech Club
KOPPELINGENMICROSOFT DYNAMICS 365 BUSINESS CENTRAL

Business Central koppelen

Een koppeling met Business Central zorgt dat orders, klanten, voorraad en facturen niet meer met de hand tussen systemen gaan. Dat scheelt dubbel werk bij sales, inkoop en finance, en het maakt de maandafsluiting voorspelbaarder. Hieronder lees je hoe koppelen met Business Central online werkt.

Alle koppelingen
4,8 uit 127 reviews
ISO 9001 & 27001
Microsoft Dynamics 365 Business CentralBoekhouding en ERP · Microsoft
  • Klanten en leveranciers gaat heen en weer met Je andere systemen
  • Artikelen, prijzen en voorraad gaat heen en weer met Je andere systemen
  • Verkooporders en verkoopfacturen gaat heen en weer met Je andere systemen
  • Inkoopfacturen gaat heen en weer met Je andere systemen
Je andere systemenZoals Shopify, Salesforce

Onder meer gebouwd voor Tata Steel, M&G Investments, Digistore24, Toppers in Concert, Bar-le-Duc en Loogman

Wat je uitwisselt

Dit zijn de gegevens die organisaties het vaakst tussen systemen laten lopen. Welke daarvan voor jou tellen, hangt af van waar het werk nu blijft liggen.

Klanten en leveranciers

Stamgegevens met adres, btw-gegevens, betalingstermijn en boekingsgroepen. Die boekingsgroepen bepalen later op welke rekeningen en met welke btw een factuur geboekt wordt.

Artikelen, prijzen en voorraad

Business Central is vaak de bron voor artikelgegevens en voorraad per locatie. Webshops, portals en verkoopkanalen lezen dat uit.

Verkooporders en verkoopfacturen

Orders uit een webshop, portal of CRM worden verkooporders die het magazijn oppakt, of meteen een factuur als er niets meer geleverd hoeft te worden.

Inkoopfacturen

Facturen van leveranciers, al dan niet gekoppeld aan een inkooporder, klaar om te controleren en te boeken.

Dimensies en journalen

Kostenplaats, afdeling of project hangen als dimensie aan een boeking. Koppelingen die rechtstreeks in een journaal boeken, moeten die dimensies meegeven.

Betalingen en openstaande posten

Betaalstatus en openstaand saldo per klant, voor terugkoppeling naar sales of een klantportaal.

Standaard of maatwerk

Niet altijd. Doet een bestaande koppeling voor Microsoft Dynamics 365 Business Central precies wat je nodig hebt, dan zeggen we dat ook.

Wat er al bestaat

Microsoft levert zelf een paar koppelingen mee. De Shopify Connector is vooraf geïnstalleerd en synchroniseert artikelen, voorraad, klanten en orders. Met Dynamics 365 Sales, de CRM van Microsoft, koppel je via Dataverse. Voor andere systemen staan er apps van partners op Microsoft AppSource.

Zo'n standaardkoppeling is genoeg als je proces dicht bij de standaard blijft: één bedrijf, gangbare prijsafspraken en geen eigen velden die mee moeten. Hoe meer eigen velden, extensies en uitzonderingen je Business Central heeft, hoe eerder je tegen de grenzen van een standaardapp aanloopt.

Wanneer maatwerk nodig is
  • Je hebt eigen velden of tabellen in Business Central die een standaard-API niet kent.
  • Je CRM is geen Dynamics 365 Sales, maar bijvoorbeeld Salesforce of HubSpot.
  • Je werkt met meerdere bedrijven in één omgeving en orders moeten in het juiste bedrijf landen.
  • Orders komen uit een eigen b2b-portal met klantspecifieke prijzen en goedkeuringen.
  • Je wilt afwijkingen tegenhouden voordat er iets wordt geboekt.
Hoe het technisch werkt

REST API v2.0 en eigen API's

Business Central online heeft standaard-API's op OData v4, voor onder meer klanten, artikelen en verkoopfacturen, en die staan standaard aan. Je kunt ze niet uitbreiden met extra velden. Heb je die nodig, dan kopieer je de AL-code en maak je een eigen API-pagina in een extensie.

Inloggen via Microsoft Entra ID

Toegangssleutels voor webservices (basic auth) worden sinds oktober 2022 niet meer ondersteund in Business Central online. Je gebruikt OAuth via Microsoft Entra ID. Voor koppelingen zonder gebruiker is er service-to-service-authenticatie met de client credentials flow; daarvoor is volgens Microsoft geen gebruikerslicentie nodig.

Webhooks die je moet verlengen

Via de subscriptions-API abonneer je je op wijzigingen in bijvoorbeeld klanten of facturen. Business Central controleert eerst je endpoint met een validationToken. Een abonnement verloopt na drie dagen als je het niet verlengt, en een melding zegt alleen welk record is gewijzigd, niet wat de nieuwe gegevens zijn.

Limieten per gebruiker

Per gebruiker mag je 6000 OData-verzoeken doen in een schuivend venster van vijf minuten, met maximaal 5 tegelijk in behandeling. Een $batch-verzoek mag 100 bewerkingen bevatten en een verzoek duurt maximaal acht minuten. Per omgeving zijn maximaal 200 webhook-abonnementen mogelijk.

Sandboxomgevingen

Bij een Essentials- of Premium-abonnement horen één productieomgeving en drie sandboxomgevingen. Daarin test je een koppeling met een kopie van echte gegevens, zonder boekingen in je productieadministratie.

AI ertussen

Een koppeling verplaatst gegevens. AI kan daartussen lezen, sorteren en een voorstel klaarzetten. Waar het ertoe doet, beslist een mens.

Inkoopfacturen als concept

Microsoft biedt in Business Central de Payables Agent: die leest leveranciersfacturen uit een mailbox, zoekt de leverancier en zet een conceptfactuur klaar die een mens controleert voordat er geboekt wordt. Microsoft meldt dat de agent is gevalideerd voor Engels. Voor Nederlandstalige facturen of eigen regels kan een eigen variant zinvol zijn, met hetzelfde principe: eerst een concept, boeken na akkoord.

Kredietsignalen voor sales

AI combineert openstaande posten en betaalgedrag uit Business Central tot een korte waarschuwing in het CRM, voordat een accountmanager een nieuwe order toezegt. De beslissing blijft bij sales en finance.

Orders controleren

Een order met een prijs onder de afgesproken ondergrens, een onbekend artikel of een afwijkend afleveradres gaat naar een controlelijst in plaats van direct naar het magazijn.

Waar het misgaat

Webhooks die stilletjes verlopen

Wie vergeet abonnementen binnen drie dagen te verlengen, mist wijzigingen zonder foutmelding. Bouw een verlengtaak en een periodieke controle die beide systemen vergelijkt.

Meldingen zonder inhoud

Een webhookmelding zegt alleen dat iets is gewijzigd. Elke melding kost dus nog een GET-verzoek, en bij veel wijzigingen tegelijk krijg je een melding van het type collection. Reken dat mee in je limieten.

Boekingsgroepen die ontbreken

Business Central bepaalt btw en grootboekrekening via boekingsgroepen van klant en artikel. Maakt een koppeling klanten of artikelen aan zonder de juiste groepen, dan loopt het boeken vast of komt de btw verkeerd uit.

Oude authenticatie

Oudere koppelingen met een gebruikersnaam en webservicesleutel werken niet meer in Business Central online. Bij een migratie maak je een app-registratie in Microsoft Entra ID en geef je die in Business Central de juiste rechten.

Zo bouwen we een koppeling

  1. Wat moet waarheen

    Welke gegevens gaan over, in welke richting, en welk systeem leidend is als twee waarden verschillen. Dat staat op papier voordat er iets gebouwd wordt. Voor deze koppeling gaat het om: Klanten en leveranciers, Artikelen, prijzen en voorraad, Verkooporders en verkoopfacturen, Inkoopfacturen, Dimensies en journalen, Betalingen en openstaande posten.

  2. Velden en regels

    Per veld de vertaling tussen de systemen: statussen, btw-codes, grootboekrekeningen, artikelnummers. En wat er gebeurt bij een dubbel of een ontbrekend gegeven. Voor deze koppeling gaat het om: REST API v2.0 en eigen API's, Inloggen via Microsoft Entra ID, Webhooks die je moet verlengen, Limieten per gebruiker, Sandboxomgevingen.

  3. Testen met echte gevallen

    In een testomgeving of testadministratie, met de uitzonderingen die in de praktijk voorkomen: creditnota's, deelleveringen, gewijzigde klantgegevens.

  4. Live, met logging en bewaking

    Elke synchronisatie wordt gelogd en bij een fout krijgt iemand een melding. Verandert de API van een leverancier, dan passen wij de koppeling aan.

Het team van Your Tech Club op kantoor in Amsterdam
Amsterdam
Wie je spreekt

Geen accountmanager. Je spreekt iemand die zelf koppelingen bouwt, en die zegt het ook als een standaardkoppeling genoeg is.

Joey van VlietJoey van VlietOprichter
Yassine SeghrouchniYassine SeghrouchniOprichter
  • Kantoor aan de Duivendrechtsekade in Amsterdam
  • ISO 9001 en ISO 27001, gecertificeerd door Kiwa
  • 500 projecten opgeleverd
  • 4,8 uit 127 reviews
Veelgestelde vragen

Heeft Business Central een API?

Ja. Business Central online heeft standaard-API's, versie 2.0, op basis van REST en OData v4, en die staan standaard aan. Daarnaast kun je in AL eigen API-pagina's maken voor gegevens die de standaard-API niet bevat. Toegang loopt via OAuth met Microsoft Entra ID.

Kan ik nog koppelen met een webservicesleutel?

Niet in Business Central online. Sinds oktober 2022 worden toegangssleutels (basic auth) daar niet meer ondersteund. Je gebruikt OAuth via Microsoft Entra ID, en voor koppelingen zonder gebruiker service-to-service-authenticatie.

Wat zijn de API-limieten van Business Central?

Per gebruiker geldt een limiet van 6000 OData-verzoeken in een schuivend venster van vijf minuten, met maximaal 5 verzoeken tegelijk in behandeling en een wachtrij van 95. Boven de limiet krijg je status 429. Een verzoek mag maximaal acht minuten duren.

Heeft Business Central webhooks?

Ja, via de subscriptions-API. Je registreert een URL, Business Central doet een handshake met een validationToken en stuurt daarna meldingen bij wijzigingen. Abonnementen verlopen na drie dagen, dus je moet ze verlengen.

Kan ik velden toevoegen aan de standaard-API?

Nee. Volgens Microsoft kun je de standaard-API's niet uitbreiden met extra velden. Je kopieert dan de AL-code van de API en maakt er een eigen API van, als onderdeel van een extensie.

Hoe test ik een Business Central-koppeling veilig?

In een sandboxomgeving. Bij een Essentials- of Premium-abonnement horen drie sandboxen, waarin je een kopie van je productiegegevens kunt zetten. Zo test je met echte situaties zonder boekingen in je echte administratie.