Business Central Setup
Business Central Setup Guide
Section titled “Business Central Setup Guide”Connect your Microsoft Dynamics 365 Business Central instance to automatically sync vendors and items with the EUDR platform.
Prerequisites
Section titled “Prerequisites”- Microsoft Dynamics 365 Business Central instance (cloud)
- Azure AD admin access for app registration
- N’entropy platform account with active subscription
Step 1: Register an Azure AD Application
Section titled “Step 1: Register an Azure AD Application”- Go to the Azure Portal
- Navigate to Azure Active Directory → App registrations → New registration
- Enter a name:
N'entropy EUDR Integration - Set Redirect URI to:
https://backend.joinnentropy.com/api/integrations/dynamics/callback - Click Register
Note the following values:
Section titled “Note the following values:”- Application (client) ID → This is your
Client ID - Directory (tenant) ID → This is your
Tenant ID
Step 2: Create a Client Secret
Section titled “Step 2: Create a Client Secret”- In your app registration, go to Certificates & secrets → Client secrets → New client secret
- Set an expiration (recommended: 24 months)
- Copy the secret value immediately — it won’t be shown again
Step 3: Configure API Permissions
Section titled “Step 3: Configure API Permissions”- Go to API permissions → Add a permission
- Select Dynamics 365 Business Central
- Choose Delegated permissions:
Financials.ReadWrite.All
- Or Application permissions for daemon/service apps:
API.ReadWrite.All
- Click Grant admin consent
Step 4: Connect in N’entropy
Section titled “Step 4: Connect in N’entropy”- Go to Integrations → ERP Connections → Add Connection
- Select Microsoft Dynamics 365 Business Central
- Enter your Azure AD credentials:
- Tenant ID: Your Azure AD directory ID
- Client ID: Application ID from Step 1
- Client Secret: Secret from Step 2
- Environment:
productionorsandbox
- Click Connect & Authorize
- Sign in with your Microsoft account when prompted
- After authorization, you’ll be redirected back to the platform
Step 5: Select a Company
Section titled “Step 5: Select a Company”After connecting, the platform will show available Business Central companies. Select the company you want to sync data from.
Step 6: Run Initial Sync
Section titled “Step 6: Run Initial Sync”- Click Sync Now on your integration
- The platform will fetch all vendors → suppliers and items → products
- Review the sync results in the Sync History tab
Sync Behavior
Section titled “Sync Behavior”- Vendors are synced as Suppliers in the EUDR platform
- Items are synced as Products in the EUDR platform
- Records are matched by Business Central ID (
externalId) - Re-syncing updates existing records (no duplicates)
- Deleted records in BC are not automatically deleted in the platform
Incremental Sync
Section titled “Incremental Sync”After the initial sync, use the Modified Since filter to only fetch records that changed since the last sync:
POST /api/integrations/:id/dynamics/sync{ "modifiedSince": "2024-01-15T00:00:00Z"}Troubleshooting
Section titled “Troubleshooting””Azure AD token exchange failed”
Section titled “”Azure AD token exchange failed””- Verify your Client ID, Tenant ID, and Client Secret
- Ensure the redirect URI matches exactly
- Check that admin consent was granted
”Failed to list companies”
Section titled “”Failed to list companies””- The app may not have the correct API permissions
- Try granting
API.ReadWrite.Allapplication permission
”No valid credentials available”
Section titled “”No valid credentials available””- OAuth tokens may have expired
- Re-authorize by clicking Connect & Authorize again