# 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>

## 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 href="/pages/Ncoj7hnccL9iGudThmZL#id-3.-shopware-medienordner" 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>

**Symptome:**

* Fehlermeldung beim Upload
* Dokument erscheint nicht in Shopware.

**Mögliche Ursachen:**

1. PDF-Modul nicht aktiviert
2. Shopware-Plugin nicht installiert
3. Kunde nicht gefunden

**Lösungen:**

1. Aktivieren Sie **PDF Dokumente aktivieren** in den Einstellungen.
2. Installieren Sie das **Solutioo Invoice Documents** Plugin.
3. Prüfen Sie die Kundenzuordnung (E-Mail/Kundennummer).

</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>

## Performance

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

## 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>


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.