weclapp mit Shopware 6 verbinden: ERP-Integrationsleitfaden

So verbinden Sie weclapp mit Shopware 6: Voraussetzungen, Connector-Plugin, API-Konfiguration, Synchronisation, Test, Fehlerbehebung und Go-live.

Einleitung

weclapp ist ein Cloud-ERP für Warenwirtschaft, CRM, Rechnungsstellung und Projekte. Verbunden mit Shopware 6 laufen Artikel, Bestände, Kunden und Bestellungen zwischen Shop und ERP automatisch hin und her, ohne doppelte Datenpflege. Dieser Leitfaden zeigt Shopbetreibern, Entwicklern und Agenturen, wie die Anbindung aufgebaut ist: Voraussetzungen, Plugin-Installation, API-Konfiguration, Test, Fehlerbehebung und Go-live.

Wenn Sie noch prüfen, welches ERP zu Ihrem Shop passt, hilft unser Beitrag zur kosteneffizienten ERP-Integration für Shopware 6. Grundlagen zur Plattform finden Sie auf unserer Seite zur Shopware-Entwicklung.

Was ist weclapp?

weclapp ist ein cloudbasiertes ERP-System, das Warenwirtschaft, CRM, Auftragsabwicklung, Rechnungsstellung und Projektmanagement in einer Plattform bündelt. Für Onlinehändler ist es interessant, weil es Lager, Einkauf und Buchhaltung abdeckt, ohne dass ein eigener Server betrieben werden muss.

Nutzen für den E-Commerce

• Kunden-, Bestands- und Verkaufsdaten liegen zentral an einer Stelle.
• Rechnungen und Buchungen entstehen direkt aus der Bestellung, das reduziert den Verwaltungsaufwand.
• Bestellungen und Bestände werden automatisch abgeglichen, die Verfügbarkeit im Shop stimmt.

Warum mit Shopware 6 verbinden?

• Daten in Shop und ERP sind jederzeit konsistent.
• Wiederkehrende Aufgaben wie das Übertragen von Bestellungen entfallen.
• Weniger manuelle Eingaben bedeuten weniger Fehler.

Shopware bleibt dabei das Frontend für Ihre Kunden, weclapp das Backend für Abwicklung und Finanzen. Welche weiteren Systeme sich anbinden lassen, zeigt unsere Übersicht zu Shopware ERP- und CRM-Integrationen.

Voraussetzungen

Technisch

• Shopware 6.4 oder neuer, stabil laufend
• PHP 8.1 oder neuer
• Webserver mit HTTPS und ausreichend Arbeitsspeicher für PHP (mindestens 512 MB empfohlen), damit Synchronisationsläufe nicht abbrechen
• MySQL 8.0 oder neuer bzw. MariaDB

weclapp-Konto

• Aktives weclapp-Cloud-Konto mit Administratorrechten
• Zugang zu den API-Daten: Mandantenname, API-Token und Endpunkt-URL

Sonstiges

• Shopware-Admin-Zugang mit Rechten zur Installation und Konfiguration von Erweiterungen
• Grundkenntnisse in der Installation von Shopware-Plugins

Prüfen Sie jede Voraussetzung, bevor Sie beginnen. Das spart in der Einrichtung Zeit.

Connector-Plugin installieren

Für die Verbindung brauchen Sie ein Connector-Plugin. Zwei Wege stehen offen:

• Ein kommerzielles Plugin aus dem Shopware Store (Suche nach „weclapp“), das die Standardfälle abdeckt.
• Ein eigenes Plugin auf Basis der weclapp-API, wenn Sie besondere Prozesse oder Feldzuordnungen brauchen. Wie wir so etwas umsetzen, lesen Sie auf unserer Seite zur Shopware-Plugin-Entwicklung.

Installation über den Store

1. Melden Sie sich in der Shopware-Administration an.
2. Öffnen Sie Erweiterungen → Store und suchen Sie nach „weclapp“.
3. Wählen Sie das passende Plugin und klicken Sie auf Installieren.
4. Aktivieren Sie das Plugin unter Erweiterungen → Meine Erweiterungen.
5. Öffnen Sie dort die Konfiguration des Connectors.

Achten Sie auf die Kompatibilität mit Ihrer Shopware-Version. Bei einem eigenen Plugin folgen Sie der Installationsanleitung des Entwicklers, in der Regel über bin/console plugin:install --activate.

Plugin konfigurieren

API-Zugang

• Mandant: Ihr weclapp-Firmenkürzel, zu finden in den Kontoeinstellungen.
• API-Token: wird im Benutzerprofil in weclapp erzeugt. Legen Sie dafür am besten einen eigenen technischen Benutzer mit den nötigen Rechten an.
• Endpunkt: üblicherweise https://{mandant}.weclapp.com/webapp/api/v1/.

Synchronisation

• Produkte: Artikelstammdaten aus weclapp nach Shopware übertragen, inklusive Preise und Varianten.
• Bestellungen: Shopware-Bestellungen automatisch als Aufträge in weclapp anlegen.
• Kunden: Kundenkonten und Adressen zuordnen und abgleichen.
• Bestände: Lagerbestände aus weclapp in den Shop schreiben.

Weitere Einstellungen

• Steuerzuordnung zwischen Shopware-Steuersätzen und weclapp-Steuerschlüsseln
• Währungen und Sprachen passend zu Ihren Verkaufskanälen
• Logging und Synchronisationsintervall

Speichern Sie die Konfiguration und prüfen Sie jede Zuordnung, bevor Sie den ersten Abgleich starten.

Integration testen

Produktabgleich

1. Legen Sie in weclapp einen Testartikel mit Artikelnummer, Preis und Beschreibung an.
2. Prüfen Sie, ob er mit korrekten Daten im Shopware-Katalog erscheint.

Bestellabgleich

1. Geben Sie im Shop eine Testbestellung auf.
2. Kontrollieren Sie in weclapp unter Verkauf → Aufträge, ob die Bestellung mit allen Positionen angekommen ist.

Logs prüfen

• Sehen Sie die Plugin-Logs auf Fehlermeldungen oder Bestätigungen durch.
• Nutzen Sie die Entwicklerwerkzeuge des Browsers und die Shopware-Logs, um fehlgeschlagene Aufrufe zu finden.

Dokumentieren Sie Abweichungen und beheben Sie sie, bevor Sie live gehen.

Fehlerbehebung

Typische Probleme

• Ungültiger API-Token: Token vollständig kopieren und prüfen, ob der Benutzer in weclapp die nötigen Rechte hat.
• Zeitüberschreitung: Firewall und Endpunkt-URL kontrollieren.
• Bestellungen werden nicht übertragen: Prüfen, ob die automatische Übertragung aktiv ist und der Shopware-Scheduler (bin/console scheduled-task:run) bzw. der Cronjob läuft.
• Bestandsabweichungen: Synchronisationsintervall und Regeln zum Überschreiben im Plugin prüfen.

Logs und Diagnose

• Shopware: Einstellungen → System → Protokolle
• Ausführliches Logging während der Einrichtung einschalten
• In weclapp die API-Antworten und Protokolle auswerten

Plugin-Konflikte

• Nicht benötigte Plugins vorübergehend deaktivieren, um Konflikte einzugrenzen.
• Plugin-Version auf Kompatibilität mit der Shopware-Version prüfen.

Go-live

1. Stellen Sie die Umgebung in den Plugin-Einstellungen von „Test“ auf „Live“ um.
2. Prüfen Sie API-Zugangsdaten und Steuerzuordnung ein letztes Mal.
3. Führen Sie einen vollständigen Abgleich von Produkten, Kunden und Beständen durch.
4. Informieren Sie Mitarbeiter und Support über die Umstellung und schulen Sie sie bei Bedarf.

Vor dem Start

• Sichern Sie die Shopware-Datenbank und exportieren Sie die weclapp-Daten.
• Geben Sie im Livemodus eine Testbestellung auf und prüfen Sie Rechnung, Bestand und Kundendaten.
• Kontrollieren Sie die Zuordnung aller Felder wie Artikelnummer, Preise und Bestände.

Best Practices und Sicherheit

Sicherheit

• API-Tokens in Umgebungsvariablen oder einem Secret-Store ablegen, nicht im Code.
• Tokens regelmäßig erneuern und nicht mehr genutzte entziehen.
• Berechtigungen des technischen Benutzers auf die benötigten Module beschränken.

Performance

• Große Abgleiche in verkehrsarme Zeiten legen.
• Bei umfangreichen Katalogen Übertragungen bündeln.
• Fehlerbenachrichtigungen und Synchronisationsberichte einrichten.

Wartung

• Plugin-Updates zeitnah einspielen.
• Logs wöchentlich sichten.
• Nach größeren Updates von Shopware oder weclapp den Abgleich erneut testen.

Häufige Fragen

Was passiert, wenn eine Bestellung nicht übertragen wird?
Das Plugin protokolliert den Fehler. Sie können die Daten korrigieren und die Übertragung manuell erneut anstoßen.

Kann ich nur bestimmte Produkte synchronisieren?
Ja, die meisten Connectoren erlauben Filter nach Kategorie oder Tag.

Werden Zahlungs- und Versandstatus übernommen?
Status lassen sich zwischen den Systemen zuordnen, der Umfang hängt vom Plugin ab.

Wie gehe ich mit mehreren Verkaufskanälen um?
Geben Sie jedem Verkaufskanal in weclapp eine eindeutige Kennung und eine eigene Synchronisationskonfiguration.

Aktualisiert weclapp den Shopware-Bestand automatisch?
Ja, wenn der Bestandsabgleich aktiv ist. Das Intervall legen Sie in den Plugin-Einstellungen fest.

Wenn Sie lieber eine Warenwirtschaft direkt in Shopware möchten, lesen Sie unsere Anleitung zu Pickware in Shopware 6. Für die Anbindung von weclapp oder einem anderen ERP sprechen Sie uns an, einen schnellen Überblick liefert unsere Shop-Analyse.