Microsoft Dynamics 365 Business Central Connector
Status: In development: its code is written and tested on its own, but it does not work end to end on the platform yet. It cannot be installed.
| Kind | Version | Publisher | Licence |
|---|---|---|---|
| Connector | 1.2.0 | ZAITRACK | Apache-2.0 |
What it does
Reads a company's sales invoices from Dynamics 365 Business Central online (API v2.0) every 30 minutes, with a Microsoft Entra app's client credentials. An invoice in the company's own currency takes it from the company information. With a vehicle class set, it also reads the fixed assets of that class or subclass: each is added to the fleet or updates its vehicle, matched on its serial number as the VIN. With a mapping that syncs both ways, a change made on the platform is written back to the asset.
- Regions: SA, AE, US, EU
- Capabilities:
integration.erp.sync.fact.invoice,integration.erp.sync.fact.vehicle,integration.erp.write_back
How to use it
Not yet: see its status above.
Configuration
| Setting | Type | Required | Allowed values and default |
|---|---|---|---|
azure_tenant_id | string | yes | The tenant's id or its domain (contoso.onmicrosoft.com) |
bc_environment | string | no | default "production"; The Business Central environment's name: production, or a sandbox's |
bc_company_id | string | yes | GET …/api/v2.0/companies lists them; a GUID |
bc_vehicle_class | string | no | The fixed asset class or subclass code whose assets are the fleet's vehicles (VEHICLES, TRUCKS); left empty, no fixed assets are read |
Credentials
Each is a secret setting of the installation: kept sealed (OpenBao in production), never shown again; Adapter Studio shows it as set.
azure_client_idazure_client_secret
Limits
- Memory: 256 MB
- Time per call: 30,000 ms
- Largest message: 1,048,576 bytes
- Calls at once: 16
- Network: only
api.businesscentral.dynamics.com,login.microsoftonline.com
Troubleshooting
- Credentials refused. The secret settings must be the ones the provider issued for this account and environment (sandbox or live); give them again in Adapter Studio, since they are never shown back.
- Rate limited. The provider's limit applies to the account: calls are retried with a growing pause; spread scheduled work or ask the provider for a higher limit.
- Nothing is sent or synced. The installation must be active, its version approved; it reaches only the hosts listed under Limits.
- Webhooks rejected. The webhook secret must match the one configured at the provider; a request whose signature does not match is refused.
Source
adapters/connectors/microsoft-dynamics-365