FAQ
Lösungen für häufig auftretende Probleme mit dem Shopware 6 API Connector.
Allgemein
401 Unauthorized
Symptome:
API-Aufrufe schlagen mit 401 Fehlermeldung
Authentifizierungsfehler
Lösungen:
Prüfen Sie die API-Zugangsdaten.
Generieren Sie neue Integration-Credentials in Shopware.
Prüfen Sie, ob die Integration aktiv ist.
Verbindung konnte nicht herstellt werden
Symptome:
Fehlermeldung "Verbindung konnte nicht hergestellt werden".
Timeout bei Verbindungstest
Mögliche Ursachen:
Falsche URL
Falsche Zugangsdaten
Server nicht erreichbar
Firewall blockiert
Lösungen:
Prüfen Sie die Webseite-URL (inkl. https://).
Prüfen Sie Access Key und Secret Key.
Testen Sie die URL im Browser.
Prüfen Sie Firewall-Einstellungen.
Falscher Kundentyp zugeordnet
Prüfen Sie die Kundengruppe in Shopware.
Prüfen Sie das Kundengruppen-Mapping.
Korrigieren Sie den Debitor in BC.
USt-IdNr. fehlt
Kunde muss USt-IdNr. in Shopware hinterlegen.
Bei nächster Bestellung wird diese übernommen.
Oder manuell in BC nachtragen.
Staffelpreise werden nicht angezeigt
Prüfen Sie, ob Staffelzeilen in BC existieren.
Prüfen Sie das Staffelpreis-Limit in den Einstellungen.
Synchronisieren Sie den Artikel erneut.
Falscher Preis im Warenkorb
Prüfen Sie die Mindestmengen in BC.
Prüfen Sie die Kundengruppen-Zuordnung.
Leeren Sie den Shopware-Cache.
Sonderpreis wird nicht angezeigt
Prüfen Sie das Gültigkeitsdatum (Start/Ende).
Prüfen Sie die Kundengruppen-Zuordnung.
Synchronisieren Sie den Artikel erneut.
Leeren Sie den Shopware-Cache.
Falscher Preis für Kunde
Prüfen Sie die Kundengruppe des Kunden.
Prüfen Sie die Preisgruppen-Zuordnung in BC.
Prüfen Sie das Mapping in den Einstellungen.
Bestellimport
Bestellungen werden nicht importiert
Symptome:
Keine neuen Bestellungen in BC.
Leere Bestellliste trotz Shopware-Bestellungen.
Mögliche Ursachen:
Statusfilter schließt Bestellungen aus
Bestellungen bereits importiert
Verbindungsproblem
Lösungen:
Prüfen Sie den Statusfilter in den Einstellungen.
Prüfen Sie das Aktivitätsprotokoll.
Führen Sie einen manuellen Download durch.
Kunde nicht gefunden
Symptome:
Bestellung kann nicht importiert werden.
Fehlermeldung: Kunde existiert nicht.
Lösungen:
Aktivieren Sie automatische Kundenanlage.
Prüfen Sie das Kunden-Zuordnung (E-Mail/Kundennummer). (Mapping fehlt)
Legen Sie den Kunden manuell an.
Artikel nicht gefunden
Symptome:
Bestellposition kann nicht zugeordnet werden.
Fehlermeldung: Artikelnummer unbekannt
Lösungen:
Prüfen Sie die Artikelnummer in BC.
Legen Sie den Artikel in BC an.
Prüfen Sie das Artikelnummern-Zuordnung.
Importfehler
Prüfen Sie das "Aktivitätsprotokoll".
Häufige Fehler: fehlende Zuordnungs-Einträge, unbekannte Zahlungsmethoden.
Ergänzen Sie fehlende Zuordnung und starten Sie den Import erneut.
Fehlerhafte Bestellungen
Öffnen Sie das Aktivitätsprotokoll.
Filtern Sie nach Fehlern.
Beheben Sie die Ursache.
Importieren Sie erneut.
Artikel / Stammdatenverwaltung
Kategorie existiert nicht in Shopware
Prüfen Sie die Shopware ID in BC.
Prüfen Sie, ob die Kategorie in Shopware gelöscht wurde.
Aktualisieren Sie das Mapping oder erstellen Sie die Kategorie neu.
Artikel erscheint nicht in der Kategorie
Prüfen Sie die Kategoriezuordnung in BC.
Prüfen Sie, ob der Artikel als "Web-Artikel" markiert ist.
Synchronisieren Sie den Artikel erneut.
Bild wird nicht hochgeladen
Prüfen Sie die Bilder Ordner-ID in den Einstellungen.
Prüfen Sie das Bildformat und die Dateigröße.
Prüfen Sie das Aktivitätsprotokoll auf Fehler.
Bild erscheint nicht im Shop
Prüfen Sie, ob das Bild in Shopware vorhanden ist.
Prüfen Sie, ob das Bild dem Produkt zugeordnet ist.
Leeren Sie den Shopware-Cache.
Falsche Bildreihenfolge
Prüfen Sie die Reihenfolge in BC.
Synchronisieren Sie den Artikel erneut.
Ggf. Reihenfolge in Shopware manuell anpassen.
Bestand stimmt nicht überein.
Prüfen Sie den Lagerort in den Einstellungen.
Prüfen Sie, ob Reservierungen berücksichtigt werden.
Synchronisieren Sie manuell erneut.
Artikel nicht verfügbar trotz Bestand.
Prüfen Sie, ob der Artikel in Shopware aktiv ist.
Prüfen Sie die Verkaufskanal-Zuordnung.
Leeren Sie den Shopware-Cache.
Synchronisation läuft nicht.
Prüfen Sie den Aufgabenwarteschlangenposten.
Prüfen Sie die API-Verbindung.
Prüfen Sie das Aktivitätsprotokoll.
Attribute
Attribut wird nicht synchronisiert
Prüfen Sie, ob der Artikel als "Web-Artikel" gekennzeichnet ist.
Prüfen Sie die Attribut-Mapping/Zuordnung-Tabelle.
Prüfen Sie das Aktivitätsprotokoll auf Fehler.
Attributwert fehlt in Shopware
Prüfen Sie, ob der Wert in BC korrekt zugewiesen ist.
Synchronisieren Sie den Artikel erneut.
Leeren Sie den Shopware-Cache.
Artikelsynchronisation
Artikel erscheint nicht im Shop
Symptome:
Artikel wurde hochgeladen, ist aber nicht sichtbar
Keine Fehlermeldung
Mögliche Ursachen:
Artikel nicht aktiviert
Keinem Verkaufskanal zugeordnet
Keiner Kategorie zugeordnet
Lösungen:
Aktivieren Sie den Artikel in Shopware.
Ordnen Sie den Artikel einem Verkaufskanal zu.
Ordnen Sie den Artikel einer Kategorie zu.
Preis stimmt nicht
Symptome:
Falscher Preis in Shopware.
Preis weicht von BC ab.
Lösungen:
Prüfen Sie das Preisfeld in den Einstellungen.
Prüfen Sie die MwSt.-Zuordnung.
Prüfen Sie die Netto/Brutto-Einstellung.
Synchronisieren Sie den Preis erneut.
Bestand stimmt nicht
Symptome:
Falscher Bestand in Shopware.
Bestand ist 0 trotz Lagerbestand.
Lösungen:
Prüfen Sie den Lagerort in den Einstellungen.
Prüfen Sie die Bestandsoption (verfügbar vs. physisch).
Synchronisieren Sie den Bestand erneut.
Bestandssynchronisation
Automatische Synchronisation
Der Bestand kann automatisch synchronisiert werden:
Erstellen Sie einen "Aufgabenwarteschlangenposten".
Wählen Sie die "Codeunit" "Bestandsupload".
Legen Sie das Intervall fest (z.B. alle 30 Minuten).
Manuelle Synchronisation
Öffnen Sie die "Artikelkarte".
Klicken Sie auf "Aktionen" → "Bestand zu Shopware"
Oder für mehrere Artikel:
Öffnen Sie die "Artikelliste".
Wählen Sie die gewünschten Artikel aus.
Klicken Sie auf "Bestand zu Shopware".
PDF-Dokumente
PDF-Upload schlägt fehl
Symptome:
Fehlermeldung beim Upload
Dokument erscheint nicht in Shopware.
Mögliche Ursachen:
PDF-Modul nicht aktiviert
Shopware-Plugin nicht installiert
Kunde nicht gefunden
Lösungen:
Aktivieren Sie PDF Dokumente aktivieren in den Einstellungen.
Installieren Sie das Solutioo Invoice Documents Plugin.
Prüfen Sie die Kundenzuordnung (E-Mail/Kundennummer).
Dokumenttyp wird nicht übersetzt
Symptome:
Anzeige: "solutioo-invoice-documents.account.type.xxx"
Übersetzung fehlt
Lösungen:
Leeren Sie den Shopware-Cache.
Kompilieren Sie das Theme neu.
Prüfen Sie die Snippet-Dateien.
Performance
Synchronisation dauert sehr lange
Symptome:
Timeout bei großen Datenmengen
Langsame Performance
Lösungen:
Reduzieren Sie die Datenmenge pro Synchronisation.
Nutzen Sie Filter für inkrementelle Updates.
Planen Sie Synchronisationen außerhalb der Stoßzeiten.
Allgemeine Tipps
Vor der Kontaktaufnahme mit Support
Prüfen Sie das Aktivitätsprotokoll für Fehlermeldungen.
Notieren Sie die genaue Fehlermeldung.
Dokumentieren Sie die durchgeführten Schritte.
Prüfen Sie diese FAQ auf bekannte Lösungen.
Last updated