> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/shopware6_en_us/frequently-asked-questions-faq/faq-connection-and-authentication.md). # FAQ – Connection & Authentication ### Which access data do I need in order to connect Business Central to Shopware? You need either an **integration access** (Access Key ID + Secret Access Key) or an **administration user** (user name + password) from Shopware. The integration access is recommended because it is independent of personal user accounts. For details, see [Authentication Methods in Detail](/shopware/shopware6_en_us/configuration/authentication-methods-in-detail.md). ### What is the difference between integration access and an admin user? The **integration access** (client credentials) is a technical access without any personal reference and is therefore ideal for automation. The **admin user** (password grant) uses the user name and password of a Shopware administrator and must be updated whenever the password changes. The connector supports both methods. ### How do I test the connection to the Shopware shop? Enter the URL, API module path, and access data in the Shopware configuration and use the **Test Connection** action. If it succeeds, a valid token is retrieved. You will find detailed instructions under [Test Connection & Diagnostics](/shopware/shopware6_en_us/configuration/test-connection-and-diagnostics.md). ### The connection fails – what can I do? Check the **website URL** (including `https://`), the **API module path** (usually `/api`), and the **access key** and **secret**. If necessary, enable the Developer Log to see the exact server response. Additionally, test the URL in a browser and check your firewall settings. ### What is the Shopware API module path? Usually `/api`. A trailing slash is removed automatically by the connector so that no duplicate paths occur. ### Do I have to renew the API token manually? No. The Shopware 6 API Connector retrieves the access token automatically when required and renews it on its own. You do not have to worry about token management. ### What happens if I change the Shopware admin password? With the password grant (admin user), you must enter the new password in the configuration, otherwise the sign-in fails. With the **integration access**, a password change has no effect – another reason to prefer the integration access. ### Why do I receive the error "401 Unauthorized"? A **401 Unauthorized** means that authentication against the Shopware API has failed. Check the API access data, generate new integration credentials in Shopware if necessary, and make sure that the integration is active. ### Which Shopware version is supported? **Shopware 6.4 or higher** with access to the Admin API is recommended. The connector communicates exclusively via the Shopware Admin API. {% hint style="info" %} More about the technical communication: [API Endpoints (Reference)](/shopware/shopware6_en_us/reference-and-lookup/api-endpoints-reference.md). {% endhint %} ### Which Shopware permissions does the integration access need? In Shopware 6, the integration access (access key) needs read and write permissions for the relevant areas of the Admin API: products, categories, properties, media, customers, orders, prices, and sales channels. The easiest approach is to create an integration with administrator permissions in Shopware under **Settings › System › Integrations**. This allows the Shopware 6 API Connector to fully synchronize all data between Business Central and Shopware. ### Does the access token expire and do I have to renew it? No, the actual access token (bearer token) is retrieved automatically by the Shopware 6 API Connector and renewed on its own when it expires. In Business Central, you only enter the Access Key ID and Secret Access Key once. Only if you delete the integration in Shopware or regenerate the keys do you have to update the access data in the configuration. ### Can I connect several Shopware shops to one Business Central environment? Yes. The connector supports multiple sales channels and environments. For separate shops, you work with different sales channels or separate configurations. This allows you, for example, to run a B2B and a B2C shop in parallel from the same Business Central. For details, see [Set Up Sales Channels](/shopware/shopware6_en_us/configuration/set-up-sales-channels.md) and [Operate Multiple Sales Channels](/shopware/shopware6_en_us/onboarding-and-best-practices/operate-multiple-sales-channels.md). ### Why do I receive the error 401 Unauthorized? An HTTP status of **401 Unauthorized** means that authentication has failed. Check the Access Key ID and Secret Access Key for typos, make sure that the integration in Shopware has not been deactivated or deleted, and verify the API module path (usually `/api`). After correcting this, use the **Test Connection** action again. ### What does the error 404 or an empty response during the connection test mean? A **404** or an empty response usually indicates an incorrect shop URL or an incorrect API module path. Check that the website URL starts with `https://`, contains no superfluous paths, and that the API path is correct. Also open the URL in a browser to check whether the shop is reachable and that no maintenance mode or firewall is blocking access. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.solutioo.de/shopware/shopware6_en_us/frequently-asked-questions-faq/faq-connection-and-authentication.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.