Eine WooCommerce Webshop verbinden

Um eine WooCommerce Webshop zu verbinden benötigst du drei Schlüssel (Keys). Ein API-Schlüssel, ein geheimer API-Schlüssel und ein geheimes Webhook-Schlüssel.

?> Tip Stelle sicher, dass bevor du die Verbindung herstellst, alle 'offenen' Bestellungen in deiner WooCommerce Webshop bearbeitet wurden. Auf diese Weise vermeidest du mögliche Bestandsunterschiede.

API-Schlüssel erstellen

Die API-Verbindung sorgt dafür, dass Stoqflow mit deiner WooCommerce-Webshop kommunizieren kann. Denk an das Abrufen von Bestellungen und Produktinformationen, Änderung der Bestellstatusse, usw. Hier unten finden Sie den Schritt-für-Schritt-Anleitungen, um eine WooCommerce Webshop mit Stoqflow zu verbinden.

• Melde dich bei deiner WooCommerce-Webshop an
• Navigiere zu 'WooCommerce' => 'Einstellungen' => 'Geavanceert'
• Klicke auf 'Rest API'
• Klicke auf 'Schlüssel hinzufügen'

• Gib im Feld 'Beschreibung': Stoqflow ein
• Wähle bei 'Rechte' für: Lesen/Schreiben aus
• Du erhältst die ersten zwei Schlüssel zu sehen

• Achtung: schließe dieses Fenster nicht, du erhältst diese Schlüssel nur einmal zu sehen
• Öffne Stoqflow in einem neuen Tab oder Fenster
• Navigiere zu 'Warenhäuser' und füge eine neue Warenhaus ein
• Gib der Warenhaus einen Namen und wähle für 'Online-Warenhaus', dann für 'WooCommerce'
• Gib unter 'API-Konfiguration' die beiden erstellten Schlüssel ein

• API-Key = Kunden-Schlüssel, API-Secret = Kunden-Geheim
  • Vergiss auch nicht bei 'API-Endpunkt' die vollständige URL deiner Webshop einzugeben (inklusive http oder https)
• Schließe das Fenster in Stoqflow nicht ab, sondern kehre zurück zu WooCommerce

!> Achtung Nach dem Einrichten der API und vor dem Einrichten der Webhooks versuche, eine Synchronisierung von Produkten und Bestellungen durchzuführen, in dieser Reihenfolge. Nachdem die API-Schlüssel eingerichtet wurden, wirst du zwei Synchronisierungs-Knopf unter deinen API-Einstellungen in Stoqflow sehen.

Webhooks hinzufügen

Die Webhooks sorgen dafür, dass WooCommerce unsere Anwendung sofort (realtime) von Änderungen auf Bestellniveau informiert. Ohne Webhooks wird Stoqflow die Änderungen nur auf voreingestellten Zeitpunkte empfangen und nicht in Echtzeit.

Erster Webhook: bearbeitete Bestellung

• Navigiere in WooCommerce zu 'WooCommerce' => 'Einstellungen' => 'Geavanceert' => 'Webhooks'
• Klicke auf 'Webhook hinzufügen'
• Gib folgende Felder ein:
  • Name: Stoqflow – Bestellung aktualisiert
  • Status: Aktiv
  • Thema: Bestellung bearbeitet (Order updated)
  • Ziel-URL: https://app.stoqflow.com/webhooks/woocommerce
  • Geheim: (vorläufig offen lassen)
  • API-Version: WP REST API-integrations V3
• Klicke auf 'Webhook speichern'
• Das Feld 'Geheim' wird automatisch eingefügt nach dem Speichern
• Kopiere diesen geheimen Schlüssel und kehre zurück zu Stoqflow
• Gib unter 'Webhooks-Konfiguration' diesen gemeinsamen geheimen Schlüssel ein bei 'Geheimer Schlüssel'
• Vergiss nicht, bei 'Quelle' die vollständige Domain-Name deiner Webshop einzugeben (inklusive http oder https)
• Wähle welche Bestellungen du in Stoqflow haben möchtest, anhand des Status-Filter oder einer fortgeschrittenen Filter (meist verwendet ist der Status 'processing')
• Speichere diese Konfiguration in Stoqflow

Zweiter Webhook: erstellte Bestellung

• Navigiere in WooCommerce zu 'WooCommerce' => 'Einstellungen' => 'Geavanceert' => 'Webhooks'
• Klicke auf 'Webhook hinzufügen'
• Gib folgende Felder ein:
  • Name: Stoqflow – erstellte Bestellung
  • Status: Aktiv
  • Thema: Erstellte Bestellung (Order created)
  • Ziel-URL: https://app.stoqflow.com/webhooks/woocommerce
  • Geheim: kopiere hier den zuvor angelegten geheimen Schlüssel aus dem ersten Webhook ein
• API-Version: WP REST API-integrations V3
• Klicke auf 'Webhook speichern'

Dritter Webhook: gelöschte Bestellung

• Navigiere in WooCommerce zu 'WooCommerce' => 'Einstellungen' => 'Geavanceert' => 'Webhooks'
• Klicke auf 'Webhook hinzufügen'
• Gib folgende Felder ein:
  • Name: Stoqflow – gelöschte Bestellung
  • Status: Aktiv
  • Thema: Gelöschte Bestellung (Order deleted)
  • Ziel-URL: https://app.stoqflow.com/webhooks/woocommerce
  • Geheim: kopiere hier den zuvor angelegten geheimen Schlüssel aus dem ersten Webhook ein
• API-Version: WP REST API-integrations V3
• Klicke auf 'Webhook speichern'

Lieferungsoptionen hinzufügen

Wenn es eine Verkaufsbestellung mit einer bestimmten Lieferungsoption gibt, wird eine kurier gesucht, die einen gleichnamigen Namen hat und eine für den Laden untergeschaltete Versandmethode bietet. Wenn so ein Kurier gefunden wurde, wird dieser als Vorzugskurier verwendet für diese Verkaufsbestellung. Lieferungsoptionen können in WooCommerce hinzugefügt werden, indem folgende Schritte durchgeführt werden:

• Navigiere in WooCommerce zu 'WooCommerce' => 'Einstellungen' => 'Geavanceert' => 'Webhooks'
• Erstelle eine oder mehrere 'shipping zones'
• Verwende die Namen der Kuriers, die du verwenden möchtest als 'shipping methods' für die 'shipping zones'