Skip to main content

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.

KindVersionPublisherLicence
Connector1.2.0ZAITRACKApache-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​

SettingTypeRequiredAllowed values and default
azure_tenant_idstringyesThe tenant's id or its domain (contoso.onmicrosoft.com)
bc_environmentstringnodefault "production"; The Business Central environment's name: production, or a sandbox's
bc_company_idstringyesGET …/api/v2.0/companies lists them; a GUID
bc_vehicle_classstringnoThe 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_id
  • azure_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