Setup Dynamics 365 Business Central

Before you can access data from users using Dynamics 365 Business Central for their accounting, you need to set up a Dynamics 365 Business Central integration in the Railz Dashboard™. You'll need to:

  1. Register a new application on Dynamics 365 Business Central developer portal.
  2. Add your secure keys to Railz.

Register your Application

  1. Visit the Azure Portal and sign in or create an account.

📘

Dynamics 365 Business Central and Azure Account details

  • If your organization is using Azure Active Directory to control access to Dynamics 365 Business Central, ask your Azure Active Directory administrator to add your account to the correct permission group.
  • If you're unable to sign up for a new account, contact your Dynamics 365 Business Central administrator. They may have disabled this feature.
  1. Once logged in, select Azure Active Directory from the left sidebar navigation or in-page menu. If you can't see this entry on the home page or menu, click All Services and then select Azure Active Directory.

📘

Multi Tenant Access

You might have been granted access to more than one tenant, so check the details are correct. If they're incorrect, select Switch tenant and choose the right one.

22402240

Azure Active Directory - Manage / Switch Tenant. Click to Expand.

38283828

Azure Active Directory. Click to Expand.

  1. From the left sidebar navigation or in-page menu, select App Registrations.
25302530

Azure Active Directory - App Registration. Click to Expand.

  1. Enter your app details.
20282028

Azure Active Directory - New App Registration. Click to Expand.

  1. The application Name is displayed to your users when connecting, so should have your company or application name.
  2. Under Redirect URI, select Web and then enter https://auth.railz.ai/dynamicsBusinessCentral.
  3. Click Register. Once the app is created you will be redirected automatically to the Applications page where you will see your Client ID. You'll need these for the next stage of the process.

📘

Your Client ID will not be displayed after you leave this page. So make sure you store this somewhere safe.

26522652

Azure Active Directory - App Details. Click to Expand.

  1. Click Add a certificate or secret.
19221922

Azure Active Directory - Certificates & Secrets. Click to Expand.

  1. In the Add a client secret dialogue box. enter a short Description for your client secret to make it easier to find. Under Expires, select the most appropriate option that complies with your company's security policy.
  2. Click Add. Your client secret is generated and displayed at the bottom of the page. The Secret Value won't be displayed again in full so copy it and store it somewhere safe. You'll need these for the next stage of the process.
31163116

Azure Active Directory - Client Secret. Click to Expand.

  1. As a final step, you will need to update the access permissions for your application, which control the data that your app can access in Dynamics 365 Business Central. In the left sidebar navigation menu, go to API permissions, then click + Add a permission.
  • In the Request API permissions menu, select Select “Dynamics 365 Business Central”.
  • Click Delegated permissions, then choose both user_impersonation and Financials.ReadWrite.All
  • Click Add permissions, then above the listed permissions, click Grant admin consent, and click Yes to confirm your change. Note that this option may not be available for all subscription types.
38103810

Azure Active Directory - API permissions. Click to Expand.

38263826

Azure Active Directory - API permissions. Click to Expand.

Add your Secure Keys to Railz

  1. Open the Railz Dashboard™ and log in.
  2. In the left sidebar navigation menu, go to Integrations > Accounting.
  3. Scroll down to the MS Dynamics 365 Business Central integration and click Configure.
Railz Integration Settings. Click to Expand.Railz Integration Settings. Click to Expand.

Railz Integration Settings. Click to Expand.

  1. Paste in your Client ID and Client Secret from the above steps, and then click Save & Enable.
Railz Manage Accounting Integration. Click to Expand.Railz Manage Accounting Integration. Click to Expand.

Railz Manage Accounting Integration. Click to Expand.

Business Authorization Flow

🚧

Depending on the end user's Azure Active Directory settings for Dynamics 365 Business Central they may need the connection to your app to be approved by an admin of their Azure Active Directory. If this is the case the user will be guided to request access and the admins will be notified. Once approved the user can run through the link flow process again to complete the connection to your app.

🚧

  • When connecting their Dynamics 365 Business Central account, Railz will only allow access to production accounts.
  • According to their access level, a company called Cronus may also be available for selection in their account. This is a Microsoft test company populated with sample data.

Did this page help you?