tl;dr
Du brauchst zwei Dinge aus Shopware, um die Verbindung abzuschließen:
Deine Shopware API URL (deine Shop-URL +
/api)Eine Access Key ID und einen Secret Access Key — erzeugt in Shopwares Einstellungen → Integrationen
Zwei Optionen für die Integration: Administrator-Zugriff gewähren (am schnellsten) oder eine eigene Rolle mit reinen Leserechten erstellen (sicherer, für den Produktivbetrieb empfohlen).
Schritt 1: Shopware 6 als Datenquelle in Klar hinzufügen
Gehe in der linken Seitenleiste zu Store-Konfigurator → Datenquellen
Klicke auf Datenquelle hinzufügen → Neue Datenquelle hinzufügen
Suche oder wähle Shopware 6
Gib einen Namen für den Store ein (z.B.
Shopware 6 DE) und klicke auf Connect
Schritt 2: Deine Shopware API URL eingeben
Gib in Klar deine Shopware API URL ein. Das ist deine Shop-URL mit angehängtem /api:
Shop-URL:
my-shop.com→ API-URL:my-shop.com/apiShop-URL:
www.my-shop.com→ API-URL:www.my-shop.com/api
⚠️ Hinweis: Manche Shopware-Setups benötigen die URL ohne www. — wenn die Verbindung fehlschlägt, versuche es ohne.
Schritt 3: Eine Integration in Shopware erstellen
Gehe in deinem Shopware-Admin zu Einstellungen → Integrationen.
Klicke auf Integration hinzufügen. Du hast zwei Optionen:
Option A — Administrator-Zugriff (am schnellsten) Aktiviere den Administrator-Toggle. Das gibt Klar vollen Lesezugriff. Nutze dies zum Testen oder wenn dir der Berechtigungsumfang recht ist.
Option B — Eigene Rolle mit reinen Leserechten (empfohlen) Siehe den Abschnitt Setup der eigenen Rolle unten für ein sichereres Setup.
Schritt 4: Zugangsdaten in Klar kopieren
Sobald die Integration gespeichert ist, kopiere die Access Key ID und den Secret Access Key aus Shopware und füge sie in die entsprechenden Felder in Klar ein. Schließe das Setup über Save Integration ab.
Für Option B: Eigene Rolle statt Admin-Rechte gewähren
Für Produktivumgebungen empfehlen wir, eine Rolle mit nur den Berechtigungen zu erstellen, die Klar benötigt — Lesezugriff auf Bestellungen, Produkte und Kunden.
Melde dich in deinem Shopware-6-Admin-Dashboard an
Gehe zu Einstellungen → System → Benutzer & Berechtigungen
Klicke im linken Menü auf Rollen
Klicke auf Rolle erstellen
Gib einen Namen ein (z.B.
Klar API Read-Only)Klicke auf den Tab Berechtigungen
Gewähre Ansehen (Lesen)-Zugriff für die folgenden Entitäten — nutze die Suchleiste, um jede schnell zu finden:
Entität | Berechtigung |
Category | Ansehen |
Country | Ansehen |
Currency | Ansehen |
Order | Ansehen (umfasst order, order-delivery, order-transaction, order/line-items) |
Payment Method | Ansehen |
Product | Ansehen |
Sales Channel | Ansehen |
Shipping Method | Ansehen |
State Machine State | Ansehen |
Unit | Ansehen |
8. Klicke auf Save
9. Weise beim Erstellen der Integration (Schritt 3) diese neue Rolle zu, statt Administrator zu aktivieren