...
| Version | Datum | Autor | Kapitel | Änderung | Status |
|---|---|---|---|---|---|
| 1.1 | 15.06.2026 | kv.digital GmbH | Health Check Endpoint | Neues Kapitel | in Kraft |
| 1.0 | 2705.0506.2026 | kv.digital GmbH | alle | Erstellung | in Kraft- |
| Inhalt |
|---|
Allgemein
Sobald das Audit erfolgreich abgeschlossen ist und Sie die Zertifizierung erhalten haben, können Sie die Schnittstelle final in die Produktivumgebung Ihrer Software oder Plattform integrieren.
Hierzu stellt Ihnen die kv.digital einen Zugangslink zur Produktivumgebung sowie die erforderlichen Zugangsdaten bereit (OAuth2 mit dem Client‑Credential‑Flow).
Für die Nutzung ist außerdem eine VPN‑Verbindung einer Site-to-Site-VPN‑Verbindung (VPN-Verbindung) zwischen den vertrauenswürdigen Umgebungen der Client‑ und der Server‑Systeme erforderlich, die zur sicheren Speicherung des Schlüsselmaterials Client‑seitig in Hardware ausgelegt ist.
...
- Audit erfolgreich abgeschlossen
- Zertifizierung liegt vor
(gilt für die jeweilige Schnittstelle gemäß § 370a Abs. 2 SGB V)
...
Wichtig: Planen Sie für die vollständige Anbindung mindestens 20 Arbeitstage ein.
Aktuelle Meldungen und Systemstatus
Regelmäßige Wartungsarbeiten sowie planbare Releases finden – soweit möglich – mittwochs ab 18:30 Uhr statt.
In diesem Zeitraum können Komponenten des 116117 Terminservice vorübergehend nicht erreichbar sein.
Sollte eine ungeplante oder zusätzliche Downtime außerhalb dieses Zeitfensters erforderlich sein, wird darüber frühzeitig informiert.
👉 Den aktuellen Systemstatus finden Sie hier:
https://partnerportal.kv-telematik.de/spaces/TSSCA/pages/134881409/Aktuelle+Meldungen+und+Systemstatus
📌 Empfehlung:
Setzen Sie die Seite auf „Beobachten“, um automatisch über Änderungen und Störungen informiert zu werden.
Health Check Endpoint
Der Health-Check-Endpunkt dient dazu, die grundlegende Erreichbarkeit und Funktionsfähigkeit der Anwendung zu prüfen.
Endpoint-Definition
URL:
| Codeblock |
|---|
{baseURL}/api/v2/healthcheck |
HTTP-Methode:
| Codeblock |
|---|
GET |
FHIR-Kontext:
Es handelt sich ausdrücklich nicht um einen FHIR-Endpunkt.
Request:
Der Endpoint benötigt keine speziellen Header oder Parameter.
Response:
Erfolgreicher Fall
Wenn der Service erreichbar ist und läuft:
| Codeblock |
|---|
HTTP/1.1 200 OK |
- Es wird kein Response-Body erwartet.
- Der Statuscode allein signalisiert den erfolgreichen Health-Zustand.
Fehlerfall:
Falls der Service nicht funktionsfähig ist, wird ein HTTP-Statuscode ungleich 200 zurückgegeben.
Schritt 1: Anmeldung zur Integration
...
Zusammenfassung:
Produktivgang <Ihre Organisation> / <Schnittstelle>Beschreibung:
- Ansprechpartner für den Produktivgang
- E-Mail-Adresse für die Kommunikation
gewünschte Schnittstelle
geplantes Datum für den Produktivgang
Optional:
Weitere Beteiligte hinzufügen (Registrierung erforderlich)
...
Nach erfolgreicher Prüfung erhalten Sie Ihre Zugangsdaten und den Zugangslink
- Bereitstellung durch das Team Anwendungen & Support-Team
- Versand über die sichere Plattform Cryptshare → Absender: audit@kv.digital
- Passwort wird separat per E-Mail an die angegebene E-Mailadresse gesendet
...
Sie erhalten vom Support-Team eine Aufforderung
Erstellen Sie einen den CSR (Certificate Signing Request) bereitzustellen
Erstellen Sie einen CSR
Senden Sie den CSR über Cryptshare an audit@kv.digital:
Senden Sie zusätzlich per E-Mail an audit@kv.digital:
- das gewählte Passwort
- die Tracking-ID
Sie erhalten anschließend Ihr signiertes Zertifikat über das Ticket
Ergebnis
Nach erfolgreicher Einrichtung können Sie:
...