> For the complete documentation index, see [llms.txt](https://docs.solutioo.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solutioo.de/shopware/fehlerbehebung-and-support/haufige-probleme-und-losungen.md).

# FAQ

**Allgemein**

<details>

<summary><strong>ID-Felder finden</strong></summary>

</details>

<details>

<summary><strong>Bestandssynchronisation</strong></summary>

</details>

<details>

<summary><strong>401 Unauthorized</strong></summary>

**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.

</details>

<details>

<summary><strong>Verbindung konnte nicht herstellt werden</strong></summary>

**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.

</details>

<details>

<summary><strong>Kunde konnte nicht angelegt werden</strong></summary>

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.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

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.

</details>

<details>

<summary><strong>Falscher Kundentyp zugeordnet</strong></summary>

1. Prüfen Sie die **Kundengruppe** in Shopware.
2. Prüfen Sie das **Kundengruppen-Mapping.**
3. Korrigieren Sie den Debitor in BC.

</details>

<details>

<summary><strong>USt-IdNr. fehlt</strong></summary>

* Kunde muss USt-IdNr. in Shopware hinterlegen.
* Bei nächster Bestellung wird diese übernommen.
* Oder manuell in BC nachtragen.

</details>

<details>

<summary><strong>Staffelpreise werden nicht angezeigt</strong></summary>

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.

</details>

<details>

<summary><strong>Falscher Preis im Warenkorb</strong></summary>

1. Prüfen Sie die Mindestmengen in BC.
2. Prüfen Sie die Kundengruppen-Zuordnung.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Sonderpreis wird nicht angezeigt</strong></summary>

* Prüfen Sie das **Gültigkeitsdatum** (Start/Ende).
* Prüfen Sie die **Kundengruppen-Zuordnung.**
* Synchronisieren Sie den Artikel erneut.
* Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Falscher Preis für Kunde</strong></summary>

* Prüfen Sie die Kundengruppe des Kunden.
* Prüfen Sie die Preisgruppen-Zuordnung in BC.
* Prüfen Sie das Mapping in den Einstellungen.

</details>

**Bestellimport**

<details>

<summary><strong>Bestellungen werden nicht importiert</strong></summary>

**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.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

**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.

</details>

<details>

<summary><strong>Artikel nicht gefunden</strong></summary>

**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.

</details>

<details>

<summary><strong>Importfehler</strong></summary>

* 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.

</details>

<details>

<summary><strong>Zahlungsmethode unbekannt</strong></summary>

Mapping fehlt <i class="fa-right">:right:</i> Zahlungsmethoden-Mapping ergänzen

</details>

<details>

<summary><strong>Fehlerhafte Bestellungen</strong></summary>

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

</details>

<details>

<summary><strong>Status wird nicht aktualisiert</strong></summary>

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

</details>

<details>

<summary><strong>Tracking nicht sichtbar</strong></summary>

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.

</details>

**Artikel / Stammdatenverwaltung**

<details>

<summary><strong>Kategorie existiert nicht in Shopware</strong></summary>

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.

</details>

<details>

<summary><strong>Artikel erscheint nicht in der Kategorie</strong></summary>

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.

</details>

<details>

<summary><strong>Bild wird nicht hochgeladen</strong></summary>

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.

</details>

<details>

<summary><strong>Bild erscheint nicht im Shop</strong></summary>

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.

</details>

<details>

<summary><strong>Falsche Bildreihenfolge</strong></summary>

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

</details>

<details>

<summary><strong>Shopware Medienordner, Ordner-ID</strong></summary>

<a class="button primary">Shopware Medienordner</a>

</details>

<details>

<summary><strong>Bestand stimmt nicht überein.</strong></summary>

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

</details>

<details>

<summary><strong>Artikel nicht verfügbar trotz Bestand.</strong></summary>

1. Prüfen Sie, ob der Artikel in Shopware aktiv ist.
2. Prüfen Sie die Verkaufskanal-Zuordnung.
3. Leeren Sie den Shopware-Cache.

</details>

<details>

<summary><strong>Synchronisation läuft nicht.</strong></summary>

* Prüfen Sie den Aufgabenwarteschlangenposten.
* Prüfen Sie die API-Verbindung.
* Prüfen Sie das Aktivitätsprotokoll.

</details>

**Attribute**

<details>

<summary><strong>Attribut wird nicht synchronisiert</strong></summary>

* 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.

</details>

<details>

<summary><strong>Attributwert fehlt in Shopware</strong></summary>

* Prüfen Sie, ob der Wert in BC korrekt zugewiesen ist.
* Synchronisieren Sie den Artikel erneut.
* Leeren Sie den Shopware-Cache.

</details>

**Artikelsynchronisation**

<details>

<summary><strong>Artikel erscheint nicht im Shop</strong></summary>

**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.

</details>

<details>

<summary><strong>Preis stimmt nicht</strong></summary>

**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.

</details>

<details>

<summary><strong>Bestand stimmt nicht</strong></summary>

**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.

</details>

<details>

<summary><strong>Bestandssynchronisation</strong></summary>

**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".*

</details>

**PDF-Dokumente**

<details>

<summary><strong>PDF-Upload schlägt fehl</strong></summary>

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

</details>

<details>

<summary><strong>Dokumenttyp wird nicht übersetzt</strong></summary>

**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.**

</details>

<details>

<summary><i class="fa-screwdriver-wrench">:screwdriver-wrench:</i> <strong>Dokumente werden nicht angezeigt</strong></summary>

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

</details>

<details>

<summary><strong>API-Fehler 401 (Unauthorized)</strong></summary>

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

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

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

</details>

**Performance / Automatisierung**

<details>

<summary><strong>Synchronisation dauert sehr lange</strong></summary>

**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.**

</details>

<details>

<summary><strong>Aufgabenwarteschlangenposten: Aufgabe läuft nicht</strong></summary>

* 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

</details>

<details>

<summary><strong>Aufgabenwarteschlangenposten: Fehler bei Ausführung</strong></summary>

* Ö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"

</details>

<details>

<summary><strong>Upload schlägt fehl</strong></summary>

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

</details>

<details>

<summary><strong>Daten nicht aktualisiert</strong></summary>

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.

</details>

<details>

<summary><strong>Kunde nicht gefunden</strong></summary>

**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.

</details>

<details>

<summary><strong>Artikel nicht gefunden</strong></summary>

**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.

</details>

<details>

<summary><strong>Verbindung fehlgeschlagen</strong></summary>

**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.

</details>

<details>

<summary><strong>Timeout bei Anfrage</strong></summary>

**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.

</details>

**Allgemeine Tipps**

<details>

<summary><strong>Vor der Kontaktaufnahme mit Support</strong></summary>

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.

</details>

<details>

<summary><strong>Cache leeren</strong></summary>

In Shopware:

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

In Business Central:

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

</details>

<details>

<summary><strong>Entwicklerprotokoll aktivieren</strong></summary>

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".*

</details>

###

#### Weitere Antworten nach Themen

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

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Verbindung &#x26; Authentifizierung</strong></td><td>Öffnen</td></tr><tr><td><strong>Artikel &#x26; Katalog</strong></td><td>Öffnen</td></tr><tr><td><strong>Preise &#x26; Bestand</strong></td><td>Öffnen</td></tr><tr><td><strong>Bestellungen</strong></td><td>Öffnen</td></tr><tr><td><strong>Kunden &#x26; B2B</strong></td><td>Öffnen</td></tr><tr><td><strong>Synchronisation &#x26; Fehler</strong></td><td>Öffnen</td></tr></tbody></table>

{% hint style="info" %}
Zur tiefergehenden Fehleranalyse helfen das Aktivitätsprotokoll, der API Call Log und der Leitfaden API-Antworten analysieren.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.solutioo.de/shopware/fehlerbehebung-and-support/haufige-probleme-und-losungen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.