Shopware

Shopware Admin API

Die Shopware Admin API ist die Management- und Integrationsschnittstelle von Shopware 6. Über sie greifen Server, ERP- und PIM-Systeme sowie Middleware auf die Backend-Daten des Shops zu, um Produkte, Bestellungen, Kunden und Konfigurationen zu pflegen. Sie deckt CRUD-Operationen für die Shopware-Entitäten ab, ist RESTful aufgebaut, gibt JSON aus und authentifiziert sich über OAuth 2.0.

Die Admin API ist für die Server-zu-Server-Kommunikation gedacht, nicht für den Endkunden. Sie ist die Schnittstelle, über die Daten in Shopware hinein- und aus Shopware herausfließen: Produktimporte aus einem PIM, Bestellexporte in ein ERP, Kundenabgleich mit dem CRM oder Massenaktualisierungen über Middleware. Der Fokus liegt auf Konsistenz, Validierung und der Verarbeitung großer Datenmengen.

Damit ist die Admin API die zweite Hälfte des zweigeteilten Shopware-API-Modells. Ihre Gegenstelle, die Store API, bedient das kundenseitige Frontend. Den Gesamtüberblick über beide Schnittstellen liefert der Eintrag Shopware API. Dieser Eintrag vertieft ausschließlich die Admin API.

Kriterium	Shopware Admin API	Shopware Store API
Perspektive	Verwaltend (Backend, Integration)	Kundenseitig (Frontend, Sales Channel)
Typische Nutzung	Produkte, Bestellungen, Kunden pflegen (CRUD)	Produkte anzeigen, Warenkorb, Checkout
Aufrufer	ERP, PIM, CRM, Middleware, Server-Prozesse	Frontend, App, Headless-Storefront
Authentifizierung	OAuth 2.0 (Integration oder Nutzer)	Access-Key je Sales Channel (sw-access-key)
Datenumfang	Voller Zugriff auf Backend-Entitäten	Nur freigegebene, kundenrelevante Daten

Stand: August 2026. Angaben zur Shopware 6 Admin API und Store API auf Basis der offiziellen Entwicklerdokumentation (developer.shopware.com).

Datenfluss der Shopware Admin API

ERP- und PIM-Systeme kommunizieren über OAuth-2.0-authentifizierte Server-zu-Server-Aufrufe mit der Admin API, die die Daten im Shopware-Backend pflegt. Die Darstellung ist schematisch vereinfacht.

Wofür wird die Shopware Admin API genutzt?

Die Admin API ist die Schnittstelle für Verwaltung und Systemanbindung. Sie kommt überall dort zum Einsatz, wo Daten zwischen Shopware und anderen Systemen automatisiert ausgetauscht werden. Typische Aufgaben:

Produktdaten aus einem PIM nach Shopware synchronisieren (anlegen, ändern, löschen).
Bestellungen und Kunden an ein ERP oder CRM übergeben und Status zurückschreiben.
Bestände und Preise per Massenoperation aktualisieren.
Konfigurationen, Kategorien und Medien programmgesteuert verwalten.

Anders als die Store API ist die Admin API nicht auf einen einzelnen Sales Channel beschränkt, sondern arbeitet auf der Ebene der Backend-Entitäten. Sie ist für hohe Datenlasten und transaktionale Integrität ausgelegt, nicht für die kürzest mögliche Antwortzeit im Frontend.

Einordnung

Die Admin API ist die Schnittstelle, an der die meisten Integrationsprojekte tatsächlich hängen. Ob ERP, PIM oder CRM: der Datenfluss in den Shop hinein läuft über sie. Der teuerste Fehler ist, sie mit der Store API zu verwechseln und Frontend-Logik über die Admin API zu bauen. Wer die Admin API sauber und rechtebeschränkt anbindet, hält Import und Export stabil, auch bei großen Sortimenten.

Philipp Foreman, Geschäftsführer onacy GmbH

Admin API als Basis für ERP- und PIM-Anbindung

Die Admin API ist der technische Weg, über den die Shopware-ERP-Anbindung und die Anbindung eines PIM an Shopware laufen. Ein ERP schiebt Bestellungen, Bestände und Kundendaten über die Admin API, ein PIM liefert die Produktdaten. Damit dieser Austausch stabil bleibt, braucht es klare Rechte über OAuth-Integrationen, saubere Fehlerbehandlung und ein durchdachtes Mapping der Datenfelder.

Bei onacy binden wir Shopware über die Admin API so an, dass Datenhoheit und Fehlerbehandlung von Anfang an geregelt sind. Den Überblick, wie Store API und Admin API zusammenspielen, liefert der Eintrag Shopware API.

Häufige Fragen zur Shopware Admin API

Was ist die Shopware Admin API?

Die Shopware Admin API ist die Management- und Integrationsschnittstelle von Shopware 6. Über sie greifen Server, ERP- und PIM-Systeme sowie Middleware auf die Backend-Daten zu, um Produkte, Bestellungen, Kunden und Konfigurationen zu pflegen. Sie deckt CRUD-Operationen für die Shopware-Entitäten ab, ist RESTful aufgebaut, liefert JSON und authentifiziert sich über OAuth 2.0.

Was ist der Unterschied zwischen Admin API und Store API?

Die Admin API ist verwaltend und für die Server-zu-Server-Integration gedacht, etwa das Pflegen von Produkten, Bestellungen und Kunden aus ERP oder PIM. Die Store API ist kundenseitig und bedient das Frontend eines Sales Channels mit Produktanzeige, Warenkorb und Checkout. Die Admin API nutzt OAuth 2.0, die Store API einen Sales-Channel-Access-Key. Beide sind RESTful und liefern JSON.

Wie authentifiziert sich ein System an der Admin API?

Die Admin API nutzt OAuth 2.0. Für Systemanbindungen legt man in Shopware eine Integration an und erhält eine Access-Key- und Secret-Kombination, mit der sich das externe System per client_credentials ein Token holt. Alternativ ist eine nutzerbasierte Anmeldung möglich. Über die Rechte der Integration lässt sich der Zugriff gezielt einschränken.

Läuft die ERP-Anbindung von Shopware über die Admin API?

Ja. Die Admin API ist der Standardweg für die Anbindung von ERP-, PIM- und CRM-Systemen an Shopware. Ein ERP übergibt Bestellungen, Bestände und Kundendaten, ein PIM liefert Produktdaten, jeweils per CRUD über die Admin API. Wichtig sind klare OAuth-Rechte, ein sauberes Feld-Mapping und robuste Fehlerbehandlung, damit der Datenaustausch auch bei großen Sortimenten stabil bleibt.

ERP und PIM sauber an Shopware anbinden

Die Admin API ist der Weg, auf dem ERP-, PIM- und CRM-Daten in Shopware fließen. Im Erstgespräch klären wir, wie Ihre Systeme über die Admin API angebunden werden, damit Import, Export und Fehlerbehandlung auch bei großen Sortimenten tragen.

Shopware-Erstgespräch vereinbaren

Mehr Kontext: Shopware-Leistungen und Integrationen und Schnittstellen