Microsoft Dynamics 365 Business Central koppelen aan APIcenter

Je koppelt Business Central aan APIcenter met de gegevens van je Business Central-omgeving in de cloud. Je doet dit één keer. Daarna gebruik je Business Central in al je integraties.

Wat je nodig hebt

• Een Business Central-omgeving in de cloud van Microsoft.
• De APIcenter-app voor Business Central, geïnstalleerd in die omgeving. De koppeling gebruikt API-pagina's waarvan de naam met ApiCenter begint. De code en de catalogus van APIcenter zeggen niet waar je de app downloadt. Vraag het aan APIcenter-support.
• Het tenant-ID, het omgevingstype en het bedrijf-ID van je Business Central. Zie hieronder.

Zo koppel je Business Central

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Microsoft Dynamics 365 Business Central.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je omgeving.
3. Vul de velden in die APIcenter toont. Dit zijn de verplichte velden:
   • Tenant ID: het ID van je tenant.
   • Environment Type: de omgeving van Business Central waarmee je verbindt.
   • Company ID: het ID van het bedrijf in Business Central.
4. Klik op Opslaan.
5. Klik op Testverbinding om te controleren of de verbinding werkt.

De algemene stappen staan in Een nieuwe applicatie koppelen en Een applicatie bewerken.

Welke gegevens je invult

Microsoft beschrijft in de documentatie voor service-to-service-authenticatie hoe je met een tenant-ID en een omgevingsnaam een verbinding met Business Central maakt. De URL van de API bevat de naam van de omgeving, bijvoorbeeld production. Het tenant-ID is het ID van je organisatie in Microsoft Entra. Zie Using service-to-service (S2S) authentication.

Welke waarde APIcenter precies voor Environment Type verwacht en waar je het bedrijf-ID in Business Central vindt, staat niet in de code of de catalogus van APIcenter. Vraag het aan APIcenter-support als je het niet weet.

Meerdere bedrijven in Business Central

Een order of creditnota kan een administratie-ID bevatten. Staat het bedrijf-ID (Company ID) in de URL van de verbinding, dan vervangt APIcenter dat ID door het administratie-ID van de order. De order komt dan in dat bedrijf terecht. Zie Verkooporders naar Business Central sturen.

Inloggen bij Business Central

Microsoft beveelt OAuth aan voor alle webservices van Business Central. Toegangssleutels (Basic Auth) zijn verouderd en worden sinds oktober 2022 niet meer ondersteund in Business Central online. Zie Web services authentication.

Volgens Microsoft heb je voor een integratie zonder gebruiker, zoals een koppeling, een app-registratie in Microsoft Entra nodig. Die app moet je ook in Business Central inschakelen en rechten geven. APIcenter toont de velden voor het inloggen bij het koppelen. Welke app of welke rechten APIcenter nodig heeft, staat niet in de code of de catalogus. Vraag dat aan APIcenter-support voordat je koppelt.

Als het niet lukt

Zie Verbinding of inloggen mislukt en Microsoft Dynamics 365 Business Central: veelvoorkomende fouten.

Volgende stappen

Maak een integratie met Business Central en controleer de instellingen. Zie Business Central verbindings- en integratie-instellingen.