{"title":"Build Power BI reports for displaying Dynamics 365 Business Central data","url":"https://jonas-paprotka.de/docs/across-how-use-financials-data-source-powerbi/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/across-how-use-financials-data-source-powerbi, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/across-how-use-financials-data-source-powerbi","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Connect Power BI Desktop to Business Central data, build accessible reports, publish and share them, and configure advanced connection options.","date":"2026-11-11","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Build Power BI reports for displaying Dynamics 365 Business Central data","slug":"build-power-bi-reports-for-displaying-dynamics-365-business-central-data","at":0,"chars":10154},{"level":2,"title":"Prepare to build Power BI reports","slug":"prepare-to-build-power-bi-reports","at":604,"chars":1305},{"level":2,"title":"Add Business Central as a data source in Power BI Desktop","slug":"add-business-central-as-a-data-source-in-power-bi-desktop","at":1909,"chars":2816},{"level":2,"title":"Create accessible reports","slug":"create-accessible-reports","at":4725,"chars":568},{"level":2,"title":"Create reports to display data associated with a list in Business Central","slug":"create-reports-to-display-data-associated-with-a-list-in-business-central","at":5293,"chars":466},{"level":2,"title":"Using the Business Central report theme (optional)","slug":"using-the-business-central-report-theme-optional","at":5759,"chars":1307},{"level":3,"title":"Download the theme","slug":"download-the-theme","at":6223,"chars":453},{"level":3,"title":"Import the theme on a report","slug":"import-the-theme-on-a-report","at":6676,"chars":390},{"level":2,"title":"Publish reports to Power BI","slug":"publish-reports-to-power-bi","at":7066,"chars":518},{"level":2,"title":"Distribute or share a report","slug":"distribute-or-share-a-report","at":7584,"chars":1038},{"level":2,"title":"How to develop cross-company or cross-environment Power BI reports","slug":"how-to-develop-cross-company-or-cross-environment-power-bi-reports","at":8622,"chars":1055},{"level":2,"title":"Customize the Power Query code that connects to your Business Central data source","slug":"customize-the-power-query-code-that-connects-to-your-business-central-data-source","at":9677,"chars":477},{"level":1,"title":"Edit existing report<#tab/existing>","slug":"edit-existing-reporttabexisting","at":10154,"chars":178},{"level":1,"title":"Create new report<#tab/new>","slug":"create-new-reporttabnew","at":10332,"chars":9944},{"level":3,"title":"Connect with the ApiContentsWithOptions function","slug":"connect-with-the-apicontentswithoptions-function","at":11642,"chars":2253},{"level":3,"title":"Advanced: Customize language, timeout, database replica, or page size for your Business Central data source","slug":"advanced-customize-language-timeout-database-replica-or-page-size-for-your-business-central-data-source","at":13895,"chars":2894},{"level":3,"title":"Configure the advanced options","slug":"configure-the-advanced-options","at":16789,"chars":798},{"level":2,"title":"Troubleshoot Power BI connections","slug":"troubleshoot-power-bi-connections","at":17587,"chars":2156},{"level":3,"title":"\"Expression.Error: The environment 'Production' doesn't exist.\" error when specifying a Business Central environment","slug":"expressionerror-the-environment-production-doesnt-exist-error-when-specifying-a-business-central-environment","at":17624,"chars":1158},{"level":3,"title":"\"Can't insert a record. Current connection intent is Read-Only.\" error connecting to custom API page","slug":"cant-insert-a-record-current-connection-intent-is-read-only-error-connecting-to-custom-api-page","at":18782,"chars":961},{"level":2,"title":"Related information","slug":"related-information","at":19743,"chars":533}],"text":"# Build Power BI reports for displaying Dynamics 365 Business Central data\nYou can make your Dynamics 365 Business Central data available as a data source in Power BI Desktop and build powerful reports about the state of your business.\nThis article describes how to start using Power BI Desktop to create reports that display Dynamics 365 Business Central data. After you create reports, you can publish them to your Power BI service or share them with all users in your organization. When the reports are in the Power BI service, users with access can view the reports in Dynamics 365 Business Central.\n## Prepare to build Power BI reports\n Sign up for the Power BI service.\n  If you aren't signed up, go to https://powerbi.microsoft.com<https://powerbi.microsoft.com>. When you sign up, use your work email address and password.\n Download Power BI Desktop<https://powerbi.microsoft.com/desktop/>.\n  Power BI Desktop is a free application you install on your local computer. See Quickstart: Connect to data in Power BI Desktop<https://learn.microsoft.com/power-bi/desktop-quickstart-connect-to-data>.\n Make sure the data you want in the report is available as an API (recommended) or published as a web service. See Expose data through API pages or OData web services<admin-powerbi-setup#exposedata>.\n Download the Business Central report theme (optional).\n  See Use the Business Central report theme<#theme> in this article.\n> NOTE\n> You could get the data from various companies in a single report with OData web services. However, starting with Business Central 2021 release wave 2, only ODataV4 is supported. ODataV4 doesn't export data from multiple companies. The $expand function in Power BI that you might think would be an alternative way to create a multi-company report can't be used either. It creates a column with the company name but doesn't populate it with the company data after a refresh.\n## Add Business Central as a data source in Power BI Desktop\nThe first task in creating reports is to add Business Central as a data source in Power BI Desktop. Once connected, you can start to build the report. The following steps use the new Get Data experience in Power BI Desktop. Learn more about the new experience in Get data in Power BI Desktop<https://learn.microsoft.com/power-bi/connect-data/desktop-data-sources?tabs=new-experience>.\n1. Start Power BI Desktop.\n1. Select Get data or Get data from other sources. If you don't see Get data, select the File menu, then Get data.\n If you're prompted to sign in, sign in using the same work account that you use to sign in to Business Central.\n> NOTE\n> The first time you connect to Business Central, you might be prompted to sign in. After you connect, you won't be prompted again unless you change or clear the account used for the connection. How do I change or clear the account I'm currently using to connect to Business Central from Power BI Desktop?<power-bi-faq?tabs=designer#perms>.\n1. On the Choose data source page, search for Business Central, and then select Dynamics 365 Business Central.\n1. On the Connect to data source page, select Next to connect to Business Central.\n1. On the Choose data page, expand the environment and company that contain the data you want to use in your report.\n The available data sources are grouped by environment and company as follows:\n  Environment name\n    Company name\n      Advanced APIs\n       Lists advanced APIs published by Microsoft, such as the Business Central automation APIs<dev-itpro/administration/itpro-introduction-to-automation-apis>, and APIs published by other organizations, also known as custom APIs. Custom APIs are further grouped according to the dev-itpro/developer/properties/devenv-apipublisher-property/dev-itpro/developer/properties/devenv-apigroup-property properties of the API source code.\n      Standard APIs v2.0\n       Lists the standard data APIs exposed by Business Central API V2.0<dev-itpro/api-reference/v2.0>. These APIs provide access to Business Central data, such as customers, vendors, items, general ledger entries, dimensions, payment methods, and units of measure.\n      Web services (legacy)\n       Lists pages and queries published as OData web services in Business Central. Codeunits aren't available as OData data sources. We recommend using APIs instead of OData web services when possible.\n1. Select the data source or sources that you want to add to your data model, and then select Load.\n1. To add more Business Central data later, repeat the previous steps.\nAfter the data is loaded, it appears in the Data pane on the right side of Power BI Desktop. You're now connected to your Business Central data and can start building your Power BI Desktop report.\n## Create accessible reports\nIt's important to make your reports usable for as many people as possible. Try to design reports so that they don't require any special adaptation to meet the specific needs of different users. Make sure the design lets users take advantage of assistive technologies, like screen readers. Power BI includes various accessibility features, tools, and guidelines to help. See Design Power BI reports for accessibility<https://learn.microsoft.com/power-bi/create-reports/desktop-accessibility-creating-reports> in the Power BI documentation.\n## Create reports to display data associated with a list in Business Central\nYou can create reports that display in a FactBox on a Business Central list page, and change when different rows are selected in the list. Creating these reports is similar to other reports, except there are a few things to do to make sure the reports display as expected. See Creating Power BI Reports for Displaying List Data in Business Central<across-how-use-powerbi-reports-factbox>.\n## Using the Business Central report theme (optional)\nBefore building your report, we recommend that you download and import the Business Central theme file. The theme file creates a color palette so you can build reports with the same color styling as the Business Central apps, without requiring you to define custom colors for each visual.\n> NOTE\n> This task is optional. You can always create your reports and then download and apply the style template later.\n### Download the theme\nThe theme file is available as a json file on Microsoft Power BI Community Themes Gallery. To download the theme file, do the following steps:\n1. Visit Microsoft Power BI Community Themes Gallery for Microsoft Dynamics 365 Business Central<https://community.fabric.microsoft.com/discussions/ThemesGallery/microsoft-dynamics-365-business-central/385875>.\n2. Select the download attachment Microsoft Dynamics Business Central.json.\n### Import the theme on a report\nAfter you download the Business Central report theme, import it to your reports. In the ribbon, select Design > Import theme, and then browse for the Microsoft Dynamics Business Central.json file. See Power BI Desktop - Import custom report themes<https://learn.microsoft.com/power-bi/create-reports/desktop-report-themes#import-custom-report-theme-files>.\n## Publish reports to Power BI\nAfter you create or modify a report, you can publish the report to your Power BI service and also share it with others in your organization. After you publish a report, it's available in Business Central. The report also becomes available for selection in Business Central.\nTo publish a report, select Publish on the Home tab of the ribbon or from the File menu. If you're signed into the Power BI service, the report is published to this service. Otherwise, you're prompted to sign in.\n## Distribute or share a report\nThere are a couple of ways to share reports:\n Share a report from your Power BI service (recommended)\n  You need a Power BI Pro or Premium Per User (PPU) license to share reports from the Power BI service. Recipients also need Pro or PPU unless both the report and its semantic model are hosted in Premium capacity or Fabric F64 or larger capacity. Content in a PPU workspace requires PPU licenses for recipients. See https://learn.microsoft.com/power-bi/collaborate-share/service-share-dashboards#share-a-dashboard-or-report.\n Distribute reports as .pbix files.\n  Reports are stored on your computer as .pbix files. You can distribute the .pbix file to users, like any other file. Then, the people you shared the file with can upload it to their Power BI service. See Upload reports from files<across-working-with-powerbi#upload>.\n> NOTE\n> Distributing reports in this way means that refreshing data for reports is done individually by each user. This situation might impact Business Central performance.\n## How to develop cross-company or cross-environment Power BI reports\nThe Business Central API endpoints all have the prefix `https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0` followed by `/companies({company_id})/accounts({id})` (here we use the accounts API as an illustration). You can use this structure to create PowerQuery queries that load data for multiple companies or multiple environments if the user who is reading data can access them.\nTo set up a query to load data for multiple companies, follow these steps:\n1. Take the PowerQuery query that loads data for a single company. Convert it to a custom Power Query function that takes the company ID (or maybe the environment name) as parameters. See Using custom Power Query functions<https://learn.microsoft.com/power-query/custom-function>.\n1. Now use the new custom function in a PowerQuery query, where you map the function over a list of companies and then merge the datasets using the https://learn.microsoft.com/powerquery-m/table-combine Power Query function.\n## Customize the Power Query code that connects to your Business Central data source\nIn most cases, using the navigation experience in the Power BI Desktop user interface is enough to get you started with building reports based on Business Central data. However, more complex scenario might require you to manually edit the Power Query code responsible to get your data.\nTo do that, follow these steps:\n1. Start Power BI Desktop.\n2. Complete the step that suits your scenario:\n# Edit existing report<#tab/existing>\n1. Select File > Open.\n2. Browse for and select the report (.pbix).\n3. In the ribbon, select Transform Data to open the Power Query Editor.\n# Create new report<#tab/new>\n1. In the ribbon, select Get Data. If you don't see Get Data, select the File menu, then Get Data.\n2. On the Get Data page, select Online Services > Dynamics 365 Business Central > Connect.\n3. In the Navigator window, select the API endpoint that you want to load data from.\n4. Select Transform Data instead of Load as you might normally do. This step opens Power Query Editor.\n3. In Power Query Editor, select Advanced Editor from the ribbon.\nThis displays the Power Query code that the system autogenerated when you made your selections in the navigator. For example, let's assume you selected the Business Central environment named Production, the company called CRONUS USA, Inc., the API folder called Standard APIs v2.0, and the table called customers. Navigating to the Advanced Editor would show a query similar to this one:\n```powerquery\nlet\n  Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),\n  PRODUCTION = Source{[Name=\"PRODUCTION\"]}[Data],\n  #\"CRONUS USA, Inc.\" = PRODUCTION{[Name=\"CRONUS USA, Inc.\"]}[Data],\n  v2.0 = #\"CRONUS USA, Inc.\"{[Name=\"v2.0\"]}[Data],\n  customers_table = v2.0{[Name=\"customers\",Signature=\"table\"]}[Data]\nin\n  customers_table\n```\nYou can now manually edit this query to make the changes that suite your needs.\n### Connect with the ApiContentsWithOptions function\nIn the query above, the function Dynamics365BusinessCentral.ApiContentsWithOptions is responsible for connecting to Business Central and retrieve the data. This function has 4 optional parameters that aren't provided in the default query.\nHere's a breakdown of the different parameters:\nParameter|Examples|Description\n-|-|-\nEnvironment|`\"Production\"`|This parameter allows you to specify the Business Central environment to connect to. If not specified, the function returns a list of all environments, and you need to select the appropriate environment in the subsequent steps of your Power Query code\nCompany|`\"CRONUS USA, Inc.\"`|This parameter allows you to specify the Business Central company to connect to, inside your selected environment. This parameter is ignored if the Environment parameter isn't specified. If not specified, the function returns a list of all companies in your selected environent (or environments), and you need to select the appropriate company in the subsequent steps of your Power Query code\nAPI category (or API route)|`\"microsoft/runtime/beta\"`, `\"v2.0\"`|This parameter allows you to specify the API route connect to in Business Central, inside your selected environment and company. This parameter is ignored if the Environment and Company parameters aren't specified. If not specified, the function returns a list of all API categories (also called API routes) in your selected environment/environments and company/companies, and you need to select the appropriate API category in the subsequent steps of your Power Query code\nAdvanced Options||This parameter allows you to specify some advanced options to connect to your Business Central data source. Notice that in the vast majority of cases, the default values are optimized and don't need to be changed. Consult the following section for more information about these parameters.\nFor example, the query shown above in this section is completely equivalent to the following query:\n```powerquery\n let\n   Source = Dynamics365BusinessCentral.ApiContentsWithOptions(\"PRODUCTION\", \"CRONUS USA, Inc.\", \"v2.0\", null),\n   customers_table = Source{[Name=\"customers\",Signature=\"table\"]}[Data]\n in\n   customers_table\n```\n### Advanced: Customize language, timeout, database replica, or page size for your Business Central data source\nThe Power BI connector for Business Central supports several advanced properties for connecting to a Business Central data source that you can set in your Power Query queries. The following table describes the parameters.\n|Advanced Option|Description|Default|Learn more at|\n|-|-|-|-|\n|AcceptLanguage|This parameter allows you to specify preferred languages for responses, ensuring users receive messages and translatable strings in their desired language. It sets the language in which the Business Central API session runs. It influences the language of error messages, formatted values in AL, and other values that depend on language or culture.<br><br>This option doesn't select the display language of the Power BI report.|not specified|Accept-Language HTTP header<dev-itpro/developer/devenv-connect-apps-tips#AcceptLanguage>.|\n|ODataMaxPageSize|This parameter limits the number of entities per results page, which allows for more flexibility when connecting to large datasets or using complex queries. It sets the maximum number of records to return for each page when calling an API. For example, if your table Customers has 13,000 records and ODataMaxPageSize is set to 5000, Power BI makes 3 API calls to get your customers. The first call gets 5,000 records, the next one gets 5000 more, and the last call gets the remaining 3000. This option can't be higher than the maximum page size enforced by Business Central, which is 20000.<br><br>Setting this parameter ensures efficient and responsive data retrieval, leading to faster insights and decision-making. You can't exceed the maximum page size defined on the service.|5000|ODataPreferenceHeader.MaxPageSize Property<https://learn.microsoft.com/dotnet/api/microsoft.odata.odatapreferenceheader.maxpagesize>|\n|Timeout|This parameter defines the maximum duration for a request before cancellation. It sets the timeout for each single API call to Business Central. Increasing this value doesn't extend the OData request timeout enforced by Business Central online, which is 8 minutes (00:08:00).<br><br>Setting this parameter helps manage system resources effectively and prevents long-running queries from impacting overall system performance. Users experience minimal delays and interruptions, ensuring a smoother workflow.|00:08:00|https://learn.microsoft.com/powerquery-m/odata-feed and Business Central online service limits<dev-itpro/administration/operational-limits-online>|\n|UseReadOnlyReplica|This parameter determines whether requests target the primary database or a read-only replica. Offloading read operations from the primary database can significantly boost performance.<br><br> Setting this property leads to faster data retrieval and improved system stability, especially during peak usage times.|true||\n### Configure the advanced options\n1. Follow the steps to view the Power Query code from Power BI Advanced Editor\n1. In Advanced Editor, locate the line that starts with `Source =`.\n ```powerquery\n Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),\n ```\n1. In the line, replace the fourth parameter of Dynamics365BusinessCentral.ApiContentsWithOptions with a Power Query record of properties and values you want to set, for example:\n ```powerquery\n Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From(\"00:07:00\"), ODataMaxPageSize = 10000, AcceptLanguage = \"it-it\"]),\n ```\n1. Select Done to close Advanced Editor.\n1. Select Close & Apply to save the changes and close Power Query Editor.\n## Troubleshoot Power BI connections\n### \"Expression.Error: The environment 'Production' doesn't exist.\" error when specifying a Business Central environment\n> APPLIES TO: Business Central online\nWhen you connect to Business Central online from Power BI, or when you install a Power BI Desktop app from Microsoft Marketplace that uses Business Central data, you might be prompted to input the Business Central environment you want to connect to.\nIf you get an error similar to \"Expression.Error: The environment 'Production' doesn't exist.\", follow these steps to troubleshoot:\n1. Make sure you're using the right credentials to access Business Central. These credentials might not be the same credentials you use to access Power BI. How do I change or clear the account I'm currently using to connect to Business Central from Power BI Desktop?<power-bi-faq?tabs=designer#perms>\n2. If your environment is an embedded ISV environment, you need to specify the embedded ISV name in parenthesis as part of the environment name. For example, if you want to connect to an environment named Production from the embedded ISV named Fabrikam, you must specify \"PRODUCTION (fabrikam)\" as environment name.\n### \"Can't insert a record. Current connection intent is Read-Only.\" error connecting to custom API page\n> APPLIES TO: Business Central online\nBy default, reports that use Business Central data connect to a read-only replica of the Business Central database. In rare cases, depending on the API design, you might get an error when you try to connect to and get data from the API. The error looks like this:\n`Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])\".`\nIf you're using a custom API, we recommend you rework the AL code to make sure it doesn't make database modifications when it's just reading data. But in case your scenario requires it, you can configure the connector to use a read-write connection instead<#advanced-customize-language-timeout-database-replica-or-page-size-for-your-business-central-data-source>.\n## Related information\nEnable Your Business Data for Power BI<admin-powerbi-setup>\nBusiness Intelligence<bi>\nGet Ready for Doing Business<ui-get-ready-business>\nImport Business Data from Other Finance Systems<across-import-data-configuration-packages>\nSet Up Business Central<setup>\nfinance\nQuickstart: Connect to data in Power BI Desktop<https://learn.microsoft.com/power-bi/desktop-quickstart-connect-to-data>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}