Business CentralInstall Decionis Commerce Gate
Commerce Gate validates sales-order release and posting against central Decionis policies. The Business Central extension is a thin enforcement client; margin, spend, budget, and drift policy logic remains in Decionis.
Install the extension package
- In Business Central, open Extension Management.
- Upload the Decionis Commerce Gate
.apppackage supplied by Decionis. - Allow HTTP client requests when Business Central prompts for permission.
- Assign the Decionis Commerce Gate permission set to the integration administrator.
The AppSource listing is planned after Microsoft certification and preview validation are complete.
Configure the enforcement gate
- Open Decionis Commerce Gate Setup.
- Enter the Microsoft Entra tenant ID, Azure region, Decionis agent ID, and API key issued for the tenant.
- Choose FAIL_OPEN to continue during availability failures and queue background revalidation, or FAIL_CLOSED to stop until validation is available.
- Enable the extension and test one sales document before production rollout.
API keys are stored in company-scoped Business Central isolated storage. Never place a key in a document field, attachment, or support message.
Expected behavior
| Result | Business Central action |
|---|---|
| ALLOW | Release or posting continues. |
| BLOCK | The transaction is stopped and rolled back with the Decionis reason code, regardless of fallback mode. |
| Timeout or HTTP 5xx service failure | The configured FAIL_OPEN or FAIL_CLOSED policy is enforced. |
| HTTP 4xx, invalid response, or mismatched transaction | Release or posting stops. The outage fallback does not bypass these failures. |
The candidate guard backend blocks a changed request with an equal or older timestamp when a configured agent budget already tracks that transaction. Exact current retries retain their budget result. This requires the matching backend deployment.
Background revalidation labels any BLOCK as a drift alert. A stale-request conflict calls for reconciliation; it does not prove historical overspend. Check the reason code and transaction state before drawing that conclusion.
Support and service status
Confirm that Business Central allows outbound HTTPS requests and that the tenant can reach https://api.decionis.com/v1/guard/validate. Decision and failure traces include the tenant and transaction identifiers for support correlation.