Artikel, Event-Tickets, Warenkorb und Checkout in Apps verkaufen.
Wenn Artikel oder Event-Tickets in der App verkauft werden sollen, wird zuerst der fachliche Shop in simplebis eingerichtet. Dort werden Artikel, Preise, Verfügbarkeiten, Steuern, Zahlungsarten, Versand-/Abholoptionen und weitere Shop-Regeln gepflegt.
Die App verwendet diese Shop-Konfiguration anschließend für Darstellung, Warenkorb und Checkout. Die App macht einen Shop zugänglich, ersetzt aber nicht die fachliche Shop-Konfiguration.
Ein Shop wird unter Apps > App bearbeiten > Shops für die App freigeschaltet. Dort wird pro Eintrag ein simplebis-Shop ausgewählt. Zusätzlich können ein Shop-Titel in der App, Kundengruppen-Beschränkungen, Sichtbarkeit auf der Shop-Startseite, Lieferoptionen, Floating-Cart-Button und eine eigene Artikel-Detailseite konfiguriert werden.
Nur für bestimmte Kundengruppen aufrufbar begrenzt den Zugriff auf ausgewählte Kundengruppen. In Shop-Startseite nicht anzeigen blendet den Shop in der Shop-Übersicht aus, lässt ihn aber für direkte Verlinkungen nutzbar, sofern sonstige Bedingungen passen. Lieferoptionen in diesem Shop deaktivieren überspringt Lieferoptionen in der App. Floating Cart-Button steuert die Darstellung des schwebenden Warenkorbbuttons.
Für normale Artikel nutzt die App typische Shop-Routen:
/instance/shop/{shopId}
/instance/shop/{shopId}/list/{categoryId}
/instance/shop/{shopId}/article/{articleId}
/instance/checkout/{shopId}
Für eigene Artikel-Detailseiten wird ein Builder-Screen erstellt und beim App-Shop als Artikel-Detailseite hinterlegt. Der Screen sollte einen Artikel-Context verwenden, damit der Artikel vor dem Rendern geladen wird.
Das Builder-Element article_cart_action zeigt abhängig von Verfügbarkeit und Warenkorbzustand die passende Aktion. Ist der Artikel verfügbar, kann er in den Warenkorb gelegt werden. Ist er bereits im Warenkorb, wird die Menge angezeigt. Ist er nicht verfügbar, wird ein deaktivierter Zustand angezeigt oder der Button ausgeblendet.
Event-Tickets werden ebenfalls über Shop und Checkout verkauft. Für den Ticketverkauf muss das Event fachlich so konfiguriert sein, dass Tickets verkauft werden können, und der zugehörige Shop muss in der App verfügbar sein.
Auf eigenen Event- oder Ticketseiten kann das Builder-Element ticket_add_to_cart_button verwendet werden. Es benötigt eine Event-ID und kann Labels wie Tickets kaufen und Zum Warenkorb konfigurieren. Nach der Ticketauswahl führt der Ablauf in den Warenkorb und Checkout des verbundenen Shops.
Wenn Tickets nicht kaufbar sind, liegt die Ursache meist nicht in der App-Seite selbst, sondern in Event-, Ticket-, Shop-, Preis-, Verfügbarkeits- oder Zahlungs-Konfiguration.
Für Shop- und Verkaufsseiten sind vor allem diese Builder-Elemente relevant:
article_cart_action zeigt die Warenkorbaktion für einen geladenen Artikel.
shop_floating_cart_button zeigt einen schwebenden Warenkorbbutton für einen Shop. Das Element benötigt eine Shop-ID.
ticket_add_to_cart_button zeigt eine Ticket-Kaufaktion für ein Event. Das Element benötigt eine Event-ID.
Diese Elemente sollten mit passenden Contexts und Properties kombiniert werden, damit Artikel, Shop oder Event zur Laufzeit eindeutig geladen werden können.
Der Checkout wird über die Shop- und Zahlungs-Konfiguration der Umgebung gesteuert. Die App stellt dafür Warenkorb, Versand-/Abholschritt, Zahlungsseite und Bestellabschluss bereit.
Zahlungsmittel funktionieren nur, wenn sie in simplebis korrekt eingerichtet und für den betroffenen Ablauf verfügbar sind. Bei externen Zahlungsanbietern müssen zusätzlich die Zugangsdaten und Anbieter-Einstellungen stimmen.