FAQ

Lösungen für häufig auftretende Probleme mit dem Shopware 6 API Connector.

Allgemein

ID-Felder finden

Bestandssynchronisation

401 Unauthorized

Symptome:

• API-Aufrufe schlagen mit 401 Fehlermeldung
• Authentifizierungsfehler

Lösungen:

1. Prüfen Sie die API-Zugangsdaten.
2. Generieren Sie neue Integration-Credentials in Shopware.
3. 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:

1. Falsche URL
2. Falsche Zugangsdaten
3. Server nicht erreichbar
4. Firewall blockiert

Lösungen:

1. Prüfen Sie die Webseite-URL (inkl. https://).
2. Prüfen Sie Access Key und Secret Key.
3. Testen Sie die URL im Browser.
4. Prüfen Sie Firewall-Einstellungen.

Kunde konnte nicht angelegt werden

Mögliche Ursachen:

• Nummernserie erschöpft.
• Pflichtfelder fehlen in Shopware.
• Debitorenvorlage nicht konfiguriert.

Lösung

1. Prüfen Sie das Aktivitätsprotokoll.
2. Korrigieren Sie die Kundendaten.
3. Importieren Sie die Bestellung erneut.

Kunde nicht gefunden

Mögliche Ursachen:

• Kundennummer stimmt nicht überein.
• E-Mail-Adresse wurde geändert.
• Mapping-Typ passt nicht.

Lösung

1. Prüfen Sie das Aktivitätsprotokoll.
2. Korrigieren Sie die Kundendaten.
3. Importieren Sie die Bestellung erneut.

Falscher Kundentyp zugeordnet

1. Prüfen Sie die Kundengruppe in Shopware.
2. Prüfen Sie das Kundengruppen-Mapping.
3. 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

1. Prüfen Sie, ob Staffelzeilen in BC existieren.
2. Prüfen Sie das Staffelpreis-Limit in den Einstellungen.
3. Synchronisieren Sie den Artikel erneut.

Falscher Preis im Warenkorb

1. Prüfen Sie die Mindestmengen in BC.
2. Prüfen Sie die Kundengruppen-Zuordnung.
3. 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:

1. Statusfilter schließt Bestellungen aus
2. Bestellungen bereits importiert
3. Verbindungsproblem

Lösungen:

1. Prüfen Sie den Statusfilter in den Einstellungen.
2. Prüfen Sie das Aktivitätsprotokoll.
3. Führen Sie einen manuellen Download durch.

Kunde nicht gefunden

Symptome:

• Bestellung kann nicht importiert werden.
• Fehlermeldung: Kunde existiert nicht.

Lösungen:

1. Aktivieren Sie automatische Kundenanlage.
2. Prüfen Sie das Kunden-Zuordnung (E-Mail/Kundennummer). (Mapping fehlt)
3. Legen Sie den Kunden manuell an.

Artikel nicht gefunden

Symptome:

• Bestellposition kann nicht zugeordnet werden.
• Fehlermeldung: Artikelnummer unbekannt

Lösungen:

1. Prüfen Sie die Artikelnummer in BC.
2. Legen Sie den Artikel in BC an.
3. 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.

Zahlungsmethode unbekannt

Mapping fehlt Zahlungsmethoden-Mapping ergänzen

Fehlerhafte Bestellungen

1. Öffnen Sie das Aktivitätsprotokoll.
2. Filtern Sie nach Fehlern.
3. Beheben Sie die Ursache.
4. Importieren Sie erneut.

Status wird nicht aktualisiert

1. Prüfen Sie die API-Verbindung.
2. Prüfen Sie das Aktivitätsprotokoll.
3. Stellen Sie sicher, dass die Bestellung in Shopware existiert.

Tracking nicht sichtbar

1. Prüfen Sie, ob das Tracking-Feld korrekt gefüllt ist.
2. Prüfen Sie das Format der Paketnummer.
3. Melden Sie den Status erneut.

Artikel / Stammdatenverwaltung

Kategorie existiert nicht in Shopware

1. Prüfen Sie die Shopware ID in BC.
2. Prüfen Sie, ob die Kategorie in Shopware gelöscht wurde.
3. Aktualisieren Sie das Mapping oder erstellen Sie die Kategorie neu.

Artikel erscheint nicht in der Kategorie

1. Prüfen Sie die Kategoriezuordnung in BC.
2. Prüfen Sie, ob der Artikel als "Web-Artikel" markiert ist.
3. Synchronisieren Sie den Artikel erneut.

Bild wird nicht hochgeladen

1. Prüfen Sie die Bilder Ordner-ID in den Einstellungen.
2. Prüfen Sie das Bildformat und die Dateigröße.
3. Prüfen Sie das Aktivitätsprotokoll auf Fehler.

Bild erscheint nicht im Shop

1. Prüfen Sie, ob das Bild in Shopware vorhanden ist.
2. Prüfen Sie, ob das Bild dem Produkt zugeordnet ist.
3. Leeren Sie den Shopware-Cache.

Falsche Bildreihenfolge

1. Prüfen Sie die Reihenfolge in BC.
2. Synchronisieren Sie den Artikel erneut.
3. Ggf. Reihenfolge in Shopware manuell anpassen.

Shopware Medienordner, Ordner-ID

Bestand stimmt nicht überein.

1. Prüfen Sie den Lagerort in den Einstellungen.
2. Prüfen Sie, ob Reservierungen berücksichtigt werden.
3. Synchronisieren Sie manuell erneut.

Artikel nicht verfügbar trotz Bestand.

1. Prüfen Sie, ob der Artikel in Shopware aktiv ist.
2. Prüfen Sie die Verkaufskanal-Zuordnung.
3. 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:

1. Artikel nicht aktiviert
2. Keinem Verkaufskanal zugeordnet
3. Keiner Kategorie zugeordnet

Lösungen:

1. Aktivieren Sie den Artikel in Shopware.
2. Ordnen Sie den Artikel einem Verkaufskanal zu.
3. Ordnen Sie den Artikel einer Kategorie zu.

Preis stimmt nicht

Symptome:

• Falscher Preis in Shopware.
• Preis weicht von BC ab.

Lösungen:

1. Prüfen Sie das Preisfeld in den Einstellungen.
2. Prüfen Sie die MwSt.-Zuordnung.
3. Prüfen Sie die Netto/Brutto-Einstellung.
4. Synchronisieren Sie den Preis erneut.

Bestand stimmt nicht

Symptome:

• Falscher Bestand in Shopware.
• Bestand ist 0 trotz Lagerbestand.

Lösungen:

1. Prüfen Sie den Lagerort in den Einstellungen.
2. Prüfen Sie die Bestandsoption (verfügbar vs. physisch).
3. Synchronisieren Sie den Bestand erneut.

Bestandssynchronisation

Automatische Synchronisation

Der Bestand kann automatisch synchronisiert werden:

1. Erstellen Sie einen "Aufgabenwarteschlangenposten".
2. Wählen Sie die "Codeunit" "Bestandsupload".
3. Legen Sie das Intervall fest (z.B. alle 30 Minuten).

Manuelle Synchronisation

1. Öffnen Sie die "Artikelkarte".
2. Klicken Sie auf "Aktionen" → "Bestand zu Shopware"

Oder für mehrere Artikel:

1. Öffnen Sie die "Artikelliste".
2. Wählen Sie die gewünschten Artikel aus.
3. Klicken Sie auf "Bestand zu Shopware".

PDF-Dokumente

PDF-Upload schlägt fehl

Fehler	Mögliche Ursache	Lösung
Kunde nicht gefunden.	Kundennummer/E-Mail exisiert nicht in Shopware.	Prüfen Sie die Kundendaten in beiden System.
PDF konnte nicht generiert werden.	Berichtslayout fehlt oder ist fehlerhaft.	Prüfen Sie die Berichtseinstellungen.
Verbindungsfehler	API-Verbindung zu Shopware unterbrochen.	Prüfen Sie die Netzwerkverbindung und API-Einstellungen.
Modul nicht aktiviert.	PDF-Modul ist in BC nicht aktiviert.	Aktivieren Sie das Modul in der Konfiguration.

Dokumenttyp wird nicht übersetzt

Symptome:

• Anzeige: "solutioo-invoice-documents.account.type.xxx"
• Übersetzung fehlt

Lösungen:

1. Leeren Sie den Shopware-Cache.
2. Kompilieren Sie das Theme neu.
3. Prüfen Sie die Snippet-Dateien.

Dokumente werden nicht angezeigt

• Prüfen Sie, ob das Plugin aktiviert ist.
• Leeren Sie den Cache: bin/console cache:clear
• Kompilieren Sie das Theme: bin/console theme:compile

API-Fehler 401 (Unauthorized)

• Prüfen Sie die API-Zugangsdaten in Business Central.
• Stellen Sie sicher, dass die Integration aktiv ist.
• Prüfen Sie die Berechtigungen der Integration.

Kunde nicht gefunden

• Prüfen Sie, ob der Kunde in Shopware existiert.
• Vergleichen Sie E-Mail-Adresse und Kundennummer.
• Prüfen Sie auf Tippfehler in den Daten.

Performance / Automatisierung

Synchronisation dauert sehr lange

Symptome:

• Timeout bei großen Datenmengen
• Langsame Performance

Lösungen:

1. Reduzieren Sie die Datenmenge pro Synchronisation.
2. Nutzen Sie Filter für inkrementelle Updates.
3. Planen Sie Synchronisationen außerhalb der Stoßzeiten.

Aufgabenwarteschlangenposten: Aufgabe läuft nicht

• Prüfen Sie den Status (muss "Bereit" oder "In Warteschlange" sein)
• Prüfen Sie die Früheste Startzeit
• Prüfen Sie die Wochentags-Einstellung
• Starten Sie den Aufgabenwarteschlangenposten-Dienst neu

Aufgabenwarteschlangenposten: Fehler bei Ausführung

• Öffnen Sie die Fehlermeldung
• Prüfen Sie die API-Verbindung
• Prüfen Sie das Aktivitätsprotokoll
• Beheben Sie das Problem und setzen Sie den Status auf "Bereit"

Upload schlägt fehl

• Prüfen Sie die API-Verbindung.
• Prüfen Sie das Aktivitätsprotokoll.
• Beheben Sie die gemeldeten Fehler.
• Versuchen Sie es erneut.

Daten nicht aktualisiert

1. Prüfen Sie, ob der Artikel als "Web-Artikel" markiert ist.
2. Prüfen Sie die Mapping-Tabellen.
3. Leeren Sie den Shopware-Cache.

Kunde nicht gefunden

Ursache: Kunden-Mapping fehlgeschlagen

Lösung:

1. Prüfen Sie die E-Mail/Kundennummer.
2. Aktivieren Sie automatische Kundenanlage.
3. Oder legen Sie den Kunden manuell an.

Artikel nicht gefunden

Ursache: Artikelnummer in BC nicht vorhanden

Lösung:

1. Prüfen Sie die Artikelnummer.
2. Legen Sie den Artikel in BC an.
3. Oder korrigieren Sie das Mapping.

Verbindung fehlgeschlagen

Ursache: API nicht erreichbar

Lösung:

1. Prüfen Sie die Shopware-URL.
2. Prüfen Sie die API-Zugangsdaten.
3. Prüfen Sie Firewall-Einstellungen.

Timeout bei Anfrage

Ursache: Anfrage dauert zu lange

Lösung:

1. Reduzieren Sie die Datenmenge pro Anfrage.
2. Erhöhen Sie ggf. Timeout-Werte.
3. Prüfen Sie die Server-Performance.

Allgemeine Tipps

Vor der Kontaktaufnahme mit Support

1. Prüfen Sie das Aktivitätsprotokoll für Fehlermeldungen.
2. Notieren Sie die genaue Fehlermeldung.
3. Dokumentieren Sie die durchgeführten Schritte.
4. Prüfen Sie diese FAQ auf bekannte Lösungen.

Cache leeren

In Shopware:

bin/console cache:clear
bin/console theme:compile

In Business Central:

• Starten Sie den BC-Client neu.
• Leeren Sie den Browser-Cache.

Entwicklerprotokoll aktivieren

Für detaillierte Fehleranalyse:

1. Öffnen Sie Shopware → Einstellung
2. Aktivieren Sie "Erlaube Entwickler-Protokoll".
3. Reproduzieren Sie das Problem.
4. Prüfen Sie das "API-Call-Log".

Weitere Antworten nach Themen

Ergänzend zu den obigen Lösungen finden Sie thematisch sortierte Kurzantworten im FAQ-Bereich:

Verbindung & Authentifizierung

Öffnen

Artikel & Katalog

Öffnen

Preise & Bestand

Öffnen

Bestellungen

Öffnen

Kunden & B2B

Öffnen

Synchronisation & Fehler

Öffnen

Zur tiefergehenden Fehleranalyse helfen das Aktivitätsprotokoll, der API Call Log und der Leitfaden API-Antworten analysieren.