Zum Hauptinhalt springen
Version: 16.08

Gutscheinverwaltung

Allgemein​

info

Lizenzpflichtiges Modul. Pro Dongel. Pro Anbieter.

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

Achtung

Bei Orderman SOL ist nur die Einlösung von Gutscheinen möglich.

Einstellungen MELZER X3000​

Modulunabhängige Einstellungen welche gesetzt werden müssen.

Stammdaten → Zahlungsarten​

Zahlungsart für "Gutschein" anlegen.

  • "Art:" "Gutschein ..." - Jeweiliges Modul auswählen.

Stammdaten → Einstellungen pro Arbeitsplatz​

  • Registerkarte "Schnittstellen"
  • Registerkarte "Formulare"
    • Bonformular für optionalen Gutscheindruck anlegen (z.B. "Bon G")
      • Formular: 80MM-GS.mrt
      • Einstellungen ⚙️
        • "Bon Art:" "Einzelbon" oder "Sammelbon" ohne "Mengensammlung"

Stammdaten → 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 ("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 ("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.
      • "Preis 0 darf boniert werden" darf bei diesen Artikel NICHT aktiviert sein.
    • Registerkarte "Diverses"
      • "Minusartikel" aktivieren.
      • "Gutschein:" "Gutschein Storno" wählen; Spezifizierung je nach Gutscheinmodul wählen.

Module​

X3000​

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

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.

Stammdaten → Gutscheinverwaltung → Gutscheingruppen​

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

Parameter Gutscheingruppen​
  • "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" & "Num. Bereich von-bis"
    Wird ein "Präfix" vergeben, muss auch ein "Num. Bereich von-bis" 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.
    Werden diese Parameter gesetzt, vergibt das Kassensystem automatisch die nächste fortlaufende freie Nummer in der gewählten Gutscheingruppe/Range. Andernfalls 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.
  • "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.

E-Guma​

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

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
Info

Sollten Gutscheine über die Kasse verkauft werden, erhaltet man vom Interfaceanbieter die entsprechenden Gutscheincodes. Diese müssen in die Kasse importiert werden.

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.

Info

Sollten Gutscheine über die Kasse verkauft werden, erhaltet man vom Interfaceanbieter die entsprechenden Gutscheincodes. Diese müssen in die Kasse importiert werden.

Incert​

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

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​

Im Kassenverzeichnis findet sich folgendes Log:

  • Incert.log
Info

Sollten Gutscheine über die Kasse verkauft werden, erhaltet man vom Interfaceanbieter die entsprechenden Gutscheincodes. Diese müssen in die Kasse importiert werden.

WebsLINE​

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

Durch dieses Modul können in X3000 WebsLINE-Gutscheine geprüft, aufgewertet, entwertet, eingelöst und 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
Info

Sollten Gutscheine über die Kasse verkauft werden, erhaltet man vom Interfaceanbieter die entsprechenden Gutscheincodes. Diese müssen in die Kasse importiert werden.

Bessa​

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

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://api.bessa.app/
BESSAAPIKEY=xxxx

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]*$
Hinweis

Bei Bessa-Gutscheinen darf in der Gutscheinverwaltung bei den Gutscheingruppen keine Range angelegt werden.

Log-Dateien​

Unter C:/MFSERVER finden sich folgende Logs:

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