PDF

API-Token und weitere Einstellungen verwalten

Hier verwaltest du API-Token für externe Systeme, konfigurierst Versicherungsträger, Standorte und Endgeräte. Diese Einstellungen ermöglichen die Anbindung von Schnittstellen und die Verwaltung deiner Organisationsstruktur.

So kommst du hierher

Öffne das Menü und wähle Einstellungen > System > Einstellungen.
Du siehst eine Übersicht mit verschiedenen Verwaltungsbereichen. Die folgenden Schritte beschreiben die wichtigsten davon.

Voraussetzungen

Für die Verwaltung von API-Token benötigst du das Recht API-Token ausstellen. Für Standorte benötigst du das Recht Standorte verwalten. Versicherungsträger können alle Benutzer anlegen und bearbeiten.

Aufbau der Übersicht

Die Einstellungsseite zeigt mehrere Bereiche:

API-Token: Hier werden ausgestellte Zugangsschlüssel für externe Anwendungen aufgelistet.
Versicherungsträger: Verwaltung von Krankenversicherungen und Kostenträgern.
Standorte: Übersicht deiner Betriebsstätten mit Adresse und Kontaktdaten.
Endgeräte: Konfiguration von Tablets, Registrierkassen und anderen Geräten.

So gehst du vor

API-Token ausstellen

Scrolle zum Bereich API-Token und klicke auf Token ausstellen.
Trage eine Bezeichnung ein, unter der du den Token später erkennst.
Wähle ein Ablaufdatum aus (mindestens ein zukünftiges Datum).
Wähle einen Standort aus – der Token wird für diesen Standort gültig sein.
Aktiviere unter Berechtigungen die Funktionen, die das externe System nutzen soll. Du musst mindestens eine Berechtigung auswählen.
Klicke Erstellen.
Der Token wird sofort angezeigt. Dieser Text wird danach nicht mehr eingeblendet – kopiere ihn jetzt und speichere ihn sicher ab. Klicke Token kopieren, um ihn in die Zwischenablage zu übernehmen, und danach Fertig.

Der Token ist nun in der Liste sichtbar. Die Spalten zeigen Bezeichnung, Präfix (erste Zeichen), gewährte Berechtigungen, Ersteller, Erstellungsdatum, Ablaufdatum und wann er zuletzt genutzt wurde.

Einen Token widerrufen

Scrolle zum Bereich API-Token und finde den Token in der Liste.
Klicke auf das Verbotszeichen in der Spalte Aktion.
Bestätige die Abfrage. Der Token wird sofort ungültig und kann nicht mehr verwendet werden.

Widerrufene Token kannst du mit dem Schalter Widerrufene anzeigen in der Symbolleiste einblenden, um zu sehen, welche Token nicht mehr aktiv sind.

Versicherungsträger hinzufügen

Scrolle zum Bereich Versicherungsträger und klicke auf Hinzufügen.
Trage eine Kurzbezeichnung ein (z.B. den Namen der Krankenkasse).
Ergänze den Vollständigen Namen.
Wähle das Land aus.
Klicke Speichern.

Der neue Versicherungsträger erscheint in der Liste. Du kannst ihn später bearbeiten, indem du ihn doppelklickst oder auf das Stiftsymbol klickst. Mit dem Archivierungssymbol verschiebst du ihn in die Archivübersicht.

Einen Standort hinzufügen

Scrolle zum Bereich Standorte und klicke auf Hinzufügen.
Das Fenster Standort bearbeiten öffnet sich. Trage die wichtigsten Daten ein: Name, Adresse, Stadt, Postleitzahl, Telefon und E-Mail.
Unter dem Reiter Standort bearbeiten kannst du weitere Einstellungen vornehmen: Öffnungszeiten, Zahlungsoptionen, Druckeinstellungen und weitere Konfigurationen.
Klicke Speichern. Der Standort wird sofort übernommen.

Der neue Standort erscheint in der Übersicht. Du kannst später durch einen Doppelklick auf einen Standort in die Detailseite wechseln, um weitere Einstellungen vorzunehmen (Öffnungszeiten, Kalender, Druckeinstellungen etc.).

Ein Endgerät konfigurieren

Scrolle zum Bereich Endgeräte und wähle das Gerät aus, das du einrichten möchtest (z.B. ein Tablet oder eine Registrierkasse).
Das Fenster Endgerät konfigurieren öffnet sich.
Vergib einen Namen für das Gerät, damit du es später erkennst.
Wähle einen fixen Drucker aus (optional), der standardmäßig verwendet werden soll.
Unter Verfügbare Kassen: Aktiviere oder deaktiviere, welche Kassen auf diesem Gerät sichtbar sein sollen.
Ist das Gastro-Modul aktiv, kannst du auch Küchenmonitore und den Küchendruck konfigurieren.
Unter Rechte: Aktiviere oder deaktiviere Funktionen für dieses Gerät. Mit dem Auswahlfeld oben kannst du schnell alle Rechte auf einmal aktivieren oder deaktivieren.
Klicke Speichern.

Das Gerät ist nun mit deinen Einstellungen konfiguriert und wird beim nächsten Start diese Konfiguration laden.

Was danach passiert

API-Token: Der ausgestellte Token kann sofort von externen Anwendungen verwendet werden. Du kannst ihn in der Liste überwachen (Spalte „Zuletzt genutzt") und ihn jederzeit widerrufen.
Versicherungsträger: Der neue Träger steht ab sofort in allen Auswahlfeldern zur Verfügung und kann Patienten zugeordnet werden.
Standorte: Der neue Standort wird in der Verwaltung aktiviert und kann weiterkonfiguriert werden. Weitere Einstellungen wie Öffnungszeiten oder Zahlungsoptionen erfolgen in der Standortdetailseite.
Endgeräte: Die Konfiguration wird auf dem Gerät wirksam. Benutzer sehen nur noch die freigegebenen Kassen und Funktionen.

Tipps und Hinweise

Token-Sicherheit: Ein ausgestellter Token wird dir nur einmal angezeigt. Bewahre ihn an einem sicheren Ort auf (z.B. Passwort-Manager). Ist der Token verloren gegangen, musst du einen neuen ausstellen und den alten widerrufen.
Ablaufdatum: Setze ein realistisches Ablaufdatum für deine Tokens. Danach sind sie automatisch ungültig – das erhöht die Sicherheit. Eine Warnung erhältst du nicht; überprüfe regelmäßig die Spalte „Läuft ab".
Berechtigungen: Vergib nur die Berechtigungen, die die externe Anwendung wirklich benötigt. Das reduziert das Sicherheitsrisiko, falls der Token kompromittiert wird.
Standorte archivieren: Du kannst Standorte archivieren statt sie zu löschen. Historische Daten bleiben erhalten. Mit dem Schalter Zeige archivierte Einträge kannst du sie wieder sichtbar machen und wiederherstellen.
Endgeräte und Lizenzen: Jedes Endgerät benötigt eine entsprechende Lizenz. Die Konfiguration ist an das Gerät gebunden – wenn du es in ein anderes Endgerät migrierst, muss es neu konfiguriert werden.

Weitere Informationen zur Konfiguration von Standorten und Systemeinrichtung.