Socialguard unterstützt über die gängigen Ausweisscanner Combo und Osmond die Nutzung von Barcode-Kundenkarten. Über einen HTTP Endpunkt können beliebige Systeme abgerufen werden. Eine Kunden-Datenbank gehört nicht zum Umfang von Socialguard. Bitte haben Sie daher Verständnis, dass wir hier keinen Support leisten und Sie dies auf eigene Kosten und Verantwortung umsetzen müssen.

Voraussetzungen

Endpunkt

Das Kundenkartensystem muss einen Endpunkt über HTTP zur Verfügung stellen. Sofern sich der Server nicht lokal auf dem Computer befindet ist unbedingt eine verschlüsselte Verbindung über HTTPS zu nutzen.

Es können Abfragen über POST und GET definiert werden. Innerhalb der URL und in den Query-Parametern für POST-Requests wird die KundenID über die Wildcard {%ID%} gesetzt.

Eine lokaler Endpunkt auf dem jeweiligen PC vor Ort in der Spielstätte könnte so aussehen:

http://localhost/kundenkarten/{%ID%}.json

Sofern sich das Kundenkarten-System auf einem öffentlich erreichbaren Server befindet, muss der Zugang darüber hinaus über die Prüfung eines Authorization-Headers gesichert werden.

Datenformat

Die Kundendaten stehen über einen HTTP Endpunkt via GET/POST als JSON in nachfolgendem Format zur Verfügung:

{ 
"FirstName": "Vorname",  
"LastName": "Nachname", 
"BirthDay": "YYYY-MMM-TT", 
"PictureURL": "http://webserver/BildvomGesicht.jpeg", 
"CardURL": "http://webserver/BildvomAusweis.jpeg", 
"Infotext" : "Ihre Notiz" 
}

Barcode

Als Barcode empfehlen sich die folgenden Formate:

• PDF417
• QR Code
• DataMatrix
• Aztec
• Code128

Der zu kodierende String muss mit UUID: beginnen. Im Nachgang folgt die NutzerID:

UUID:987654321

=> UUID wird in zukünftigen Versionen nicht mehr notwendig sein.

Konfiguration

1. Kundenkarten-Integration aktivieren

Öffnen Sie in der SGScanner.exe das Menü über einen Klick auf den Kreis unten links am Bildschirmrand. Klicken sie auf Einstellungen. Setzen Sie einen Haken bei Kundenkarten-Integration aktivieren und Barcode.

2. HTTP-Request Header konfigurieren

Werden bestimmte Header (z.B. Authorization) im HTTP-Request benötigt, können diese im Abschnitt Headereinstellungen konfiguriert werden.

3. Kundendaten-Abfrage Endpunkt konfigurieren

Wählen Sie den Typ (GET oder POST) und geben nachfolgend die URL des Endpunkts an. Über Query Paramater können die Parameter für POST konfiguriert werden.