1. Die Schnittstellen im Überblick
Shopware 6 hat zwei HTTP-Schnittstellen, die JSON austauschen: die Admin API für Verwaltung und Hintergrundaufgaben und die Store API für alles, was Kunden im Shop tun. Dazu kommen zwei Wege ohne Programmierung: das Modul Import/Export für CSV-Dateien und der Verkaufskanal Produktvergleich, der Produktfeeds unter einer festen Adresse bereitstellt.
- Admin API: Produkte, Kategorien und Bestellungen verwalten, Backend-Anbindungen, Import- und Exportabläufe, Massenänderungen.
- Store API: kundennahe Abläufe, etwa Produkt- und Kategoriedaten für Apps und Headless-Frontends.
- Import/Export: Daten per CSV einspielen oder auslesen, ohne Code.
- Produktvergleich: Produktfeed als CSV oder XML für Preisportale, Google Shopping oder eine externe Suche.
2. Admin API und Integrationen
Die Admin API liegt unter /api/ und verlangt eine Anmeldung per OAuth 2.0. Die Zugangsdaten dafür legst du in der Administration unter Einstellungen > System > Integrationen an. Jede Anwendung bekommt dort einen eigenen Zugang: Du vergibst einen Namen und entscheidest, ob die Integration Administratorrechte erhält oder eine eingeschränkte Rolle.
Nach dem Anlegen erhältst du eine Zugangs-ID und einen Sicherheitsschlüssel. Den Schlüssel zeigt Shopware nur in diesem Moment an, speichere ihn also sofort sicher ab. Später kannst du ihn nur neu erzeugen, dabei werden laut Doku Zugangs-ID und Schlüssel ersetzt, und die angebundene Anwendung braucht die neuen Daten.
Gib einer Integration nur die Rechte, die sie braucht. Ein Tool, das nur Bestellungen ausliest, braucht keine Administratorrechte.
3. Store API
Die Store API liegt unter /store-api/ und ist öffentlich erreichbar. Sie braucht keinen Login, aber den Zugangsschlüssel eines Verkaufskanals im Header sw-access-key. Den Schlüssel findest du im jeweiligen Verkaufskanal, etwa beim Storefront-Kanal, und kannst dort einen neuen erzeugen. Dann wird der alte ungültig. Für kundenbezogene Endpunkte wie das Kundenkonto ist zusätzlich eine Anmeldung nötig.
Die Store API nutzt du für Headless-Frontends, Apps oder Erweiterungen, die Produkt- und Kategoriedaten so abrufen, wie ein Kunde sie im Verkaufskanal sieht, also mit dessen Preisen, Sprache und Sichtbarkeit.
4. Import/Export per CSV
Unter Einstellungen > Automatisierung > Import/Export spielst du Daten per CSV ein oder liest sie aus. Ein Profil legt fest, welche Spalten in welche Daten geschrieben werden. Die Datei muss laut Doku UTF-8 sein, mit Semikolon als Feldtrenner und Anführungszeichen als Zeichenketten-Trenner. Preise schreibst du mit Punkt (5.00 statt 5,00), sonst werden sie falsch importiert.
Zwei Eigenheiten solltest du kennen: Ein Import kann nur hinzufügen, nicht entfernen. Eine bestehende Verkaufskanalzuordnung eines Produkts löschst du also nicht per Import. Und mit „Testlauf starten“ prüfst du die Datei vorab komplett, damit ein Import nicht nur halb durchläuft. Fehlerhafte Zeilen bekommst du als eigene CSV zum Download, die Import-Aktivität zeigt die letzten 30 Tage.
5. Produktfeeds über den Produktvergleich
Für Preisportale, Marktplätze und externe Dienste legst du einen Verkaufskanal vom Typ Produktvergleich an. Für große Preisportale gibt es Vorlagen, das Template arbeitet mit Twig-Variablen. Als Format wählst du CSV oder XML, dazu Varianten, Generierungsintervall und über eine dynamische Produktgruppe, welche Artikel im Feed stehen. Die fertige Datei liegt unter einer Export-URL, die du beim Portal einträgst.
Neu erzeugt wird die Datei laut Doku nur, wenn das Intervall abgelaufen und „per Scheduler generieren“ aktiv ist. Zeigt die Export-URL im Browser einen Fehler, prüfst du die Bedingungen der dynamischen Produktgruppe, etwa „Verkaufspreis > 0“.
6. Beispiel: eine externe Suche anbinden
Eine externe Shopsuche braucht vor allem aktuelle Produktdaten. Grumeria nutzt dafür den Produktfeed: Du trägst die Export-URL aus dem Produktvergleich ein, Grumeria liest sie regelmäßig ein, und das kostenlose Plugin Grumeria Suche bindet das Such-Widget ein. Eine Integration mit Administratorrechten musst du dafür nicht anlegen.
Ob dein Feed die nötigen Felder enthält, prüfst du vorab ohne Anmeldung im Feed-Check. Die Tarife beginnen bei 29 € netto im Monat, die ersten 14 Tage sind kostenlos.
Häufige Fragen
Welche Schnittstellen hat Shopware 6?
Die Admin API für Verwaltung und Backend-Anbindungen, die Store API für kundennahe Abläufe und Headless-Frontends, das Modul Import/Export für CSV-Dateien und den Verkaufskanal Produktvergleich für Produktfeeds als CSV oder XML.
Wo lege ich in Shopware 6 einen API-Zugang an?
Für die Admin API unter Einstellungen > System > Integrationen. Dort vergibst du einen Namen und Rechte und erhältst Zugangs-ID und Sicherheitsschlüssel. Für die Store API nutzt du den Zugangsschlüssel des Verkaufskanals.
Was ist der Unterschied zwischen Admin API und Store API?
Die Admin API verwaltet Daten im Hintergrund und verlangt eine Anmeldung per OAuth 2.0. Die Store API liefert Daten so, wie Kunden sie im Verkaufskanal sehen, und braucht nur den Zugangsschlüssel des Kanals im Header sw-access-key.
Wie exportiere ich einen Produktfeed aus Shopware 6?
Über einen Verkaufskanal vom Typ Produktvergleich. Du wählst eine Vorlage oder ein eigenes Template, CSV oder XML und eine dynamische Produktgruppe. Die Datei steht dann unter der Export-URL des Kanals bereit.