Shopify Konnektor

Shopify ist ein beliebtes und leistungsstarkes E-Commerce- und Warenkorb-Tool, das umfangreiche Funktionsmöglichkeiten, konfigurierbare Workflows, Analysen und Optionen zur Steigerung des Umsatzes bietet, indem es beispielsweise Rabattcodes und Geschenkkarten ermöglicht. Shopify ist als Software-as-a-Service (SaaS)-Modell mit verschiedenen Abonnementmodellen verfügbar. Voraussetzung für die Einrichtung der Verbindung durch imc ist, dass ein gültiges Abonnement für Shopify besteht und dass die API-Schlüsseldaten und Callback-URLs von/zu der Shopify-Instanz des Kunden an imc übermittelt werden. Alle Lizenzgebühren im Zusammenhang mit dem Shopify-Abonnement oder der Konfiguration von Shopify selbst werden nicht von imc übernommen und müssen direkt vom Kunden organisiert werden. Der imc Shopify Connector stellt eine Schnittstelle zwischen der imc Learning Suite und Shopify bereit, über die Lerner Kurse und Lernpfade über den LMS-Katalog in ihren Warenkorb hinzufügen und über Shopify bezahlen können. Der imc Shopify Connector als Teil der imc Learning Suite:

• Vermittelt die Kommunikation zwischen dem imc LMS und Shopify und übernimmt automatisch die Erstellung und Aktualisierung des Produktkatalogs in Shopify mit Kursen aus dem LMS-Katalog.

• Ermöglicht es Lernenden, Kurse und Lernpfade dem Warenkorb hinzuzufügen, basierend auf dem für den Lernenden geltenden Preis (Vorzugspreise basierend auf der Gruppenzugehörigkeit können über das LMS definiert werden).

• Führt Anmeldeprüfungen durch, z. B. die erfüllten Voraussetzungen, und stellt den Lernenden ein Anmeldeformular zur Verfügung, in dem zusätzliche Daten für die Anmeldung erfasst werden können.

• Ermöglicht es Lernern, Artikel aus ihrem Warenkorb zu entfernen.

• Ermöglicht es Lernern, mit den Artikeln in ihrem Warenkorb zur Kasse zu gehen.

• Bearbeitet die Buchungen auf Grundlage der von Shopify erhaltenen Zahlungsbenachrichtigungen.

In Zusammenarbeit mit Shopify, das:

• Zeigt die Checkout-Seite an und bearbeitet die Zahlung.

• Informiert die imc Learning Suite, sobald eine Zahlung erfolgreich bestätigt wurde.

• Einrichten und den Lernenden beim Bezahlen Rabattcodes verwenden lassen

• Zugriff auf Verkaufsanalysen und Reporting

• Liste aller Bestellungen anzeigen

• Zahlungsoptionen konfigurieren

• Shopify unterstützt Hunderte von Zahlungsanbietern – siehe Zahlungsanbieter und Online-Zahlungsgateways (2025)

• Die Checkout-Seite anpassen

Hinweis: imc ist kein Shopify-Experte. Wir empfehlen dem Kunden, sich an einen Shopify-Experten zu wenden, wenn er Hilfe bei der Konfiguration von Shopify benötigt, die über die in diesem Dokument beschriebene technische Schnittstelle hinausgeht. Auf der Shopify-Seite sind viele Dinge konfigurierbar (z. B. Gutscheincodes, Steuerregeln, Rechnungsvorlagen, Konfiguration vieler verschiedener Zahlungsabwickler usw.), die einen großen Mehrwert für den Prozess des Kunden darstellen können. In den Online-Ressourcen und Foren von Shopify finden Sie zahlreiche Dokumentationen und Support-Informationen. Darüber hinaus werden in diesem Dokument die Konfigurationen und Einstellungen beschrieben, die für die erfolgreiche Einrichtung des imc Shopify Connectors erforderlich sind.

Lerner-Journey

Die Lernreise beginnt im LMS-Katalog. Der Lerner sucht den gewünschten Artikel, fügt ihn dem Warenkorb hinzu oder meldet sich zunächst an, falls er noch nicht angemeldet ist, und geht dann zur Kasse. 

Auf der Checkout-Seite kann der Lerner je nach Shopify-Konfiguration Rabattcodes oder Geschenkkarten eingeben.

Sobald die Zahlung verarbeitet wurde, wird der Lerner zum LMS weitergeleitet, sofern eine solche Weiterleitung auf der Shopify-Seite konfiguriert ist, und kann auf die gebuchten Kurse zugreifen, sobald die Transaktion auf der LMS-Seite abgeschlossen ist. Dieser Schritt kann einige Sekunden dauern, erfolgt jedoch in der Regel sofort.

Hinzufügen zum Warenkorb

Die Option „Zum Warenkorb hinzufügen” wird dem Lerner unter folgenden Bedingungen angezeigt:

• Der Kurs ist mit dem Meta-Tag „An Shopify senden“ als Shopify-relevant gekennzeichnet.

• Die Buchungsart des Kurses ist „Selbstanmeldung“.

• Es gibt freie Plätze im Kurs oder Lernpfad.

• Der Meta-Tag-Wert für die Selbstbuchung möglich bis ist entweder nicht festgelegt oder auf einen Zeitpunkt in der Zukunft gesetzt.

• Auf der Grundlage der festgelegten Preise ist der Lerner berechtigt, einen Preis zu zahlen.

Kostenlose Kurse können direkt gebucht werden, ohne dass ein Kaufvorgang erforderlich ist.

Wenn der Nutzer bereits angemeldet ist, kann er den Artikel in den Warenkorb hinzufügen. Sobald sich der Artikel im Warenkorb befindet, wird stattdessen die Option zum Entfernen aus dem Warenkorb angezeigt.

Wenn der Nutzer noch nicht angemeldet ist, wird er aufgefordert, sich anzumelden, um Artikel in den Warenkorb hinzuzufügen. Nach der Anmeldung wird der Nutzer zurück zu dem Artikel weitergeleitet, bei dem die Option „Zum Warenkorb hinzufügen“ verfügbar ist.

Um die aktuelle Liste der im Warenkorb verfügbaren Artikel anzuzeigen, kann das Warenkorb-Symbol in der oberen Navigationsleiste ausgewählt werden.

Kurse innerhalb von Lernpfaden

Für über Shopify erworbene Lernpfade werden zwei Workflows unterstützt:

Szenario 1: Der Kauf eines Lernpfads ermöglicht dem Nutzer den direkten Zugriff auf alle darin enthaltenen Kurse (kostenlos).

Es ist möglich, die direkte Anmeldung für einige oder alle Kurse im Lernpfad in Konfiguration zu setzen. In diesem Fall wird der Nutzer automatisch angemeldet und muss die Kurse nicht zusätzlich erwerben. 

Hinweis: Die direkte Registrierung ist nur möglich, wenn der Benutzer die Voraussetzungen erfüllt und keine weiteren Hindernisse für die automatische Registrierung vorliegen. 

Szenario 2: Der Nutzer erwirbt den Lernpfad, um Zugang zu den darin enthaltenen Kursen zu erhalten. Anschließend muss er sich für die Kurse registrieren oder diese erwerben.

Sobald ein Nutzer einen Lernpfad gekauft hat oder dafür registriert ist, muss er sich für die Kurse im Lernpfad registrieren. In diesem Szenario ist es möglich, dass die Kurse selbst kostenlos sind, d. h. nicht Shopify-relevant.

Alternativ, wenn der/die Kurs(e) auch für Shopify relevant sind und einen Preis haben, muss der Lerner die Kurse in den Warenkorb hinzufügen und kaufen.

Es ist möglich, die direkte Anmeldung für einige oder alle Kurse im Lernpfad zu konfigurieren. In diesem Fall wird der Nutzer automatisch angemeldet und muss die Kurse nicht zusätzlich erwerben.

Kauf von Kursen/Lernpfaden aus mehreren Shopify-Shops

Der Lerner kann mehrere Kurse/Lernpfade erwerben, die Teil mehrerer Shopify-Shops sind.

Jeder Kurs/Lernpfad wird im Warenkorb basierend auf dem Anbieter angezeigt. Der Name des Anbieters wird ebenfalls neben der Zwischensumme jedes Shops angezeigt.

In diesem Fall müssen separate Checkouts durchgeführt werden, wobei jeweils nur ein Checkout möglich ist. Sobald der Nutzer beispielsweise 1/3 der Checkouts abgeschlossen hat, wird der Warenkorb automatisch geöffnet, um die restlichen 2 Checkouts durchzuführen. Wenn der letzte Checkout erfolgreich beendet ist, wird der Warenkorb nicht mehr geöffnet.

Die Zahlung wird wie bisher über Shopify abgewickelt.

Buchung auf der Warteliste, wenn für einen Kurs/Lernpfad keine Plätze mehr verfügbar sind

Lerner können sich nun selbst auf eine Warteliste für einen Kurs setzen lassen, für den keine Plätze mehr verfügbar sind.

Die Lernenden werden per Benachrichtigung informiert, sobald Plätze verfügbar sind, und haben die Möglichkeit, den Kurs in den Warenkorb zu legen und die Zahlung später abzuschließen. Die Lernenden erhalten in der Benachrichtigung einen Link, über den sie direkt zur Beschreibung gelangen. Das Hinzufügen von Kursen zum Warenkorb reserviert den Kurs nicht. Die Zahlung muss noch erfolgreich abgeschlossen werden.

Wenn Plätze verfügbar werden, wird die Option “Hinzufügen zum Warenkorb” erneut angezeigt, und die Lernenden können den Artikel dem Warenkorb hinzufügen. Nach erfolgreicher Zahlungsabwicklung wird der Status des Lernenden entsprechend aktualisiert (von „Wartend“ zu „Gebucht“).

Das neue Verhalten wird nur im Selbstkontext unterstützt. Vorgesetzte können beispielsweise keine anderen Personen auf die Warteliste setzen.

Buchungs-Prüfungen

Sobald der Nutzer beschlossen hat, einen Artikel in seinen Warenkorb hinzuzufügen, führt das LMS eine Reihe von Überprüfungen durch, um sicherzustellen, dass der Nutzer die in den Voraussetzungen oder in der Platzzuweisung festgelegten Bedingungen erfüllt. Wenn eine dieser Bedingungen nicht erfüllt ist, kann der Nutzer den Artikel nicht in den Warenkorb hinzuzufügen.

Nicht erfüllte empfohlene Voraussetzungen werden dem Benutzer angezeigt, wobei er die Möglichkeit hat, mit dem Kauf fortzufahren.

Wenn obligatorische Voraussetzungen nicht erfüllt sind, kann das Hinzufügen des Kurses nicht erfolgen. Der Lerner erhält Informationen zu den fehlenden Voraussetzungen.

In einem solchen Fall wird der Kurs nicht an den Shopify-Warenkorb gesendet und es wird kein Datensatz über den Kaufversuch in Shopify gespeichert.

Anmeldeformular

Wenn ein Buchungsformular für den Kurs oder Lernpfad konfiguriert ist, wird das Formular dem Lerner angezeigt, sobald dieser den Artikel in den Warenkorb hinzufügen möchte.

Die Informationen werden in einer temporären Tabelle gespeichert, bis die Anmeldung bearbeitet ist.

Wenn die Anmeldung nicht innerhalb von 50 Tagen nachdem die Buchungsdaten bereitgestellt wurden abgeschlossen wurde, werden diese Daten aus dem System entfernt, um die Einhaltung der DSGVO zu gewährleisten.

Warenkorb anzeigen

Wenn das Warenkorb-Symbol ausgewählt wird, wird die aktuelle Liste der Artikel angezeigt, die im Warenkorb des Benutzers verfügbar sind.

Die Liste enthält den Kursnamen, ein Bild (entweder das für den Kurs in Shopify definierte Bild, sofern verfügbar, oder das Standardbild des Artikels) und den Preis in der entsprechenden Währung.

Am Ende der Artikelliste wird eine Zwischensumme berechnet, die auf dem Standardpreis jedes Artikels basiert. Weitere Steuern oder Rabatte sind erst im nächsten Schritt verfügbar, sobald der Nutzer zur Kasse gegangen ist. 

Im Fall von mehreren Shopify-Shops werden die Nutzer darüber informiert, dass der Warenkorb mehrere Artikel enthält, die separate Checkouts benötigen. Der Name des Anbieters wird für jeden verbundenen Shop angezeigt. Die Zwischensumme wird ebenfalls für jeden Shop angezeigt.

Wichtige Überlegungen

Die Warenkorb-Liste wird von Shopify verwaltet und basiert auf einem Cookie, das 14 Tage lang gültig ist. Die Gültigkeitsdauer verlängert sich jedes Mal, wenn ein neuer Artikel in den Warenkorb gelegt wird. Aus diesem Grund ist die Liste der Warenkorb-Artikel nicht mehr zugänglich, wenn der Nutzer das LMS in einem neuen Browser öffnet.

Da es möglich ist, dass nach dem Hinzufügen bestimmter Artikel zum Warenkorb und bis zur Kaufabwicklung Änderungen im System auftreten, besteht das Risiko, dass die Registrierung nicht mehr möglich ist. In solchen Fällen wird eine E-Mail an den Administrator gesendet, wie in Abschnitt E-Mail-Adresse für unbearbeitete Bestellungen.

Zur Kasse gehen und zum LMS weiterleiten

Sobald der Nutzer die Schaltfläche „Zur Kasse gehen“ ausgewählt hat, wird er zur Kasse weitergeleitet, wo er seine Zahlungsinformationen eingeben kann.

Der Name des Teilnehmers/der Teilnehmer wird für jeden ausgewählten Artikel angezeigt. Die Sprache des Textes, der vor dem Namen des Teilnehmers angezeigt wird, entspricht der Sprache der LMS-Plattform, die zum Zeitpunkt der Auswahl der Aktion „Hinzufügen zum Warenkorb“ oder „Jetzt kaufen“ verfügbar war.

Shopify ermöglicht auch die Konfiguration dieser Checkout-Seite sowie die Änderung des Erscheinungsbildes. Falls notwendig, muss ein solches Skin-Design vom Kunden direkt auf Shopify vorgenommen werden. Das auf das LMS angewendete imc-Design wird nicht automatisch auf die Shopify-Checkout-Seite übertragen.

Die Felder auf der Checkout-Seite, einschließlich der Rechnungsadresse und der E-Mail-Adresse, werden von Shopify kontrolliert.

Wichtige Überlegungen

Aufgrund der jüngsten Plattformänderungen seitens Shopify sind alle Shops passwortgeschützt. Bei jedem kostenpflichtigen Tarif kann diese Funktion aktiviert oder deaktiviert werden. Die Schritte zum Hinzufügen oder Entfernen des Kennworts finden Sie auf der offiziellen Shopify-Website.

Auftragsbearbeitung

Shopify informiert das LMS über die Bestellung und den Besteller, woraufhin das LMS die notwendigen Buchungen bearbeitet.

Wenn die Bestellung nicht vollständig erfüllt werden kann, wird eine E-Mail an die konfigurierte Verwaltungs-E-Mail-Adresse gesendet, in der über das Problem informiert und zusammengefasst wird, welche Artikel für den Benutzer nicht registriert werden konnten. Der Administrator hat die Möglichkeit, die Bestellungen im Shopify-Verwaltungs-Backend zu überprüfen und eine entsprechende Rückerstattung vorzunehmen.

Bestellungen werden nicht innerhalb des LMS nachverfolgt. Das LMS zeichnet nur registrierte Kurse und Lernpfade auf. Wenn eine Bestellung in Shopify nicht erfüllt wird, sind im LMS keine Nachverfolgungsdaten sichtbar.

Manager-Journey

Vorgesetzte und Personalverantwortliche können Kurse und Lernpfade für ihre Mitarbeiter einzeln oder in größeren Mengen erwerben.

Die Option ist über die folgenden Workflows verfügbar:

• Wählen Sie den gewünschten Kurs im Katalog aus und wählen Sie die Option „Einkauf für Mitarbeiter“.

• Wählen Sie die gewünschten Teilnehmer über „Mitarbeiter“ aus und wählen Sie die Option „Mehrfachanmeldung“.

• Auswahl eines einzelnen Nutzers über „Mitarbeiter“ und Auswahl der Option „Mitarbeiter registrieren“

Kauf für „Mitarbeiter“

Kurse, die als Shopify-relevant gekennzeichnet sind, werden in der Liste der verfügbaren Kurse mit dem Hinweis „Vorauszahlung erforderlich” versehen, sobald der Mehrfachanmeldeprozess aufgerufen wurde.

Nach der Auswahl wird der jeweilige Preis für jeden Mitarbeiter angezeigt, zusammen mit einem Hinweis, ob der Benutzer noch nicht angemeldet ist oder bereits als Teil des Kurses registriert ist. In diesem Fall wird er nicht in den Kaufprozess einbezogen.

Darüber hinaus ist bei Vorliegen von Voraussetzungen nur die Verfügbarkeit derjenigen Nutzer gewährleistet, die die Voraussetzungen erfüllt haben, während der Manager für die anderen Nutzer den individuellen Voraussetzungen über eine spezielle Aktion überprüfen kann.

Wenn andere Anmeldebedingungen gelten, wie z. B. das Ausfüllen eines Anmeldeformulars oder Bedingungen in Bezug auf die Platzzuweisung oder die Mehrfachanmeldung zu Kursen aus derselben Vorlage, ist eine individuelle Überprüfung notwendig. Sobald die notwendigen individuellen Überprüfungen durchgeführt wurden und die Anmeldebedingungen dies zulassen, kann der Vorgesetzte das Hinzufügen des Artikels für den betreffenden Mitarbeiter in den Warenkorb vornehmen.

Sobald die berechtigten Benutzer für die Registrierung ausgewählt wurden, hat der Vorgesetzte die Möglichkeit, nach der Konfiguration ein Fälligkeitsdatum und eine Kennzeichnung (z. B. „Verpflichtend“ oder „Compliance“) anzugeben und entweder die ausgewählten Artikel in den Warenkorb zu legen oder direkt mit den ausgewählten Artikeln zur Kasse zu gehen.

Wenn eine Kombination aus Shopify- und nicht Shopify-relevanten Kursen zur Auswahl steht, löst der Prozess die Buchung für diejenigen Kurse aus, für die eine direkte Buchung möglich ist, und fügt die Shopify-relevanten Kurse in den Warenkorb hinzu.

Beim Hinzufügen von Artikeln in den Warenkorb wird der Name jedes ausgewählten Teilnehmers in Verbindung mit dem Kurs angezeigt, für den er zur Teilnahme nominiert wurde.

Der Vorgesetzte kann Kurse/Lernpfade für mehrere Mitarbeiter erwerben. Alle Artikel werden hinzugefügt und wie unten dargestellt angezeigt. Im Szenario mit mehreren Shopify-Shops ist nur das Hinzufügen zum Warenkorb möglich.

Nach dem Hinzufügen zum Warenkorb sieht der Vorgesetzte alle Mitarbeiter mit allen Artikeln, die nach Veranstalter sortiert angezeigt werden. Die Zwischensumme jedes Artikels wird angezeigt.

Kauf über den Katalog

Nach Auswahl des gewünschten Kurses über den Katalog hat der Vorgesetzte die Möglichkeit, die Nutzer auszuwählen, die noch keinen Status für den Kurs haben, und mit dem Kaufvorgang fortzufahren.

Wenn Anmeldebedingungen gelten, darf der Vorgesetze jeweils nur einen Teilnehmer auswählen und diesen einzeln in den Warenkorb legen. Dabei kann er die Voraussetzungen überprüfen, ein Anmeldeformular ausfüllen (sofern konfiguriert) oder Überprüfungen wie die Platzzuweisung oder Mehrfachbuchungen für Kurse derselben Vorlage durchführen. 

Hinweise: Es ist auch möglich, mehrere Artikel, die zu verschiedenen Shopify-Shops gehören, direkt aus dem Katalog zu kaufen.

Shopify-Konfiguration

Lizenz für den Shopify-Konnektor

Der Shopify-Konnektor ist im LMS lizenziert. Alle für Shopify spezifischen Konfigurationen und Funktionen sind erst verfügbar, wenn die Lizenz aktiv ist. Darüber hinaus sind einige Konfigurationen durch imc Consulting notwendig, um die Einrichtung abzuschließen. Hinweis: Falls Shopify auf Ihrem System nicht aktiviert ist und Sie eine Lizenz für den Shopify-Konnektor benötigen, wenden Sie sich bitte an Ihren imc-Kundenberater.

Einrichten der benutzerdefinierten Shopify-App

Damit das LMS mit Shopify in Kommunikation treten kann, muss eine benutzerdefinierte Shopify-App erstellt werden.

Melden Sie sich dazu im Admin-Backend von Shopify an → navigieren Sie zu Apps → Apps für Ihren Shop entwickeln und wählen Sie dann die Option App erstellen. 

Nachdem Sie den Namen der App angegeben haben (dies kann ein beliebiger Name sein), werden Sie aufgefordert, die Admin-API-Bereiche und die Storefront-API-Bereiche zu konfigurieren.

Admin-API-Berechtigungen:

• Inventar – Schreib- und LESEN-Rechte

• Produkte – Schreib- und LESEN-Rechte

• Produktlisten – Schreib- und Lesen-Berechtigungen

• Veröffentlichungen – Schreib- und LESEN-Rechte

• Standorte – Schreib- und LESEN-Rechte

Setzen Sie das Webhook-Abonnement auf 2025-04 (die aktuellste verfügbare).

Storefront-API-Berechtigungen:

• Checkout – Berechtigungen für nicht authentifizierte Schreib- und Lese-Checkouts

• Produkte – nicht authentifiziertes Lesen von Produktvarianten, nicht authentifiziertes Lesen des Produktbestands, nicht authentifiziertes Lesen von Produkt-Tags

Nachdem alle Berechtigungen festgelegt wurden, installieren Sie die App. 

Sobald die benutzerdefinierte App erstellt wurde, werden die folgenden Informationen generiert:

• API-Schlüssel

• Admin-API-Zugriffstoken

• Zugriffstoken für Storefront

Bitte speichern Sie diese Informationen, da sie im weiteren Verlauf der Konfiguration des LMS notwendig sind.

Erstellen eines Shopify-Webhooks

Ein Webhook ist notwendig, damit Shopify das LMS über die Zahlung der Bestellung informieren kann. Diese Information benötigt das LMS, um die Buchung des Nutzers nach dem Kauf zu bearbeiten.

Um einen Webhook einzurichten, müssen Sie in Shopify zum folgenden Abschnitt navigieren:

http://yourshop.myshopify.com/admin/settings/notifications

Erstellen Sie einen Webhook für die Zahlungsabwicklung gemäß dem folgenden Beispiel:

<Ihre LMS-URL>/ils/restapi/shopify/webhook/order

Nachdem der Webhook erstellt wurde, wird ein Webhook-Schlüssel bereitgestellt. Dieser Wert muss im Feld „API-Geheimnis“ der LMS-Konfiguration hinzugefügt werden.

Eine Weiterleitungs-URL einrichten

Sobald eine Transaktion in Shopify erfolgreich abgeschlossen ist, d. h. eine erfolgreiche Kaufabwicklung erfolgt ist, muss der Nutzer zurück zum LMS weitergeleitet werden. Shopify ermöglicht die Konfiguration einer Weiterleitungs-URL, zu der der Nutzer nach Abschluss des Kaufvorgangs weitergeleitet werden kann. Diese Kaufabwicklungs-URL müssen vom Kunden über die Shopify-Admin-Oberfläche konfiguriert werden:

Im Shopify-Adminbereich -> Einstellungen -> Kasse -> Bestellabwicklung -> Zusätzliche Skripte.

In diesem Feld können Sie die gewünschte Rückgabe-URL angeben.

imc bietet zwei Möglichkeiten: 

Option 1: Standard-URL zurück zum Lernbereich oder zu beliebigen vorhandenen Portalseiten im LMS

z. B. <SCRIPT> window.location ="<IHRE LMS-URL>/pages/personalarea.jsf"; </SCRIPT>

imc empfiehlt eine Weiterleitung zu einem Portal, damit das System die erforderliche Zeit für die Bearbeitung der Anmeldung hat.

 Option 2: Benutzerdefiniertes Funktionsfenster

Durch die Verwendung eines Feature-Plugin-Panels ist es auch möglich, die Bestellnummer auf einem LMS-Portal anzuzeigen. In diesem Fall könnte die Rückgabe-URL wie folgt lauten:

<SCRIPT>window.location=”<IHRE LMS-URL>pages/new-internal-dashboard.jsf?menuId=<MENUID>&locale=en-GB&showbundlekeys=false#/?dashboardId=<DASHBOARDID>&order_id={{order_number}}"; </script>

Hinweis: Das benutzerdefinierte Funktionsfeld ist nicht im Standardprodukt enthalten und muss separat eingerichtet werden. Bitte wenden Sie sich an Ihren Kundenberater, um einen Kostenvoranschlag zu erhalten.

Wichtige Überlegungen

Aufgrund der jüngsten Änderungen an der Shopify-Plattform “Weiterleitungen nach erfolgreichen Zahlungen” - die zuvor über benutzerdefinierte Skripte im Storefront abgewickelt wurden - wird diese nicht mehr unterstützt für Geschäfte, die nach dem 1. Januar 2025 gegründet wurden. Diese Änderung ist bereits in Kraft getreten und kann sich auf Händler auswirken, die auf skriptbasierte Weiterleitungen angewiesen sind. Die offiziellen Details finden Sie auf der offiziellen Website von Shopify.

Shopify-Sprache und -Währung festlegen

Ein Shopify-Shop erfordert eine Shop-Währung, die in den allgemeinen Einstellungen konfiguriert werden kann: https://yourshop.myshopify.com/admin/settings/Einstellungen/general

Die Shopify-Sprache muss im Abschnitt „Sprachen“ eingestellt werden: https://yourshop.myshopify.com/admin/einstellungen/languages

LMS-System-Konfiguration

Notwendige Konfiguration für die Verbindung des LMS mit Shopify

Der LMS-Administrator hat die Möglichkeit, systemweit einen Shopify-Shop zu konfigurieren, mit dem sich das LMS verbindet, um Produkte zu erstellen, zu aktualisieren und Buchungen zu bearbeiten.

Die während der Einrichtung der privaten Shopify-App erhaltenen Informationen sind hier notwendig, um die beiden Dienste miteinander zu verbinden.

Basis-URL – Dies ist die URL Ihres Shopify-Shops -> https://yourshop.myshopify.com/

API-Version – Die vom LMS verwendete Shopify-API-Version wurde angegeben. imc hat den Konnektor mit der Version 2022-01 getestet. Bitte verwenden Sie dieselbe Version, sofern von imc nicht anders angegeben.

Die Werte für API-Schlüssel, Admin-API-Zugriffstoken, Storefront-API-Zugriffstoken und Webhook-Schlüssel, die Sie von Shopify erhalten haben, sollten in die entsprechenden Felder im LMS eingegeben werden.

Für die API-Pfade verwenden Sie bitte explizit die folgenden Werte:

API-Pfad für GET-Anfragen

/admin/api/{api-version}/products/{productId}.json

API-Pfad zum Erstellen des Shopify-Katalogs

/admin/api/{api-version}/products.json

API-Pfad zum Aktualisieren des Shopify-Katalogs

/admin/api/{api-version}/products/{productId}.json

Zusätzliche Konfigurationsmöglichkeiten

Konfiguration für zusätzliche Metainformationen

Im Rahmen der Shopify-Konfiguration steht ein spezieller Eintrag zur Verfügung, über den zusätzliche Informationen zum Shopify-Produkt hinzugefügt werden können, die über die standardmäßig bereitgestellten Informationen hinausgehen, wie in Kapitel Shopify-Sprache und -Währung festlegen.

Ein wichtiger Aspekt, der zu beachten ist, ist, dass das Hinzufügen zusätzlicher Informationen die Zeit erhöht, die der geplante Job benötigt, um den Katalog zu füllen.

E-Mail-Adresse für nicht bearbeitete Bestellungen

Wenn das LMS eine bezahlte Bestellung nicht bearbeiten kann, besteht die Möglichkeit, eine Notfall-E-Mail-Adresse zu konfigurieren, an die eine E-Mail gesendet wird, die Informationen darüber enthält, welche Artikel aus der betreffenden Bestellung nicht bearbeitet werden konnten.

In diesem Fall kann der Administrator entweder eine Rückerstattung über Shopify vornehmen oder den Nutzer kontaktieren.

Dieses Feld befindet sich in der LMS-System-Konfiguration.

Spezifischer Metatag, der als SKU für die Shopify-Produktvarianten verwendet werden soll

Shopify-Produktvarianten enthalten ein SKU-Feld, das für die Berichterstellung auf der Shopify-Seite verwendet werden kann. Mit Version 14.10 des LMS ist es möglich, einen Metatag zu definieren, der als Quelle für den SKU-Wert verwendet wird. Hier werden Text-Metatags unterstützt.

Name des Verkäufers

Durch die Angabe eines Verkäufernamens im dafür vorgesehenen Feld wird das Shopify-Verkäuferfeld ausgefüllt, wenn der Produktkatalog vom LMS generiert wird. Der Verkäufername wird als zusätzliche Webhook-Sicherheitsmaßnahme verwendet, um sicherzustellen, dass nur Anfragen, die diesen Wert enthalten, vom LMS als gültige Anmeldeanfragen verarbeitet werden.

Automatische Veröffentlichung von Kursen in der benutzerdefinierten App

Bei der Erstellung des Produktkatalogs und der entsprechenden Kurse und Lernpfade über das LMS in Shopify können diese Elemente durch Aktivieren dieser Einstellung automatisch zum Kauf angeboten werden. Ist diese Einstellung deaktiviert, erfolgt die Veröffentlichung nicht automatisch und muss manuell über Shopify verwaltet werden.

Kasse für kostenlose Kurse notwendig

Aktivieren Sie diese Funktion, wenn erforderlich, damit Nutzer auch bei Einkäufen, bei denen einige oder alle Artikel kostenlos sind, zur Kasse gehen können, wenn ein solcher Vorgang für die Rechnungsstellung notwendig ist.

Verhaltenskontrolle für Kurse innerhalb von Lernpfaden

Wenn Lernpfade als Kurspakete zu einem reduzierten Preis angeboten werden, kann es wünschenswert sein, dass nach dem Kauf des Lernpfads die darin enthaltenen Kurse ohne zusätzliche Kosten gebucht werden können. Es gibt eine Konfiguration, um festzulegen, ob die Kursbuchung aus einem gebuchten Lernpfad zulässig sein soll, ohne dass der Benutzer aufgefordert wird, den Kurs zusätzlich zu kaufen.

Möglichkeit, mehrere Shopify-Shops zu konfigurieren

Es ist möglich, neben dem standardmäßig konfigurierten Shop, der den Kauf von Kursen/Lernpfaden von mehreren Veranstaltern ermöglicht, die mit anderen Shopify-Shops verbunden sind, auch mehrere Shops zu definieren. Die Unterscheidung zwischen den verschiedenen Shops und den Kursen/Lernpfaden, die zu den verschiedenen Shops gehören, erfolgt auf der Grundlage vom Veranstalter.

Im Veranstalter-Manager steht nun ein zusätzliches Feld zur Verfügung, das Shopify-Shop der den auf der Seite Standardeinstellungen Registerkarte. Sie kann ganz einfach geändert werden, indem Sie einen anderen Shop aus der Liste auswählen. Der neue Shop muss zuvor angelegt werden. 

Wichtig, wenn auf Kurs-/Lernpfad-Level das Feld „Veranstalter“ leer bleibt und das Element als Shopify-relevant markiert ist, wird es mit dem Standard-Shopify-Shop verbunden. Wenn der Nutzer ein Element mit einem anderen Shop verbinden möchte, muss der Veranstalter aus dem Feld ausgewählt werden.

Hinweise: Wenn Shopify auf dem System aktiviert ist (lizenziert), wird das Feld angezeigt. Andernfalls bleibt es ausgeblendet.

Auf der angezeigten zusätzlichen Registerkarte mit dem Namen Weitere Shopify-Shops, Der Administrator kann beliebig viele Shops konfigurieren.

Erstellen, Bearbeiten und Löschen sind die Aktionen, die zur Konfiguration zusätzlicher Shops durchgeführt werden können.

Erstellen – Es ist möglich, zusätzliche Shops zu erstellen, indem Sie eine Seite mit mehreren Feldern öffnen, die nur Shopify-bezogene Konfigurationen enthalten, um eine Verbindung mit Shopify herzustellen. Pflichtfelder sind mit einem * gekennzeichnet. Beim Speichern des Formulars wird eine Benachrichtigung angezeigt, wenn notwendige Angaben nicht gemacht wurden. Sobald das Formular gespeichert ist, wird der Name des Shops in der Liste angezeigt.

Löschen – Diese Aktion ermöglicht das Löschen eines Shops nur, wenn der Kurs noch nicht einem Anbieter zugewiesen wurde. Besteht eine Verbindung zwischen dem Shop und dem Anbieter, wird der Nutzer darüber durch eine Benachrichtigung informiert. Es kann jeweils nur ein Shop gelöscht werden. Eine Mehrfachauswahl ist für die Löschfunktion nicht möglich. Das Löschen des Anbieters vor der Entkopplung vom Shopify-Shop führt dazu, dass der Shop nicht mehr gelöscht werden kann. Es wird daher empfohlen, dies zu vermeiden. 

Den Shopify-Produkt-Katalog füllen

Meta-Tag und Konfiguration geplanter Aufgaben

Um Kurse oder Lernpfade über Shopify erwerben zu können, sind folgende Konfigurationen notwendig:

• Jeder Kurs und jeder Lernpfad, der mit Shopify funktionieren soll, muss mit einem Meta-Tag gekennzeichnet sein und den Planungsstatus haben. FreigegebenDer Meta-Tag heißt „An Shopify senden (11820)

  • Hinweis: Dieser Meta-Tag muss manuell zu Kurstypen, Kursvorlagen, Kursen und Lernpfaden hinzugefügt werden. Es wäre zusätzlicher Aufwand notwendig, um den Meta-Tag mithilfe von Skripten zu bestehenden Objekten hinzuzufügen.

• Basierend auf diesem Meta-Tag aktualisiert ein geplantes Job den Shopify-Produkt-Katalog regelmäßig.

  • Shopify-Katalogartikel erstellen oder aktualisieren

  • Prozessorname: de.imc.clix.webservices.client.shopify.job.CreateOrUpdateShopifyCatalogItemsJob

  • Dies muss von imc consulting konfiguriert werden. Es wird empfohlen, den Cron-Scheduler so einzustellen, dass er entsprechend der Solr-Indizierung für den Katalog ausgeführt wird.

• Sobald die Kurse und Lernpfade als Produkte zu Shopify hinzugefügt wurden, müssen die Produkte für die private App verfügbar gemacht werden, damit sie im Rahmen des Bestellvorgangs in den Warenkorb gelegt werden können (dies ist nur notwendig, wenn keine automatische Veröffentlichung gewünscht wird, siehe oben). Navigieren Sie für diesen Schritt zum Shopify-Adminbereich, gehen Sie zu „Alle Produkte“ → Alle auswählen → Weitere Aktionen → Hinzufügen von verfügbaren Kanälen → Markieren Sie die private App und klicken Sie auf „Produkte verfügbar machen“.

• Damit das System Webhooks verarbeiten kann, muss ein zusätzlicher Cron-Job konfiguriert werden, wobei empfohlen wird, diesen in kurzen Intervallen auszuführen. Dieser Cron-Job ist dafür zuständig, die empfangenen Webhooks zu identifizieren, die noch nicht verarbeitet wurden, und diese zu verarbeiten, damit die entsprechenden Buchungen durchgeführt werden können.

  • Der Name des Jobs lautet ShopifyProcessWebhookJob. 

Da ein Shopify-Shop eine Standardwährung und eine Standardsprache hat, unterstützt das LMS als Teil des Konnektors nur eine Sprache und eine Währung. Diese Einschränkung gilt sowohl für die Erstellung des Katalogs als auch für den Checkout-Prozess.

Die Standardsprache und die Standardwährung des Artikels werden verwendet.

Die Ersatzsprache ist die Sprache, die auf der Registerkarte „Sprache“ des Kurses als „Basissprache“ gekennzeichnet ist. Die Standardwährung ist die Währung, die im externen Preis-Meta-Tag (Id 10128) angegeben ist.

Besondere Aufmerksamkeit muss der Einrichtung der richtigen Standardwährung eines Artikels gewidmet werden. Die Standardwährung des Artikels muss mit der Standardwährung des Shopify-Shops übereinstimmen, um Unstimmigkeiten beim Bezahlvorgang zu vermeiden.

Aktualisierung des Katalogs

Um die verfügbare Menge in Shopify mit der Anzahl der freien Plätze in ILS für einen Kurs oder Lernpfad synchron zu halten, sendet ILS aktualisierte Informationen, falls der Zielstatus eines Teilnehmers auf „abgesagt” oder „eingeschrieben” geändert wird. Das bedeutet, dass Teilnehmer nicht vollständig aus Kursen entfernt oder verschoben werden sollten, ohne zuvor abgemeldet worden zu sein, bzw. dass Teilnehmer nicht mit einem anderen Status als „eingeschrieben” zum Kurs hinzugefügt werden sollten, um Diskrepanzen zu vermeiden.

Falls solche Status-Änderungen erforderlich sind, stellen Sie bitte sicher, dass der Cronjob so konfiguriert ist, dass er häufig ausgeführt wird, um die Konsistenz der freien Plätze zu gewährleisten.

Wenn eine Zahlung bearbeitet und das LMS über den Webhook benachrichtigt wird, werden die freien Plätze entsprechend angepasst. 

Da die Erstellung und Aktualisierung von Produkten in Shopify automatisch vom LMS übernommen wird, raten wir davon ab, manuelle Änderungen direkt in Shopify vorzunehmen, da dies dazu führen kann, dass Produkte nicht mehr aktualisiert werden können.

Standard-Metainformationen, die an Shopify gesendet werden

Standardmäßig füllt das LMS die folgenden Metatags aus Kursen und Lernpfaden in ein Shopify-Produkt ein:

• Name (ID: 10000)

• Vorschaubild (ID 10950)

• Preis

Für jeden gruppenspezifischen Preis wird eine separate Produktvariante erstellt.

Wichtig: Um die Verfügbarkeit des Bildes für Shopify zu gewährleisten, muss der Bilddatenordner öffentlich zugänglich sein. Dies sollte entweder von imc erfolgen, wenn das System von imc gehostet wird, oder vom Kunden, wenn das System vor Ort gehostet wird.

Konfiguration für zusätzliche Metainformationen

Im Rahmen der Shopify-Konfiguration steht ein spezieller Eintrag zur Verfügung, über den das Hinzufügen zusätzlicher Informationen ermöglicht wird, die zum Shopify-Produkt hinzugefügt werden sollen.

Diese Informationen basieren auf Metatags und werden zugeordnet zu Tags in Shopify.

Das LMS schränkt zwar die Verwendung von Meta-Tag-Typen nicht ein, unterstützt jedoch nur Textfelder und Auswahllisten. Die Verwendung anderer Meta-Tag-Typen kann aus Formatierungsgründen zu einer anderen Ausgabe als erwartet führen.

Ein wichtiger Aspekt, der zu beachten ist, ist, dass das Hinzufügen zusätzlicher Informationen die Zeit erhöht, die der geplante Job benötigt, um den Katalog zu füllen.

Gruppen-Spezifische Preise

Innerhalb des LMS ist es möglich, für Kurse und Lernpfade unterschiedliche Preise für verschiedene Nutzergruppen festzulegen.

Es muss ein Standardpreis auf Basis des Meta-Tags „Externer Preis“ definiert werden. Zusätzliche Vorzugspreise können definiert werden, indem die entsprechenden Benutzergruppen hinzugefügt und der geltende Preis festgelegt werden.

Bei der Erstellung von Shopify-Produkten auf Basis solcher Kurse wird für jede verfügbare Gruppe eine separate Variante erstellt.

Wichtig Bitte legen Sie Preise nur in der Währung des Shopify-Shops fest. Die Festlegung von Preisen in mehreren Währungen führt dazu, dass Produkte in Shopify nicht bearbeitet werden können.

Warenkorb-Navigation Artikel

Im Rahmen der Konfiguration im LMS muss den Lernern ein neues Navigationselement zur Verfügung gestellt werden, damit sie die Warenkorb-Liste überwachen und zur Kasse gehen können.

Hinweis: Bitte konfigurieren Sie die Navigation in der Hauptnavigation für alle Kategorien.

Der Eintrag in der Navigation ist ein spezieller Funktionstyp im Menü.

Shopify-Verwaltungsansicht

Auf der Shopify-Seite bietet das Shopify-Verwaltungs-Backend neben der Erstellung und Verwaltung von Rabattcodes ein Analyse-Dashboard, mit dem sich Verkaufstrends überwachen, die meistverkauften Kurse identifizieren und Schulungsanbieter Möglichkeiten zur Umsatzsteigerung ermitteln können. 

Einschränkungen

• Der LMS Shopify-Konnektor wird nur in einer einzigen Sprache und einer einzigen Währung unterstützt. Kunden sollten sicherstellen, dass alle mit Shopify verwendeten Kurse und Lernpfade dieselbe Ersatzsprache und dieselbe Standardwährung wie der Shopify-Shop haben.

• Die Buchung von Teilnehmern über die einfache Kurserstellung ist für Shopify-relevante Kurse/Lernpfade nicht möglich.

• Im Zusammenhang mit der Buchung auf der Warteliste wird das Meta-Tag Automatisches Nachrücken wird nicht unterstützt, da es sich um einen automatischen Prozess handelt, der mit dem manuellen Zahlungsprozess nicht kompatibel ist. Im gleichen Zusammenhang werden, wie in der aktuellen Norm festgelegt, einige der Anmeldeprüfungen bei der Buchung auf der Warteliste durchgeführt (obligatorische Voraussetzung nicht erfüllt), andere jedoch erst beim Hinzufügen zum Warenkorb (Platzzuweisung, Anmeldeformulare). Benachrichtigungen werden nur gesendet, wenn der Benutzer den Status „Wartend” hat, um ihn über die neuen verfügbaren Plätze zu informieren.

• Die in diesem Dokument beschriebenen Verbesserungen gelten nur für die Webanwendung und nicht für die nativen mobilen Apps.

• Bei der Shopify-Implementierung gibt es keine Begrenzung der Benutzeranzahl; die Zuweisung von Benutzerplätzen wird jedoch unterstützt und angewendet.