# WooCommerce verbinden

WooCommerce wird über die **offizielle REST-API** von WooCommerce angebunden. Sie erzeugen dazu einmalig ein **Consumer-Key-Paar** in Ihrem WordPress-Backend und hinterlegen es in SendDrop. Die Einrichtung dauert ca. 3–5 Minuten.

***

### Voraussetzungen

* **WooCommerce** Version 3.5 oder neuer (empfohlen: aktuelle Version).
* **Permalinks** in WordPress nicht auf „Plain" gestellt (gehen Sie auf **Einstellungen → Permalinks** und wählen Sie eine beliebige andere Option – sonst schlägt die API fehl).
* Ein WordPress-Nutzer mit Berechtigung, **REST-API-Keys** anzulegen (üblicherweise Administrator).
* Die öffentlich erreichbare **Shop-URL**, z. B. `https://meinshop.at`.

{% hint style="warning" %}
**HTTPS ist Pflicht.** WooCommerce-API-Keys für nicht-sensible Endpunkte funktionieren zwar auch über HTTP, aber SendDrop erfordert für eine sichere Übertragung **zwingend HTTPS**.
{% endhint %}

***

### Schritt 1: API-Keys in WooCommerce erzeugen

{% stepper %}
{% step %}

#### WooCommerce-API öffnen

Öffnen Sie im WordPress-Backend: **WooCommerce → Einstellungen → Erweitert → REST API**.
{% endstep %}

{% step %}

#### Neuen Schlüssel hinzufügen

Klicken Sie auf **„Schlüssel hinzufügen"**.
{% endstep %}

{% step %}

#### Schlüssel konfigurieren

* **Beschreibung:** z. B. `SendDrop`
* **Benutzer:** Ihr Administrator-Account
* **Berechtigungen:** **Lesen/Schreiben**
  {% endstep %}

{% step %}

#### Generieren

Klicken Sie auf **„API-Schlüssel generieren"**. Es werden ein **Consumer Key** und ein **Consumer Secret** angezeigt.

{% hint style="danger" %}
Das **Consumer Secret** wird Ihnen **nur ein einziges Mal** angezeigt. Kopieren Sie beide Werte sofort und speichern Sie sie sicher ab. Sollten Sie das Secret verlieren, müssen Sie einen neuen Key erzeugen.
{% endhint %}
{% endstep %}
{% endstepper %}

\[BILD-007 – Bild einfügen, welches Folgendes darstellt: WooCommerce-Einstellungen mit geöffnetem Reiter „REST API" und der Generierung eines neuen Schlüssels inklusive Consumer Key und Secret.]

***

### Schritt 2: Shop in SendDrop anlegen

{% stepper %}
{% step %}

#### „Neuer Shop" öffnen

Im Onboarding oder unter **Einstellungen → Shops → „Neuer Shop"**.
{% endstep %}

{% step %}

#### WooCommerce auswählen

In der Systemauswahl **WooCommerce** wählen.
{% endstep %}

{% step %}

#### Shop-Daten eingeben

| Feld                | Wert                                   |
| ------------------- | -------------------------------------- |
| **Shop-URL**        | `https://meinshop.at` (mit `https://`) |
| **Consumer Key**    | Aus Schritt 1                          |
| **Consumer Secret** | Aus Schritt 1                          |
| {% endstep %}       |                                        |

{% step %}

#### Verbindung testen

SendDrop prüft die Zugangsdaten automatisch. Bei Erfolg sehen Sie einen grünen Haken.
{% endstep %}

{% step %}

#### Standards wählen

Legen Sie **Standard-Marke** (Absenderadresse) und **Standard-Carrier** für diesen Shop fest.
{% endstep %}

{% step %}

#### Verbindung abschließen

SendDrop registriert automatisch Webhooks für `order.created`, `order.updated` und `order.deleted`. Neue Bestellungen erscheinen ab sofort in Echtzeit.
{% endstep %}
{% endstepper %}

***

### Was wird synchronisiert?

| Datenpunkt                                        | Richtung                                               |
| ------------------------------------------------- | ------------------------------------------------------ |
| **Bestellungen** (Empfänger, Positionen, Notizen) | WooCommerce → SendDrop                                 |
| **Tracking-Nummer & Label-URL**                   | SendDrop → WooCommerce (als Order-Note bzw. Meta-Feld) |
| **Versandstatus**                                 | SendDrop → WooCommerce                                 |
| **Produkte / Bestand**                            | nicht synchronisiert                                   |

***

### Fehlerbehebung

<details>

<summary><strong>„Ungültige Zugangsdaten" – obwohl alles richtig eingegeben</strong></summary>

Prüfen Sie Folgendes:

1. **Permalinks** sind nicht auf „Plain" gestellt (Einstellungen → Permalinks).
2. **HTTPS** ist aktiv und das SSL-Zertifikat ist gültig.
3. **Consumer Secret** wurde vollständig kopiert (keine Leerzeichen!).
4. **Rest-API** ist in WooCommerce aktiviert (Standard: ja).
5. **Berechtigungen** des Keys stehen auf **Lesen/Schreiben**.

</details>

<details>

<summary><strong>„Shop nicht erreichbar"</strong></summary>

Ihre Firewall / Ihr Hosting blockiert möglicherweise eingehende Verbindungen. Typische Ursachen:

* **ModSecurity / WAF** blockiert API-Anfragen → Whitelist-Regel für SendDrop-IPs einrichten.
* **Cloudflare / Sicherheits-Plugin** blockiert Bot-Zugriff → Rate Limits prüfen.

</details>

<details>

<summary><strong>Webhooks erreichen SendDrop nicht</strong></summary>

SendDrop registriert die Webhooks automatisch. Wenn Sie zusätzlich ein Caching-/Security-Plugin einsetzen, stellen Sie sicher, dass **Webhook-Aufrufe an externe URLs erlaubt** sind. Details siehe WooCommerce → Einstellungen → Erweitert → Webhooks.

</details>

***

### Häufige Fragen

<details>

<summary>Werden Rechnungen / Lieferadressen automatisch übernommen?</summary>

Ja. SendDrop nutzt die **Lieferadresse** (Shipping Address) aus WooCommerce. Ist keine Lieferadresse gesetzt, wird die **Rechnungsadresse** (Billing Address) verwendet.

</details>

<details>

<summary>Werden WooCommerce-Statusupdates zurück in den Shop geschrieben?</summary>

Ja. Sobald Sie ein Label erstellen, fügt SendDrop eine **Bestellnotiz** mit Tracking-Nummer und Link hinzu. Optional kann auch der Bestellstatus in WooCommerce aktualisiert werden.

</details>

<details>

<summary>Ich betreibe WooCommerce mit WPML (mehrsprachig) – geht das?</summary>

Ja. SendDrop liest Adressen und Positionsdaten aus der WooCommerce-API unabhängig von der Sprach-Einstellung. Produktnamen werden in der Sprache übernommen, in der die Bestellung angelegt wurde.

</details>

<details>

<summary>Kann ich mehrere WooCommerce-Shops verbinden?</summary>

Ja. Legen Sie für jeden Shop einen eigenen Eintrag in SendDrop an – jeder Shop kann eigene Standard-Marken und -Carrier haben.

</details>

***

{% hint style="info" %}
**Brauchen Sie Hilfe?** Unser Support-Team hilft Ihnen gerne weiter: <support@senddrop.com> oder über den Chat unten rechts in Ihrem Dashboard.
{% endhint %}

***

### Siehe auch

{% content-ref url="/pages/afzpYobkmkiQzWB9jB1n" %}
[Shop-Anbindung: Überblick](/2.-ihren-shop-verbinden/ueberblick.md)
{% endcontent-ref %}

{% content-ref url="/pages/34mLRZ7tylkvsQmfTkIU" %}
[Häufige Probleme bei der Shop-Anbindung](/2.-ihren-shop-verbinden/haeufige-probleme.md)
{% endcontent-ref %}

{% content-ref url="/pages/h7CIjXXtG4ZsjeFkUNMd" %}
[Carrier pro Shop automatisch festlegen](/4.-versanddienstleister/carrier-pro-shop.md)
{% endcontent-ref %}


---

# 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://wiki.senddrop.com/2.-ihren-shop-verbinden/woocommerce.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.