API-Token, Versicherungsträger, Endgeräte und Standorte verwalten

In den erweiterten Einstellungen richtest du API-Token für externe Zugriffe ein, pflegst Versicherungsträger und Endgeräte und verwaltest deine Standorte mit allen ihren Daten und Berechtigungen.

So kommst du hierher

1. Öffne das Menü Verwaltung in der Seitenleiste.
2. Wähle System/Einstellungen.

Jetzt siehst du die Übersicht mit mehreren Kategorien. Wähle die entsprechende aus:

• API-Token für externe Zugriffe
• Versicherungsträger (nur in bestimmten Branchen)
• Endgeräte für Mobile-Geräte-Konfiguration
• Standorte für deine Filialen oder Betriebsstätten

Voraussetzungen

Du benötigst das Recht System/Einstellungen verwalten. Je nach Bereich können weitere spezifische Rechte erforderlich sein.

So gehst du vor

API-Token ausstellen

1. In der API-Token-Übersicht klickst du auf Token ausstellen. Ein Eingabeformular öffnet sich.

2. Fülle folgende Felder aus:

   • Bezeichnung: Ein Name, unter dem du den Token später wiedererkennst (Pflichtfeld)
   • Gültig bis: Wähle ein zukünftiges Datum (Pflichtfeld)
   • Standort: Wähle den Standort, für den dieser Token gilt (Pflichtfeld)

3. Unter Berechtigungen aktivierst du die Scopes (Zugriffsrechte), die der Token haben soll. Mindestens eine Berechtigung ist erforderlich.

4. Klicke Erstellen.

   Der Token wird jetzt erzeugt und dir genau einmal angezeigt. Kopiere ihn sofort mit der Schaltfläche Token kopieren und speichere ihn sicher – du kannst ihn später nicht erneut einsehen. Klicke Fertig, um das Fenster zu schließen.

5. Der Token erscheint jetzt in der Liste mit seiner Bezeichnung, seinem Präfix (die ersten Zeichen für die Erkennung), den Berechtigungen, dem Ersteller, dem Erstellungsdatum, dem Ablaufdatum und dem Status (Aktiv, Abgelaufen oder Widerrufen).

6. Wenn du einen Token widerrufen möchtest (z. B. wenn er kompromittiert wurde), klickst du auf die Ban-Schaltfläche in der Zeile. Bestätige die Sicherheitsabfrage – der Token ist dann sofort ungültig.

   Hinweis: Widerrufene Token bleiben in der Liste sichtbar. Um sie auszublenden, deaktiviere den Schalter Widerrufene anzeigen oben.

Versicherungsträger pflegen

1. In der Versicherungsträger-Übersicht klickst du auf Hinzufügen, um einen neuen Träger einzutragen, oder doppelklickst eine bestehende Zeile, um sie zu bearbeiten. Ein Eingabeformular öffnet sich.

2. Fülle folgende Felder aus:

   • Kurzbezeichnung: Ein kurzer Name (Pflichtfeld)
   • Vollständiger Name: Die offizielle Bezeichnung (Pflichtfeld)
   • Land: Wähle das Land, in dem der Träger tätig ist (Pflichtfeld)

3. Klicke Speichern.

4. Der Träger wird in der Liste aufgeführt und zeigt die Kurzbezeichnung, den Vollständigen Namen, das Land und die Anzahl Patienten (wenn bereits Patienten diesem Träger zugeordnet sind).

5. Um einen Träger zu archivieren, klickst du auf die Archiv-Schaltfläche in seiner Zeile. Bestätige die Sicherheitsabfrage. Archivierte Träger sind nicht mehr in der aktiven Liste sichtbar, können aber über den Schalter Zeige archivierte Einträge wiederhergestellt werden.

Endgeräte konfigurieren

1. Rufe die Endgeräte-Übersicht auf (dieser Bereich ist Teil der erweiterten Einstellungen, wird aber im selben Fenster angezeigt).

2. Klicke auf ein Endgerät, um es zu konfigurieren. Das Konfigurationsfenster öffnet sich.

3. Im Bereich Daten:

   • Name: Der Gerätename (z. B. Tablet Theke)
   • Drucker: Wähle einen festen Drucker für dieses Gerät, oder lasse das Feld leer (Kein fixer Drucker), wenn das Gerät den Drucker flexibel wählen soll.

4. Unter Verfügbare Kassen: Schalte die Kassen ein oder aus, die auf diesem Gerät sichtbar sein sollen. Ausgeschaltete Kassen werden auf dem Gerät nicht angezeigt.

5. Wenn die Gastro-Erweiterung aktiv ist:

   • Unter Verfügbare Küchenmonitore: Schalte die Monitore ein oder aus, die auf diesem Gerät verfügbar sein sollen.
   • Unter Küchendruck: Schalte Küchendruck auf diesem Endgerät deaktivieren ein, um Druckaufträge für die Küche von diesem Gerät aus zu unterbinden.

6. Im Bereich Rechte: Du siehst eine Liste aller verfügbaren Berechtigungen. Aktiviere oder deaktiviere jede Berechtigung mit dem Kontrollkästchen, um festzulegen, welche Funktionen auf dem Gerät nutzbar sind. Mit der Kontrollkästchen-Kopfzeile kannst du alle Berechtigungen auf einmal aktivieren oder deaktivieren.

7. Klicke Speichern.

   Die Einstellungen werden gespeichert und sofort auf dem Gerät aktiv.

Standorte verwalten

1. In der Standorte-Übersicht siehst du alle deine Betriebsstätten aufgelistet. Jede Zeile zeigt das Logo, den Standortnamen, das Unternehmen, die Adresse (Straße, Postleitzahl, Ort, Land), die Telefonnummer, die E-Mail und weitere Details.

2. Zum Hinzufügen eines neuen Standorts klickst du auf Hinzufügen. Das Formular Standort konfigurieren öffnet sich, in dem du alle Daten eingibst.

3. Zum Bearbeiten eines Standorts doppelklickst du auf die Zeile. Ein umfassendes Konfigurationsfenster öffnet sich. Hier gibst du (je nach Konfiguration) ein:

   • Adressdaten
   • Öffnungszeiten
   • Kontaktdaten
   • Kalender und Feiertage
   • Zahlungsoptionen
   • Druckeinstellungen

   Alle Änderungen kannst du nach dem Bearbeiten speichern.

4. Zum Archivieren eines Standorts klickst du auf die Archiv-Schaltfläche. Bestätige die Sicherheitsabfrage. Ein archivierter Standort wird nicht mehr in der Standardliste angezeigt, bleibt aber erhalten.

5. Um archivierte Standorte zu verwalten, aktiviere oben den Schalter Zeige archivierte Einträge. Du kannst die Standorte dann wiederherstellen oder auch später endgültig löschen.

Aufbau der Seite

API-Token-Übersicht Die Liste zeigt alle ausgestellten Tokens mit ihren Metadaten. Die Spalte Status hilft dir, gültige von abgelaufenen oder widerrufenen Tokens zu unterscheiden.

Versicherungsträger-Übersicht Eine Tabelle mit den Kurzbezeichnungen, vollständigen Namen, Ländern und Patientenzahlen. Neue Träger können schnell hinzugefügt oder archiviert werden.

Endgeräte-Konfiguration Ein strukturiertes Formular mit fünf Bereichen: Gerätedaten, verfügbare Kassen, Küchenmonitore (nur mit Gastro-Modul), Küchendruck-Einstellungen und eine Berechtigungstabelle mit Checkboxen.

Standorte-Übersicht Eine detaillierte Tabelle mit allen Standortinformationen. Die Spalten lassen sich ein- oder ausblenden (z. B. um Änderungsdatum und Benutzer anzuzeigen). Die Doppelklick-Funktion öffnet den Konfigurationsdialog direkt.

Was danach passiert

• API-Token: Der neue Token ist sofort einsatzbereit. Externe Systeme oder Skripte können sich jetzt mit diesem Token authentifizieren und auf die autorisierte API zugreifen.

• Versicherungsträger: Der Träger steht sofort in Auswahlfeldern zur Verfügung, z. B. bei der Patienteneingabe oder in Rechnungen.

• Endgeräte: Die Konfiguration wird sofort auf dem Gerät wirksam – Kassen, Monitore und Berechtigungen passen sich an.

• Standorte: Der Standort und seine Einstellungen sind sofort im System verfügbar und beeinflussen z. B. Adressausgabe, Öffnungszeiten und Druckverhalten.

Weitere verwandte Aufgaben:

• System/Standorte – weitere Fenster und Dialoge
• System/Kontenrahmen – weitere Fenster und Dialoge
• System/Einrichtung

Tipps und Hinweise

• Token-Sicherheit: Speichere den Token sofort nach der Erstellung. Wer ihn sieht, hat Zugriff auf deine API. Du kannst ihn später nicht erneut abrufen – ein weiterer Token muss die Stelle des verlorenen einnehmen.

• Ablaufdatum für Tokens: Setze realistische Ablaufdaten (z. B. 90 Tage). Abgelaufene Tokens werden automatisch ungültig, können aber weiterhin in der Liste angezeigt werden.

• Endgeräte-Scopes: Nicht alle Berechtigungen sind für alle Geräte sinnvoll. Überlege, welche Funktionen auf welchem Gerät nötig sind, und deaktiviere alles andere – so senkst du auch das Sicherheitsrisiko.

• Standorte und Profit Center: In weboffice ist jeder Standort ein "Profit Center". Wenn du mehrere Betriebe hast, erstelle für jeden einen Standort, damit alle Daten (Adresse, Steuernummern, Konten, Öffnungszeiten) unabhängig sind.