Business Central On-Premise koppelen aan APIcenter

Je koppelt Business Central On-Premise aan APIcenter met de gegevens van je eigen Business Central-server. Je doet dit één keer. Daarna gebruik je Business Central On-Premise in al je integraties.

Wat je nodig hebt

• Een Business Central-server die je zelf beheert, en die bereikbaar is voor APIcenter.
• De APIcenter-app voor Business Central, geïnstalleerd in jouw 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.
• De inloggegevens die APIcenter vraagt. APIcenter toont de velden bij het koppelen.

Zo koppel je Business Central On-Premise

1. Ga in APIcenter naar Applicaties en kies Nieuwe applicatie koppelen, of doe dit in stap 2 van de wizard, Verbind je apps. Kies Business Central On-Premise.
2. Vul een Weergavenaam in, bijvoorbeeld de naam van je omgeving.
3. Vul de velden in die APIcenter toont. Een paar daarvan zijn:
   • Scheme: kies https:// of http://. Standaard staat dit op https://. Microsoft raadt aan SOAP- en OData-webservices met SSL te beveiligen.
   • Company ID: het ID van het bedrijf in Business Central. Zie hieronder.
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.

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 On-Premise sturen.

Inloggen bij Business Central

Hoe Business Central web services beveiligt, hangt af van het type referentie dat je server gebruikt. Microsoft beschrijft dit in Web services authentication. Volgens Microsoft:

• is OAuth de aanbevolen methode voor alle webservice-endpoints;
• is een webservice-toegangssleutel (Basic Auth) verouderd;
• maak je voor een externe applicatie het beste een aparte gebruiker die alleen voor webservices dient;
• kunnen gebruikersnaam, wachtwoord en toegangssleutel zichtbaar worden als het verkeer zonder SSL wordt onderschept.

Welk inlogtype APIcenter voor Business Central On-Premise gebruikt, volgt uit de velden die APIcenter bij het koppelen toont.

Als het niet lukt

Zie Verbinding of inloggen mislukt en Business Central On-Premise: veelvoorkomende fouten.

Volgende stappen

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