Troubleshooting
Error references, organised the way you meet them: the message on screen, what actually caused it, the fix, and how to stop it coming back.
28 references · last updated 2026-09-06. Every guide follows the same shape — symptom, cause, fix, prevention — so you can scan for your error and stop reading. RSS for new references.
Foundations
Business Central
- AL compiler errors in Business CentralThe AL compiler errors every Business Central developer hits — AL0118, AL0132, AL0185, AL0296, AL0432, AL0603, AL0604, ID-range and symbol errors — with cause.
- AL runtime errors in Business CentralThe Business Central runtime errors AL developers and admins meet most — record already exists, does not exist, modified by another user, string length.
- Business Central API errorsBusiness Central API and OData errors decoded — Authentication_InvalidCredentials, BadRequest_ResourceNotFound, Internal_CompanyNotFound, Request_EntityChanged.
- Business Central extension install and upgrade errorsWhy a Business Central AL extension fails to install, publish, or upgrade — dependency, data-upgrade, and schema errors decoded.
- Business Central job queue errorsWhy Business Central job queue entries fail or stall — Error status, stuck In Process, entries that never run, permission and user problems, overlapping jobs.
- Business Central journal and document posting errorsBusiness Central posting errors that are not posting groups — allowed posting dates, dimension code mandatory, number series, blocked customers and items.
- Business Central permission errorsThe Business Central permission-set errors that stop a user cold — cause, fix, and how to design permission sets that avoid them.
- Business Central posting setup errorsBusiness Central posting group errors decoded — Gen., VAT, Customer/Vendor, Inventory Posting Setup, Direct Posting, blocked accounts.
- Business Central report layout errorsWhy posting or printing a document in Business Central fails with a layout error — Word and RDLC layout selection, custom fields, and rendering failures.
Finance & SCM
- Dual-write sync errorsDual-write errors between Finance and Operations and Dataverse decoded — lookup not found, company missing, integration key conflicts, validation failures.
- F&O batch job and workflow errorsWhy a Finance and Operations batch job or workflow gets stuck or fails — batch server, queue, and workflow errors decoded.
- F&O data entity import and export errorsWhy a Data Management Framework import or export fails in Finance and Operations — staging, validation, and mapping errors decoded.
- Finance and Operations database synchronization errorsWhy an X++ table or field change fails to synchronize into the SQL database in Finance and Operations — and how to read the sync log.
Customer Engagement
- Dataverse duplicate detection and business rule errorsWhy a Dataverse record won't save — duplicate detection blocks, business rule validation errors, and how to tell them apart.
- Dataverse plug-in exceptions explainedThe Dataverse plug-in errors that recur on every project — ISV code aborted (0x80040265), missing privilege (0x80040220), sandbox timeout, worker crash.
- Dataverse sharing and security errorsWhy a Dataverse user can't see or edit a record they should be able to — security role, business unit, and record-sharing errors decoded.
- Dataverse solution import errorsWhy Dataverse solution imports fail — missing dependencies, managed cannot overwrite unmanaged, version lower than installed, language not installed.
- Dataverse Web API errors explainedDataverse Web API errors by code — 0x80040217 does not exist, 0x80040220 privilege, 0x80040333 duplicate, 0x80040237 duplicate key, 0x80048d19 payload.
Power Platform
- Copilot Studio publishing and channel errorsWhy a Copilot Studio agent won't publish, a topic won't trigger, or a channel (Teams, a website) shows the wrong or no response — decoded.
- Power Apps canvas app errors explainedThe canvas app errors makers hit most — delegation warnings, 'The specified column does not exist', Patch type errors, network error when using Patch.
- Power Apps model-driven form errorsWhy a Dataverse model-driven form won't save, a business process flow gets stuck, or a form control shows the wrong data — decoded.
- Power Automate Desktop RPA errorsWhy a Power Automate Desktop flow can't find a UI element, a machine shows as offline, or an unattended run fails silently — decoded.
- Power Automate flow failures explainedThe Power Automate errors that stop flows — ActionFailed, BadGateway, InvalidTemplate, 429 throttling, 'Could not find a property named', null Apply to each.
- Power BI dataset refresh failuresWhy a Power BI dataset refresh against Dynamics 365 data fails — gateway, credential, and timeout errors, decoded.
- Power Pages Liquid and portal errorsThe Power Pages errors makers hit most — Liquid syntax and permission errors, form submission failures, and the ones that only show up in production.
- Power Platform throttling and 429 errorsWhy Power Automate, Dataverse, or a connector starts returning 429 Too Many Requests — API limits decoded, and how to design around them.
Integrations
Not here yet?
Each reference grows as new errors are reported. If you hit one that is not covered, send the exact message and the context — it is the fastest way to get it added. The broader operations guides — Business Central telemetry, Dataverse tracing, and Power Automate error monitoring — cover how to find these errors before users do.
Frequently asked questions
How is each troubleshooting page structured?
- Symptom, cause, fix, prevention — in that order. Scan for the exact error message, read the cause paragraph, apply the fix, then decide whether the prevention step is worth adopting. Every reference on the site follows the same shape so you never have to hunt.
Do the fixes apply to on-premises deployments?
- Business Central on-prem and Dataverse cloud share most error codes, but a fix that assumes SaaS-only telemetry or an Azure resource may not apply. Each page calls out on-prem caveats where the fix diverges.
How current are the error references?
- Every release wave (April and October) the AL compiler errors, Dataverse Web API errors, and Power Automate error catalogue are reviewed for changes; individual pages are updated immediately when Microsoft renumbers or renames an error.
What if my error isn't listed?
- Send the exact error message via the contact form with the surrounding context (which app, what the user was doing, timestamp for telemetry). New references are added roughly weekly; a reproducible error usually joins the list within days.