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.
  • Add another permission by selecting Add a permission again.
  • Select Microsoft APIs > Dynamics 365 Business Central > Delegated Permissions.
  • Tick all boxes, then click Add permissions.
  • When the permissions have been added, click Grant admin consent for <company name> next to the Add permissions button.
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 period for the client secret or specify a custom duration. Note that the default expiration for a client secret is six months. You may extend the lifetime to minimize the need for frequent credential updates.
  • 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)

Additionally, please inform us if your client secret expires and you generate a new one. 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!

Was this page helpful?

Lexware OfficeQuickBooks