TARGET_SYSTEM: businesscentral

Microsoft Dynamics 365 Business Central is a comprehensive business management solution for small and medium-sized businesses.

When targeting Business Central endpoints, it is essential to fill in the environmentName and companyId query parameters. You can obtain these values by using the GET Environments and GET Companies endpoints available under the Authentication section.

AccountsBillsCustomersCredit notesFilesInvoicesItemsPurchase ordersSales ordersSuppliersTracking categoriesTransactionsVendor credits
Read
Create
Update

How to connect to Microsoft Business Central

To allow your customers to link your application with their Business Central account, you need to set up a Microsoft Entra App and submit your application credentials to maesn.

1

Prerequisites

Before you begin, ensure you have the following:

  • An active Azure account with a valid subscription.
  • Cloud Application Administrator permissions on your Azure account.
  • A Microsoft Entra tenant. *An Admin-permissioned Business Central account.
2

Set up a Multitenant Microsoft Entra Application

  • Sign in to your Microsoft Entra account.
  • In the sidebar, select Applications > App registrations.
  • To set up a new application, select “New registration” and enter a name for your application.
  • Select “Multitenant application”.
  • Under “Redirect URI”, select “Web” and enter the following URI: https://api.maesn.dev/auth/callback/businesscentral
  • Click “Register”.

On the “Overview” page of your application, you will find all the information about your application. Note the “Application (client) ID,” as it will be needed later.

3

Set Permissions for Your Application

In you Microsoft Entra application:

  • Select API permissions in the sidebar > Add a permission > Microsoft APIs.
  • Select Dynamics 365 Business Central.
  • Select Application permissions, choose AdminCenter.ReadWrite.All, then click Add permissions.
4

Generate Credentials

In you Microsoft Entra application

  • Select Certificates & secrets in the sidebar
  • Select Client secrets > New client secret.
  • Add a description for your client secret.
  • Select an expiration for the secret or specify a custom lifetime.
  • Click Add.
  • Copy and securely store the secret’s value immediately, as it will not be accessible after you leave this page.
5

Add the Application Credentials to Business Central

In Business Central:

  • Press the search bar and enter “Microsoft Entra Applications”. If you dont find this page, please review your user permissions.
  • Click “New”
  • Add the application (client) ID of your application and enter a brief description for your application.
6

Configure Your Integration in the maesn API

Finally, set up your API tenant with your application’s details. Contact your maesn representative to provide the following information:

  • Application (Client) ID of your application
  • Client Secret (ensure you provide the value, not the ID)

If you are not sure who your technical contact is, do not hesitate to reach out to us via support@maesn.com, but do not enter your client credentials directly in the email. That’s not safe!