# WooCommerce mit RUIT verbinden

Tutorial zum Verbinden von WooCommerce: Gib deine Shop-Adresse ein und genehmige den Zugriff in WordPress, oder erstelle API-Schlüssel und füge sie in RUIT ein.

_Updated: 2026-09-28 · Source: https://ruit.es/de/docs/woocommerce-verbinden/_

In diesem Tutorial verbindest du deinen WooCommerce-Shop mit RUIT. Es gibt zwei Wege, und beide
führen ans selbe Ziel: **in deinem eigenen Shop autorisieren**, der kurze Weg (du gibst seine Adresse
ein, genehmigst in deinem WordPress und kommst zurück), oder **Schlüssel einfügen**, die du selbst in
WooCommerce erzeugst. Es dauert **fünf Minuten** und passiert **ein einziges Mal**.

**Du brauchst** Administratorrechte für den Shop, WooCommerce **3.5 oder neuer** und einen Shop, der
über `https://` **im Stammverzeichnis seiner Domain** läuft, etwa `https://deinshop.de`. Und eine
[verifizierte Telefonnummer](https://ruit.es/de/docs/deine-telefonnummer-verifizieren/), denn ohne sie öffnet sich
der Assistent zum Verbinden nicht.

> **Achtung:** RUIT übernimmt von der Adresse, die du eingibst, nur die Domain. Ein WordPress, das in einem Ordner
> installiert ist, etwa `https://meinedomain.de/shop/`, verliert diesen Ordner unterwegs und lässt sich
> heute nicht verbinden.

## 1. Gib die Adresse deines Shops in RUIT ein

Geh auf **Einstellungen → Konten**, drücke auf **Konto verbinden** und wähle **WooCommerce**. Gib die
Adresse deines Shops unter **Website** ein.

_Screenshot: Der Dialog zum Verbinden von WooCommerce in RUIT: die Bitte, die Informationen einzugeben, der Link zu dieser Anleitung, das Feld Website, die Schaltfläche zum Verbinden und darunter der ausklappbare Bereich für das manuelle Verbinden_

Der Dialog von WooCommerce. Die Zahl markiert **Website**. Unter der Schaltfläche klappt **Lieber
manuell verbinden?** den Weg mit den Schlüsseln auf, das ist Schritt 4.

## 2. Genehmige den Zugriff in deinem Shop

Drücke auf **Mit WooCommerce verbinden**. Solange die Adresse leer ist, steht auf der Schaltfläche
**Felder ausfüllen**; ist die Adresse eingetragen, bringt dich die Schaltfläche zur Autorisierung in
deinem eigenen Shop.
Bist du dort nicht als Administrator angemeldet, fragt WordPress zuerst danach.

Die Seite nennt, was RUIT anfordert: **Lese- und Schreibzugriff** auf deinen Shop, den RUIT braucht,
um Produkte zu veröffentlichen, den Bestand aktuell zu halten und von Verkäufen zu erfahren. Drücke
auf **Genehmigen**.

_Screenshot: Die Autorisierungsseite des WooCommerce-Shops: der Hinweis, dass RUIT sich mit Lese- und Schreibzugriff verbinden möchte, die Liste dessen, was es tun darf, das Administratorkonto, mit dem du angemeldet bist, und die Schaltflächen zum Ablehnen und Genehmigen_

Die Autorisierung, gezeigt in einem Shop mit englischer Oberfläche. Der Rahmen markiert
**Genehmigen**; in deinem Shop erscheinen die Beschriftungen in der Sprache deines WordPress.

> **Achtung:** Diese Autorisierung läuft **15 Minuten** nach dem Druck auf die Schaltfläche ab. Bleibt sie halb
> fertig liegen, geh zurück zu Schritt 1 und fang von vorn an.

## 3. Kehre zu RUIT zurück

Dein Shop erzeugt ein Schlüsselpaar und schickt es von selbst an RUIT; RUIT prüft es gegen deinen
Shop, speichert das Konto und zeigt dir **WooCommerce verknüpft**. Drücke auf **Meine Konten
ansehen** und spring zu „Was du erreicht hast“.

## 4. Oder füge die Schlüssel von Hand ein

Wenn dein Shop dich nicht genehmigen lässt oder du den Schlüssel lieber selbst erstellst, führt der
andere Weg über API-Schlüssel von WooCommerce. Du erzeugst sie in deinem WordPress unter
**WooCommerce → Einstellungen → Erweitert → REST-API** mit der Schaltfläche **Schlüssel
hinzufügen**.

_Screenshot: Der Reiter Erweitert in den Einstellungen von WooCommerce, im Bereich REST-API, mit der Liste der vorhandenen Schlüssel und der Schaltfläche zum Hinzufügen eines Schlüssels neben dem Titel_

Die Liste der Schlüssel deines Shops, mit englischer Oberfläche. Der Rahmen markiert **Schlüssel
hinzufügen**.

Gib eine Beschreibung ein, die du wiedererkennst, wähle als Benutzer einen **Administrator** und bei
den Berechtigungen **Lesen/Schreiben**. Drücke auf **API-Schlüssel generieren**.

_Screenshot: Das Formular für den neuen Schlüssel in WooCommerce: das Feld für die Beschreibung, die Auswahl des Benutzers, die Auswahl der Berechtigungen mit Lesen/Schreiben und die Schaltfläche zum Generieren des Schlüssels_

Die drei Rahmen: die **Beschreibung**, die **Berechtigungen** mit Lesen und Schreiben und die
Schaltfläche zum **Generieren**. Der Benutzer ist abgedeckt, weil er die E-Mail-Adresse des
Administrators zeigt.

> **Achtung:** Erstelle den Schlüssel mit **Lesen/Schreiben**. RUIT prüft die Berechtigungen beim Verbinden nicht:
> Mit einem reinen Leseschlüssel klappt die Verbindung, und später scheitern stillschweigend die
> Meldungen, die dein Shop RUIT bei jedem Verkauf schickt.

WooCommerce zeigt dir die beiden Schlüssel **ein einziges Mal**: den `Consumer Key`, der mit `ck_`
beginnt, und das `Consumer Secret`, das mit `cs_` beginnt. Kopiere sie jetzt; schließt du die Seite,
musst du einen neuen Schlüssel generieren.

_Screenshot: Die Seite von WooCommerce nach dem Generieren des Schlüssels: der Hinweis, die Schlüssel jetzt zu kopieren, die Felder für Consumer Key und Consumer Secret mit ihrer Schaltfläche zum Kopieren und der QR-Code_

Die beiden Schlüssel, hier abgedeckt. Die Rahmen markieren die beiden Schaltflächen zum
**Kopieren**; der grüne Hinweis warnt, dass der geheime Schlüssel nicht noch einmal angezeigt wird.

Geh zurück zu RUIT, klappe **Lieber manuell verbinden?** auf und fülle **Website**, `Consumer Key`
und `Consumer Secret` aus. Drücke auf **Verbinden**. RUIT prüft, ob die Schlüssel die richtige Form
haben, und testet sie dann gegen deinen Shop.

## Was du erreicht hast

Dein Shop erscheint unter **Verbundene Konten** mit seiner WooCommerce-Karte. Die Schlüssel laufen
nicht ab, deshalb hat die Karte nicht die Schaltfläche **Neu verbinden**, die Wallapop und Vinted
haben: Die Verbindung hält, bis du den Schlüssel in WooCommerce löschst. Außerdem ist dein Shop jetzt
so eingerichtet, dass er RUIT jeden Verkauf sofort meldet, ohne auf die nächste Abrufrunde zu warten.

_Screenshot: Der Bildschirm Verbundene Konten von RUIT mit einer Karte pro Marktplatz, darunter die WooCommerce-Karte mit dem verbundenen Shop, und oben rechts die Schaltfläche Konto verbinden_

Der WooCommerce-Shop unter den verbundenen Konten. Seine Karte trägt den Namen, den du dem Shop geben
willst, und keine Schaltfläche zum erneuten Verbinden.

**Nächster Schritt:** aus einem Marktplatz importieren, um die Produkte zu holen, die du schon im
Shop hast, oder [dein erstes Produkt veröffentlichen](https://ruit.es/de/docs/deine-erste-anzeige/).

## Wenn etwas nicht passt

- **„Die Zugangsdaten konnten nicht überprüft werden. Bitte prüfe deine API-Schlüssel und die URL
  deines Shops“.** RUIT hat deinen Shop aufgerufen und keine gültige Antwort bekommen. Die Meldung
  ist bei allen Ursachen dieselbe, prüfe sie also der Reihe nach: Die Adresse zeigt auf das
  Stammverzeichnis der Domain; die API von WooCommerce antwortet unter
  `https://deinshop.de/wp-json/wc/v3/` (ein Plugin für die Sicherheit oder die WordPress-Permalinks
  auf **Einfach** schalten sie ab); WooCommerce ist 3.5 oder neuer; und die Schlüssel sind
  vollständig kopiert.
- **„Ungültiges Format der Zugangsdaten“.** Der `Consumer Key` beginnt nicht mit `ck_` oder das
  `Consumer Secret` nicht mit `cs_`. Kopiere beide noch einmal, ohne Leerzeichen.
- **„Die URL muss HTTPS verwenden (nicht HTTP)“.** RUIT verbindet keine Shops ohne `https://`.
  Richte ein Zertifikat für den Shop ein und versuch es noch einmal.
- **Du kommst mit „WooCommerce verknüpft“ zurück, aber die Karte erscheint nicht unter Konten.** Dein
  Shop hat genehmigt, aber RUIT konnte die Schlüssel nicht gegen ihn prüfen. Nimm den Weg mit den
  Schlüsseln, Schritt 4: Er sagt dir sofort, was nicht stimmt.
- **„Die Verbindung wurde nicht autorisiert“.** Du hast in deinem Shop auf **Ablehnen** gedrückt.
  Wiederhole ab Schritt 2 und akzeptiere die Berechtigungen, die angefordert werden.
- **Die Autorisierung ist seit mehr als 15 Minuten offen.** Sie ist abgelaufen. Fang noch einmal bei
  Schritt 1 an.

- [Auf WooCommerce verkaufen mit RUIT](https://ruit.es/de/docs/marketplaces/)
- [PrestaShop mit RUIT verbinden](https://ruit.es/de/docs/prestashop-verbinden/)
- [So funktioniert das Verbinden eines Kontos](https://ruit.es/de/docs/so-funktioniert-das-verbinden-eines-kontos/)