Shopify + kursflow: So bindest du deine Kurse in deinen Shop ein

Du betreibst einen Shopify-Shop und einen Kurs-Anbieter-Account? Dann brauchst du nicht zwei getrennte Systeme — kursflow integriert sich direkt mit deinem Shop. Wir zeigen dir, wie du Bestellungen automatisch erfasst und deine Kursliste auf jeder Shopify-Seite einbindest.

Was die Shopify-Integration für dich macht

Die Integration verbindet zwei Dinge:

• Order Sync: Wenn ein Kunde in Shopify kauft, erfasst kursflow die Bestellung automatisch als Kursbuchung. Dafür muss das Shopify-Produkt nur die richtige Kennung haben — mehr dazu gleich.
• Widget-Embed: Du bindest deine aktuelle Kursliste direkt auf deiner Shopify-Website ein. Kein App Store nötig, kein zusätzliches JavaScript-Chaos. HTML-Snippet rein, fertig.
• Kunden-Abgleich: Shopify-Kunden werden per E-Mail mit deinen kursflow-Kontakten verknüpft. So entsteht ein einheitliches Kundenprofil.

Das bedeutet für dich: Ein Kauffluss (Shopify), ein Buchungssystem (kursflow), keine manuellen Einträge.

Schritt 1: Webhook in kursflow einrichten

Der Webhook ist die Brücke zwischen deinem Shop und kursflow. Hier aktivierst du die Kommunikation:

1. Öffne in deinem kursflow-Admin: Integrationen → Shopify
2. Kopiere die Webhook-URL (sieht so aus: https://<dein-slug>.kursflow.de/api/shopify/webhook)
3. Trage das Webhook-Secret ein (das bekommst du gleich aus Shopify)
4. Optional: Trage deine Shop-Domain ein (z.B. meinogastudio.myshopify.com)
5. Speichern klicken

Das Secret ist wichtig — es sorgt dafür, dass nur echte Shopify-Nachrichten angenommen werden. Passt es nicht, landen deine Bestellungen nicht in kursflow.

Schritt 2: Webhook in Shopify eintragen

Jetzt geht es zu Shopify. Hier sagst du deinem Shop, wohin er Bestellungen schicken soll:

1. Shopify Admin → Einstellungen → Benachrichtigungen
2. Ganz unten: Webhooks → Webhook erstellen
3. Ereignis: Wähle Bestellung erstellt
4. Format: JSON
5. URL: Hier kommt deine kopierte Webhook-URL rein
6. Speichern — Shopify zeigt dir sofort das Signing Secret

Dieses Secret trägst du in kursflow ein (Schritt 1, Feld "Webhook-Secret"). Das war's — die Verbindung ist live.

Tipp: Shopify zeigt dir unter Einstellungen → Benachrichtigungen → Webhooks → [dein Webhook] die letzten Liefervorgänge. Wenn dort grüne Häkchen stehen, funktioniert es.

Schritt 3: Shopify-Produkte richtig kennzeichnen

Damit kursflow weiß, welches Shopify-Produkt welcher Kurs ist, brauchst du die richtige SKU im Shopify-Produkt:

EVT-abc123def456    (für Kurse)
PASS-xyz789         (für Gutscheine/Passes)

Die Event-ID findest du in kursflow so:

1. Kurse → deinen Kurs öffnen
2. Schau die URL an — am Ende steht die ID
3. Beispiel: /admin/events/abc123def456 → SKU ist EVT-abc123def456

In Shopify trägst du diese SKU ins Produkt ein:

1. Produkte → Produkt öffnen
2. Varianten → SKU bearbeiten
3. EVT-abc123def456 eingeben
4. Speichern

Fertig. Jetzt weiß Shopify: "Wenn jemand dieses Produkt kauft, gehört es zum Kurs abc123def456 in kursflow."

Deine Kursliste direkt in Shopify einbinden

Du kannst deine Kurse auch live auf deiner Shopify-Website anzeigen — ohne App, ohne Umschweife.

So funktioniert's

1. Online-Store → Themes → Anpassen
2. Seite öffnen, wo deine Kurse sichtbar sein sollen
3. Section hinzufügen → Benutzerdefinierter HTML-Code
4. Diesen Code einfügen:

<div class="kursflow-widget" data-tenant="dein-slug"></div>
<script async src="https://dein-slug.kursflow.de/widget.js"></script>

dein-slug ist deine kursflow-Subdomain (z.B. yogastudio-berlin).

Das Widget zeigt dann automatisch deine veröffentlichten Kurse.

Widget anpassen mit Parametern

Du kannst steuern, wie das Widget aussieht:

| Parameter | Wert | Was es tut | |---|---|---| | data-layout | grid, liste, kompakt | Layout-Style | | data-limit | 6, 12, 20 | Wie viele Kurse angezeigt werden | | data-branche | yoga, motorrad, sprachkurs | Nur Kurse dieser Kategorie |

Beispiel:

<div class="kursflow-widget" data-tenant="yogastudio" data-layout="grid" data-limit="8"></div>
<script async src="https://yogastudio.kursflow.de/widget.js"></script>

Das zeigt maximal 8 Kurse im Grid-Layout.

Order-Status: Das bedeuten die Labels

Nach jeder Bestellung kannst du unter Integrationen → Shopify → Order-Mappings sehen, was passiert ist:

| Status | Heißt | Aktion nötig? | |---|---|---| | pending | Bestellung eingegangen, aber kein passender Kurs gefunden (SKU stimmt nicht) | Ja — SKU prüfen oder manuell reconcilen | | linked | Bestellung erfolgreich einem Kurs zugeordnet | Nein | | reconciled | Alles komplett verarbeitet (Buchung + Bezahlung) | Nein | | failed | Verarbeitung ist schiefgelaufen | Ja — Fehlertext lesen, Support kontaktieren |

Wenn Bestellungen auf pending stecken bleiben, kannst du sie manuell neu verarbeiten:

Integrationen → Shopify → Aktualisieren — kursflow prüft alle offenen Einträge der letzten 24 Stunden erneut.

Das solltest du wissen (Limitierungen)

Damit es keine Überraschungen gibt:

• Zwei Checkouts, kein gemeinsamer: Der Kunde kauft in Shopify, kursflow erfasst es als Zuordnung. Es ist kein einstufiger Checkout — das ist derzeit so gewünscht.
• Stornierungen: Wenn eine Shopify-Bestellung storniert wird, musst du die kursflow-Buchung manuell stornieren. Ein automatischer Sync ist nicht aktiv.
• Bestandsverwaltung: Kurs-Kapazität und Shopify-Lagerbestand sind derzeit getrennt. Das Sync dieser beiden Systeme ist in Vorbereitung.

Häufige Fehlerquellen

"Bestellungen landen im Status pending"

• Das Shopify-Produkt hat keine SKU oder die SKU ist falsch
• Prüfe: Muss mit EVT- oder PASS- beginnen und die exakte kursflow-ID enthalten

"Das Widget zeigt keine Kurse"

• Sind die Kurse in kursflow als "Veröffentlicht" gesetzt? (ja/nein prüfen)
• Stimmt der data-tenant-Wert mit deinem Slug überein?
• Öffne die Browser-Konsole (F12) — siehst du Fehler mit kursflow: Prefix? Das ist ein CORS-Problem.

"Der Webhook kommt nicht an"

• Shopify Admin → Einstellungen → Benachrichtigungen → Webhooks → deinen Webhook anklicken
• Schau die letzten Liefervorgänge an — sind sie grün oder rot?
• Prüfe das Webhook-Secret: Muss exakt mit deinem kursflow-Secret übereinstimmen

Die Shopify-Integration spart dir Zeit und macht dein Leben einfacher — ein Shop, ein Buchungssystem, eine Quelle der Wahrheit. Starte jetzt und verbinde deine Systeme.

Sichere dir deinen Beta-Platz auf kursflow.de — 3 Monate kostenfrei, 0 % Provision.