Microsoft Dynamics 365 Business central

Modified on Wed, 4 Nov at 3:41 PM

Microsoft Dynamics 365 Business Central Integration Guide

Set up the Microsoft Dynamics 365 Business Central (BC) integration by granting access to the Position Green app registration.


Prerequisites

Make sure the following are available before starting:

  • Active Dynamics 365 Business Central SaaS environment, such as Production or Sandbox
  • Azure AD Global Administrator or Privileged Role Administrator access
  • Microsoft 365 license with Business Central
  • Position Green app registration Client ID provided by Position Green

Grant admin consent to the Position Green app

Position Green app Client ID: d31e6eca-cb85-4f80-816b-f3a5394b7e12

  1. Open the admin consent link in a browser:
    https://login.microsoftonline.com/common/adminconsent?client_id=d31e6eca-cb85-4f80-816b-f3a5394b7e12
  2. Sign in with an Azure AD admin account.
  3. Approve the consent prompt.

If the setup is successful, the browser redirects to the Position Green website.


Add the app in Business Central

Access to the company’s Business Central portal is required for this step.

  1. Open the Business Central portal.
  2. Select the target environment, such as Production.
  3. Open Search in the upper-right corner.
  4. Search for Microsoft Entra Applications.
  5. Select Microsoft Entra Applications.
  6. Click "+New".
  7. Enter the Position Green Client ID in the Client ID field:
    d31e6eca-cb85-4f80-816b-f3a5394b7e12
  8. Add a description.
  9. The description field does not affect the integration.
  10. Change State to "Enabled".
  11. Confirm the application creation.

Assign permissions in Business Central

Assign permission sets to the application registration from the same window.

  1. Go to User Permission Sets.
  2. Click the empty Permission Set field.
  3. Click "(⋮)".
  4. Select the required permission set from the list.

Assign the "D365 READ" permission set to enable read access to all API endpoints.

If assigning a custom permission set, include access to at least:

  • Companies
  • Dimensions
  • Vendors
  • Purchase Invoices
  • General Ledger Setup
  • General Ledger Entries

Step 2: Setup Connection Inside Position Green

  1. Navigate to “Data” in the left side menu.
  2. Navigate to the "Integrations" tab.
  3. Click "Add integration" and "Connect" under Business Central.
  4. Insert your "Azure Tenant ID”, "Environment name", and "Company name"
  5. Click “Authenticate and activate integration”.
  6. After clicking the button, a check is performed to verify that the credentials are correct and that we get gata from the integration. You will see a popup and the card display “Authenticating credentials”.
  7. When authentication completes (usually takes about 30 seconds), the card status will change to "Finish up".
  8. Click "Finish up" and review the integration setup
  9. You should now see that the integration is "Active"


Note that there are a preselected set of financial General Ledger (GL) accounts for each integration depending on your country and accounting standard. You can see and change that under "Account settings" under the integration setup. More information about account settings here.


Step 3: Fetching Data to Position Green

  1. The first time you set up the integration, you can trigger a historical upload for a custom period, e.g. for the whole last year or for only last month by clicking the "Sync now" button or the sync icon
  2. Note that you can also set a scheduled integration, e.g. making sure we get data the 5th of every month, under the "Sync frequency" option.
  3. Congratulations! You are integrated.



Contact Position Green Support

If you run into any issues, contact your Position Green onboarding representative for guidance or troubleshooting support.


Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article