Content
Technische Voraussetzungen
Vectron-Kassensystem
- VPOS Version 6.5.0.0
- VPOS Script-API 1.25.0
- VPOS-App 1.1.5
- VPOS-App ID 26
- Kundenanzeige C75, C100, C11 und Mobile M4
Lizenzen
- Die VPOS-App ist auf jedem Kassensystem zu installieren auf dem die Zahlung ausgeführt werden soll.
- Für jedes Kassensystem ist ein individueller Lizenzschlüssel (Scriptaktivierungscode = SAC) erforderlich.
- Teilen Sie dem "PayWithCharlie"-Ansprechpartner die Software-Seriennummer mit, danach erhalten Sie von dort Ihren individuellen Lizenzschlüssel.
Einstellungen
Wenn die folgenden Beschreibungen nicht eindeutig oder nicht verständlich sind informieren Sie uns bitte.
VPOS
Konfiguration
| Abteilung | Bezeichnung | Benötigter Wert |
|---|---|---|
| Finanzen etc. / Finanzwege | Anzahl | +1 |
| Eingabe / Makros | Anzahl | +1 |
| Skripte | Anzahl | +2 |
| Skripte | Anzahl SAC | +1 |
| Skripte | Anzahl Links | +1 |
| Skripte / Key-/Value-Speicher... | Aktiv | 1 / ja |
Programmieren
Damit das Kassensystem bei der Bezahlung von Rechnungen autmatisch den QR-Code erzeugen kann ist ein eigener Finanzweg für "PayWithCharlie" zu nutzen.
| Abteilung | Einstellungen |
|---|---|
| Finanzen etc. / Finanzwege | Name: Name (Frei wählbar zum Beispiel "PwC") |
| Finanzen etc. / Finanzwege / Zahlungen | Zahlungsart: Unbar |
Skript/Makro
Skripte/Makros.../Makro
Dieses Makro wird benötigt umd die Kundenanzeige nach der Erzeugung der Rechnung zu refreshen. Beispiel Makro Name: Refresh Kundenanzeige
| Code | Funktion |
| 70 | Start Tastencode |
| N |
Ziffer N Nummer der Kundenanzeige |
| 13 | Dezimalzeichen |
| 1 | Ziffer 1 |
| 5 | Ziffer 5 |
| 232 |
Kundenanz. Refresh |
Download
Sie können die Skriptdateien unter diesem Link herunterladen.
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_PwC.vsc | 1 = ja | 1 = kein Neustart | - | - |
| tb_PwC_Settings.ini | 0 = nein | 0 = Neustart b. Fehler | - | - |
*.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 |
|---|---|---|
| Media | N | Nummer des Finanzweges (1-15) der PwC zugeordnet ist |
| waitInterval | N | Dauer des Warteintervalls in Sekunden für die Abfrage ob die Transaktion abgebrochen werden soll oder erneut gewartet werden soll. (Standard = 15) |
| urlSuccess | "https://api.kasse-stimmt.de/connect/tb_pwc_success.php" | Diese URL wird für die Kommunikation zwischen PayWithCharlie und dem Kassensystem benötigt. |
| urlFailure |
"https://api.kasse-stimmt.de/connect/tb_pwc_failure.php" | Diese URL wird für die Kommunikation zwischen PayWithCharlie und dem Kassensystem benötigt. |
| CustomerDisplay | N | Der PwC-QR-Code wird auf der Kundenanzeige ausgegeben: 1-5 (Nummer der Kundenanzeige) Eine Kundenanzeige wird nicht genutzt: 0 = nein Hinweis: Der PwC-QR-Code wird immer auf dem Bediener-Touchdisplay zur Kontrolle der Funktion ausgegeben. |
| Makro | N | NN = Nummer des Makros Refresh Kundenanzeige
|
| PwC_Username | "xxxxxxx_xxxxx" | Diese Daten werden von PayWithCharlie zur Verfügung gestellt. |
| PwC_Password | "xxxxx-xxxxxx-xxxxxx-xxxxxxx" | Diese Daten werden von PayWithCharlie zur Verfügung gestellt. |
| PwC_ClientID | "xxxxxxxxxxxx" | Diese Daten werden von PayWithCharlie zur Verfügung gestellt. |
| PwC_merchantID | "xxxx_xxxx" | Diese Daten werden von PayWithCharlie zur Verfügung gestellt. |
| qrMag | N | QR-Code Ausgabe für Kundenanzeige und Bediener-Touchdisplay: 1-16 = Vergrößerungsfaktor der QR Code-Bilddaten (4 = default) |
| Horizontal_Pos | N | QR-Code Ausgabe für Kundeanzeige: horizontale Position (150 = deafult) |
| Vertical_Pos | N | QR-Code Ausgabe für Kundenanzeige: vertikale Position (150 = deafult) |
| Dialog_Horitzontal_Pos | N | QR-Code Ausgabe für Bediener-Touchdisplay: horizontale Position innerhalb des Bildschirms (30 = default) |
| Dialog_Vertical_Pos | N | QR-Code Ausgabe für Bediener-Touchdisplay: vertikale Position innerhalb des Bildschirms (50 = default) |
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 | PwC-Verbindungstest | VPOS:tb_PwC.vsc | 1 | Diese Funktion testet die Verbindung mit den eingestellten ini-Parametern zur PayWithCharlie-API. |
Externes System
Einstellungen
Einstellungen des externen Systems sind nicht bekannt.