For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.

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.

More about the technical communication: API Endpoints (Reference).

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 and Operate Multiple Sales Channels.

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.