> 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/automatisierungen-und-zeitplane/fehlerhandling-bei-automatischen-prozessen.md).

# Fehlerhandling bei automatischen Prozessen

Automatische Prozesse können aus verschiedenen Gründen fehlschlagen. Hier erfahren Sie, wie Sie Fehler erkennen und beheben.

## 1. Fehlertypen

<table data-view="cards"><thead><tr><th></th><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-wifi">:wifi:</i> <i class="fa-triangle-exclamation">:triangle-exclamation:</i></td><td><h3>Verbindungsfehler</h3></td><td><ul><li>API-Verbindung unterbrochen</li><li>Timeout bei Anfragen</li><li>Authentifizierungs-probleme</li></ul></td></tr><tr><td><i class="fa-database">:database:</i> <i class="fa-triangle-exclamation">:triangle-exclamation:</i></td><td><h3>Datenfehler</h3></td><td><ul><li>Fehlende Pflichtfelder</li><li>Ungültige Datenformate</li><li>Mapping-Probleme</li></ul></td></tr><tr><td><i class="fa-sensor-triangle-exclamation">:sensor-triangle-exclamation:</i></td><td><h3>Systemfehler</h3></td><td><ul><li>Shopware-Server nicht erreichbar</li><li>BC-Dienste nicht verfügbar</li><li>Ressourcenengpässe</li></ul></td></tr></tbody></table>

## 2. Fehlererkennung

### 2.1 Aufgabenwarteschlange

Öffnen Sie die [*Aufgabenwarteschlangenposten*](/shopware/automatisierungen-und-zeitplane/aufgabenwarteschlangenposten.md). Den aktuellen Status finden Sie in der Spalte *"Status"*. Falls hier *"Fehler"* steht, klicken Sie direkt darauf. Es öffnet sich ein neues Fenster *"Karte für Aufgabenwarteschlagenposten"*.

Gehen Sie anschließend der Ursache des Fehlers nach. Dabei stehen Ihnen verschiedene unterstützende Funktionen zur Verfügung, beispielsweise die Schaltfläche *„Fehler anzeigen“*.

<div align="left" data-with-frame="true"><figure><img src="/files/jOZIRuTyxrVnsQJKscsi" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="/files/VH9dVGEuIFwbp0ZozOtv" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.2 Aktivitätsprotokoll

> Folgen Sie dem Pfad: *"Shopware"* <i class="fa-right">:right:</i> *"Aktivitätsprotokoll"*

Filtern Sie nach Fehlern und analysieren Sie diese.

<div align="left" data-with-frame="true"><figure><img src="/files/FJACibz01RyK5kfGDzsE" alt="" width="563"><figcaption></figcaption></figure></div>

### 2.3 API-Call-Log

> Folgen Sie dem Pfad: *"Shopware"* <i class="fa-right">:right:</i> *"API-Aufrufprotokoll"*

Für eine detaillierte Analyse prüfen Sie den Request und die Response. Auf diese Weise können Sie die Fehlerursache gezielt identifizieren.

<div align="left" data-with-frame="true"><figure><img src="/files/mWPYF018BacpnekqwbOB" alt="" width="563"><figcaption></figcaption></figure></div>

## 3. Fehlerbehandlung

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><h3>Allgemeines Vorgehen</h3></td><td><ol><li>Fehler identifizieren</li><li>Ursache analysieren</li><li>Problem beheben</li><li>Aufgabe erneut ausführen</li><li>Erfolg prüfen</li></ol></td></tr><tr><td><h3>Verbindungsfehler beheben</h3></td><td><ol><li>Prüfen Sie die <strong>API-Verbindung</strong> in den Einstellungen.</li><li>Führen Sie einen <strong>Verbindungstest</strong> durch</li><li>Prüfen Sie die <strong>API-Zugangsdaten.</strong></li><li>Prüfen Sie die <strong>Netzwerkverbindung.</strong></li></ol></td></tr><tr><td><h3>Datenfehler beheben</h3></td><td><ol><li>Identifizieren Sie den <strong>fehlerhaften Datensatz.</strong></li><li>Prüfen Sie die <strong>Pflichtfelder.</strong></li><li>Korrigieren Sie die <strong>Daten.</strong></li><li>Prüfen Sie die <strong>Mapping-Tabellen.</strong></li></ol></td></tr></tbody></table>

## 4. Benachrichtigungen

{% tabs %}
{% tab title="E-Mail-Benachrichtigungen" %}
Richten Sie Benachrichtigungen bei Fehlern ein:

1. Öffnen Sie **Aufgabenwarteschlangenposten.**
2. Wählen Sie den Posten.
3. Aktivieren Sie *"Bei Fehler benachrichtigen"***.**
4. Geben Sie E-Mail-Adressen an.
   {% endtab %}

{% tab title="Monitoring-Dashboard" %}
Nutzen Sie die Bestellübersicht für einen schnellen Überblick:

* Anzahl fehlerhafter Imports
* Letzte erfolgreiche Synchronisation
* Offene Fehler
  {% endtab %}
  {% endtabs %}

## 5. Wiederholungsstrategien

{% tabs %}
{% tab title="Automatische Wiederholung" %}
Einige Fehler werden automatisch wiederholt:

* Verbindungsfehler nach kurzer Pause.
* Timeout-Fehler mit erhöhtem Timeout.
  {% endtab %}

{% tab title="Manuelle Wiederholung" %}

1. Beheben Sie die Fehlerursache.
2. Setzen Sie den Status auf *"Bereit"*.
3. Die Aufgabe wird beim nächsten Intervall ausgeführt.
   {% endtab %}
   {% endtabs %}

<details>

<summary><strong>Tipps für den täglichen Umgang</strong></summary>

#### Proaktive Überwachung

* Prüfen Sie täglich die Aufgabenwarteschlange.
* Überwachen Sie das Aktivitätsprotokoll.
* Reagieren Sie schnell auf Fehler.

#### Fehlerprävention

* Pflegen Sie vollständige Stammdaten.
* Halten Sie Mappings aktuell.
* Testen Sie Änderungen zuerst manuell.

#### Dokumentation

* Dokumentieren Sie wiederkehrende Fehler.
* Erstellen Sie eine FAQ für häufige Probleme.
* Schulen Sie Mitarbeiter in der Fehlerbehebung.

</details>


---

# 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/automatisierungen-und-zeitplane/fehlerhandling-bei-automatischen-prozessen.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.