> 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

Erfahren Sie, wie Sie Fehler bei automatischen Prozessen erkennen und beheben.

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="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FvMkOiJsVclu41xM11wSj%2FBildschirmfoto%202026-06-30%20um%2011.17.41.png?alt=media&amp;token=0f15e6a9-d24a-48c7-b87f-9ce61cf2a8f9" alt=""><figcaption></figcaption></figure></div>

<div align="left" data-with-frame="true"><figure><img src="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FJ814RWU7KnQam6qtOpwv%2FBildschirmfoto%202026-06-30%20um%2011.29.06.png?alt=media&amp;token=d9ab1d09-41e8-4e77-9242-2d7e3b8aa542" 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="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2FjKrp3Vl2Xwh1LYME5l7x%2FBildschirmfoto%202026-06-30%20um%2011.38.49.png?alt=media&amp;token=0f30aef6-2b6f-465b-8aa1-6889f324151f" 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="https://3167966143-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVsUTvHyq0bxTYi3oQtlM%2Fuploads%2Fpeh5j6G2NyQp9Vx3aib6%2FBildschirmfoto%202026-06-30%20um%2011.46.03.png?alt=media&amp;token=352bbb10-b840-4cdd-ac53-8db9f6c8ef86" 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.solutioo.de/shopware/automatisierungen-und-zeitplane/fehlerhandling-bei-automatischen-prozessen.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.