Zum Hauptinhalt springen
Version: v18

Elektronische Karte

info

Lizenzpflichtiges Modul. Pro Dongel.

info

Diese Dokumentation befindet sich in Bearbeitung.

Mit dem Modul "Elektronische Karten" können Bestellungen aus Self-Ordering Systeme direkt in das Kassensystem MELZER X3000 übernommen werden. Beschreibung der genauen Funktionsweise siehe Handbuch MELZER X3000 - Kapitel "Elektronische Karten".

Einstellungen MELZER X3000​

Modulunabhängige Einstellungen welche gesetzt werden müssen.

Einstellungen → Einstellungen allgemein​

  • Registerkarte "Schnittstellen"
    • "Elektronische Karte": Das entsprechende Modul mit deren Einstellungen (siehe unten "Module") auswählen
    • "Pfade"
      • "Elektronische Karte"
        Pfad für den Austauschordner der elektronischen Karte einstellen.
        Standardpfad: ekarte\ (Ordner "EKarte" im Kassenverzeichnis)
      Achtung
      • Wird ein anderer Pfad verwendet, muss der Pfad von der Transfer.exe für "Bestellungen Elektronische Karte" und X3000.exe -i erreichbar sein.

Stammdaten → Bediener​

Es muss ein Bediener für Bestellungen der elektronischen Karte angelegt werden.

Hinweis

Pro Arbeitsstation "Transfer - Ordering", "Transfer - Payment", "Transfer - Platform" bzw. "Kiosk" kann ein eigener Bediener definiert werden.

Zahlungswege → Zahlungsarten​

Es muss eine Zahlungsart mit der Art "Elektronische Karten" & der EKarte Art "Online" angelegt werden. Als "Kurzbezeichnung" kann zB. "OZ" (Online-Zahlung) verwendet werden.

Hinweis

Werden in der EKarte weitere Zahlungsarten unterstützt (Paypal, Twint usw..) kann für jede dieser Abrechnungsmethoden eine eigene Zahlungsart mit der Art "Elektronische Karten" angelegt werden.

Stammdaten → Artikelverwaltung → Karten​

Es empfiehlt sich eine eigene Karte für die "elektronische Karte" anzulegen. Bei mehreren Karten dürfen "Spartenkurzbezeichnungen" nicht doppelt vergeben werden.

Gültigkeit/Sperre:
Es kann unter "Stammdaten - Artikelverwaltung - Karten" in der jeweiligen Karte pro Sparte eine "Sperre" hinterlegt werden. Ist hier ein Zeitraum angegeben können diese Kartensparten nur zu gewissen Zeiten aufgerufen werden.

Stammdaten → Artikelverwaltung → Artikel​

Beilagen-Artikel "***" muss angelegt sein.​

Sollen manuelle Kommentare immer auf der Rechnung erscheinen:

  • Registerkarte "Diverses"
    • "Artikel soll trotz Preis 0 auf der Rechnung stehen" aktivieren

Trinkgeld-Artikel "TIP" oder "Trinkgeld" muss angelegt sein.​

Artikel Liefergebühr​

Den Artikel als umsatzneutralen Artikel mit einem Preis von 0 angelegen. Der tatsächliche Betrag der Liefergebühr wird anschließend von der App übermittelt.

  • Registerkarte "Grunddaten"
    • "Diverses"
      • Parameter "Umsatzneutral - Einzahlung, von Barsumme NICHT abziehen" aktivieren.
      • Artikelnummer des Liefergebühr-Artikels muss unter
        Einstellungen → Einstellungen allgemein → Registerkarte: Bestellsysteme, Kiosk & Abholdisplay
        im Feld "Artikel-Nr Liefergebühr" eingetragen sein.
        Zusätzlich besteht hier die Möglichkeit, unter „Einstellungen allgemein → Bestellsysteme, Kiosk & Abholdisplay“ im Feld „Bestellung Ablauf (Minuten)“ eine Zeit in Minuten zu definieren, um den Bestellablauf festzulegen.

Allergene:​

Unter 'Stammdaten > Artikelverwaltung > Artikel' kann bei dem jeweiligen Artikel im Tab "Diverses" im Block "Allergene" die entsprechenden Allergene ausgewählt werden.

Hinweis

Es ist zu empfehlen den Artikeln fixe Beilagen zu hinterlegen. Diese Beilagen können Sie einer Gruppe (0-9 oder A-Z) zuordnen. Pro Gruppe gibt es auf der Elektronischen Karte ein eigenes Fenster. Pro Gruppe kann eine "Mindest-Anzahl" oder "Maximal-Anzahl" und eine Bezeichnung angegeben werden.

Ist beim Artikel eine "Artikelbezeichnung Lang" hinterlegt, wird diese als Bezeichnung in der App verwendet.
Die "Produktinfo" wird der Elektronischen Karte ebenso zur Verfügung gestellt.

Achtung

Sind Artikel mit "Preis 0" in der Elektronischen Karte verfügbar, muss der Parameter "Artikel soll trotz Preis 0 auf Rechnung stehen" unter Registerkarte "Diverses" aktiviert werden. Ist dies nicht der Fall, kann es passieren, dass keine Rechnung erstellt wird.

Schweiz & Deutschland

Wird in der Bestell-App die Möglichkeit geboten Take-Away-Bestellungen aufzugeben, sollte jedem Artikel eine 2. Warengruppe mit dem entsprechenden Steuersatz für Take-Away (bzw. außer Haus) eingetragen werden. Am Bon wird ein entsprechender Vermerk angedruckt.

Einstellungen → Einstellungen pro Arbeitsplatz​

Es muss ein Transferprogramm angelegt werden.

  • Registerkarte "Allgemein"
  • Registerkarte "Tisch/Konto"
    Parameter "Tisch/Konto nach ... Minuten automatisch verlassen" auf 1 setzen.
  • Registerkarte "Transfer"
  • Registerkarte "Formulare"
    Bei Formulare die jeweiligen Bonformulare bei den passenden Bonkennzeichen hinterlegen und Drucker zuweisen. Auch das Rechnungsformular muss eingetragen werden. Der Kunde erhält immer eine PDF-Rechnung über die App. Bei Bestellart "Abholung" oder "Lieferung" wird zusätzlich zur PDF-Rechnung, eine Rechnung am eingestellten Rechnungsdrucker ausgedruckt. Auf der Rechnung sind die Lieferadresse bzw. Kundendaten ersichtlich.
Zu Beachten

Der Abholcode wird im Formular-Feld "Bemerkung_2" gedruckt. Dieses Feld muss evtl. in den Report eingefügt werden!

  • Registerkarte "Kiosk / Abholdisplay / Bestelungen"
    Hier kann die Bestell-Art festgelegt werden, bei welcher die Karte gültig ist.

    "EKarte Art"BeschreibungBESSANANEAQERKO
    INIn-House✔️✔️✔️
    TATake-Away✔️✔️✔️
    LILieferung✔️✔️❌

    • Abholnummer: Die Vergabe der Abholnummer kann auf unterschiedliche Weise erfolgen. Es stehen folgende Modi zur Verfügung:

      • Automatisch: Die Abholnummer wird automatisch vom System vergeben. Für die automatische Vergabe muss eine der folgenden Einstellungen aktiviert sein:
      • Numerisch: Der Benutzer kann eine beliebige Nummer innerhalb eines vorgegebenen Nummernbereichs eingeben (z. B. zur Nutzung mit einem Tischaufsteller). Der zulässige Bereich wird über die Option Nummerbereich definiert.
      • Alphanumerisch: In diesem Modus können Abholnummern sowohl Zahlen als auch Buchstaben enthalten. Nummerbereich: Der Nummerbereich ist nur im Modus Numerisch relevant und legt fest, welche Nummern vom Gast gewählt werden können.

    • Tischbestellung, Takeaway, Lieferung: Es können verschiedene Bestellarten aktiviert werden (Tischbestellung = vor Ort essen; Takeaway = Bestellung zum Mitnehmen; Lieferung = online Bestellung mit Lieferservice). Für jede Bestellart können folgende Einstellungen getroffen werden:

      • Zuweisung einer eigenen Karte
      • Angabe eines zweistelligen Präfix (z. B. „IN“ für Inhouse, „TA“ für Takeaway, „LI“ für Lieferung). Dieser Präfix erscheint bei der Abholnummer und kann auch auf Bons und Rechnungen zur eindeutigen Kennzeichnung verwendet werden. Zusätzlich steht ein 20-stelliges Feld zur Verfügung, um die Bestellart auf dem Bon oder der Rechnung kenntlich zu machen.
      • Abholnummer am Bon drucken: Die Abholnummer der Bestellung wird auf dem Bon ausgegeben.
      • Status:
        • "Automatisch annehmen": Mit diesem Parameter kann die Bestellung automatisch angenommen werden und muss nicht mehr manuell ausgewählt werden.
        hinweis

        Diese Einstellung ist bei Bessa irrelevant, da dies vom Bessa Connector übernommen wird.

        • "Status tracken": Bei Aktivierung dieser Einstellung, kann der Status der Bestellung mitverfolgt werden. Die möglichen Status lauten "In Zubereitung", "Abholbereit" & "Fertig".
      • Kundeninformation am Bon drucken: Zusätzliche Kundeninformationen werden auf dem Bon mitgedruckt, um eine eindeutige Zuordnung zu erleichtern.

    • Zahlungswege: Folgende Zahlungsarten stehen zur Verfügung und können bei Bedarf einzeln aktiviert oder deaktiviert werden:

      • Kreditkarte
      • Chip
      • Bar
        • "Rechnung erstellen": Beim Zahlungsweg „Bar“ steht der Zusatzparameter „Rechnung erstellen“ zur Verfügung. Ist diese Option aktiviert, werden die bonierten Positionen übernommen und die Rechnung unmittelbar als Barzahlung abgeschlossen.
      • Zimmer
      • Gutschein
      • Cashdispenser

Für jede aktivierte Zahlungsart kann ein individueller Hinweistext hinterlegt werden. Dieser Text wird nach erfolgreichem Abschluss einer Bestellung angezeigt und kann beispielsweise zur Bestätigung oder als Information für den Gast genutzt werden.

Module​

BESSA1​

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

Einstellungen → Einstellungen allgemein​

  • Registerkarte "Schnittstellen"
    Hinweis

    Ab v18 sind für Bessa keine weiteren Einstellungen in den "Einstellungen - Einstellungen allgemein - Schnittstellen" mehr notwendig. Die IP-Adresse vom PC, auf dem die "X3000Interfaces" läuft, muss im Bessa-Connector hinterlegt werden.

  • Registerkarte Tisch/Konto
    • "Auto Tisch-/Kontosuche von-bis": Die Tischauswahl erfolgt über die "Autotischsuche". Hierzu unter einen Tischbereich eintragen. Für jede Bestellung ohne zugewiesenen Tisch wird die Tischnummer innerhalb dieses Bereichs automatisch um 1 erhöht.

Funktionen​

Artikelgruppierung (Speisen/Getränke/Sonstiges):
Sollte es notwendig sein den Artikeltyp an BESSA zu übergeben (Trennung von Speisen & Getränken) kann dies unter "Stammdaten → Artikelverwaltung → Warengruppen → Diverses Kennzeichen" eingestellt werden.

  • Für Getränke Wert 3 ins Feld "Diverses Kennzeichen" eintragen
  • Für Speisen Wert 4 ins Feld "Diverses Kennzeichen" eintragen
  • Für Sonstiges Wert 2 ins Feld "Diverses Kennzeichen" eintragen

Fertig-Benachrichtigung via Bondisplay:
Die Funktion Bestellungen als "Fertig" zu markieren, ermöglicht es dem Gast mitzuteilen, dass eine Bestellung fertig zubereitet wurde und nun abholbereit ist bzw. bald serviert wird, siehe: "Einstellungen Arbeitsplatz → Bondisplay", Feld: "EKarte Benachrichtigung bei Fertigstellung".

Es besteht die Möglichkeit, Getränke separat als "Fertig" zu markieren. Dazu muss der Artikeltyp eingetragen werden (siehe "Artikelgruppierung" oben).

Diverse Settings in der param.ini, Bereich [EKARTE]:
Grundsätzlich wird bei Bestellungen ohne Tisch (Typ Abholung, Lieferung, Kiosk) der nächste Tisch lt. dem Tischbereich für die EKarte verwendet ("Einstellungen Allgemein → Schnittstellen", "Tisch/Konto von-bis"). Ist der Eintrag "PICKUPNR-TISCHNR=1" gesetzt, wird der Abholcode als Tischnummer eingestellt. Dabei ist zu beachten, dass der Abholcode nur Nummern enthalten darf, damit er als gültige Tischnummer eingestellt werden kann.

Hinweis

Ist dieses Verhalten auch bei der Tischbestellung notwendig kann es dem Eintrag "PICKUPNR-TISCHNR-INHOUSE=1" aktiviert werden.

Info

Durch das Setzen der oben genannten Einträge, ist die Tischnummer immer gleich der Abholnummer. Dadurch ist die Bonzeile mit dem Abholcode nicht unbedingt notwendig. Durch das setzen des Eintrags "DO-NOT-SHOW-CODE=1" wird die Zeile mit dem Abholcode am Bon nicht mehr gedruckt!

Einträge in param.ini​

In der param.ini können folgende Einträge hinzugefügt werden:

[EKARTE]
BON-CUSTOMERINFO=1
...
ParameterErklärung
BON-CUSTOMERINFO=1Adressinformation wird auch auf dem Bestellbon angedruckt.
DO-NOT-SHOW-CODE=1Abholnummer am Bon nicht drucken.
PICKUPNR-TISCHNR=1Abholnummer als Tischnummer verwenden (Nur bei Abholung, Lieferung & Kiosk).
PICKUPNR-TISCHNR-INHOUSE=1Abholnummer als Tischnummer verwenden (auch bei Tischbestellung)
SHORTCODETEXT=Bestimmten Text als Bezeichnung für Abholnummer verwenden.
SHORTCODETEXT-INHOUSE=Bestimmten Text als Bezeichnung für Abholnummer für InHouse Bestellungen verwenden.
SHORTCODETEXT-PICKUP=Bestimmten Text als Bezeichnung für Abholnummer für PickUp Bestellungen verwenden.
SHORTCODETEXT-DELIVERY=Bestimmten Text als Bezeichnung für Abholnummer für Liefer Bestellungen verwenden.
SHORTCODETEXT-KIOSK=Bestimmten Text als Bezeichnung für Abholnummer für Kiosk Bestellungen verwenden.

Multi-Gastro​

Es ist möglich, dass mehrere Restaurants Bestellungen in dieselbe MELZER X3000 Kasse übertragen. Dies ermöglicht eine Unterteilung eines Betriebs in verschiedene Bereiche. Pro Bereich werden eigene Karten exportiert und es können eigene Drucker bzw. Formulare angelegt werden.

Ablauf:

  • Für jeden Bereich eine WSNR mit der Funktion "Bestellungen Elektronische Karte einlesen" anlegen und unter "Formulare" die entsprechenden Drucker zuweisen.
  • Unter "Einstellungen > Einstellungen pro Arbeitsplatz > Bestellsysteme / Kiosk / Abholdisplay" kann jeder Arbeitsstation bei den Bestellarten eine entsprechende Karte zugeordnet werden.
  • Für jeden Bereich muss nun die jeweilige Transfer.exe und X3000.exe -i gestartet werden. Dazu die WSNR als Parameter beim Programmstart angeben:
Zu Beachten

Die X3000.exe -i muss mit Administratoren-Rechten gestartet werden! Über das Wappen-Icon ist ersichtlich, ob die Anwendung mit Adminrechten gestartet wurde.

z.B.: Transfer.exe

  • Ziel: C:\X3000\Kasse\Transfer.exe 001
  • Ausführen in: C:\X3000\Kasse

z.B.: X3000.exe -i

  • Ziel: C:\X3000\Kasse\X3000.exe -i 001
  • Ausführen in: C:\X3000\Kasse

Zusätzliche Optionen:

  • Werden zusätzliche Schnittstellen der X3000Interfaces verwendet kann mittels eines Eintrags in der param.ini der Start der Schnittstelle "Elektronische Karte" deaktiviert werden (siehe interfacesDemo.ini)
Zu Beachten

Die X3000.exe -i muss mit Administratoren-Rechten gestartet werden! Über das Wappen-Icon ist ersichtlich, ob die Anwendung mit Adminrechten gestartet wurde.

Bsp.:

[EKARTE]
START=0
  • Die IP-Adresse kann mittels eines Eintrags in der param.ini pro WSNR festgelegt werden. Dieser Eintrag übersteuert die IP-Adresse welche unter "Einstellungen → Einstellungen Allgemein → Schnittstellen → Elektronische Karte" eingestellt wurde. (siehe interfacesDemo.ini)
    Bsp.:
[EKARTE]
WS001-IP=192.168.0.1:20030

Weiteres​

Log-Dateien​

IF-XCS-API.log bzw. IF-XCS-APIxyz.log2 wird unter <Kassenverzeichnis>\Logs & C:\MFSERVER\Logs abgelegt. Jede Übertragung wird hier erfasst.

Info

Werden Bestellungen online über Bessa bezahlt und später wieder storniert, muss die Zahlung manuell im "Stripe Dashboard" storniert werden. Die Onlinezahlungen laufen hier über den Zahlungsdienstleister "Stripe".

NANEA​

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

Mit Nanea können online Bestellungen aufgegeben sowie online bezahlt werden.

Einstellungen → Einstellungen allgemein​

  • Registerkarte "Schnittstellen"
    • "Elektronische Karte"
      Aus dem Drop-down Menü "Nanea" wählen
      • Einstellungen ⚙️
        • "Benutzer"
          Nanea API-Token hier eintragen.
        • "Restaurant ID"
          Restaurant ID angeben.
        • "Passwort"
          Passwort hineinschreiben.

Die "TRANSFER.exe" für die Arbeitsstation "Bestellungen Elektronische Karte einlesen" starten und die X3000.exe -i (X3000Interfaces) (zu finden im Ordner Kasse) starten.

Zu Beachten

Die X3000.exe -i muss mit Administratoren-Rechten gestartet werden! Über das Wappen-Icon ist ersichtlich, ob die Anwendung mit Adminrechten gestartet wurde.

Weiteres​

Information des Kunden auf Bon​

Um die Kundendaten auf dem Bon/Rechnung anzuzeigen, muss ein Kommentar-Artikel mit der PLU 9999 angelegt werden.

  • "Diverses"
    • "Bezeichnung änderbar" - aktivieren
    • "Artikel soll trotz Preis 0 auf der Rechnung stehen" - aktivieren

Einstellungen Nanea-Programm​

Nanea-Anleitung

Log-Dateien​

C:\MFSERVER\LOGS\IF-NANEA.log bzw. <Kassenverzeichnis>\LOGS\IF-NANEA.log

QERKO3​

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

Mit Qerko können Artikel bestellt und bezahlt werden.

Einstellungen → Einstellungen allgemein​

  • Registerkarte "Schnittstellen"
    • "Elektronische Karte"
      Aus dem Drop-down Menü "Qerko" wählen
      • Einstellungen ⚙️
        • "Benutzer"
          Qerko API-Token hier eintragen.
        • "Tisch/Konto von - bis"
          Tischbereich für Bestellungen ohne Tischangabe (Abholung). Pro Bestellung ohne Tisch, wird die Tischnummer um 1 erhöht.

Die "TRANSFER.exe" für die Arbeitsstation "Bestellungen Elektronische Karte einlesen" starten X3000.exe -i (zu finden im Ordner Kasse) starten.

Zu Beachten

Die X3000.exe -i muss mit Administratoren-Rechten gestartet werden! Über das Wappen-Icon ist ersichtlich, ob die Anwendung mit Adminrechten gestartet wurde.

API Token erstellen​

Um X3000 mit Qerko zu verbinden, muss ein API Token im Restaurant-Admin angelegt werden.

  • Technisches
  • API-Schnittstellen verwalten
  • Neuer API-Schlüssel (Namen vergeben, zB.: X3000)
  • "Hinzufügen"
    Der erstellte Api Token muss nun in der X3000 hinterlegt werden.

Demo Restaurant​

Um Qerko zu testen können beliebig viele Demo-Restaurants in der Qerko Sandbox angelegt werden.

  • Account bei Qerko-Sandbox erstellen
  • Demo-Restaurant anlegen
    Hinweis

    Haken bei Testrestaurant setzen.

  • API-Token erstellen und API-Token bei MELZER X3000 eintragen

Parami.ini bei Sandbox:​

[EKARTE]
DEBUG=1

Um mit der Qerko-App auf das Demo-Restaurant zugreifen zu können, muss man diese in den Test-Modus bringen:

  • Als E-Mail Adresse "qerko-toggle-test" eingeben und auf den Button Weiter klicken
  • In der App erscheint nun ein "TEST" Zeichen

Erste Schritte mit dem Demo-Restaurant:

  • Im Restaurant-Admin können unter "Technisches - QR-Codes zuordnen" QR-Codes auf Tische zugeordnet werden
  • Wenn man nun einen dieser QR-Codes mit der Qerko App scannt ("Technisches - Bilder QR-Codes") werden die aktuellen Tischpositionen angezeigt

Weitere Funktionen (müssen erst von Qerko aktiviert werden):

  • Bestellfunktion (Tischbestellung, Abholbestellung)
  • Treueprogramm (z. B.: bei jedem 10. Bier erhält man 1 Bier gratis)

Testkarte (PayU-Gateway):

  • Kartennummer 4245 7576 6634 9685
  • Ablaufdatum 12/29
  • CVC 123

Artikelbilder​

Um den Artikeln ein Bild zu hinterlegen einfach in den Ordner \ARIMAGES im Kassenverzeichnis Bilder einfügen. Der Name muss der Artikelnummer entsprechen und die Dateiendung muss entweder ".png" oder ".jpeg" sein.

Weiteres​

Information des Kunden auf Bon​

Um die Kundendaten auf dem Bon/Rechnung anzuzeigen, muss ein Kommentar-Artikel mit der PLU 9999 angelegt werden.

  • "Diverses"
    • "Bezeichnung änderbar" - aktivieren
    • "Artikel soll trotz Preis 0 auf der Rechnung stehen" - aktivieren
Log-Dateien​

EKARTESRV.log bzw. EKARTESRVxyz.log4 wird unter <Kassenverzeichnis>\Logs abgelegt. Jede Übertragung wird hier erfasst.
KALOG998.log Datenbankfehler oder allgemeine Fehler.

Footnotes​

  1. BESSA - BEStellen & Sammeln https://bessa.app ↩

  2. xyz = Workstationnummer. ↩

  3. QERKO - https://www.qerko.com/de ↩

  4. xyz = Workstationnummer. ↩