Skip to main content

How to Connect Zevoy to Microsoft Dynamics 365 Business Central

To link your Zevoy account with Microsoft Dynamics 365, a small one-time setup is needed in your Microsoft Azure portal.

Step-by-step instructions

  1. Sign In to Microsoft Entra

    Open https://entra.microsoft.com and log in using your Microsoft work account.

  2. Create a New App

    1. In the left-hand menu, go to Azure Active Directory > App registrations

    2. Click + New registration

    3. Give it a name like Zevoy integration

    4. Under account types, choose Accounts in this organization directory only

    5. Click Register

  3. Set the Redirect Link

    1. After creating the app, go to Authentication

    2. Click Add a platform, then select Web

    3. Under Redirect URIs, paste this link: https://api.production.zevoy.com/ms/redirect

    4. Click Configure

  4. Add Permissions

    1. Go to API permissions

    2. Click + Add a permission

    3. Choose Dynamics 365 Business Central

    4. Select Delegated permissions

    5. Tick these boxes:

      • user_impersonation

      • Financials.ReadWrite.All

    6. Click Add permissions

    7. After this, you'll see 3 permissions listed: Financials.ReadWrite.All, user_impersonation and User.Read

  5. Create a Secret Key

    1. Click Certificates & secrets

    2. Under Client secrets, click + New client secret

    3. Name it for example Zevoy integration

    4. Set expiry to 730 days (2 years) (or any other duration you prefer)

    5. Click Add

📋 Important: Copy the Value shown. This is your secret key and you’ll need it in the next step.

Connect in Zevoy

  1. Log in to Zevoy Hub

  2. Go to Settings → Export → Integrations

  3. Fill in the fields:

Field

Where to find it

Client ID

From the app's Overview page

Client Secret

The secret value you just copied

Tenant ID

Also on the Overview page

Company Name

Found in Dynamics: Help → Help & support -> Report a problem

Environment

Found in the same Help & Support area

Map your VAT codes

Finally, in Zevoy, match your VAT percentages with the product posting group codes used in Dynamics 365.

When you click the “Connect to Microsoft Dynamics” button, you will be redirected to a Business Central login screen. Your integration is up and running once the authentication is completed.

Ensuring VAT / Tax Codes and Amounts Sync Correctly

When exported transactions land in Microsoft Dynamics 365 Business Central, Business Central calculates the VAT amount and posts the line based on the mapped taxCode (VAT Prod. Posting Group) alongside the account's business posting setup.

If VAT amounts are showing as 0.00 or VAT groups fail to populate on the journal lines, complete the following setup in Business Central:

1. Enable "Copy VAT Setup to Jnl. Lines" on the Journal Batch

To allow Business Central to automatically pull VAT business posting groups and default tax settings onto exported journal lines, this setting must be active on the target batch:

  1. In Business Central, search for and open General Journal Batches.

  2. Locate the batch used for Zevoy exports (e.g., ZEVOY).

  3. Ensure the Copy VAT Setup to Jnl. Lines checkbox is enabled. (If the column is hidden, click the gear icon > Personalise or select Edit List to bring it into view).

2. Configure Default Posting Groups on G/L Account Cards

Because Zevoy passes the product tax code (taxCode), Business Central requires the underlying G/L Account card to provide the business posting group (e.g., NAT / KOTIMAAN) to form a complete tax combination.

Do the following for every G/L Account linked to a Zevoy Category:

  1. Open the G/L Account Card in Business Central.

  2. Scroll down to the Posting FastTab.

  3. Ensure the following fields are populated:

    • Gen. Posting Type: Purchase

    • Gen. Bus. Posting Group: Your default business group (e.g., NAT or KOTIMAAN)

    • Gen. Prod. Posting Group: Your default general product group (e.g., SEKAL. or SERVICES)

    • VAT Bus. Posting Group: Your default VAT business group (e.g., NAT or KOTIMAAN)

    • VAT Prod. Posting Group: Default VAT product group fallback if the code is not specified. Zevoy will override this if another code is sent from Zevoy

💬 Need Help?

If you're unsure or need support, don’t hesitate to contact your Microsoft partner or reach out to us at [email protected], we’re happy to help!

Did this answer your question?