#Bessa-App-Gutschein Schnittstelle wurde realisiert.
Diese Schnittstelle hat einige Besonderheiten:
Die Nummer kann bis zu 20 Stellen lange sein.
Wird eine Kennung (ersten Ziffern) der Gutscheinnummer definiert,
so ist es möglich, dass interne Gutscheine und Bessa-App-#Gutscheine
automatisch auseinander gehalten werden können und es ist sogar
eine Zahlung möglich mit internen Gutscheinen und Bessa-Gutscheinen
gemischt. Kennung wäre z.B. 200, dann fangen alle Bessa-Gutscheine mit
dieser Nummer an, z.B. 2001, 2004334, 20043, etc.
Werden neue Gutscheine erstellt, so können keine Internen
Gutscheine mehr erzeugt werden. Könnte aber durch die Kennung
noch erweitert werden, dass beides geht.
Wird KEINE Kennung verwendet, so muss das Zahlungsarten-Kennzeichen
ein I (Internet-Gutscheine) sein. Wird eine Kennung verwendet,
so kann das Kennzeichen der Zahlungsart auch G sein. Es muss
jedoch eine Zahlungsart mit der Kennung I gehen, damit die
Schnittstelle initialisiert werden kann.
Wird eine rein numerische Nummer verwendet, ohne führende Nullen
so kann beim Gutscheinverkauf auch die Menge aktiviert werden,
so können gleich 10 Gutscheine auf einmal erzeugt werden.
Soll ein Gutschein storniert werden, so muss beim Gutscheinverkauf
im Feld “NAME” einfach “storno” eingegeben werden.
Die Nummern können auch 00001 sein, dann ist aber die Menge immer
1 wenn Gutscheine erzeugt werden. Hier kann dann als Kennung
z.B. “0” verwendet werden, so läuft der Nummernkreis von 00001
bis 09999 und gleichzeitig können die internen alten Gutscheine
noch eingelöst werden.
Alle Transaktionen werden in der Datei protkitzgut.txt protokolliert.
Wird Troubleshooting D eingestellt, so wird exakt alles in der
Datei protkitz.log mit protokolliert.
Wichtig: Es darf KEINE Datei incert.cfg geben!
Die Schnittstelle wird durch das Gutschein-Modul und die Datei
bessa.cfg aktiviert. Hier ein Beispiel für den Inhalt der bessa.cfg
*
Adresse = https://stg.bessa.app/v1/web/pos/cards/charge/
StornoUrl = https://stg.bessa.app/v1/web/pos/cards/cancel/charge/
Token = 903595ef287cb7d0ca14705e0100e4cd34cbfba8
BessaAppKennung = 0 // heißt, dass alle Nummern mit “0" Anfangen!
Die Konfigurations Datei kann man sich im Bessa Manager herunterladen für das jeweilige Lokal.
Bestell Einstellungen > Kassen Einstellungen > GastroTouch Gutschein Config