GDT-Schnittstelle Praxis
Über die GDT-Schnittstelle können externe Systeme Dateien an Offisy übermitteln. Derzeit wird die Schnittstelle von SonoGDT unterstützt.
Was ist die GDT-Schnittstelle?
Die GDT-Schnittstelle ist ein API-Endpunkt, über den externe Geräte oder Programme Dateien an Offisy senden können. Das externe System authentifiziert sich mit einem API-Schlüssel und einer Firmen-ID.
Voraussetzungen
- Du bist als Administrator angemeldet.
- Du hast Zugriff auf die Medizinischen Einstellungen.
Schnittstelle einrichten

- Öffne die Medizinischen Einstellungen.
- Navigiere zum Abschnitt GDT Schnittstelle.
- Klicke auf Generieren. Offisy erstellt automatisch einen sicheren API-Schlüssel.
- Klicke auf Speichern.
- Nach dem Generieren werden die Zugangsdaten angezeigt. Klicke auf Kopieren, um sie in die Zwischenablage zu übernehmen.
- Konfiguriere das externe System (z. B. SonoGDT) mit den kopierten Zugangsdaten:
- x-sonogdt-company: Die UUID deiner Firma in Offisy
- x-sonogdt-secret: Der automatisch generierte API-Schlüssel
Hinweis: Ohne generierten API-Schlüssel ist die Schnittstelle deaktiviert. Externe Systeme können dann keine Dateien an Offisy senden.
Hinweis: Mit Löschen kannst du den API-Schlüssel entfernen und die Schnittstelle wieder deaktivieren.
Unterstützte Systeme
| System | Beschreibung |
|---|---|
| SonoGDT | Übermittlung von Sonographie-Dateien an die Patientenakte |
Häufige Fehler
- Externes System kann keine Dateien senden: Prüfe, ob ein API-Schlüssel generiert und gespeichert wurde. Stelle sicher, dass die kopierten Zugangsdaten korrekt im externen System hinterlegt sind.
- Datei wird keinem Patienten zugeordnet: Stelle sicher, dass die korrekte Patienten-ID übermittelt wird.
- Datei wird abgelehnt: Die maximale Dateigröße beträgt 15 MB. Prüfe außerdem, ob ausreichend Speicherplatz vorhanden ist.