🎰 Verkaufsautomaten von Stüwer anbinden

Diese Anleitung zeigt Dir, wie Du einen Verkaufsautomaten von Stüwer anbindest.

🧩 Was machen die Codes?

Die bereitgestellten chayns.codes erledigen automatisch folgende Schritte:

  • Fügt alle Artikel vom Automaten zum Shop hinzu

  • Hält die Bestände im Shop mit denen im Automaten synchron

  • Bearbeitung der Bestellungen und Ausgabe der Artikel

  • Optional: Ausgabe der Artikel von eingelösten Coupons

⚙️ Voraussetzungen

Bevor Du die Codes nutzen kannst, benötigst Du:

  • einen aktiven chayns-Shop

  • einen eingerichteten Verkaufsautomaten von Stüwer

  • Zugriff auf chayns.codes für Deine Site

Zusätzlich benötigst Du mehrere Werte, die Du von Stüwer erfragen solltest:

  • USERNAME

  • PASSWORD

  • CLIENT_ID

  • MACHINE_NUMBER

  • ID_MASTER

  • ID_DEVICE

Außerdem benötigst Du noch eine weitere ID, die im Code und in den Triggern vorkommen:

  • SHOP_ID (auch BRANCH_ID genannt)

Diese ID musst Du selbst aus dem Netzwerktapp herauslesen. Eine Anleitung dazu findest Du weiter unten.

🧠 Wo trage ich die Werte und IDs ein?

In jedem Code findest Du am Anfang eine Reihe von Konstanten:

Hier musst Du einfach die entsprechenden Werte ersetzen. Die Anzahl der Variablen und die benötigten Werte kann sich hier von Code zu Code unterscheiden, da nicht alle Werte für jeden Code benötigt werden.

⏱️ Ausführung der Jobs

Die Codes werden zu unterschiedlichen Zeiten und zu unterschiedlichen Anlässen ausgeführt. Beim Anlegen der chayns.codes-Backends können als Trigger neben „Zeit“ auch noch „MQTT“ ausgewählt werden. Hier eine Übersicht, welcher Code welchen Trigger benötigt:

Code

Trigger-Art

Wert

transferArticle

HTTP

Standard. Kein Zusatz nötig

patchArticle

Zeit

2 Minuten (kann angepasst werden)

automation

MQTT

eShop/branches/##BRANCH_ID##/orders

processOrder

Zeit

jede Minute

updateArticleStock

MQTT

eShop/branches/+/articles/+/stock

redeemArticle

MQTT

coupon-pickup/boards/+/orders/+/completions

Bei automation muss ##BRANCH_ID## durch die ID deines Shops ausgetauscht werden. Fertig ausgetauscht sollte es dann bspw. so aussehen: „eShop/branches/00000/orders“

⚙️ Benötigte Codes

Grundsätzlich werden alle hier genannten Codes benötigt. Soll jedoch keine Coupon-Ausgabe genutzt werden, wird der Code „redeemArticle“ nicht benötigt.

🔃 Die richtige Reihenfolge

  1. Benötigte Codes auf Deiner Site anlegen

  2. Platzhalter mit den echten Werten austauschen

  3. „transferArticle“ einmalig ausführen

  4. Zeit- und MQTT-Trigger einrichten

💻 Die Codes

Zum Kopieren 😄

transferArticle

patchArticle

automation

processOrder

updateArticleStock

redeemArticle

🎟️ Coupon-Ausgabe aktivieren

Wenn Du das Reservieren von Artikeln zur späteren Abholung mittels Coupons aktivieren möchtest, musst Du Deinem Shop einen neuen Bestellabschluss hinzufügen.

Dazu führst Du folgende Schritte aus:

  • Gehe auf Deine Shop-Page

  • Aktiviere den Admin-Modus

  • Füge unter „Einstellungen“ -> „Bestellabschluss“ einen neuen Bestellabschluss vom Typ „Abholung“ hinzu

  • Öffne den neu erstellen Bestellabschluss und aktiviere unter „Ausgabe“ „Coupon“

Wird jetzt dieser Bestellabschluss bei der Bezahlung ausgewählt, erhält der Kunde einen Coupon in seinen chayns.cards und die Artikel sind für die spätere Ausgabe reserviert.

Wo finde ich die ShopID?

Die ShopID kannst Du ganz einfach aus dem Netzwerktapp Deines Browsers auslesen. Dazu musst Du auf der Shop-Page die Netzwerkkonsole öffnen. Dies kannst Du durch Drücken von F12 erreichen. Dann lädst Du die Seite einmal neu und suchst im Netzwerktapp nach „branches“ suchst. Dort gibt es mehrere Einträge, die in etwa so aussehen: „https://shopsystem.tobit.com/server/v1.0/branches/:branchId“

Anstelle des :branchId befindet sich dort eine Zahl. Diese Zahl ist die BranchID - oder ShopID - Deines Shops.