🎰 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

Benötigte Codes auf Deiner Site anlegen
Platzhalter mit den echten Werten austauschen
„transferArticle“ einmalig ausführen
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 im Shop auslesen. Dazu musst Du in der Developer-Gruppe auf Deiner Site sein. Dann findest Du im Shop unter Einstellungen -> Entwickleroptionen die ShopID/BranchID.