The Business Central Native Execution API (Documentation Index
Fetch the complete documentation index at: https://mintlify.com/CodexaCP/DG_BACK/llms.txt
Use this file to discover all available pages before exploring further.
/api/integration/businesscentral-native or /api/v1/integration/businesscentral-native) provides read access to data fetched live from a connected Microsoft Dynamics 365 Business Central instance. All endpoints are available exclusively to tenants with IntegrationMode = BusinessCentralNative and authenticate via X-Api-Key. The response envelope wraps the remote BC payload with Dragon Guard metadata including correlation ID and provider name.
All endpoints on this page require
X-Api-Key authentication and the tenant must have IntegrationMode = BusinessCentralNative. Requests from other tenant types receive 409 Conflict.GET /api/v1/integration/businesscentral-native/items
Fetches the current item catalog from the connected Business Central instance. Any query parameters supplied are forwarded to the BC OData/API adapter without modification (e.g.,$filter, $top, $skip).
Authentication: X-Api-Key: <api-key> (required).
Whether the BC call succeeded.
Dragon Guard tenant company code.
Always
BusinessCentralNative.Request correlation ID for tracing.
Business Central resource collection response.
| Status | Code | Meaning |
|---|---|---|
| 409 | Conflict | Tenant is not configured for BusinessCentralNative. |
| 501 | Not Implemented | BC adapter endpoint not configured for this resource. |
| 502 | Bad Gateway | Business Central returned an error or was unreachable. Response includes remoteHttpStatusCode and retryable flag. |
GET /api/v1/integration/businesscentral-native/receipts
Fetches purchase receipt documents from the connected Business Central instance. Returns open or posted purchase receipts depending on BC configuration. Query parameters are forwarded to BC without modification. Authentication:X-Api-Key: <api-key> (required).
Whether the call succeeded.
Tenant company code.
Always
BusinessCentralNative.Correlation ID.
BC receipts collection (same envelope as
/items).| Status | Meaning |
|---|---|
| 502 | BC gateway error. Response includes remoteHttpStatusCode and retryable flag. |
GET /api/v1/integration/businesscentral-native/shipments
Fetches sales shipment documents from Business Central. Query parameters forwarded to BC. Response follows the same envelope as/items.
Authentication: X-Api-Key: <api-key> (required).
Whether the call succeeded.
Tenant company code.
Always
BusinessCentralNative.Correlation ID.
BC shipments collection.
| Status | Meaning |
|---|---|
| 502 | BC returned an error. Inspect remoteHttpStatusCode and retryable in the error body. |
GET /api/v1/integration/businesscentral-native/movements
Fetches inventory movement / journal records from Business Central. Query parameters forwarded to BC. Response follows the same envelope as/items.
Authentication: X-Api-Key: <api-key> (required).
Whether the call succeeded.
Tenant company code.
Always
BusinessCentralNative.Correlation ID.
BC movements collection.
| Status | Meaning |
|---|---|
| 501 | BC adapter does not support this resource for the tenant’s BC configuration. |
| 502 | BC gateway error. |