Wie binde ich meinen Shop an?

Damit der K3 sich mit Ihrem Shop verbinden kann, müssen Sie in Ihrem Shop ein Plugin installieren. Für diese Shops bieten wir fertige Plugins an:

• Shopware Version 6
• Woocommerce
• Oxid eSales
• Magento 2
• Prestashop
• Shopify

tip

Im Laufe der Zeit werden weitere Shopsysteme hinzukommen.

Ausserdem bietet der K3 offene Schnittstellen, Sie können daher auch eine individuelle Anbindung programmieren (lassen).

Wenn Sie das Plugin mit dem K3 verbinden, werden beiderseits Sicherheitstoken hinterlegt, sodass die Kommunikation geschützt abläuft. Der K3 kann anschliessen Artikel aus Ihrem Shop lesen, eine fertige Konfiguration in den Warenkorb legen und bei einem Kauf die Konfiguration gegen weitere Änderung sperren.

Shop und K3 verbinden

Sie verwenden Shopify? - Schauen Sie weiter unten.

• Öffnen Sie den Editor Ihres Konfigurators.
• Klicken Sie in der Seitenleiste auf
  Loading...
  .
• Wechseln Sie zu dem Tab Shop.
• Klicken Sie bei dem Shopsystem Ihrer Wahl auf
  Loading...
  oder bei Shopify direkt auf "Ist installiert".
• Installieren Sie das heruntergeladene Plugin in Ihrem Shop.
• Schauen Sie sich die Optionen des Plugin an und stellen Sie sie so ein, wie es passt.
• Klicken Sie bei dem Shopsystem Ihrer Wahl auf
  Loading...
  .
• Geben Sie nun die Web-Adresse des Shops ein (bei individueller Anbindung die Adresse des Plugins).
• Bei Shopify geben Sie hier noch das generierte Token ein.
• Schalten Sie im Normalfall Sollen die Artikel aus dem Shop importiert werden? ein.
• Einige Shops bieten die Option Artikel bei einer Bestellung zu einem Einzigen zusammenzufassen
• Klicken Sie auf
  Loading...
  .
• Der Import kann einen Moment dauern. Anschliessend erhalten Sie eine Erfolgmeldung.

Shopify

In Shopify:

info

Eine neue Shopify App ist in Vorbereitung. Damit wird sich das Verfahren vereinfachen.

• Navigieren Sie zu der Administrationsoberfläche Ihres Shops
• Klicken Sie auf "Apps" und dann auf "App- und Vertriebskanaleinstellungen"
• Klicken Sie auf "Apps erstellen" und dann auf "Eine App erstellen"
• Geben Sie der App einen Namen und klicken Sie auf "App erstellen"
• Klicken Sie auf "Admin-API-Bereiche konfigurieren"
• Erteilen Sie der App Berechtigungen für "read_orders", "write_products" (wenn Sie die Artikel bei der Bestellung zu einem kombinieren möchten) und "read_products"
• Wählen Sie bei Webhook-Abonnements die Event Version 2022-10 aus.
• Klicken Sie auf "Speichern"
• Wechseln Sie auf den Reiter API-Anmeldedaten
• Klicken Sie bei "Zugriffstoken" auf "App-Installieren" und "Installieren"
• Lassen Sie sich das Token anzeigen. Sie brauchen es für die Einrichtung des Shops im K3.

Im K3:

• Öffnen Sie den Editor Ihres Konfigurators.
• Klicken Sie in der Seitenleiste auf
  Loading...
  .
• Wechseln Sie zu dem Tab Shop.
• Klicken Sie bei bei Shopify direkt auf "Ist installiert".
• Geben Sie nun die Web-Adresse des Shops ein. Das ist nicht die Primäradresse, sondern sie muss myshopify.com enthalten.
• Geben Sie nun noch das generierte Token ein.
• Schalten Sie im Normalfall Sollen die Artikel aus dem Shop importiert werden? ein. Sie können nach diesen Shopify-Attributen Produkte suchen: collection_id, created_at_max, created_at_min, fields, handle, ids, limit, presentment_currencies, product_type, published_at_max, published_at_min, published_status, since_id, status, title, updated_at_max, updated_at_min, vendor
• Sie haben die Möglichkeit, jede Konfiguration in Shopify als neuen Artikel anzulegen. Wenn Sie das möchten, wählen Sie Sollen die Artikel bei der Bestellung zusammengefasst werden? an und vergeben Sie einen Namen für den Artikel. Wenn Sie das Feld leer lassen, wird dieser Name verwendet: "Ihre Bestellung {code}" In diesem Namen können diese beiden variablen Teile verwendet werden:
  • {code}: Der eindeutige Code der Konfiguration.
  • {link}: Ein Link zurück zur Konfiguration.
• Klicken Sie auf
  Loading...
  .
• Der Import kann einen Moment dauern. Anschliessend erhalten Sie eine Erfolgmeldung.

Warenkorb-Knopf anlegen.

Der Shop ist nun mit dem K3 verbunden. Als nächstes müssen Sie dafür sorgen, dass die richtigen Artikel im Warenkorb landen. Dazu führt der K3 eine Stückliste. Lesen Sie hier, wie Sie das steuern. Wenn Sie die Artikel-Regeln fertig eingerichtet haben, machen Sie hier weiter:

• Öffnen Sie den Editor Ihres Konfigurators.
• Klicken Sie in der Seitenleiste auf
  Loading...
  .
• Klicken Sie auf das Stift-Symbol an dem Block, der Preis und Bestellen-Knöpfe enthält
• Hier können Sie Bestellen-Knöpfe anlegen und pflegen. Nutzen Sie entweder den vorhandenen oder klicken Sie auf
  Loading...
  , um einen neuen anzulegen.
• Setzen Sie den Haken bei An Shop senden
• Nehmen Sie üblicherweise alle anderen Haken heraus.
• Klicken Sie auf
  Loading...
• Probieren Sie eine Bestellung: Nach Klick auf den Bestellen-Knopf öffnet sich eine Zusammenfassung. Im nächsten Schritt geht Ihr Shop in einem neuen Fenster auf und die gewünschten Artikel liegen im Warenkorb.

Wenn der Nutzer auf diesen neuen Warenkorb-Knopf klickt, wird die Konfiguration in den Warenkorb des Shops gelegt und der Warenkorb in einem neuen Tab angezeigt.

tip

Das Öffnen eines neuen Tabs wird u.U. vom Browser des Benutzers blockiert. Daher zeigen wir zusätzlich in der Bestätigung einen Link zum Warenkorb an.

Programmatische Warenkorb-Anbindung bei Iframe

Wenn der Konfigurator bereits in einem IFrame in den Shop eingebettet ist, ist das Öffnen des Warenkorbs in einem neuen Tab ggf. nicht gewünscht.

In diesem Fall kann dem Shop die Konfiguration unsichtbar für den Benutzer übergeben werden.

Dazu ist auf Shop-Seite Programmierung nötig. Der Vorgang ist hier beschrieben.