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