Mit der Shopware‑6‑Schnittstelle übernehmen Sie Kund:innen, Artikel und Bestellungen aus Shopware in die Warenwirtschaft — inklusive Provisionsberechnung. Kund:innen aus der Warenwirtschaft können zurück nach Shopware exportiert werden.
Wo? Menü Einstellungen → Shopware
Die Konfiguration hat drei Reiter: Einstellungen, VP Verkaufskanäle, Bestellungen-Status.
1) Was die Anbindung macht
| Richtung | Inhalt |
|---|---|
| Shopware → WBO (Import) | Kund:innen, Artikel (optional), Bestellungen, Statusänderungen |
| WBO → Shopware (Export) | Kund:innen; optional Zahlungseingang und Versandnummer |
Nicht exportiert werden: Artikel und Bestellungen Richtung Shopware.
Kombination mit internem Shop: Shopware eignet sich besonders für Endkunden-Marketing und Skalierung. Der integrierte Affiliate-Shop bleibt für spezielle Partner-Konditionen und volle Partnerprogramm-Funktionen relevant — beide Systeme können parallel genutzt werden.
2) Einmalige Einrichtung
A. API‑Schlüssel in Shopware anlegen
- In Shopware öffnen: Einstellungen → System → Integration.
- Auf Integration anlegen klicken.
- Namen und Rolle eintragen — Shopware erzeugt Zugangs-ID und Sicherheitsschlüssel.
- Beide Werte kopieren und sicher aufbewahren.
B. Verbindung in der Warenwirtschaft
- Einstellungen → Shopware → Reiter Einstellungen.
- Unter API Credentials eintragen:
- URL Shopware API (z. B.
https://ihr-shop.de/api) - Benutzername (= Zugangs-ID aus Shopware)
- Passwort (= Sicherheitsschlüssel)
- URL Shopware API (z. B.
- Aktiv ankreuzen und Speichern.
API Credentials
Import‑Einstellungen (Auszug aus dem Reiter Einstellungen)
Tipp zum Lesen: Klicken Sie auf ein Bild, um es zu vergrößern.
C. Import‑Einstellungen
| Feld | Bedeutung |
|---|---|
| Muster‑Artikel | Vorlage für neu aus Shopware importierte Produkte (wie „Artikel duplizieren“). Name, Beschreibung und Preis kommen aus Shopware; Provisionen & Co. vom Muster. |
| Werbung‑Artikel | Artikelnummer für Werbe-/Platzhalter-Produkte aus Shopware (falls verwendet). |
| Benutzer import als | Legt fest, wie neue Shopware-Kund:innen angelegt werden: Gast, Kunde, Vertriebspartner usw. |
| Registrierungsbestätigung verschicken | Bestätigungsmail bei Neuanlage durch unsere Software (oft aus, wenn Shopware bereits mailt). |
| Zahlungsart (Standard) | Fallback, wenn der Shopware-Name nicht gefunden wird. |
| Versandart (Standard) | Fallback für die Versandart. |
| Bestellbestätigung verschicken | Mail bei importierter Bestellung (oft aus, wenn Shopware bereits bestätigt). |
| Zuordnung des Vermittlers bei Bestellung | Siehe Abschnitt Vermittler bei Bestellungen. |
| Artikel importieren | Produkte aus Shopware übernehmen (empfohlen, wenn der Shop-Produktkatalog dort gepflegt wird). |
Tipp: Legen Sie Zahlungs- und Versandarten in beiden Systemen gleich benannt an (z. B. „Vorkasse“, „DHL“). Abweichende Namen führen zum Standard-Fallback.
D. Export‑Einstellungen
| Feld | Bedeutung |
|---|---|
| Vermittler aus Kundenstammdaten automatisch in Shopware‑Feld übertragen | Optional: VP-Nummer ins Shopware-Kundenfeld schreiben. |
| Shopware Verkaufskanal / Zahlungsart / Kundengruppen | Standardwerte für den Kunden-Export nach Shopware. |
| Fehlermeldung E‑Mail | Empfänger bei Schnittstellenfehlern (mehrere Adressen mit Komma). |
| Zahlungseingang | Optional: Bei Zahlungseingang in der WBO den Shopware-Auftrag als bezahlt markieren (nur Status, keine Beträge). |
| Versandnummer | Optional: Tracking-URL und Status Versandt nach Shopware übertragen. |
Export‑Einstellungen (Auszug)
3) Weitere Reiter
| Reiter | Thema | Anleitung |
|---|---|---|
| VP Verkaufskanäle | VP-Nr. ↔ Shopware-Verkaufskanal | Shopware – VP Verkaufskanäle |
| Bestellungen-Status | Shopware-Status → WBO-Aktion (Bezahlt, Storno …) | Shopware – Bestellungen-Status zuordnen |
4) Shopware Datenübernahme Statistik
Pfad: Assistent → Shopware Datenübernahme Statistik
Hier sehen Sie alle Import- und Export-Vorgänge in einer Tabelle.
- Typansicht Monitor: Aktualisiert sich automatisch (Live-Ansicht).
- Typansicht Statistik: Keine Auto-Aktualisierung — zum ruhigen Prüfen.
- Status: Warteschleife, In Bearbeitung, Verarbeitet.
- Fehlerhaftigkeit: Alle / ohne Fehler / mit Fehler.
Fehler beheben: Ursache korrigieren (z. B. fehlende Zahlungsart), betroffene Zeilen markieren, Aufgaben neu starten.
5) Checkliste für den Start
- API-Zugang in Shopware erstellt und unter Einstellungen → Shopware eingetragen, Aktiv gesetzt.
- Muster‑Artikel sauber konfiguriert (Steuern, Provision, Lager).
- Benutzer import als, Standard-Zahlungs- und Versandart gewählt.
- Zahlungs- und Versandarten in beiden Systemen gleich benannt.
- Nummernkreis VP/KD von Shopware-Nummern getrennt (Nummerierung).
- Bestellungen-Status für Ihre Shopware-Statusnamen eingerichtet (z. B. „Bezahlt“, „erstattet“).
- Fehlermeldung E‑Mail hinterlegt.
- Erste Vorgänge in der Datenübernahme Statistik geprüft.
6) Vermittler bei Shopware-Bestellungen
Beim Import einer Bestellung wird der Vermittler in dieser Priorität ermittelt:
- VP-Gutschein in der Bestellung (Typ VP Registrierung) — höchste Priorität → siehe Gutscheine §9
- VP Verkaufskanal (wenn zugeordnet) → VP Verkaufskanäle
- affiliateCode / campaignCode aus Shopware
- Vermittler aus Kundenstamm — abhängig von Zuordnung des Vermittlers bei Bestellung:
- Verwendung des Vermittlers aus dem Shop: Vermittler aus Shopware-Daten (Codes, Verkaufskanal …)
- Verwendung des bestehenden Vermittlers im System: Vermittler aus dem Kundenstamm, sofern nicht Master VP
7) Häufige Fragen
Warum fehlt ein importierter Artikel?
Prüfen Sie Artikel importieren und ob ein Muster‑Artikel hinterlegt ist.
Warum hat die Bestellung die falsche Zahlungsart?
Name in Shopware stimmt nicht mit der WBO überein → Standard-Zahlungsart greift.
Warum wird „erstattet“ nicht storniert?
Status-Zuordnung fehlt → Bestellungen-Status.
Doppelte Kund:innen?
Kund:innen werden bidirektional synchronisiert. Gleiche E-Mail in beiden Systemen fast gleichzeitig kann zu Konflikten führen — in Shopware ggf. zusammenführen.
Gutscheine in Shopware?
Automatischer Export von VP-Registrierungs-Gutscheinen → Dokumentation Gutscheine §9.
Video-Anleitung (Einstieg): Shopware in MLM Verwalter integrieren (YouTube)