Technische Voraussetzungen

Vectron-Kassensystem

• VPOS Version 7.0.7.0
• VPOS Script-API 1.25.3
• VPOS-App 1.2.10
• VPOS-App ID 19

Lizenzen

• Die VPOS-App ist auf einem Kassensystem (Single- oder Verbundsystem) zu installieren. Dieses Kassensystem muss Zugriff auf die gewünschten Tische haben. Wird mit mehreren Tischservern gearbeitet ist jeweils eine VPOS-App in dem jeweiligen Kassenverbund zu installieren.
• Die Scriptaktivierungscodes (SAC) erhalten sie über den Kontakt "Entwicklung".

Einstellungen

Wenn die folgenden Beschreibungen nicht eindeutig oder nicht verständlich sind informieren Sie uns bitte.

Beachten sie die bitte:

• Grundkonfiguration: LucaPay stellt für jeden Tisch einen Aufsteller mit dem QR-Code zur Verfügung oder
• Druck QR-Code: Ein Drucker des Kassensystems erzeugt den QR-Code

Grundkonfiguration

LucaPay stellt für jeden Tisch einen Aufsteller mit dem QR-Code zur Verfügung.

VPOS

Konfiguration

Abteilung	Bezeichnung	Benötigter Wert
Finanzen etc. / Finanzwege	Anzahl	+1
Finanzen etc. / Rabatttypen	Anzahl	+1
Finanzen etc. / Rabatttypen	Rabattspeicher	+1
Drucken	Drucker	+1
Skripte	Anzahl	+7
Skripte	Anzahl SAC	+1
Skripte	Anzahl Links	+3
Diverses / Vorgänge	Hintergrund Anzahl	+1
Hardware	Schnittstellen	+1

Programmieren

Damit die Rechnungsdaten an LucaApp übermittelt werden können wird ein virtueller Temporärer Drucker benötigt.

Abteilung	Einstellungen
Einstellungen / Schnittstellen	Name: zum Beispiel lucaApp Anschlusstyp: Datei Gerätename: GeräteName (z. B.: lucaPay) (*.ini-Datei: drFileName)
Drucken / Drucker	Schnittstelle: SchnittstellenName (z. B. lucaPay) Vorprogrammierter Treiber: Ja Druckertreiber: File Timeout: 3 sec (Standard 30 sec)

Die  VPOS-App LucaPay prüft die Anmeldeart des Bedieners. Wenn die Anmeldung nur per Schlüssel = 1 ist, wird ein Touchcode >0 (ID des Magnet-Schlüssel) benötigt.

Die LucaPay-App beinhaltet die Funktionen Tisch separieren und TIP buchen. Damit diese Funktionen von der LucaPay-App genutzt werden können, sind die erforderlichen Berechtigungen in der VPOS-Programmierung zu erteilen.

Abteilung	Einstellungen
Bediener etc. / Bediener oder Bedienergruppen / Finanzen etc.	Rabatt erlaubt: 1 - Ja (TIP)
Bediener etc. / Bediener oder Bedienergruppen / Tische.../ Tische umbuchen/sep ....	*Autorisierung: 1 - Ja

Für die Zahlungen mit LucaPay-App wird ein eigener Finanzweg benötigt.

Abteilung	Einstellungen
Finanzen etc. / Finanzwege	Name: FinanzwegName (z. B.: lucaPay)
... / Zahlungen	Zahlungsart: 2 - Unbar Teilzahlung: 1 - Ja
... / Abrechnung/Berichte	Kassenspeicher: 3 - Unbar Diverses Abzugebender Betrag: 0 - Nein Anfangsbestandserf.: 0 - Nein In Abrechnung: 1 - Ja Bestand erhalten: 0 - Nein
... / Abrechnung/Berichte / 0-Zahlungen zählen	Kundenzähler: 1 - Ja
... / Scheine/Münzen	Euro: 1 - Euro

Damit der Nutzer der LucaPay-App TIP/Trinkgeld geben kann sind die notwendigen Einstellungen für TIP in der VPOS zu aktivieren. Beachten sie dafür die Empfehlungen und Einstellungen aus dem SDB 7092.

Abteilung	Einstellungen
Finanzen etc. / Rabatttypen	Name: RabattypName (z. B.: Trinkgeld) Typ: 5 - Trinkgeld Modus: Standard Überschreibbar: 1 - Ja Bei Rabatt berücksichtigen: 0 - Nein Rabattspeicher: 5

Damit die LucaPay-App den Tischabschluss ausführen kann, darf der Abschlussmodus keinen Zwang enthalten.

Die VPOS-App schliesst nach jedem Zugriff vorsorglich alle Tische, damit die externe Anwendung LucaPay-App Zugriff auf die Tischdaten erhält.

Abteilung	Einstellungen
Parameter / Tische/Rechnungen/Buchungsspeicher ...
... / Finanzen etc.	Abschlussmodus: 0 - Standard
... / Eingabe	Tischtasten Modus: 0 - Standard

USB-Stick

• Für die Nutzung der VPOS-App mit einer proprietären Vectron-Hardware ist der dauerhafte Einsatz eines USB-Sticks zwingend erforderlich.
• Auf dem Stick muss sich die Vectron-Verzeichnisstruktur befinden.
• Die Vectron-Verzeichnisstruktur kann beispielsweise mit der Aktion "Dump sichern" erzeugt werden.
• Beim Einsatz einer VPOS PC ist ein USB-Stick nicht erforderlich.

Skript

Download

Sie können die Skriptdateien unter diesem Link herunterladen.

Mit einer neuen Skriptversion kann sich der Aufbau der beteiligten Dateien ändern. Aktualisieren Sie bitte stets alle Skriptdateien.

Skripte/Makros/Skriptverzeichnis

Ausführliche Informationen zum Importieren von Skripten finden sie im SDB-Beitrag 5644.

Name	Automatisch starten	Laufzeitverhalten	Terminal Gruppe	Läuft immer
tb_LucaPay.vsc	1 = Ja	1 = kein Neustart	0	-
tb_LucaPay_Backend.vsc	0 = nein	1 = kein Neustart	>= 1 (*ini-Datei: Term_gruppe_Nr)	0 = Nein
tb_LucaPay_Setting.ini	0 = nein	0 = Neustart b. Fehler	0	-

*.ini-Datei

Beachten sie die folgenden Hinweise:

• Wird eine mögliche Option nicht festgelegt, so wird automatisch der jeweilige Default-Wert verwendet.
• Achten Sie auf die genaue Einhaltung der Schreibweise und nutzen Sie die richtigen Zeichen.
• Sind die Einstellungen nicht passend zur Installation, kann das dazu führen dass die gesamte Anbindung nicht funktioniert.

Bezeichnung	Wert	Beschreibung
SPort	NNNN	Server-Port der Kommunikation zwischen VPOS und lokaler "LucaApp-Anwendung". Abstimmung mit "LucaApp" erforderlich. Default: 1984
Term_Gruppe_Nr	N	Nummer der Terminalgruppe für die Nutzung von "LucaPay" im Hintergrund aus VPOS / Skripte/Makros / Skriptverzeichnis / tb_LucaPay_Backend.vsc / Term.-Gruppe: Nummer
Media	N	Nummer des Finanzwegs "LucaPay" aus VPOS / Finanzen etc. / Finanzweg: Nummer
TIP_ID	N	Nummer des Rabatttyps "TIP" aus VPOS / Finanzen etc. / Rabatttyp: Nummer
PrinterID	N	Nummer des Druckers für die Übergabe der Rechnungsdaten an "LucaApp" aus VPOS / Drucken / Drucker: Nummer
PrinterFileName	"GeräteName"	Name des virtuellen Drucker für die temporäre Auslagerung von Rechnungsdaten aus VPOS / Einstellungen / Schnittstellen / Gerätename: "GeräteName"
PrinterPath	"FILE:/Vectron/Data/" oder  "C:/Vectron/VPosPC/Scripts/"	Für die temporäre Auslagerung von Rechnungsdaten. Wenn VPOS-Hardware mit USB-Stick dann "FILE:/Vectron/Data/" oder wenn VPOS-PC dann "C:/Vectron/VPosPC/Scripts/"
ConfirmationPrinter	N	Für den Ausdruck einer Message/Infobon von "LucaApp" bei erfolgreicher Bezahlung. Aus VPOS / Drucken / Drucker: Nummer
AuthUser	{"G3","B1"}	Angabe der berechtigten Bedienergruppe und/oder Bediener: {"G3", "B1"} bedeutet {"G3 = Bedienergruppe 3", "B1 = Bedienernummer 1"}  In diesem Beispiel erhalten alle Bediener der Bedienergruppe 3 und der Bediener 1 die Berechtigung für die Ausführung des Skriptlinks 1 und 2 (in Bearbeitung).

Skripte/Makros/Skriptakt.codes

Tragen sie hier den Scriptakivierungscodes ein den Sie vom Kontakt "Entwicklung" erhalten haben.

Skripte/Makros/Skriptlinks

Legen Sie für jede gewünschte Funktion einen Skriptlink an. Die gewünschte Funktion rufen Sie mit der Tastenfunktion "244 (Skript starten) | N (Code)" auf.

Code	Name (kann frei vergeben werden)	URL	Einsprungspunkt	Funktion
N (Beispiel 11901)	lucaPay	VPOS:tb_LucaPay.vsc	1	Finanzweg (*.ini)  kann nur von AuthUser genutzt werden
N (Beispiel 11902)	TIP	VPOS:tb_LucaPay.vsc	2	tipID (*.ini) kann nur von AuthUser genutzt werden

QR-Code-Konfiguration

Ein Drucker des Kassensystems erzeugt den QR-Code

VPOS

Konfiguration

Abteilung	Bezeichnung	Benötigter Wert
Drucken/ Druckertreiber	Anzahl	+1
Drucken/ Druckertreiber	Länge Druckerst.seq.	100
Drucken/ Druckertreiber	2D-Barcode	1
Drucken	Ausgabeformate	+1
Drucken	Formatprofile	+1
Texte.../ Lange Texte...	Anzahl	+3

Programmieren

Damit die Rechnungsdaten an LucaApp übermittelt werden können wird ein virtueller Temporärer Drucker benötigt.

Abteilung	Einstellungen
Einstellungen / Schnittstellen	Name: zum Beispiel lucaApp Anschlusstyp: Datei Gerätename: GeräteName (z. B.: lucaPay) (*.ini-Datei: drFileName)
Drucken / Drucker	Schnittstelle: SchnittstellenName (z. B. lucaPay) Vorprogrammierter Treiber: Ja Druckertreiber: File Timeout: 3 sec (Standard 30 sec)

Die  VPOS-App LucaPay prüft die Anmeldeart des Bedieners. Wenn die Anmeldung nur per Schlüssel = 1 ist, wird ein Touchcode >0 (ID des Magnet-Schlüssel) benötigt.

Die LucaPay-App beinhaltet die Funktionen Tisch separieren und TIP buchen. Damit diese Funktionen von der LucaPay-App genutzt werden können, sind die erforderlichen Berechtigungen in der VPOS-Programmierung zu erteilen.

Die LucaPay-App nutzt vorbereitete Tisch-QR-Codes (LucaPay stellt den Gastronomen feste Tischaufsteller zur Verfügung) für den Einstieg in den Bezahlprozess. Wenn keine Tisch-QR-Codes vorbereitet sind, können dynamische QR-Codes von der VPOS erzeugt werden. Für die Erzeugung eines dynamischen QR-Codes ist folgende Programmierung erforderlich:

Abteilung	Name	*Text	Hinweis
Texte / Lange Texte	luca Header	#L1-L90 Beispiel: #L84	84 (*.ini-Datei: Platzhalter_Header)
Texte / Lange Texte	luca Text	#L1-L90 Beispiel: #L85	85 (*.ini-Datei: Platzhalter_Text)
Texte / Lange Texte	luca Table Amount	#L1-L90 #L1-90 Beispiel: #L86 #L87	86 (*.ini-Datei: Platzhalter_Tabel)   87 (*.ini-Datei: Platzhalter_Amount)

Damit der dynamische QR-Code erzeugt wird muss der Druckertreiber dafür angepasst sein.

Abteilung	Wert
Drucken / Druckertreiber	Name: QR-Code Drucker (Name frei wählbar) 2D-Barcode 1: 1B,61,01,1D,28,6B,03,00,31,43,08,1D,28,6B,03,00,31,45,31,1D,28,6B,%2,+3,%3,+3,31,50,30,%1,1D,28,6B,03,00,31,51,30,1B,61,00
Drucken / Drucker	Vorprogrammierter Treiber: 0 - Nein Druckertreiber: Nummer des Druckertreiber (QR-Code Drucker) Hinweise: (*.ini-Datei: QRCodePrinter )

Damit der dynamische QR-Code ausgedruckt werden kann, wird ein eigenes Ausgabeformat benötigt. Die VPOS-App LucaPay wechselt automatisch auf dieses Ausgabeformat.

Drucken / Ausgabeformate / Name	Name: AusgabeformateName (z. B.: luca) / Nummer: N (z.B.: 44)
Drucken / Ausgabeformate / Texte...	Ausgabeformat "luca": *Font Endetext 1: > 0 (z. B. 1 - Font 1) *Endetext 1[+]: Lange Texte (z. B. luca Header) *Font Endetext 2: > 0 (z. B. 1 - Font 1) *Endetext 2[+]: Lange Texte (z. B. luca Text) *Font Endetext 3: > 0 (z. B. 1 - Font 1) *Endetext 3[+]: Lange Texte (z. B. luca Table Amount) *Skriptinfo: > 0 (z. B. 1 - Font 1)
Drucken / Ausgabeformate / Infodaten	> 0 (z. B. 1 - Font 1)
Drucken / Formatprofile	Drucken / Drucker / Formatprofil: N (z. B.: 1) Infobon... *4: Nummer AusgabeformateName (z. B. 44) (*.ini-Datei: fmtShiftNo)

Skript

*.ini-Datei

Beachten sie die folgenden Hinweise:

• Wird eine mögliche Option nicht festgelegt, so wird automatisch der jeweilige Default-Wert verwendet.
• Achten Sie auf die genaue Einhaltung der Schreibweise und nutzen Sie die richtigen Zeichen.
• Sind die Einstellungen nicht passend zur Installation, kann das dazu führen dass die gesamte Anbindung nicht funktioniert.

Bezeichnung	Wert	Beschreibung: ynamischer QR-Code
LucaBoxIP	NNN.NNN.NNN.NNN	Tragen sie hier die IP-Adresse er "LucaBox" ein.
LucaPort	NNNN	Kommunikation zwischen VPOS und LucaBox zum Empfang und Ausdruck eines dynmaischen QR-Codes. Der dynamische QR-Code wird erzeugt wenn keine statischen QR-Code auf den Tischen bereitgestellt werden. Default: 9000
fmtShiftNo	N	Nummer des Bon-Formatprofils, zu dem gewechselt werden soll
Platzhalter_Header	N	Platzhalter L1 bis L90 in Langtexten
Platzhalter_Text	N	Platzhalter L1 bis L90 in Langtexten
Platzhalter_Tabel	N	Platzhalter L1 bis L90 in Langtexten
Platzhalter_Amount	N	Platzhalter L1 bis L90 in Langtexten
tempInvoice	= false	= true: Der dynamische QR-Code wird mit einer separaten Zwischenrechnung ausgedruckt. = false: Der dynamische QR-Code wird ohne Zwischenrechnung ausgedruckt. Default: false.
QRCodePrinter	N	Drucker auf dem der dynamaische QR-Code ausgedruckt wird. (VPOS / Drucken / Drucker: Nummer)

Skripte/Makros/Skriptlinks

Legen Sie für jede gewünschte Funktion einen Skriptlink an. Die gewünschte Funktion rufen Sie mit der Tastenfunktion "244 (Skript starten) | N (Code)" auf.

Code	Name (kann frei vergeben werden)	URL	Einsprungspunkt	Funktion
N (Beispiel 11903)	luca QR-Code	VPOS:tb_LucaPay.vsc	3	Für den Ausdruck des dynamischen QR-Codes