# Blue Code Integration

Blue Code Zahlungen in der TOPTECH-Kasse einrichten und durchführen – ab Version 5.2.

# Allgemeine Informationen

Ab Version **5.2** können Sie Blue Code Zahlungen in der Kasse durchführen. Blue Code® ist eine Bezahlmethode mit dem Smartphone.

## Voraussetzung

Die Zahlungstransaktion selbst wird über Evita TouchPoint abgewickelt. Voraussetzung ist TouchPoint ab Version **14.00.65**.

<p class="callout info">Ist diese Version nicht installiert, löst die Kasse das Update von Evita aus. Danach muss die Kassensoftware neu gestartet werden.</p>

## Wie funktioniert Blue Code?

Die App funktioniert mit jedem Smartphone und jedem österreichischen oder deutschen Bankkonto. Mit Blue Code kann in Geschäften an der Kasse, in Onlineshops und via Bluetooth an Automaten bezahlt werden.

## Wie bezahlt der Kunde mit Blue Code?

1. Der Kunde öffnet an der Kasse die Blue Code App auf dem Handy.
2. Die App zeigt einen einmal gültigen blauen Barcode und den dazugehörigen Zahlencode.
3. Der Barcode wird an der Kasse gescannt und die Zahlung eingeleitet.

## Ergänzung der TOPTECH-Datenbank

Für die Blue Code Zahlung wird ein eigener Buchungstyp mit der Nummer `850` verwendet. Er wird automatisch in der Datenbank (Access und SQL) mit folgenden Einstellungen angelegt:

<table id="bkmrk-einstellungwert-umsa"><thead><tr><th>Einstellung</th><th>Wert</th></tr></thead><tbody><tr><td>Umsatzwirksam</td><td>wahr</td></tr><tr><td>Geldfluss</td><td>falsch</td></tr><tr><td>Warenfluss</td><td>wahr</td></tr></tbody></table>

# Version prüfen und Update

Blue Code ist ab TOPTECH-Version 5.2.0 verfügbar. Prüfen Sie zuerst Ihre Version.

## Version prüfen

1. Lesen Sie die Versionsnummer rechts unten in der Statusleiste der Kasse ab.

![Kasse mit vergrößerter Versionsanzeige Version 5.2.0 rechts unten](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/kasse-version.png)

*Versionsanzeige rechts unten in der Kasse*

## Update durchführen

Ist Ihre Versionsnummer kleiner als 5.2.0, fordern Sie bitte eine Freischaltung für das Update an.

1. Beim nächsten Kassenstart führt die Software die Aktualisierung auf Version 5.2.0 oder höher automatisch durch. Bestätigen Sie die Meldung mit **OK**.
2. Starten Sie Ihre Kassensoftware nach dem Update wie gewohnt.

![Meldung Ein neues Update ist verfügbar mit den Schaltflächen Abbruch und OK](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/update-meldung.png)

*Update-Meldung beim Kassenstart*

# Blue Code Taste anlegen

Für die manuelle Eingabe des Blue Codes legen Sie mit dem Touch-Designer eine eigene Taste an.

## Touch-Designer öffnen

1. Drücken Sie die Schaltfläche **Tools**.

![Kasse mit vergrößerter Schaltfläche Tools](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/kasse-tools.png)

*Schaltfläche „Tools“*

## Tastatur bearbeiten

1. Drücken Sie die Schaltfläche **Tasten**.
2. Wählen Sie Ihre Tastatur aus und drücken Sie **Bearbeiten**.

![Kasse mit der Schaltfläche Tasten und der Touch-Designer mit der Schaltfläche Bearbeiten](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/kasse-tasten-bearbeiten.png)

*„Tasten“ und Tastatur bearbeiten*

## Blue Code Taste hinzufügen

1. Klicken Sie auf **Button hinzufügen**.
2. Wählen Sie den Reiter **Funktion**, danach **BlueCode**, und klicken Sie auf **Hinzufügen**.
3. Klicken Sie auf **Speichern**.

![Touch-Designer: Button hinzufügen, Funktion BlueCode auswählen, Hinzufügen und Speichern, nummeriert 1 bis 4](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/touch-designer-bluecode.png)

*Button hinzufügen, Funktion „BlueCode“ wählen und speichern*

## Touch-Designer beenden

1. Klicken Sie auf **Beenden**. Die Software springt zurück in das Kassenfenster, die Taste **BlueCode** ist auf der Tastatur verfügbar.

![Touch-Designer mit vergrößerter Schaltfläche Beenden](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/touch-designer-beenden.png)

*Touch-Designer beenden*

![Kasse mit der neuen Taste BlueCode auf der Tastatur](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/kasse-bluecode-taste.png)

*Die neue Taste „BlueCode“ auf der Kassentastatur*

# Mit Blue Code bezahlen

Wenn ein Kunde mit Blue Code bezahlen möchte, zeigt er sein Smartphone mit dem Blue Code vor.

## Blue Code scannen

1. Der Kunde zeigt den Blue Code in seiner App an der Kasse vor.
2. Scannen Sie den Blue Code vom Smartphone ab. Die Kasse erkennt den Code eigenständig und startet den Bezahlvorgang automatisch.

![Smartphone mit geöffneter Blue Code App und blauem Barcode](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-app.png)

*Blue Code in der App des Kunden*

![Der Blue Code wird mit einem Handscanner vom Smartphone abgescannt](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-scannen.png)

*Blue Code vom Smartphone abscannen*

<p class="callout warning">**Achtung:** Zum Abscannen vom Smartphone ist ein eigener Scanner (Imager) notwendig.</p>

## Blue Code alternativ eintippen

Haben Sie keinen Scanner, der den Blue Code vom Smartphone abscannen kann, geben Sie den Code manuell ein.

1. Wählen Sie die zuvor erstellte Taste **BlueCode**.
2. Tippen Sie den Blue Code des Kunden über das Zahlenfeld oder eine angeschlossene Tastatur ein und bestätigen Sie.

![Fenster Bitte geben Sie den Blue Code ein mit Zahlenfeld](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-eintippen.png)

*Blue Code manuell eingeben*

## Zahlung wird durchgeführt

Nach dem Bestätigen der Eingabe oder nach dem Scannen wird geprüft, ob der Kunde berechtigt ist, mit Blue Code zu bezahlen. Anschließend wird die Zahlung durchgeführt.

![Fenster Zahlung wird durchgeführt](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-zahlung-laeuft.png)

*Die Zahlung wird durchgeführt*

## Zahlung fehlgeschlagen

Schlägt die Zahlung fehl, weil der Kunde nicht berechtigt ist oder zum Beispiel ein Übertragungsfehler aufgetreten ist, bricht der Zahlvorgang mit einer Fehlermeldung ab. Danach können Sie den Beleg mit einer anderen Zahlungsart abschließen.

![Meldung Zahlung fehlgeschlagen mit Grund und Schaltfläche OK](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-zahlung-fehlgeschlagen.png)

*Meldung bei fehlgeschlagener Zahlung*

## Zahlung erfolgreich

Bei erfolgreicher Zahlung schließt sich das Blue Code Bezahlfenster, und die Transaktionsbestätigung sowie der Kundenbeleg werden ausgedruckt.

![Ausgedruckte Blue Code Transaktionsbestätigung und Kundenbeleg](https://dokumentation.toptech.at/uploads/images/gallery/2026-10/scaled-1680-/bluecode-belege.png)

*Transaktionsbestätigung und Kundenbeleg*