Hilfe & Tipps

Loslegen in wenigen Schritten

Mit nachfolgenden Schritten kann die QR-Zahlteil App eingerichtet werden.


1. ComputerApp herunterladen (Windows, MacOS)

Installieren Sie die ComputerApp an einen beliebigen Ort (z.B. C:\Programme\QrZahlteilApp).


2. ComputerApp starten (Windows QrZahlteilScanner.exe)

Beim Starten der ComputerApp zeigt Windows möglicherweise eine blaue Warnung an. Falls dem so ist, wählen Sie auf dieser Meldung "Weitere Informationen", gefolgt von "Trotzdem starten" um die App regulär zu starten.


3. Finanzsoftware / Online Banking konfigurieren

Definieren Sie unter "Datei - Einstellungen" (macOS: "Einstellungen"), an welche Finanzsoftware / Online Banking gescannte Zahlungen übermittelt werden sollen.


4. Smartphone App installieren


5. Smartphone App mit ComputerApp verbinden

In der ComputerApp wird ein QR-Code angezeigt. Scannen Sie diesen mit der Smartphone App, um die beiden Geräte zu verbinden. Die erfolgreiche Verbindung wird in beiden Apps angezeigt.

Falls die ComputerApp nicht angezeigt wird, ist diese möglicherweise minimiert. Doppelklicken Sie zum Öffnen der ComputerApp in der Windows-Taskleiste bei der Anzeige der Zeit auf das Symbol der QR-Zahlteil App.


6. QR-Rechnungen scannen

Bewegen Sie den Scanner der QR-Zahlteil App über den QR-Code einer QR-Rechnung um diesen zu scannen.

Hinweis: Bitte beachten Sie, dass beim Scannen der Text-Cursor am Computer in einer Texteingabe steht. Zu Testzwecken kann dies die geöffnete QR-Zahlteil ComputerApp sein. Für die Texteingabe kann der Text-Cursor z.B. in Word oder dem Windows Editor platziert werden.


Übersicht

Allgemeine Hilfe

Nachfolgende Punkte können Ihnen bei Problemen und Fragen weiterhelfen.


Smartphone App erkennt QR-Rechnungen nicht

Bei Problemen mit der Erkennung von QR-Rechnungen in der Smartphone App können folgende Punkte weiterhelfen:
  • Versuchen Sie die Distanz von Smartphone und Rechnung zu verändern. Teilweise klappt die Erkennung bei unscharfem Bild nicht optimal, wenn das Smartphone zu nahe an die Rechnung gehalten wird.
  • Falls Sie QR-Rechnungen mit dem Smartphone im Querformat lesen beachten Sie, dass die Statusbar der App stets unten sein muss.
  • (Android) Tippen Sie auf den QR-Code/Kodierzeile, sobald Sie diese in der Vorschau sehen. Dabei wird die Erkennung auf diesen getippten Punkt fokussiert.
  • Stellen Sie sicher, dass jeweils der gesamte QR-Code/Kodierzeile in der Vorschau ersichtlich ist. Die App "sieht" jeweils das Sie in der Vorschau sehen.
  • Schliessen Sie die QR-Zahlteil App und öffnen Sie diese erneut. Eher seltener kann auch ein Neustart des Smartphones helfen.
  • Prüfen Sie, ob dieselbe Rechnung auch mit einem anderen Smartphone problematisch ist. Je nach Gerät kann die Erkennung unterschiedlich gut funktionieren. Die Erkennung bei älteren Smartphones kann länger (3-4 sec) dauern.
  • Stellen Sie sicher, dass Sie die aktuellste Version der QR-Zahlteil App auf dem Smartphone installiert haben.

Sicherstellen, dass die ComputerApp läuft (ohne Direktintegration)

Damit die gescannten Daten vom Smartphone auf den Computer übertragen werden, muss dort die QR-Zahlteil ComputerApp laufen. Die 'Schritt für Schritt' Anleitung sollte Ihnen bei der Einrichtung helfen. Sie können folgendermassen sicherstellen, dass die ComputerApp läuft:
  • In der Task-Liste rechts unten alles anzeigen ("Pfeil klicken"). Es erscheint ein Bildchen/Icon der QR-Zahlteil ComputerApp.
  • Klicken Sie mit der rechten Maustaste darauf und wählen Sie "Öffnen".

Sicherstellen, dass Smartphone mit Computer verbunden ist

Steht in der Smartphone App unten 'Verbindung getrennt', können keine Daten auf Ihren Computer übertragen werden. Führen Sie zur Kopplung von Computer und Smartphone den Schritt '4. Smartphone App mit ComputerApp verbinden' aus der 'Schritt für Schritt' Anleitung durch. Das Smartphone wie auch der Computer müssen mit dem Internet verbunden sein (WLAN oder Mobile Daten).

Verwendung in Fachapplikationen / Online Banking klappt nicht

Detailliertere Informationen dazu finden Sie unter 'Verwendung in Fachapplikationen'.

Gescannte Daten werden nicht weitergeleitet (z.B. in Online Banking)

Die QR-Zahlteil App auf Ihrem Smartphone ist erfolgreich mit der ComputerApp verbunden. Gescannte Daten werden aber nicht an die Zielsoftware (z.B. Online Banking) übertragen. Bitte prüfen Sie dazu folgende Punke:
  • Die empfangende Software/Browser muss das aktivierte und fokussierte Fenster sein.
  • Falls Sie eine Sicherheitssoftware nutzen, blockiert diese möglicherweise die Übertragung in Ihr Online Banking. Deaktivieren Sie diese testhalber und definieren Sie allenfalls eine entsprechende Ausnahme für die QR-Zahlteil ComputerApp (QrZahlteilScanner.exe).

Autostart der ComputerApp mit Windows funktioniert nicht

Obwohl in den Einstellungen der ComputerApp aktiviert, startet die ComputerApp nicht automatisch mit Windows. Prüfen Sie folgende Punkte:
  • Deaktivieren Sie den Autostart in den Einstellungen der ComputerApp und speichern Sie. Aktivieren Sie die Option wieder und speichern Sie erneut. Damit wird der Pfad zur ComputerApp für den Autostart aktualisiert.
  • Stellen Sie sicher, dass im Windows Task-Manager im Register 'Autostart' der Eintrag 'QrZahlteilScanner' den Status 'Aktiviert' hat. Mittels rechter Maustaste auf dem Eintrag kann der Autostart aktiviert werden falls nötig.

Falls immer noch Probleme auftreten, könnten folgende Punkte weiterhelfen

  • Sind möglicherweise Fehler in der Windows Ereignisanzeige sichtbar?
  • Treten die Probleme weiterhin auf, wenn temporär die Antiviren Software deaktiviert wird?
  • Ordner mit der Software (QrZahlteilApp) an andere Orte verschieben (z.b. "Meine Dokumente"). Möglicherweise wir der Start der Software aus Sicherheitsbedenken automatisch blockiert. Die ComputerApp muss dazu geschlossen werden.
  • Hat die ComputerApp jemals einen QR-Code zur Paarung angezeigt? Falls nicht, ist dies ein Hinweis auf Verbindungsprobleme mit dem Internet.
  • Funktioniert die Smartphone App z.B. bei Tests mit qr-rechnung.net (oben "Mit QRZAHLTEIL.CH App scannen")?

Ende-zu-Ende-Verschlüsselung deaktivieren


Zur sicheren Datenübertragung von Ihrem Smartphone an Ihren Computer werden gescannte Daten Ende-zu-Ende verschlüsset und TLS gesichert übertragen. Die ComputerApp (Windows, MacOS) aktiviert diese Verschlüsselung automatisch. Diese Verschlüsselung sollte aus Datenschutzgründen aktiviert bleiben. Sollte das dafür notwendige Update der QR-Zahlteil App auf Ihrem Smartphone nicht oder erst zu einem späteren Zeitpunkt möglich sein, kann diese Verschlüsselung deaktiviert werden.

Vorgehen zur Deaktivierung

  1. Schliessen Sie die QR-Zahlteil ComputerApp.
  2. Öffnen Sie die Datei settings.json zur Bearbeitung.
    Windows: Öffnen Sie die Datei %AppData%\QrZahlteilApp\settings.json mit dem Windows Editor (z.B. C:\Benutzer\IhrBenutzerName\AppData\Roaming\QrZahlteilApp\settings.json). Sie können %AppData%\QrZahlteilApp direkt in die Adresszeile des Windows Explorers kopieren.
    MacOS: Öffnen Sie die Datei Macintosh HD/Benutzer/IhrBenutzerName/QrZahlteilApp/settings.json mit einem Text Editor.
  3. Ersetzten Sie "encryptionAlgo":"aes256Cbc" durch "encryptionAlgo":""
  4. Speichern Sie die Änderung
  5. Starten Sie die QR-Zahlteil ComputerApp

 Mehr zur Ende-zu-Ende-Verschlüsselung.

ComputerApp MacOS


Nachfolgende Punkte können Ihnen beim Betrieb auf MacOS weiterhelfen.

Probleme bei Installation und Einrichtung

Eine  Schritt für Schritt Anleitung für die Installation steht bereit. Diese zeigt die einzelnen Schritte vom Download bis zum ersten Scan der ComputerApp auf MacOS.

Verwendung in Fachapplikationen / Online Banking klappt nicht

Detailliertere Informationen dazu finden Sie unter 'Verwendung in Fachapplikationen'.

Cloud-/Server-Betrieb


Nachfolgende Punkte können Ihnen bei der Bereitstellung mittels automatischer Paketierung und im Cloud-/Server-Betrieb weiterhelfen.

Genutzte Ports der ComputerApp

Die ComputerApp benötigt folgende Verbindungen:

Port
Verwendung
443
Verbindung zum QR-Zahlteil Server (wss://qrzahlteil.ch)
443
Updateprüfung (https://www.qrzahlteil.ch), kann mittels allowUpdateApp deaktiviert werden.

Konfiguration für ComputerApp vorgeben (nur Windows)

Einstellungen für die Anwender können vordefiniert werden. Dazu wird eine Datei settings.predefined.json erstellt ( Beispiel-Datei). Diese Datei wird in folgender Reihenfolge gesucht, wobei die zuerst gefundene verwendet wird.
  1. %AppData%\QrZahlteilApp\settings.predefined.json
  2. <ProgrammOrdner>\settings.predefined.json

Nachfolgende Parameter sind in settings.predefined.json möglich:

Konfiguration
Mögliche Werte
Beschreibung
receivingAppId
[Auswahl], null
Definiert die Konfiguration welche zur Übertragung an die Fachapplikation verwendet werden soll oder null, falls versucht werden soll, die Applikation automatisch zu erkennen. Zur Ermittlung des korrekten Wertes definieren Sie in den Einstellungen der ComputerApp die Konfiguration und entnehmen den gespeicherten Wert für receivingAppId der Datei settings.json im selben Ordner.
Standardwert: null
autostartEnabled
null, true, false
true, wenn die ComputerApp automatisch nach der Windowsanmeldung gestartet werden soll. Bei null kann der Anwender dies konfigurieren.
Standardwert: null
allowUpdateApp
true, false
true, wenn der Anwender selbstständig die ComputerApp aktualisieren darf oder false, falls dies nicht möglich sein soll.
Standardwert: true
startupVisibility
normal, minimized, minimizedToTray
Definiert, wie die ComputerApp beim Starten angezeigt werden soll. Diese Einstellung ist nur in settings.predefined.json möglich.
Standardwert: minimizedToTray
closedVisibility
quit (ab 1.0.28), minimized, minimizedToTray
Definiert, wie sich die ComputerApp beim Schliessen des Fensters verhalten soll. Bei quit wird die Applikation beendet. Diese Einstellung ist nur in settings.predefined.json möglich.
Standardwert: minimizedToTray
lastAgbId
1.0, null
Definiert die Version der AGB, welche akzeptiert werden oder null, falls dies jeder Anwender einzeln entscheidet. Wenn dieser Wert den aktuell gültigen AGB entspricht, wird dem Anwender der Dialog zur Akzeptierung der AGB nicht angezeigt. Wenn die AGB aktualisiert werden, muss dieser Wert ebenfalls angepasst werden. Andernfalls wird der Dialog zur Akzeptierung der AGB dem Anwender angezeigt. Ohne Annahme der jeweils aktuellen AGB kann die QR-Zahlteil ComputerApp nicht verwendet werden. Verfügbar ab ComputerApp 1.0.26.
Standardwert: null

Lizenzen für ComputerApp vorgeben (nur Windows)

Lizenzenschlüssel können für mehrere Anwender einer Installation vorgegeben werden. Dazu werden in settings.predefined.json nachfolgende Parameter konfiguriert.
licenseProvider
staticLicenseKey, program
Definiert wie ein Lizenzschlüssel verwaltet wird.
  • staticLicenseKey ermöglicht es jedem Anwender, in den Einstellungen der ComputerApp den Lizenzschlüssel selbstständig zu verwalten. Dies ist das Standardverhalten, falls der Parameter nicht vorhanden ist.
  • program ermöglicht es Lizenzschlüssel extern zu verwalten.
licenseProviderParameter.path
[Pfad]
Pfad zum ausführbaren program, welches über den Windows StandardOutput den zu verwendenden Lizenzschlüssel liefert.
licenseProviderParameter.arguments
[Argumente]
Optionale Argumente für das auszuführende Programm.

Beispiele für licenseProvider program

Gerne unterstützen wir Sie bei der Einrichtung oder erstellen für Ihre Umgebung spezifische Lösungen. Die Beispieldateien müssen jeweils in settings.predefined.json umbenannt werden.

Beispiel Powershell
 settings.predefined.json
 QrZahlteilApp_LicenseKey_ByUsername.ps1
Windows Command/Cmd
 settings.predefined.json
 QrZahlteilApp_LicenseKey_ByUsername.cmd

API-Key für ComputerApp vorgeben (Volumenlizenz, nur Windows)

Bei der Konfiguration eines spezifischen API-Keys für Ihr Unternehmen werden keine Lizenzschlüssel verwaltet. Der Erwerb, die Verwaltung und Zuweisung von Lizenzschlüssel entfällt. Die Abrechnung findet dabei direkt zwischen Ihnen als Betreiber und uns statt. Bei Interesse erläutern wir gerne näheres im Detail.

Videos


Weitere Videos finden Sie auf dem YouTube Channel  radynamics | software solutions