For the complete documentation index, see llms.txt. This page is also available as Markdown.
User Roles and Permissions
For administrators: Manage user roles and permissions for the Shopware 6 API Connector.
The icon marks those chapters of the documentation that are primarily relevant for administrators.
The Shopware 6 API Connector uses the standard permission system of Microsoft Dynamics 365 Business Central. Here you learn which permissions are required to use the connector.
1. Assigning permissions
When the Shopware 6 API Connector is installed, a permission set is created automatically:
SOUSHW PERM: Full access to all Shopware functions
Assigning it to an individual user
Enter "Users" in the Business Central search function and open the page.
Select the desired user.
Click "Permission Sets".
Add "SOUSHOPWAREAPICONNEC".
2. Required basic permissions
In addition to the Shopware permission set, users need the following standard permissions:
Area
Required permission
Items
Read, Write
Customers
Read, Write
Sales Orders
Read, Write
Sales Invoices
Read
Sales Credit Memos
Read
Sales Shipments
Read
For the PDF upload, users additionally need read permissions for "Posted Sales Documents".
3. Recommended user roles
Full access to all functions
Can change the configuration
Can manage the API connection
Can edit mapping tables
Can synchronize items
Can import orders
Can update prices and inventory
No changes to the configuration
Can view activity logs
Can display the order overview
No synchronization functions
4. Shopware API permissions
Corresponding permissions must also be in place on the Shopware side:
The integration requires the following permissions:
product:read, product:write
category:read, category:write
media:read, media:write
customer:read
order:read, order:write
solutioo_invoice_document:read, solutioo_invoice_document:write (for the PDF module)
The admin user that is used should have full admin rights.
Restricted permissions in Shopware can lead to errors during synchronization!
