> 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/konfiguration/verbindung-testen-and-diagnose.md).

# Verbindung testen & Diagnose

Bevor Sie Daten synchronisieren, sollte die Verbindung zur Shopware-Admin-API einwandfrei funktionieren. Diese Seite zeigt, wie Sie die Verbindung prüfen und Fehler eingrenzen.

### **Verbindung testen**

In der **Shopware Konfiguration** stehen zwei hilfreiche Aktionen bereit:

* **Verbindung testen** – ruft ein frisches Token bei Shopware ab. Erscheint eine Erfolgsmeldung, sind URL, Pfad und Zugangsdaten korrekt.
* **Passwort anzeigen** – zeigt die hinterlegten Zugangsdaten zur Kontrolle an.

{% stepper %}
{% step %}
**Zugangsdaten prüfen**

Stellen Sie sicher, dass **Website-URL** (z. B. `https://shop.example.com`) und **API-Modulpfad** (üblich `/api`) korrekt sind. Ein abschließender Schrägstrich wird automatisch entfernt.
{% endstep %}

{% step %}
**Test ausführen**

Klicken Sie auf **Verbindung testen**. Der Connector fordert ein Token unter `…/oauth/token` an.
{% endstep %}

{% step %}
**Ergebnis auswerten**

Bei Erfolg erscheint eine Bestätigung. Bei Misserfolg prüfen Sie die untenstehenden Ursachen und aktivieren Sie ggf. den **Developer Log**.
{% endstep %}
{% endstepper %}

### **Typische Ursachen bei Verbindungsfehlern**

| Symptom                             | Mögliche Ursache                           | Lösung                                                |
| ----------------------------------- | ------------------------------------------ | ----------------------------------------------------- |
| „UserName or Password is incorrect“ | Falsche Zugangsdaten / falscher Auth-Modus | Zugangsdaten und Schalter *Integrationszugang* prüfen |
| Kein Token / leere Antwort          | URL oder API-Pfad falsch                   | Website-URL und API-Modulpfad korrigieren             |
| Zeitüberschreitung                  | Shop nicht erreichbar / Firewall           | Erreichbarkeit und ausgehende HTTPS-Verbindung prüfen |
| Zertifikatsfehler                   | Ungültiges TLS-Zertifikat                  | Gültiges Zertifikat im Shop hinterlegen               |

{% hint style="info" %}
Aktivieren Sie zur Fehlersuche vorübergehend **Enable Developer Log**. Anschließend sehen Sie im API Call Log die exakte Anfrage-URL und die Serverantwort.
{% endhint %}

**Checkliste**

<details>

<summary><strong>Verbindung schlägt fehl? Was prüfen?</strong></summary>

1. Ist **Aktivieren** in der Konfiguration gesetzt?
2. Stimmen **Website-URL** und **API-Modulpfad**?
3. Passt der **Authentifizierungsmodus** zu Ihren Zugangsdaten? Siehe Authentifizierungsmethoden im Detail.
4. Ist die Shopware-Admin-API von außen erreichbar?
5. Zeigt der **Developer Log** eine konkrete Fehlermeldung?

</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/konfiguration/verbindung-testen-and-diagnose.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.
