Gutschein online einlösen (Smorder-Webshop)

Zielgruppe: Gast beim Checkout — Einrichtung und Pflege durch Büro/Chef
Typische Nutzung: Bei jeder Online-Bestellung, bei der ein Gutschein ganz oder teilweise die Bezahlung ersetzt
Aufruf (Gast): Online-Checkout → Zahlungsmittel → „Gutschein einlösen"
Aufruf (Pflege): my.smorder.at → Payment → Zahlungsmittel und my.apro → Kassenmodule → Gutscheine → Verwaltung

Zweck

Ein Gast hat einen Gutschein — entweder einen APRO-Gutschein, den der Betrieb selbst ausgestellt hat (an der Kassa, im Webshop oder über das Gutscheinmodul), oder einen Fremdgutschein von einem Drittsystem (z. B. Incert, e-guma). Beim Online-Checkout gibt er den Gutscheincode ein; die Kasse prüft den Restwert und verrechnet ihn als Zahlung. Die Logik ist die gleiche wie an der Kasse (../bonneu/gutschein-ausstellen-einloesen.md, ../bonierapp/gutschein-ausstellen-einloesen.md) — nur passiert der Schritt im Webshop, ohne dass der Gast ins Lokal kommt.

Ablauf Gast

Standard-Ablauf „Online bestellen und mit Gutschein zahlen":

1. Bestellung zusammenstellen — Gast wählt Artikel in der Menükarte und geht in den Checkout.
2. Flow wählen — Abholung, Lieferung oder Tischbestellung (siehe preorder-takeaway-delivery.md).
3. Zahlungsmittel „Gutschein einlösen" wählen — erscheint nur, wenn das Lokal Online-Gutscheineinlösung freigegeben hat.
4. Code eingeben — Code aus dem Gutscheinbeleg (APRO-Gutschein) oder aus der Fremdsystem-Mail. Auf dem Smartphone lässt sich der Code auf vorgedruckten Karten auch direkt einfügen.
5. Restwert prüfen — Das System zeigt den aktuellen Restwert des Gutscheins. Wenn er den Rechnungsbetrag deckt, bleibt keine offene Zahlung.
6. Restbetrag begleichen (falls der Gutschein nicht reicht) — Der Gast wählt zusätzlich Karte, PayPal oder — je nach Betrieb — Barzahlung bei Abholung. Eine Kombination mehrerer Zahlungsmittel ist möglich, sofern das Zahlungsmittel split-fähig eingerichtet ist.
7. Bestellung abschließen — Der Gutscheinbetrag wird sofort abgebucht, die Bestellung geht wie gewohnt in die Kasse, und der Gast bekommt Bestätigung per E-Mail (inklusive verbleibendem Gutschein-Restwert, falls etwas übrig ist).

Ablauf im Backoffice

Damit der Gast diesen Schritt überhaupt sieht, muss die Einlösung freigegeben sein:

1. Gutschein-Kategorien anlegen/prüfen — in my.apro → Kassenmodule → Gutscheine → Verwaltung. Dort wird festgelegt, welche Art von Gutschein (Wertgutschein, Rabattgutschein, Wertkarte, Markerl) in welcher Form verwendet werden darf.
2. Kategorie für Online freigeben — pro Kategorie wird getrennt eingestellt, ob sie auf BonNeu, BonierApp, Kiosk und/oder im Smorder-Webshop einlösbar ist.
3. Zahlungsmittel in Smorder anlegen — im Smorder-Backoffice unter Payment → Zahlungsmittel wird ein Zahlungsmittel vom Typ „Gutschein" angelegt und mit der Kategorie-ID verknüpft.
4. Fremdgutschein-Systeme zusätzlich — für Incert, e-guma oder andere Drittsysteme wird zusätzlich zur APRO-Gutschein-Einlösung eine eigene Fremdgutschein-Option freigegeben; Details in der Schnittstellen-Doku.
5. Checkout testen — vor dem Live-Gang einen Testgutschein anlegen und den kompletten Checkout durchspielen.

Einstellungen

• Welche Kategorien online einlösbar sind — pro Gutschein-Kategorie in der Kassenverwaltung einzeln freigebbar.
• Mindest-/Restbetrag — ob ein Gutschein auch für sehr kleine Beträge einlösbar ist; pro Kategorie.
• Split-Zahlung zulassen — Gutschein + zweites Zahlungsmittel (Karte, PayPal). Steuerbar pro Zahlungsmittel im Smorder-Backoffice und in der Kassenstammdaten-Konfiguration.
• Welche Flows unterstützt die Einlösung — Online-Gutschein kann für Abholung, Lieferung und Tischbestellung separat erlaubt werden. Empfehlung: für alle drei Flows gleich behandeln, damit der Gast keine Überraschung erlebt.
• Gutscheinmodul zum Verkauf einbinden — der Verkauf von Gutscheinen auf der Website läuft entweder über das eingebettete Gutschein-Widget (JavaScript-Snippet auf der Homepage), eine direkte Weiterleitung zum Smorder-Gutscheinshop oder eine iframe-Einbettung. Die drei Wege unterscheiden sich nur im Integrationsaufwand — am Ende landet der Gutschein in der gleichen Verwaltung.
• Fremdgutschein-Freischaltung — in Smorder wird pro Fremdsystem die API-Anbindung aktiviert und die Zahlungsmittel-ID zugeordnet.
• E-Mail-Vorlage mit Restwert-Hinweis — nach Teileinlösung kann dem Gast automatisch eine Bestätigung mit dem verbleibenden Restwert zugeschickt werden.

Berechtigungen

Varianten

• APRO-Wertgutschein online einlösen — klassischer Geschenkgutschein, wird als Zahlungsmittel von der Rechnung abgezogen. Restwert bleibt am Code erhalten.
• APRO-Rabatt-Gutschein online einlösen — reduziert die Summe auf Positionsebene (z. B. „10 € Willkommens-Bon"). Für den Gast im Checkout gleich, die Kasse rechnet automatisch.
• Teileinlösung mit Rest-Zahlung — Gutschein deckt nicht die ganze Rechnung, Gast zahlt den Rest per Karte/PayPal. Möglich, sofern das Gutschein-Zahlungsmittel split-fähig ist.
• Mehrere Gutscheine auf eine Bestellung — je nach Konfiguration dürfen Kunden mehrere Codes nacheinander eintragen. Restbeträge jedes Gutscheins werden einzeln abgebucht.
• Wertkarte / Token — aufladbare Karte mit Saldo. Online-Einlösung bucht vom Saldo ab, Aufladungen kann der Gast im Gutscheinshop selbst vornehmen (z. B. als Geburtstagsgeschenk an sich selbst).
• Markerl / Stück-Gutschein — Stück-basiert, pro Einlösung wird ein Stück abgebucht. Online eher selten, aber möglich für B2B-Catering-Szenarien.
• Fremdgutschein (Incert, e-guma u. a.) — der Gast gibt den Code seines Drittsystem-Gutscheins ein; Smorder fragt dort den Restwert ab und zieht ihn ab. Detail-Einrichtung pro System ist in der Schnittstellen-Doku beschrieben.
• Gutscheinverkauf ohne Einlösung — manche Betriebe verkaufen Gutscheine ausschließlich online (eigene Landingpage), lösen sie aber nur am Bon ein. Das ist möglich, indem die Online-Einlösung für die Kategorie deaktiviert bleibt.

Problembehebung

• „Code wird nicht akzeptiert" → Passende Kategorie online freigegeben? Code genau wie gedruckt eingegeben (ohne Bindestriche/Leerzeichen)? Gültigkeitsdatum abgelaufen?
• „Gutschein taucht im Checkout gar nicht als Zahlungsmittel auf" → Online-Zahlungsmittel „Gutschein" im Smorder-Backoffice nicht aktiv oder nicht mit einer Kategorie verknüpft.
• „Restwert passt nicht zu dem, was der Gast erwartet" → Der Gutschein wurde möglicherweise an der Kasse oder einem anderen Kanal schon teilweise eingelöst. Der angezeigte Restwert ist der aktuelle, verbindliche Stand.
• „Fremdgutschein akzeptiert den Code nicht" → Schnittstelle zum Drittsystem prüfen (Zugangsdaten, Endpunkt). Im Zweifel parallel im Admin-Bereich des Drittsystems prüfen, ob der Code dort noch gültig ist.
• „Bestellung war bezahlt, Gutschein aber nicht abgebucht" → Seltener technischer Fall. Bestellung stornieren und erneut einlösen; im Zweifel Support kontaktieren.
• „Split-Zahlung geht nicht (Gutschein + Karte)" → Zahlungsmittel „Gutschein" muss in den Kassenstammdaten als split-fähig markiert sein. Außerdem muss das zweite Zahlungsmittel online verfügbar sein.
• „Gast will nachträglich einen Gutschein einlösen" → Nach Abschluss der Online-Bestellung nicht mehr möglich. Stornieren und neu bestellen, oder bei Abholung den Gutschein direkt an der Kassa einreichen.

Siehe auch

• ../bonneu/gutschein-ausstellen-einloesen.md — Windows-POS-Variante (Einlösung an der Kassa)
• ../bonierapp/gutschein-ausstellen-einloesen.md — Mobile Variante (Einlösung am Tablet/Orderman)
• stripe-paypal-zahlung.md — Zweite Zahlung bei Gutschein + Karte/PayPal
• webshop-einrichtung.md — Grundsetup des Webshops
• ../myapro/stammdaten-sync-konfig.md — Pflege der Gutschein-Kategorien in my.apro
• Schnittstellen-Doku (für Techniker): docs/schnittstellen/articles/gutschein/apro-gutschein.md, docs/schnittstellen/articles/gutschein/fremd-gutschein-sammel.md, docs/schnittstellen/articles/gutschein/incert.md