Shopware Plugins

Shopware per SQL-API mit dem ERP verbinden

Manchmal braucht das ERP nur schnell die aktuellen Lagerbestände, und der Weg über die Standard-API ist dafür zu aufwendig. Genau dafür gibt es die SQL API.

Wann eine SQL-Schnittstelle sinnvoll ist

Die Admin-API von Shopware ist mächtig, für manche Aufgaben aber umständlich: Für eine einfache Bestandsliste müssen mehrere Anfragen gestellt und die Ergebnisse zusammengesetzt werden. Viele ERP-Systeme und Warenwirtschaften können dagegen problemlos einen HTTP-Aufruf absetzen und JSON verarbeiten.

Die SQL API schließt diese Lücke. Sie eignet sich besonders für schnelle Lesezugriffe, etwa Bestände, Bestellstatus oder Auswertungen, und für einfache, klar definierte Änderungen wie das Aktivieren oder Deaktivieren von Produkten.

So funktioniert die SQL API

Ihr System sendet eine POST-Anfrage an den Endpunkt /api/kzphSqlApi/execute Ihres Shops. Übergeben werden zwei Parameter:

  • hash: der geheime Schlüssel aus der Plugin-Konfiguration, sofern aktiviert.
  • cmds: eine oder mehrere SQL-Abfragen, getrennt durch Semikolon, die nacheinander ausgeführt werden.

Das Ergebnis kommt als JSON zurück und lässt sich in jedem ERP, jeder Middleware oder jedem Skript weiterverarbeiten. Jede ausgeführte Abfrage wird in einer eigenen Tabelle protokolliert. Eine ausführliche Dokumentation mit PHP-Beispielen liegt dem Plugin bei.

Sicherheit: So richten Sie den Zugriff richtig ein

Direkter Datenbankzugriff ist ein mächtiges Werkzeug. Mit diesen Regeln setzen Sie ihn sicher ein:

  • IP-Filter und Schlüssel kombinieren: Erlauben Sie nur die IP-Adressen Ihres ERP-Servers und verwenden Sie zusätzlich einen langen, zufälligen Schlüssel.
  • Nur über HTTPS: Anfragen und Schlüssel dürfen nie unverschlüsselt übertragen werden.
  • Feste Abfragen statt freier Eingaben: Hinterlegen Sie im ERP fest definierte Abfragen und reichen Sie keine Benutzereingaben ungeprüft weiter.
  • Lesen bevorzugen: Für komplexe Schreibvorgänge wie das Anlegen von Produkten oder Bestellungen ist die Shopware Admin-API die bessere Wahl, weil Shopware dabei Indizes, Caches und Ereignisse automatisch aktualisiert.
  • Protokoll prüfen: Werfen Sie regelmäßig einen Blick in das Abfrage-Protokoll.

Erfahrungen aus der Praxis

Die SQL API wurde bereits mit SAP Business One, Xentral und Sage eingesetzt. Ein Anwender beschreibt im Shopware Store, dass er damit endlich Lagerbestände und Bewegungen schnell abrufen kann, ohne eigene Schnittstellenentwicklung.

Für umfangreiche Integrationen mit vielen Datenflüssen empfehlen wir eine robuste Middleware. Mehr dazu im Artikel ERP an den Onlineshop anbinden.

Häufige Fragen

Welche ERP-Systeme funktionieren mit der SQL API?

Jedes System, das HTTP-POST-Anfragen senden und JSON verarbeiten kann. Getestet wurde die SQL API unter anderem mit SAP Business One, Xentral und Sage.

Ist die SQL API sicher?

Der Zugriff lässt sich per IP-Filter und geheimem Schlüssel absichern, jede Abfrage wird protokolliert. Kombinieren Sie beide Schutzmechanismen und nutzen Sie ausschließlich HTTPS.

Was kostet die SQL API?

Ab 12,42 Euro im Monat bei jährlicher Zahlung oder 14 Euro bei monatlicher Zahlung, monatlich kündbar und mit kostenlosem Probemonat.

Ersetzt die SQL API die Shopware Admin-API?

Nein, sie ergänzt sie. Für schnelle Abfragen ist die SQL API ideal, für komplexe Schreibvorgänge bleibt die Admin-API der richtige Weg.

Lassen Sie uns Ihr ERP anbinden.

Erzählen Sie uns kurz, worum es geht. Sie erhalten innerhalb eines Werktags eine ehrliche Ersteinschätzung.

Kostenlos und unverbindlich Antwort innerhalb eines Werktags Auf Wunsch mit NDA

Projekt besprechen

Ihr Ansprechpartner: Florian Bettzieche

0201 857 897 81 [email protected]
Projekt besprechen