Zum Hauptinhalt springen
Version: v18

Gutscheinverwaltung

Allgemein​

info

Lizenzpflichtiges Modul. Pro Dongel. Pro Anbieter.

MELZER X3000 bietet sowohl Schnittstellen zu Gutschein-Fremdsystemen (Incert, Casablanca, E-GUMA, WebsLine, BESSA, Gurado), als auch eine programminterne Gutscheinverwaltung (X3000).
Beschreibung der genauen Funktionsweise im Handbuch MELZER X3000 - Kapitel - "Gutscheinverwaltung".

Einstellungen MELZER X3000​

Modulunabhängige Einstellungen welche gesetzt werden müssen.

Zahlungswege → Zahlungsarten​

Zahlungsart für "Gutschein" anlegen.

  • "Art:" „Gutschein X3000“ oder „Gutschein [Fremdsystem]“ auswählen.

Einstellungen → Einstellungen allgemein​

Einstellungen → Einstellungen pro Arbeitsplatz​

In den Rechnungsformularen müssen die Felder für den Druck der EAN-Codes eingefügt werden (diese können von einem Rechnungsformular im Verzeichnis WS kopiert werden).

  • Registerkarte "Formulare"
    • Bonformular für optionalen Gutscheindruck anlegen (z.B. "Bon G")
      • Formular: 80MM-GS.mrt (Im Verzeichnis WS gibt es dafür die Vorlage 80MM-GS.MRT.)
      • Einstellungen ⚙️
        • "Bon Art:" "Einzelbon" oder "Sammelbon" ohne "Mengensammlung"

Stammdaten → Artikelverwaltung → Artikel​

Folgende Artikel anlegen:

  • "GS Prüfen" (z.B.: Nr. 80012)
    • Registerkarte "Diverses"
      • "Gutschein:" "Gutschein prüfen" wählen; Spezifizierung je nach Gutscheinmodul wählen.
  • "GS Verkauf" (z.B.: Nr. 80013)
    • Registerkarte "Grunddaten"
      • "Preis:"
        Wenn ein Preis eingetragen wird, wird ein Gutschein mit diesem Wert erstellt;
        Wenn Preis "0,00" hinterlegt ist kann ein variabler Gutscheinwert beim Verkauf eingetragen werden (in der Registerkarte Divers: "Preis 0,-- darf boniert werden" darf NICHT aktiv sein).
      • "Diverses: Umsatzneutral:" "Gutschein Verkauf / Storno (Umsatzneutral, von Barsumme NICHT abziehen)" wählen.
      • "Warengruppe:" Eine Warengruppe mit MwSt. 0% wählen.
      • "Druckerzuordnung:" Bonkennzeichen für Druck eines Gutscheins angeben (optional, z.B.: Drucker "G", Formular 80MM-GS.mrt)
    • Registerkarte "Diverses"
      • "Gutschein:" "Gutschein Verkauf" wählen; Spezifizierung je nach Gutscheinmodul wählen.
  • "GS Storno" (z.B.: Nr. 80014)
    • Registerkarte "Grunddaten"
      • "Preis:" Preis "0,00" eintragen (in der Registerkarte Divers: "Preis 0,-- darf boniert werden" darf nicht aktiv sein).
      • "Diverses: Umsatzneutral:" "Gutschein Verkauf / Storno (Umsatzneutral, von Barsumme NICHT abziehen)" wählen.
      • "Warengruppe:" Eine Warengruppe mit MwSt. 0% wählen.
    • Registerkarte "Diverses"
      • "Preis 0 darf boniert werden" darf bei diesen Artikel NICHT aktiviert sein.
      • "Minusartikel" aktivieren.
      • "Gutschein:" "Gutschein Storno" wählen; Spezifizierung je nach Gutscheinmodul wählen.

Module​

X3000​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 Gutscheine geprüft, verkauft*/aufgewertet, storniert*/entwertet, eingelöst und ausgewertet werden.
*Ab Version 16.08.15 möglich (MobileKasse)
Bereits verkaufte Gutscheine können ebenfalls in der Kasse nachträglich angelegt werden.

Einstellungen - Einstellungen allgemein - Allgemein: Gutscheinverwaltung X3000: Suche Gutschein nach Name.​

Bei Gutschein X3000 kann bei der Einlösung eines Gutscheins im Boniersystem ein Gutschein nach Namen gesucht werden ("Suche Gutschein nach Name"). Weiters kann der Parameter "Mehrere Gutscheine verkaufen" aktiviert werden, wodurch gleichzeitig mehrere Gutscheine verkauft werden können.

Stammdaten → Gutscheinverwaltung → Gutscheingruppen​

Um Gutscheine verkaufen zu können, muss eine Gutscheingruppe angelegt werden.

Parameter Gutscheingruppen​
  • "Nr"
    Vergabe einer Gutscheingruppen-Nummer.
  • "Bezeichnung"
    Bezeichnung der Gutscheingruppe, welche zur Auswahl im Boniersystem erscheint (wenn mehrere Gruppen angelegt sein sollten).
  • "Typ"
    Wahl des Gutscheinmoduls (X3000, Incert, E-Guma, ...).
  • "Präfix" & Code Art Der "Präfix" kann nur in Verbindung mit den Parametern "Num. Bereich von-bis" oder "Zufällige alphanum. Nr" mit "Anzahl Stellen (mind. 6)" vergeben werden, und umgekehrt.
    Das Präfix darf nicht mit einer Ziffer enden. Erlaubte Zeichen: A-Z, 1-9
    Beispiel: "Präfix" GS mit dem "Num. Bereich" 1 - 9999 würde GS0001 - GS9999 generieren.
    • "Num. Bereich von-bis": Werden diese Parameter zusammen gesetzt, vergibt das Kassensystem automatisch die nächste fortlaufende freie Nummer in der gewählten Gutscheingruppe/Range.
    • "Zufällige alphanum. Nr" & "Anzahl Stellen (mind. 6)": Bei aktivierter Zufallsauswahl generiert das Kassensystem automatisch eine Gutschein­nummer innerhalb der definierten Anzahl an verfügbaren Gutscheinen. Dies wird aus Sicherheitsgründen bei SB-Modus empfohlen, um das Erraten gültiger Gutschein­nummern durch auf- oder absteigende Nummernfolgen zu verhindern.
  • "Keine autom. Range"
    Hier müssen Gutscheinnummern manuell vergeben werden.
  • "Gültig von-bis"
    Datumsbereich für die Gültigkeit des Gutscheins.
  • "Gültig Anz. Tage ab Verkauf"
    Anzahl Tage für die Gültigkeit des Gutscheins ab Verkaufsdatum.
  • "Gültig bis Jahresende (VK-Datum) + ... Jahre"
    Anzahl der Jahre für die Gültigkeit des Gutscheins.
    Wird der Gutschein Beispielsweise am 07.04.2023 verkauft und "5" Jahre gewählt, wäre eine Einlösung bis 31.12.2028 möglich.
  • "Teilbar"
    Ermöglicht es den Gutschein mehrmals in Teilbeträgen einzulösen. Bei deaktivierten Parameter, wird der Gutschein auf Wert "0,00" gesetzt, sobald dieser das erste mal benützt wird.
  • "Überziehen erlaubt"
    Durch diese Funktion wird festgelegt, ob der Gutschein überzogen werden darf.
  • "Namenseingabe bei Verkauf"
    Beim Verkauf öffnet sich ein Fenster zur Namenseingabe.
  • "Inaktiv"
    Wird die Gutscheingruppe "Inaktiv" gesetzt, ist kein Verkauf mehr möglich. Einlösen eines Gutscheins dieser Gruppe ist jedoch möglich.

Bessa​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 BESSA-Gutscheine geprüft, verkauft*/aufgewertet, storniert*/entwertet, eingelöst und ausgewertet werden.

Jedem Kunden wird von Bessa eine spezifische BESSAURL sowie BESSAAPIKEY bekannt gegeben. Diese Parameter müssen in der param.ini wie folgt eingefügt werden:

[GUTSCHEINVERWALTUNG]
BESSAURL=https://stg.bessa.app/
BESSAAPIKEY=xxxx
Parameter Gutscheingruppen​

Werden BESSA-Gutscheine über das Kassensystem verkauft und es gibt keine vordefinierten Gutscheinnummern (Vordrucke Gutscheine, Gutschein Cards etc.), können Gutscheinnummern generiert werden (Numerisch, Alphanumerisch, ...). Besteht bereits eine Gutscheingruppe von BESSA kann dies ebenfalls nachträglich gesetzt werden.

  • "Bezeichnung"
    Bezeichnung der Gutscheingruppe, welche zur Auswahl im Boniersystem erscheint (wenn mehrere Gruppen angelegt sein sollten).
  • "Typ"
    Wahl des Gutscheinmoduls BESSA
  • "Präfix" & Code Art Der "Präfix" kann nur in Verbindung mit den Parametern "Num. Bereich von-bis" oder "Zufällige alphanum. Nr" mit "Anzahl Stellen (mind. 6)" vergeben werden, und umgekehrt.
    Das Präfix darf nicht mit einer Ziffer enden. Erlaubte Zeichen: A-Z, 1-9
    Beispiel: "Präfix" MX- "Alphanumerisch" würde zB. einen Code wie MX-ASKUO1232ABG generieren (15 Stellen).
    • "Num. Bereich von-bis": Werden diese Parameter zusammen gesetzt, vergibt das Kassensystem automatisch die nächste fortlaufende freie Nummer in der gewählten Gutscheingruppe/Range.
    • "Zufällige alphanum. Nr" & "Anzahl Stellen (mind. 6)": Bei aktivierter Zufallsauswahl generiert das Kassensystem automatisch eine Gutschein­nummer innerhalb der definierten Anzahl an verfügbaren Gutscheinen. Dies wird aus Sicherheitsgründen bei SB-Modus empfohlen, um das Erraten gültiger Gutschein­nummern durch auf- oder absteigende Nummernfolgen zu verhindern.
  • "Keine autom. Range"
    Hier müssen Gutscheinnummern manuell vergeben werden.
  • "Inaktiv"
    Wird die Gutscheingruppe "Inaktiv" gesetzt, ist kein Verkauf mehr möglich. Einlösen eines Gutscheins dieser Gruppe ist jedoch möglich.

Weiteres​

In param.ini kann man auch die Länge eines Gutscheincodes einstellen. Mithilfe eines Kommas, kann man mehrere Werte eingeben.

[Gutscheinverwaltung]
ALLOWED-ID-LENGTHS=13,15

Eine weitere Möglichkeit Einschränkungen zu treffen in param.ini, ist die Einstellung von erlaubten Zeichen.
Zum Beispiel mit dieser Eingabe werden nur Nummern erlaubt:

[Gutscheinverwaltung]
ID-REGEX=^[0-9]*$
Log-Dateien​

Unter C:/MFSERVER finden sich folgende Logs:

  • GSBESSAxyz.log, Meldungen von X3000
  • X3000-GSBESSA.log, Meldungen der Webrequests

Casablanca (EuCaSoft)​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 Casablanca-Gutscheine geprüft, aufgewertet, storniert*/entwertet, eingelöst und ausgewertet werden.
*Nur an Kasse möglich
*Nur bei Casablanca mit EuCaSoft-Verbund möglich!

Hotelverbund "Casablanca" muss aktiviert und konfiguriert sein. Für die Gutscheinverwaltung wird der Pfad der Hoteldateien verwendet.

E-Guma​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 E-Guma-Gutscheine geprüft, verkauft*/aufgewertet, storniert*/entwertet, eingelöst und ausgewertet werden.
*Ab Version 16.08.06 möglich (Kasse, MobileKasse)

Folgende Einträge in der param.ini einfügen:

[GUTSCHEINVERWALTUNG]
E-GUMAURL=https://api.e-guma.ch
E-GUMAAPIKEY=<Angabe lt. E-Guma einstellen>

Weiteres​

Für Betriebe mit mehr als einem Kassenverzeichnis, aber einer gemeinsamen Gutscheinverwaltung muss die Datenbank zentral geführt werden.
Folgende param.ini Einträge anpassen.
Beispiel:

[SQL]
SQLDATENBANKEXTERN=X3000ZENTRALE;C:\X3000\ZENTRALE\PSQL;\\<HOSTNAME>\X3000\ZENTRALE\PSQL
EXTERNGS=1

Gastro.Digital​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 Gastro.Digital-Gutschein geprüft, aufgewertet, entwertet, eingelöst und ausgewertet werden.

Achtung

Es können nur durch Gastro.Digital erstellte Gutscheine behandelt werden

Jedem Kunden wird von Gastro.Digital ein spezifischer API-Token bekannt gegeben. Dieser Token muss unter "Einstellungen → Einstellungen allgemein → Schnittstellen → Gutschein" beim Zahnrad eingefügt werden.

Gurado​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 Gurado-Gutscheine geprüft, verkauft/aufgewertet, storniert/entwertet, eingelöst und ausgewertet werden.

Achtung

Es können nur in Gurado erstellte Gutscheine behandelt werden.

Jedem Kunden wird von Gurado ein spezifischer GURADOAPIKEY und GURADOAPISECRET bekannt gegeben. Diese Parameter müssen in der param.ini wie folgt eingefügt werden:

[GUTSCHEINVERWALTUNG]
GURADOAPIKEY=xxxx
GURADOAPISECRET=xxxx

Incert​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 Incert-Gutscheine geprüft, verkauft/aufgewertet, storniert/entwertet, eingelöst und ausgewertet werden.

Jedem Kunden wird von Incert eine spezifische INCERTURL, INCERTTERMINALID sowie INCERTPASSWORD bekannt gegeben. Diese Parameter müssen in der param.ini wie folgt eingefügt werden:

[GUTSCHEINVERWALTUNG]
INCERTURL=https://services01.incertapi.com/voucherRedeemWS.php?account_id=xxxx
INCERTTERMINALID=xxxx
INCERTPASSWORD=xxxx

Legacy API (TLS 1.0/1.1) - Abschaltung Q2/2022 durch Incert:

[GUTSCHEINVERWALTUNG]
INCERTURL=https://legacy.incertapi.com/voucherRedeemWS.php?account_id=xxxx
INCERTTERMINALID=xxxx
INCERTPASSWORD=xxxx

Weiteres​

Zum Stornieren eines Incert Gutscheins wird die Storno ID (Reverse Charge ID) benötigt, welche am Formular bzw. der Rechnung angedruckt wird.

Log-Dateien​

Unter C:/MFSERVER finden sich folgende Logs:

  • GSINCERTxyz.log

WebsLINE​

Modulabhängige Einstellungen. Allgemeine Einstellungen müssen gesetzt sein.

hinweis

Durch dieses Modul können in X3000 WebsLINE-Gutscheine geprüft, aufgewertet, entwertet, eingelöst und ausgewertet werden.

Achtung

Es können nur bereits verkaufte/ausgestellte Gutscheine aufgeladen bzw. ausbezahlt werden.

  • Aufladen/Ausbezahlen ist nur an der Kasse möglich

Jedem Kunden wird von WebsLINE eine spezifische WEBSLINEURL sowie WEBSLINEAPIKEY bekannt gegeben. Diese Parameter müssen in der param.ini wie folgt eingefügt werden:

[GUTSCHEINVERWALTUNG]
WEBSLINEURL=xxxx
WEBSLINEAPIKEY=xxxx