Business Central
Microsoft Dynamics 365 Business Central is the primary ERP in most Demiton construction deployments. The adapter communicates with Business Central’s OData APIs to retrieve and write financial data in a controlled, observable way.
Authentication: OAuth 2.0 via Entra ID service principal
System type: D365_BUSINESS_CENTRAL
Category: ERP
Supported resources
| Resource | FETCH | PUSH | LOOKUP |
|---|---|---|---|
projects | ✓ | ✓ | |
vendors | ✓ | ✓ | ✓ |
project_ledger_entries | ✓ | ✓ | |
purchase_orders | ✓ | ✓ |
Integration model
All Business Central interaction occurs through the adapter layer. The adapter communicates with BC’s OData APIs and normalizes responses into a Sovereign Envelope before returning them to the workflow runtime.
Authentication uses OAuth 2.0 client credentials — a service principal registered in Azure Entra ID is granted access to the Business Central environment.
Connection setup
See Connecting Business Central for the full step-by-step guide including Entra ID app registration, BC permissions, and connection configuration.
Required values:
- Tenant ID
- Client ID
- Client Secret
- Business Central environment URL
Example workflow
FETCH → assignar.site_diariesTRANSFORM → extract_labour_entriesTRANSFORM → normalize_cost_categoriesPUSH → business_central.project_ledger_entriesSecurity
- Use dedicated service principals — one per environment
- Restrict application permissions to required entities only
- Rotate client secrets on a regular schedule
- Always test against a sandbox BC environment before production