...

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:

{baseURL}/api/v2/healthcheck

HTTP-Methode:

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:

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

...

1. Sie erhalten vom Support-Team eine Aufforderung

Erstellen Sie einen

2. den CSR (Certificate Signing Request) bereitzustellen

3. Erstellen Sie einen CSR 

4. Senden Sie den CSR über Cryptshare an audit@kv.digital:

5. Senden Sie zusätzlich per E-Mail an audit@kv.digital:

   • das gewählte Passwort
   • die Tracking-ID

6. Sie erhalten anschließend Ihr signiertes Zertifikat über das Ticket

Ergebnis

Nach erfolgreicher Einrichtung können Sie:

...