This guide helps you connect Dynamics 365 Business Central to HexaSync Automation Engine with a Microsoft Entra App that your company manages. When you finish, you will have created a Business Central Connector App for one company, and you can read Items and Inventory Levels data on HexaSync. The guide applies to Business Central Online.
Before you start
- A Beehexa account to sign in to HexaSync Automation Engine. If you do not have one yet, sign up on the same page.
- A Microsoft Entra App that you created or chose from your existing applications, with API permissions and Admin consent granted, and registered with permissions in Business Central Online.
- The Client ID, Client Secret Value and Tenant ID of the Entra App.
- The name of the Business Central Environment, for example Production.
- Access to the company you want to connect in Business Central. If the Environment has several companies, you select the company during the connection flow.
No Entra App yet? Follow the guide to creating a Microsoft Entra App for Dynamics 365, then add the API permission and register the application in Business Central by following the Business Central authorization section before you continue.
Part 1: Connect Dynamics 365 Business Central on HexaSync
Step 1: Sign in to HexaSync
- Go to HexaSync Automation Engine and sign in with your Beehexa account.
Step 2: Start connecting Business Central
- Open the Dynamics 365 Business Central connection setup page on HexaSync.
- On the Check connection details screen, find MS D365 Business Central and select Connect.
Step 3: Enter the connection details
- On the connection details screen, enter the following values:
| Field | Value to enter |
|---|---|
| Tenant ID | The Directory (tenant) ID or the tenant domain, for example contoso.onmicrosoft.com. |
| Environment | The name of the Business Central Environment, usually Production. |
| Client ID | The Application (client) ID of the Entra App. |
| Client Secret | The Client Secret Value of the Entra App, not the Secret ID. |
- Select Continue.
Step 4: Select the company and confirm the connection
- If the Environment has several companies, select the company you want to connect, then select Submit. If there is only one company, this selection step does not appear.
- When MS D365 Business Central Is Connected is shown, select Continue.
- When the status is Connected, select Create MS D365 Business Central Connector.
Step 5: Complete the Connector App details
- Check the suggested Connector App name and change it if needed.
- Select Continue.
- Keep the page open until HexaSync creates and opens the new Connector App. This can take a few minutes.
Note: Each Connector App in this flow connects to one company. If you need to connect another company, create another Connector App and select that company.
Part 2: Check the result after connecting
After the Business Central Connector App is created, the Connector has two default tasks:
- [MS D365 Business Central] Items: gets the item data of the company.
- [MS D365 Business Central] Inventory Levels: reads the inventory of each item at each location.
Both tasks update automatically every 15 minutes:
- Items updates items that are new or were just changed.
- Inventory Levels updates only the items that had a receipt, an issue or a transfer. Once a day, Inventory Levels gets the inventory of every item again.
About one hour after you connect, item changes are updated almost immediately. You do not need to set up anything else in Business Central.
Part 3: Re-authorize the Business Central connection
Do this when the Client Secret of the Entra App changes or expires, or when the connection reports an authentication error.
Step 1: Open Settings in the Business Central Connector App
- Open Connector Apps and select the Business Central Connector App you want to re-authorize. Select Settings in the left menu.
Step 2: Select Re-authorize
- In Settings, select Re-authorize on the Business Central connection row.
- Enter the new Client Secret Value of the Entra App, then finish by following the instructions on the screen.
Note: If several Connector Apps use the same Entra App, Re-authorize each Connector App that needs to stay connected.
Part 4: Common errors and how to fix them
| Message | How to fix it |
|---|---|
| HexaSync Could Not Save Your Microsoft Entra App | Check the Client ID and Client Secret Value and enter them again. |
| Microsoft Entra ID rejected the app’s client ID / secret | Check the Tenant ID, Client ID and Client Secret Value; confirm that the secret is still valid. |
| Token issued but GET /companies failed | Check the Environment, the State Enabled of the Entra App in Business Central and the Admin consent for API.ReadWrite.All. |
| GET /items failed for company | Check the Permission Set D365 AUTOMATION of the application in Business Central. |
| The name already exists | Give the Connector App a different name. |
| Connector App Quota Reached | Contact support@beehexa.com to check your quota. |
If the error continues, send a screenshot to support@beehexa.com.
Security note: Do not send the Client Secret Value in a screenshot or a regular email.
Part 5: Frequently asked questions
Where do I get the Client ID, Tenant ID and Client Secret?
These values come from the Microsoft Entra App. See the guide to creating a Microsoft Entra App for Dynamics 365 to register the application and prepare the credentials.
Is Business Central connected to HexaSync once the Entra App is created?
Not yet. You need to add API permissions, Grant admin consent, register the application and assign the Permission Set in Business Central (see the Business Central authorization section), then complete the connection flow on HexaSync.
Can one Connector App connect to several companies?
No. Each Connector App connects to one company. To connect another company, create another Connector App from the template and select that company.
Does this guide work for Business Central On-premises?
No. The current HexaSync Business Central Connector supports Business Central Online only. If you need to connect On-premises, contact Beehexa for further support.
If the Client Secret changes, do I need to Re-authorize each Connector App?
Yes. For each Connector App that uses the same Entra App, Re-authorize it by following Part 3 and enter the new Client Secret Value.
Does HexaSync write or change data in Business Central?
No. The default tasks configured in the Business Central Connector App only read Items and Inventory Levels data. They do not write or change data in Business Central. The API.ReadWrite.All permission is granted as recommended for the current Connector. It does not mean that the default tasks write data.