Right to Repair & EmpCo: Claims and Repairability

User permissions

The “Repair compliance” permission group with view, edit, create and delete – and who additionally needs product rights.

If several people work in your admin, you can control exactly who may do what with claims. The extension ships its own permission group called Repair Compliance, filed under Orders in the permissions list.

That's how you avoid everyone being able to do everything: your support team can view and process claims, while only the team lead may delete them.

The four levels

Permissions follow the usual Shopware pattern with four levels: View, Edit, Create, Delete. Each higher level builds on the ones below.

LevelWhat that person may do
ViewSee claims – the list, the board and a claim's detail page including the related order data. Also read the configuration, the templates and the export function. No changes.
EditOn top of View: run the workflow steps (give the notice, confirm the choice, mark as repaired, close, move cards on the board), save the configuration and import repairability product data by CSV. Requires View.
CreateOn top of that: create new claims – both manually via "New claim" and via the claims CSV import. Requires View and Edit.
DeleteOn top of that: delete claims. Requires View.

In practice:

  • Anyone who just needs an overview (management, say) gets View.
  • The support team handling claims gets View + Edit – and Create if they should log claims themselves.
  • Hand out Delete sparingly. Your claims are your compliance documentation.

Assign the permissions to a role

In Shopware you don't give permissions to individual people but to roles, which you then assign to people.

Step 1: In the admin, open Settings and go to Users & permissions → Roles.

Step 2: Pick an existing role or create a new one with Add role (for example "Support" or "Claims").

Step 3: Switch to the detailed permissions and find the group Repair Compliance – it sits with the order permissions.

Step 4: Tick the levels this role needs – View, Edit, Create, Delete. Mind the prerequisites above (Create also needs View and Edit).

Step 5: Save the role.

Step 6: Assign the role to the relevant people under Users.

The people affected should log out and back in after the change, so the new permissions take effect.

What happens without enough permissions

If someone is missing a permission, the extension either hides the function or shows it read-only. On a claim detail page, for instance, the workflow steps are visible but not runnable without the Edit permission, and a notice like "You're missing the 'Edit' permission…" appears.

If the module doesn't show up at all under Orders, the most likely cause is a missing View permission – followed by a cache that needs clearing.

The product import needs product permissions too

One special case: the repairability data import (EmpCo) writes values directly onto your products. The Edit permission of the "Repair Compliance" group is not enough on its own – the person also needs the normal Shopware product permissions (view and edit products).

If an import fails with a permissions error, add the product permissions to the role. More on the import itself in Import & export, more on the product fields in Product page (EmpCo).

These permissions are about organising your team internally. They are not a legal control – whether a claim is handled correctly stays a matter for the people doing the work.

Was this page helpful?